Method: advertisers.lineItems.bulkUpdate

چندین ردیف را به‌روز می‌کند.

درخواست‌ها به این نقطه پایانی نمی‌تواند هم‌زمان با درخواست‌های زیر که همان مورد خطی را به‌روزرسانی می‌کند انجام شود:

ردیف‌های YouTube و شرکا را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.

درخواست HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/lineItems:bulkUpdate

نشانی وب از نحو تراتبدیل 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 مراجعه کنید.