Method: sellers.adUnits.impressionSchedules.batchUpdate

يتم تعديل الجداول الزمنية لمرات الظهور بشكل مجمّع.

  • الحد الأقصى المسموح به لعدد الجداول الزمنية لمرات الظهور في الدفعة هو 1,000.
  • عرض الجداول الزمنية المعدّلة لمرات الظهور في حال نجاحها.
  • تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد حقل غير قابل للتغيير في updateMask وتم طلب تغيير.

طلب HTTP

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate

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

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

المعلمات
parent

string

مطلوب. اسم المورد الرئيسي. الشكل: البائعون/{seller}/adUnits/{adUnit}

نص الطلب

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

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

object (UpdateImpressionScheduleRequest)

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

الحد الأقصى المسموح به لعدد مرات الظهور في المجموعة هو 1,000.

نص الاستجابة

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

رسالة استجابة لـ InventoryService.BatchUpdate impressionsschedules

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

object (ImpressionSchedule)

الجدول الزمني المعدَّل لمرات الظهور.

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

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

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

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

UpdateImpressionScheduleRequest

طلب إرسال رسالة إلى InventoryService.Updateimpressionschedule

تمثيل JSON 
{
  "impressionSchedule": {
    object (ImpressionSchedule)
  },
  "updateMask": string
}
الحقول
impressionSchedule

object (ImpressionSchedule)

مطلوب. جدول مرات الظهور الجزئية مع الحقول المعدّلة.

الحقول التالية مطلوبة: * الاسم - يتم استخدامه لتحديد جدول مرات الظهور الذي يجب تعديله.
updateMask

string (FieldMask format)

مطلوب. القناع الذي يتحكّم في الحقول المطلوب تعديلها.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"