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 Overview.