Method: advertisers.lineItems.bulkUpdate

چندین مورد خط را به روز می کند.

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

موارد خط YouTube & Partners را نمی توان با استفاده از API ایجاد یا به روز کرد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
advertiser Id

string ( int64 format)

مورد نیاز. شناسه تبلیغ‌کننده‌ای که این مورد خطی به آن تعلق دارد.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
فیلدها
line Item Ids[]

string ( int64 format)

مورد نیاز. شناسه موارد خط برای به‌روزرسانی.

target Line Item

object ( LineItem )

مورد نیاز. یک شی مورد خط حاوی فیلدهایی که باید به روز شوند و مقادیر جدید برای تخصیص به همه موارد خط مشخص شده در lineItemIds ."

update Mask

string ( FieldMask format)

مورد نیاز. یک ماسک فیلد که تشخیص می دهد کدام فیلدها را به روز می کند.

در حال حاضر فقط فیلدهای زیر پشتیبانی می شوند:

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

بدن پاسخگو

پیام پاسخ برای LineItemService.BulkUpdateLineItems.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
فیلدها
updated Line Item Ids[]

string ( int64 format)

شناسه‌های موارد خطی که با موفقیت به‌روزرسانی شدند.

failed Line Item Ids[]

string ( int64 format)

شناسه موارد خطی که به‌روزرسانی نشدند.

skipped Line Item Ids[]

string ( int64 format)

شناسه‌های موارد خطی که برای به‌روزرسانی نادیده گرفته می‌شوند. برای مثال، جهش‌های غیرضروری که منجر به هیچ تغییری در موارد خطی نمی‌شوند، نادیده گرفته می‌شوند و شناسه‌های مورد خط مربوطه را می‌توان در اینجا ردیابی کرد.

errors[]

object ( Status )

خطاهایی که توسط موارد خطی که به‌روزرسانی نشدند، برگردانده شدند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/display-video

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.