Method: advertisers.lineItems.bulkUpdate

تعديل بنود متعددة

لا يمكن إرسال طلبات إلى نقطة النهاية هذه بالتزامن مع الطلبات التالية التي تعدّل العنصر نفسه:

لا يمكن إنشاء بنود إعلانية على YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.

طلب HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/lineItems:bulkUpdate

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

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

المعلمات
advertiserId

string (int64 format)

الحقل مطلوب. رقم تعريف المعلِن الذي ينتمي إليه هذا البند الإعلاني

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
الحقول
lineItemIds[]

string (int64 format)

الحقل مطلوب. أرقام تعريف البنود الإعلانية المطلوب تعديلها
targetLineItem

object (LineItem)

الحقل مطلوب. عنصر بند إعلاني يحتوي على الحقول المطلوب تعديلها والقيم الجديدة التي سيتم تخصيصها لجميع البنود الإعلانية المحدّدة في lineItemIds."
updateMask

string (FieldMask format)

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

لا تتوفّر حاليًا سوى الحقول التالية:

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

نص الاستجابة

رسالة الاستجابة لـ LineItemService.BulkUpdateLineItems.

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

تمثيل JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
الحقول
updatedLineItemIds[]

string (int64 format)

أرقام تعريف العناصر التي تم تعديلها بنجاح
failedLineItemIds[]

string (int64 format)

أرقام تعريف البنود الإعلانية التي تعذّر تعديلها
skippedLineItemIds[]

string (int64 format)

أرقام تعريف البنود الإعلانية التي تم تخطّيها في التعديلات على سبيل المثال، سيتم تخطّي عمليات التغيير غير الضرورية التي لن تؤدي إلى أي تغييرات في تفاصيل العناصر، ويمكن تتبُّع أرقام تعريف تفاصيل العناصر المقابلة هنا.
errors[]

object (Status)

الأخطاء التي عرضتها البنود التي تعذّر تعديلها

نطاقات الأذونات

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

  • https://www.googleapis.com/auth/display-video

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