Method: sellers.adPlays.batchCreate

تنشئ عمليات تشغيل جديدة للإعلانات دفعة واحدة.

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

طلب HTTP

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

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

مَعلمات المسار

المعلمات
parent

string

مطلوب. اسم مورد البائع التنسيق: seller/{seller}

نص الطلب

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

تمثيل JSON 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
الحقول
requests[]

object (CreateAdPlayRequest)

مطلوب. يتم تشغيل الإعلان لإنشائه.

الحدّ الأقصى المسموح به لعدد مرّات تشغيل الإعلان في الدُفعة هو 1,000. يجب أن يكون وقت البدء في الماضي أو قبل 3 أيام على الأكثر من تاريخ الإنشاء. يجب أن يكون وقت الانتهاء في الماضي وبعد وقت البدء.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الاستجابة لإنشاء عمليات تشغيل الإعلان دفعة واحدة.

تمثيل JSON 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
الحقول
adPlays[]

object (AdPlay)

عدد مرّات تشغيل الإعلان التي تمّ إنشاؤها

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

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

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

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

CreateAdPlayRequest

طلب رسالة إلى AdPlayService.CreateAdPlay.

تمثيل JSON 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
الحقول
parent

string

مطلوب. اسم مورد البائع التنسيق: seller/{seller}
adPlay

object (AdPlay)

مطلوب. تشغيل الإعلان المطلوب إنشاؤه.

سيُنشئ النظام اسم تشغيل الإعلان، ويجب ألا يتم تحديده. يجب أن يكون وقت البدء في الماضي أو قبل 3 أيام على الأكثر من تاريخ الإنشاء. يجب أن يكون وقت الانتهاء في الماضي وبعد وقت البدء.