Method: advertisers.lineItems.bulkUpdate

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

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

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

طلب HTTP

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