Method: adPlays.createWithExternalIds

یک بازی تبلیغاتی با شناسه های خارجی ایجاد می کند.

  • در صورت موفقیت، پخش آگهی جدید ایجاد شده را برمی گرداند.
  • اگر شناسه خارجی واحد تبلیغات، شناسه خارجی سفارش، شناسه خارجی خط یا شناسه خارجی دارایی خلاقانه نامعتبر باشد، کد خطا را INVALID_ARGUMENT برمی گرداند.
  • اگر تبلیغی برای واحد تبلیغات، سفارش، خط و خلاقیت مشابه با زمان شروع یکسان از قبل وجود داشته باشد، کد خطا INVALID_ARGUMENT برمی‌گرداند.
  • اگر شناسه خارجی واحد تبلیغاتی، شناسه خارجی سفارش، شناسه خارجی خط یا شناسه خارجی دارایی خلاقانه منطبق پیدا نشود، کد خطا NOT_FOUND برمی گرداند.

درخواست HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
فیلدها
lineExternalId

string

مورد نیاز. شناسه خارجی خطی که این پخش آگهی به آن تعلق دارد. فرمت: 123 .

orderExternalId

string

مورد نیاز. شناسه خارجی سفارشی که این پخش آگهی به آن تعلق دارد. فرمت: 456 .

adUnitExternalId

string

مورد نیاز. شناسه خارجی واحد تبلیغاتی که این پخش آگهی در آن ارائه شده است. فرمت: 789 .

creativeAssetExternalId

string

مورد نیاز. شناسه خارجی خلاقیتی که این پخش آگهی ارائه کرده است. فرمت: 3210 .

startTime

string ( Timestamp format)

مورد نیاز. زمان شروع پخش آگهی (شامل). باید در گذشته و در 3 روز گذشته باشد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

endTime

string ( Timestamp format)

مورد نیاز. زمان پایان پخش آگهی (انحصاری). باید در گذشته و بعد از زمان شروع باشد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

recordTime

string ( Timestamp format)

اختیاری. زمان ضبط این پخش آگهی. باید در زمان گذشته و پس از پایان باشد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

impressions

number

مورد نیاز. تعداد کل برداشت ها

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از AdPlay است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclickbidmanager

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.