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.