Method: advertisers.lineItems.bulkUpdate

تعمل على تعديل عناصر متعدّدة.

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v2/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.