Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

این عملیات کلیدواژه‌های منفی ارائه‌شده در BulkEditNegativeKeywordsRequest.deleted_negative_keywords را حذف می‌کند و سپس کلیدواژه‌های منفی ارائه‌شده در BulkEditNegativeKeywordsRequest.created_negative_keywords را ایجاد می‌کند.

تضمین می‌شود که این عملیات اتمی باشد و هرگز به موفقیت جزئی یا شکست جزئی منجر نخواهد شد.

درخواست HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit

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

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

پارامترها
advertiserId

string (int64 format)

الزامی. شناسه آگهی‌دهنده DV360 که فهرست کلیدواژه‌های منفی اصلی به آن تعلق دارد.

negativeKeywordListId

string (int64 format)

الزامی. شناسه فهرست کلیدواژه‌های منفی اصلی که کلیدواژه‌های منفی به آن تعلق دارند.

متن درخواست

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

نمایش JSON
{
  "deletedNegativeKeywords": [
    string
  ],
  "createdNegativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
فیلدها
deletedNegativeKeywords[]

string

کلیدواژه‌های منفی برای حذف دسته‌ای، که به‌صورت فهرستی از keyword_values مشخص شده‌اند.

createdNegativeKeywords[]

object (NegativeKeyword)

کلیدواژه‌های منفی برای ایجاد دسته‌ای، که به‌صورت فهرستی از NegativeKeywords مشخص شده‌اند.

بدنه پاسخ

Response message for NegativeKeywordService.BulkEditNegativeKeywords.

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

نمایش JSON
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
فیلدها
negativeKeywords[]

object (NegativeKeyword)

فهرست کلیدواژه‌های منفی که با موفقیت ایجاد شده‌اند.

اگر این فهرست خالی باشد، نمایش داده نخواهد شد.

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

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

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

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