Method: partners.channels.sites.bulkEdit

سایت‌های تحت یک کانال را به‌صورت انبوه ویرایش می‌کند.

این عملیات سایت‌های ارائه‌شده در BulkEditSitesRequest.deleted_sites را حذف می‌کند و سپس سایت‌های ارائه‌شده در BulkEditSitesRequest.created_sites را ایجاد می‌کند.

درخواست HTTP

POST https://displayvideo.googleapis.com/v5/partners/{partnerId}/channels/{channelId}/sites:bulkEdit

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
channelId

string (int64 format)

الزامی. شناسه کانال اصلی که سایت‌ها به آن تعلق دارند.
الزامی. نهاد DV360 را که مالک کانال اصلی است شناسایی می‌کند. این می‌تواند شریک یا تبلیغ‌کننده باشد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
partnerId

string (int64 format)

شناسه شریکی که مالک کانال اصلی است.
پایان فیلدهای متقابلاً انحصاری.

متن درخواست

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

نمایش JSON 
{
  "deletedSites": [
    string
  ],
  "createdSites": [
    {
      object (Site)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "advertiserId": string
  // End of mutually exclusive fields.
}
فیلدها
deletedSites[]

string

سایت‌هایی که باید به‌صورت دسته‌ای حذف شوند، به‌عنوان فهرستی از سایت url_or_app_ids مشخص شده‌اند.
createdSites[]

object (Site)

سایت‌هایی که باید به‌صورت دسته‌ای ایجاد شوند، به‌عنوان فهرستی از Sites مشخص شده‌اند.
الزامی. نهاد DV360 را که مالک کانال اصلی است شناسایی می‌کند. این می‌تواند شریک یا تبلیغ‌کننده باشد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
partnerId

string (int64 format)

شناسه شریکی که مالک کانال اصلی است.
advertiserId

string (int64 format)

شناسه آگهی‌دهنده‌ای که مالک کانال اصلی است.
پایان فیلدهای متقابلاً انحصاری.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی نمونه‌ای از BulkEditSitesResponse است.

دامنه‌های مجوز

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

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

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