تعمل على تعديل عناصر متعدّدة.
لا يمكن تقديم الطلبات إلى نقطة النهاية هذه بالتزامن مع الطلبات التالية التي تعدِّل العنصر نفسه:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
لا يمكن إنشاء عناصر YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.
طلب HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلن الذي ينتمي إليه هذا العنصر. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
الحقول | |
---|---|
lineItemIds[] |
مطلوبة. معرّفات العناصر المطلوب تحديثها. |
targetLineItem |
مطلوبة. عنصر عنصر يحتوي على الحقول المطلوب تعديلها والقيم الجديدة المطلوب تخصيصها لجميع العناصر المحدّدة في |
updateMask |
مطلوبة. قناع حقل يحدِّد الحقول التي يجب تعديلها. لا تتوفّر سوى الحقول التالية حاليًا: هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
نص الاستجابة
رسالة استجابة لـ LineItemService.BulkUpdateLineItems.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
الحقول | |
---|---|
updatedLineItemIds[] |
تم تعديل أرقام تعريف العناصر بنجاح. |
failedLineItemIds[] |
أرقام تعريف العناصر التي تعذّر تعديلها. |
skippedLineItemIds[] |
أرقام تعريف العناصر التي يتم تخطّيها للحصول على التعديلات. على سبيل المثال، سيتم تخطّي عمليات التغيير غير الضرورية التي ستؤدي إلى عدم إجراء أيّ تغييرات على العناصر بفعالية، ويمكن تتبُّع معرّفات العناصر المقابلة هنا. |
errors[] |
الأخطاء التي عرضتها البنود التي تعذَّر تعديلها. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.