Method: advertisers.lineItems.bulkUpdate

تعدّل هذه الطريقة عدة عناصر.

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

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

طلب HTTP

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