import {z} from 'zod' export type Size = {height?: number | undefined, iab?: boolean | undefined, id?: unknown | undefined, kind?: string | undefined, width?: number | undefined}; export type DimensionValue = {dimensionName?: string | undefined, etag?: string | undefined, id?: string | undefined, kind?: string | undefined, matchType?: ('EXACT' | 'BEGINS_WITH' | 'CONTAINS' | 'WILDCARD_EXPRESSION') | undefined, value?: string | undefined}; export type PlacementSingleConversionDomain = {conversionDomainId?: unknown | undefined, conversionDomainValue?: string | undefined}; export type PlacementConversionDomainOverride = {conversionDomains?: Array | undefined}; export type LastModifiedInfo = {time?: unknown | undefined}; export type LookbackConfiguration = {clickDuration?: number | undefined, postImpressionActivitiesDuration?: number | undefined}; export type MeasurementPartnerWrappingData = {linkStatus?: ('MEASUREMENT_PARTNER_UNLINKED' | 'MEASUREMENT_PARTNER_LINKED' | 'MEASUREMENT_PARTNER_LINK_PENDING' | 'MEASUREMENT_PARTNER_LINK_FAILURE' | 'MEASUREMENT_PARTNER_LINK_OPT_OUT' | 'MEASUREMENT_PARTNER_LINK_OPT_OUT_PENDING' | 'MEASUREMENT_PARTNER_LINK_WRAPPING_PENDING' | 'MEASUREMENT_PARTNER_MODE_CHANGE_PENDING' | 'MEASUREMENT_PARTNER_UNLINK_PENDING') | undefined, measurementPartner?: ('NONE' | 'INTEGRAL_AD_SCIENCE' | 'DOUBLE_VERIFY') | undefined, tagWrappingMode?: ('NONE' | 'BLOCKING' | 'MONITORING' | 'MONITORING_READ_ONLY' | 'VIDEO_PIXEL_MONITORING' | 'TRACKING' | 'VPAID_MONITORING' | 'VPAID_BLOCKING' | 'NON_VPAID_MONITORING' | 'VPAID_ONLY_MONITORING' | 'VPAID_ONLY_BLOCKING' | 'VPAID_ONLY_FILTERING' | 'VPAID_FILTERING' | 'NON_VPAID_FILTERING' | 'BLOCKING_FILTERING_VPAID' | 'BLOCKING_FILTERING_VPAID_ONLY') | undefined, wrappedTag?: string | undefined}; export type PricingSchedulePricingPeriod = {endDate?: string | undefined, pricingComment?: string | undefined, rateOrCostNanos?: unknown | undefined, startDate?: string | undefined, units?: unknown | undefined}; export type PricingSchedule = {capCostOption?: ('CAP_COST_NONE' | 'CAP_COST_MONTHLY' | 'CAP_COST_CUMULATIVE') | undefined, endDate?: string | undefined, flighted?: boolean | undefined, floodlightActivityId?: unknown | undefined, pricingPeriods?: Array | undefined, pricingType?: ('PRICING_TYPE_CPM' | 'PRICING_TYPE_CPC' | 'PRICING_TYPE_CPA' | 'PRICING_TYPE_FLAT_RATE_IMPRESSIONS' | 'PRICING_TYPE_FLAT_RATE_CLICKS' | 'PRICING_TYPE_CPM_ACTIVEVIEW') | undefined, startDate?: string | undefined, testingStartDate?: string | undefined}; export type TagSetting = {additionalKeyValues?: string | undefined, includeClickThroughUrls?: boolean | undefined, includeClickTracking?: boolean | undefined, includeUnescapedlpurlMacro?: boolean | undefined, keywordOption?: ('PLACEHOLDER_WITH_LIST_OF_KEYWORDS' | 'IGNORE' | 'GENERATE_SEPARATE_TAG_FOR_EACH_KEYWORD') | undefined}; export type CompanionSetting = {companionsDisabled?: boolean | undefined, enabledSizes?: Array | undefined, imageOnly?: boolean | undefined, kind?: string | undefined}; export type ObaIcon = {iconClickThroughUrl?: string | undefined, iconClickTrackingUrl?: string | undefined, iconViewTrackingUrl?: string | undefined, program?: string | undefined, resourceUrl?: string | undefined, size?: Size | undefined, xPosition?: string | undefined, yPosition?: string | undefined}; export type VideoOffset = {offsetPercentage?: number | undefined, offsetSeconds?: number | undefined}; export type SkippableSetting = {kind?: string | undefined, progressOffset?: VideoOffset | undefined, skipOffset?: VideoOffset | undefined, skippable?: boolean | undefined}; export type TranscodeSetting = {enabledVideoFormats?: Array | undefined, kind?: string | undefined}; export type VideoSettings = {companionSettings?: CompanionSetting | undefined, durationSeconds?: number | undefined, kind?: string | undefined, obaEnabled?: boolean | undefined, obaSettings?: ObaIcon | undefined, orientation?: ('ANY' | 'LANDSCAPE' | 'PORTRAIT') | undefined, publisherSpecificationId?: unknown | undefined, skippableSettings?: SkippableSetting | undefined, transcodeSettings?: TranscodeSetting | undefined}; export type YoutubeSettings = {businessLogoCreativeIds?: Array | undefined, businessName?: string | undefined, callToActions?: (Array<'CALL_TO_ACTION_UNKNOWN' | 'CALL_TO_ACTION_LEARN_MORE' | 'CALL_TO_ACTION_GET_QUOTE' | 'CALL_TO_ACTION_APPLY_NOW' | 'CALL_TO_ACTION_SIGN_UP' | 'CALL_TO_ACTION_CONTACT_US' | 'CALL_TO_ACTION_SUBSCRIBE' | 'CALL_TO_ACTION_DOWNLOAD' | 'CALL_TO_ACTION_BOOK_NOW' | 'CALL_TO_ACTION_GET_OFFER' | 'CALL_TO_ACTION_SHOP_NOW' | 'CALL_TO_ACTION_VISIT_STORE' | 'CALL_TO_ACTION_CALL_NOW' | 'CALL_TO_ACTION_VIEW_MENU' | 'CALL_TO_ACTION_TEST_DRIVE' | 'CALL_TO_ACTION_SCHEDULE_NOW' | 'CALL_TO_ACTION_BUY_NOW' | 'CALL_TO_ACTION_DONATE_NOW' | 'CALL_TO_ACTION_ORDER_NOW' | 'CALL_TO_ACTION_PLAY_NOW' | 'CALL_TO_ACTION_SEE_MORE' | 'CALL_TO_ACTION_START_NOW' | 'CALL_TO_ACTION_VISIT_SITE' | 'CALL_TO_ACTION_WATCH_NOW'>) | undefined, descriptions?: Array | undefined, headlines?: Array | undefined, longHeadlines?: Array | undefined}; export type Placement = {accountId?: unknown | undefined, activeStatus?: ('PLACEMENT_STATUS_UNKNOWN' | 'PLACEMENT_STATUS_ACTIVE' | 'PLACEMENT_STATUS_INACTIVE' | 'PLACEMENT_STATUS_ARCHIVED' | 'PLACEMENT_STATUS_PERMANENTLY_ARCHIVED') | undefined, adBlockingOptOut?: boolean | undefined, adServingPlatformId?: unknown | undefined, additionalSizes?: Array | undefined, advertiserId?: unknown | undefined, advertiserIdDimensionValue?: DimensionValue | undefined, allowOnYoutube?: boolean | undefined, campaignId?: unknown | undefined, campaignIdDimensionValue?: DimensionValue | undefined, comment?: string | undefined, compatibility?: ('DISPLAY' | 'DISPLAY_INTERSTITIAL' | 'APP' | 'APP_INTERSTITIAL' | 'IN_STREAM_VIDEO' | 'IN_STREAM_AUDIO') | undefined, contentCategoryId?: unknown | undefined, conversionDomainOverride?: PlacementConversionDomainOverride | undefined, createInfo?: LastModifiedInfo | undefined, directorySiteId?: unknown | undefined, directorySiteIdDimensionValue?: DimensionValue | undefined, externalId?: string | undefined, id?: unknown | undefined, idDimensionValue?: DimensionValue | undefined, keyName?: string | undefined, kind?: string | undefined, lastModifiedInfo?: LastModifiedInfo | undefined, lookbackConfiguration?: LookbackConfiguration | undefined, name?: string | undefined, partnerWrappingData?: MeasurementPartnerWrappingData | undefined, paymentApproved?: boolean | undefined, paymentSource?: ('PLACEMENT_AGENCY_PAID' | 'PLACEMENT_PUBLISHER_PAID') | undefined, placementGroupId?: unknown | undefined, placementGroupIdDimensionValue?: DimensionValue | undefined, placementStrategyId?: unknown | undefined, pricingSchedule?: PricingSchedule | undefined, primary?: boolean | undefined, publisherUpdateInfo?: LastModifiedInfo | undefined, siteId?: unknown | undefined, siteIdDimensionValue?: DimensionValue | undefined, siteServed?: boolean | undefined, size?: Size | undefined, sslRequired?: boolean | undefined, status?: ('PENDING_REVIEW' | 'PAYMENT_ACCEPTED' | 'PAYMENT_REJECTED' | 'ACKNOWLEDGE_REJECTION' | 'ACKNOWLEDGE_ACCEPTANCE' | 'DRAFT') | undefined, subaccountId?: unknown | undefined, tagFormats?: (Array<'PLACEMENT_TAG_STANDARD' | 'PLACEMENT_TAG_IFRAME_JAVASCRIPT' | 'PLACEMENT_TAG_IFRAME_ILAYER' | 'PLACEMENT_TAG_INTERNAL_REDIRECT' | 'PLACEMENT_TAG_JAVASCRIPT' | 'PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT' | 'PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT' | 'PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT' | 'PLACEMENT_TAG_CLICK_COMMANDS' | 'PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH' | 'PLACEMENT_TAG_TRACKING' | 'PLACEMENT_TAG_TRACKING_IFRAME' | 'PLACEMENT_TAG_TRACKING_JAVASCRIPT' | 'PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3' | 'PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY' | 'PLACEMENT_TAG_JAVASCRIPT_LEGACY' | 'PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY' | 'PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY' | 'PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4' | 'PLACEMENT_TAG_TRACKING_THIRD_PARTY_MEASUREMENT'>) | undefined, tagSetting?: TagSetting | undefined, videoActiveViewOptOut?: boolean | undefined, videoSettings?: VideoSettings | undefined, vpaidAdapterChoice?: ('DEFAULT' | 'FLASH' | 'HTML5' | 'BOTH') | undefined, wrappingOptOut?: boolean | undefined, youtubeSettings?: YoutubeSettings | undefined}; export type PatchApiUserprofilesUserprofilesIdPlacementsArgs = {userprofilesId: string, id: unknown, body: Placement}; export type PatchApiUserprofilesUserprofilesIdPlacementsOptions = {baseUrl?: string | undefined, Oauth2?: string | undefined, Oauth2c?: string | undefined, fetch?: typeof fetch | undefined}; export const size = z.object({height: z.number().int().optional(), iab: z.boolean().optional(), id: z.string().optional(), kind: z.string().optional(), width: z.number().int().optional()}); export const dimensionValue = z.object({dimensionName: z.string().optional(), etag: z.string().optional(), id: z.string().optional(), kind: z.string().optional(), matchType: z.enum(["EXACT", "BEGINS_WITH", "CONTAINS", "WILDCARD_EXPRESSION"]).optional(), value: z.string().optional()}); export const placementSingleConversionDomain = z.object({conversionDomainId: z.string().optional(), conversionDomainValue: z.string().optional()}); export const placementConversionDomainOverride = z.object({conversionDomains: z.array(placementSingleConversionDomain).optional()}); export const lastModifiedInfo = z.object({time: z.string().optional()}); export const lookbackConfiguration = z.object({clickDuration: z.number().int().optional(), postImpressionActivitiesDuration: z.number().int().optional()}); export const measurementPartnerWrappingData = z.object({linkStatus: z.enum(["MEASUREMENT_PARTNER_UNLINKED", "MEASUREMENT_PARTNER_LINKED", "MEASUREMENT_PARTNER_LINK_PENDING", "MEASUREMENT_PARTNER_LINK_FAILURE", "MEASUREMENT_PARTNER_LINK_OPT_OUT", "MEASUREMENT_PARTNER_LINK_OPT_OUT_PENDING", "MEASUREMENT_PARTNER_LINK_WRAPPING_PENDING", "MEASUREMENT_PARTNER_MODE_CHANGE_PENDING", "MEASUREMENT_PARTNER_UNLINK_PENDING"]).optional(), measurementPartner: z.enum(["NONE", "INTEGRAL_AD_SCIENCE", "DOUBLE_VERIFY"]).optional(), tagWrappingMode: z.enum(["NONE", "BLOCKING", "MONITORING", "MONITORING_READ_ONLY", "VIDEO_PIXEL_MONITORING", "TRACKING", "VPAID_MONITORING", "VPAID_BLOCKING", "NON_VPAID_MONITORING", "VPAID_ONLY_MONITORING", "VPAID_ONLY_BLOCKING", "VPAID_ONLY_FILTERING", "VPAID_FILTERING", "NON_VPAID_FILTERING", "BLOCKING_FILTERING_VPAID", "BLOCKING_FILTERING_VPAID_ONLY"]).optional(), wrappedTag: z.string().optional()}); export const pricingSchedulePricingPeriod = z.object({endDate: z.string().optional(), pricingComment: z.string().optional(), rateOrCostNanos: z.string().optional(), startDate: z.string().optional(), units: z.string().optional()}); export const pricingSchedule = z.object({capCostOption: z.enum(["CAP_COST_NONE", "CAP_COST_MONTHLY", "CAP_COST_CUMULATIVE"]).optional(), endDate: z.string().optional(), flighted: z.boolean().optional(), floodlightActivityId: z.string().optional(), pricingPeriods: z.array(pricingSchedulePricingPeriod).optional(), pricingType: z.enum(["PRICING_TYPE_CPM", "PRICING_TYPE_CPC", "PRICING_TYPE_CPA", "PRICING_TYPE_FLAT_RATE_IMPRESSIONS", "PRICING_TYPE_FLAT_RATE_CLICKS", "PRICING_TYPE_CPM_ACTIVEVIEW"]).optional(), startDate: z.string().optional(), testingStartDate: z.string().optional()}); export const tagSetting = z.object({additionalKeyValues: z.string().optional(), includeClickThroughUrls: z.boolean().optional(), includeClickTracking: z.boolean().optional(), includeUnescapedlpurlMacro: z.boolean().optional(), keywordOption: z.enum(["PLACEHOLDER_WITH_LIST_OF_KEYWORDS", "IGNORE", "GENERATE_SEPARATE_TAG_FOR_EACH_KEYWORD"]).optional()}); export const companionSetting = z.object({companionsDisabled: z.boolean().optional(), enabledSizes: z.array(size).optional(), imageOnly: z.boolean().optional(), kind: z.string().optional()}); export const obaIcon = z.object({iconClickThroughUrl: z.string().optional(), iconClickTrackingUrl: z.string().optional(), iconViewTrackingUrl: z.string().optional(), program: z.string().optional(), resourceUrl: z.string().optional(), size: size.optional(), xPosition: z.string().optional(), yPosition: z.string().optional()}); export const videoOffset = z.object({offsetPercentage: z.number().int().optional(), offsetSeconds: z.number().int().optional()}); export const skippableSetting = z.object({kind: z.string().optional(), progressOffset: videoOffset.optional(), skipOffset: videoOffset.optional(), skippable: z.boolean().optional()}); export const transcodeSetting = z.object({enabledVideoFormats: z.array(z.number().int()).optional(), kind: z.string().optional()}); export const videoSettings = z.object({companionSettings: companionSetting.optional(), durationSeconds: z.number().int().optional(), kind: z.string().optional(), obaEnabled: z.boolean().optional(), obaSettings: obaIcon.optional(), orientation: z.enum(["ANY", "LANDSCAPE", "PORTRAIT"]).optional(), publisherSpecificationId: z.string().optional(), skippableSettings: skippableSetting.optional(), transcodeSettings: transcodeSetting.optional()}); export const youtubeSettings = z.object({businessLogoCreativeIds: z.array(z.string()).optional(), businessName: z.string().optional(), callToActions: z.array(z.enum(["CALL_TO_ACTION_UNKNOWN", "CALL_TO_ACTION_LEARN_MORE", "CALL_TO_ACTION_GET_QUOTE", "CALL_TO_ACTION_APPLY_NOW", "CALL_TO_ACTION_SIGN_UP", "CALL_TO_ACTION_CONTACT_US", "CALL_TO_ACTION_SUBSCRIBE", "CALL_TO_ACTION_DOWNLOAD", "CALL_TO_ACTION_BOOK_NOW", "CALL_TO_ACTION_GET_OFFER", "CALL_TO_ACTION_SHOP_NOW", "CALL_TO_ACTION_VISIT_STORE", "CALL_TO_ACTION_CALL_NOW", "CALL_TO_ACTION_VIEW_MENU", "CALL_TO_ACTION_TEST_DRIVE", "CALL_TO_ACTION_SCHEDULE_NOW", "CALL_TO_ACTION_BUY_NOW", "CALL_TO_ACTION_DONATE_NOW", "CALL_TO_ACTION_ORDER_NOW", "CALL_TO_ACTION_PLAY_NOW", "CALL_TO_ACTION_SEE_MORE", "CALL_TO_ACTION_START_NOW", "CALL_TO_ACTION_VISIT_SITE", "CALL_TO_ACTION_WATCH_NOW"])).optional(), descriptions: z.array(z.string()).optional(), headlines: z.array(z.string()).optional(), longHeadlines: z.array(z.string()).optional()}); export const placement = z.object({accountId: z.string().optional(), activeStatus: z.enum(["PLACEMENT_STATUS_UNKNOWN", "PLACEMENT_STATUS_ACTIVE", "PLACEMENT_STATUS_INACTIVE", "PLACEMENT_STATUS_ARCHIVED", "PLACEMENT_STATUS_PERMANENTLY_ARCHIVED"]).optional(), adBlockingOptOut: z.boolean().optional(), adServingPlatformId: z.string().optional(), additionalSizes: z.array(size).optional(), advertiserId: z.string().optional(), advertiserIdDimensionValue: dimensionValue.optional(), allowOnYoutube: z.boolean().optional(), campaignId: z.string().optional(), campaignIdDimensionValue: dimensionValue.optional(), comment: z.string().optional(), compatibility: z.enum(["DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO"]).optional(), contentCategoryId: z.string().optional(), conversionDomainOverride: placementConversionDomainOverride.optional(), createInfo: lastModifiedInfo.optional(), directorySiteId: z.string().optional(), directorySiteIdDimensionValue: dimensionValue.optional(), externalId: z.string().optional(), id: z.string().optional(), idDimensionValue: dimensionValue.optional(), keyName: z.string().optional(), kind: z.string().optional(), lastModifiedInfo: lastModifiedInfo.optional(), lookbackConfiguration: lookbackConfiguration.optional(), name: z.string().optional(), partnerWrappingData: measurementPartnerWrappingData.optional(), paymentApproved: z.boolean().optional(), paymentSource: z.enum(["PLACEMENT_AGENCY_PAID", "PLACEMENT_PUBLISHER_PAID"]).optional(), placementGroupId: z.string().optional(), placementGroupIdDimensionValue: dimensionValue.optional(), placementStrategyId: z.string().optional(), pricingSchedule: pricingSchedule.optional(), primary: z.boolean().optional(), publisherUpdateInfo: lastModifiedInfo.optional(), siteId: z.string().optional(), siteIdDimensionValue: dimensionValue.optional(), siteServed: z.boolean().optional(), size: size.optional(), sslRequired: z.boolean().optional(), status: z.enum(["PENDING_REVIEW", "PAYMENT_ACCEPTED", "PAYMENT_REJECTED", "ACKNOWLEDGE_REJECTION", "ACKNOWLEDGE_ACCEPTANCE", "DRAFT"]).optional(), subaccountId: z.string().optional(), tagFormats: z.array(z.enum(["PLACEMENT_TAG_STANDARD", "PLACEMENT_TAG_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_IFRAME_ILAYER", "PLACEMENT_TAG_INTERNAL_REDIRECT", "PLACEMENT_TAG_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT", "PLACEMENT_TAG_CLICK_COMMANDS", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH", "PLACEMENT_TAG_TRACKING", "PLACEMENT_TAG_TRACKING_IFRAME", "PLACEMENT_TAG_TRACKING_JAVASCRIPT", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3", "PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4", "PLACEMENT_TAG_TRACKING_THIRD_PARTY_MEASUREMENT"])).optional(), tagSetting: tagSetting.optional(), videoActiveViewOptOut: z.boolean().optional(), videoSettings: videoSettings.optional(), vpaidAdapterChoice: z.enum(["DEFAULT", "FLASH", "HTML5", "BOTH"]).optional(), wrappingOptOut: z.boolean().optional(), youtubeSettings: youtubeSettings.optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Updates an existing placement. This method supports patch semantics. * * PATCH /userprofiles/{userprofilesId}/placements */ export const patchApiUserprofilesUserprofilesIdPlacements = async (args: PatchApiUserprofilesUserprofilesIdPlacementsArgs, options?: PatchApiUserprofilesUserprofilesIdPlacementsOptions) => { const {baseUrl = "https://dfareporting.googleapis.com/dfareporting/v5", fetch: fetchFn = fetch, Oauth2, Oauth2c} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args.id != null) query.append("id", String(args.id)) if (Oauth2 !== undefined) headers.set('authorization', `Bearer ${Oauth2}`) if (Oauth2c !== undefined) headers.set('authorization', `Bearer ${Oauth2c}`) const url = `${baseUrl.replace(/\/+$/, '')}/userprofiles/${encodeURIComponent(String(args.userprofilesId))}/placements${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "PATCH", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(placement, await res.json()) };