Method: adPlays.createWithExternalIds

إنشاء عملية تشغيل للإعلانات باستخدام معرّفات خارجية

  • عرض تشغيل الإعلان الذي تم إنشاؤه حديثًا في حالة نجاحه.
  • تعرض رمز الخطأ INVALID_ARGUMENT في حال تحديد معرّف خارجي غير صالح للوحدة الإعلانية، أو معرّف خارجي للطلب، أو معرّف خارجي للسطر، أو معرّف خارجي لملف أصل تصميم الإعلان.
  • تعرض رمز الخطأ INVALID_ARGUMENT إذا كان يتم تشغيل إعلان لنفس الوحدة الإعلانية والترتيب والسطر والتصميم بنفس وقت البدء.
  • تعرض رمز الخطأ NOT_FOUND في حال عدم العثور على معرّف خارجي مطابق للوحدة الإعلانية أو معرّف خارجي للطلب أو معرّف خارجي للسطر أو معرّف خارجي لملف أصل التصميم.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

مطلوب. وقت انتهاء تشغيل الإعلان (شامل) يجب أن يكون تاريخ ووقت البدء في الماضي.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

اختياريّ. وقت تسجيل تشغيل هذا الإعلان يجب أن يكون تاريخ الميلاد في الماضي وبعده.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
impressions

number

مطلوب. إجمالي عدد مرات الظهور

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال AdPlay.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.