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.