Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

گزینه‌های هدف‌گیری ویرایش‌های انبوه برای چندین گروه تبلیغاتی.

همان مجموعه درخواست‌های حذف و ایجاد برای همه گروه‌های تبلیغاتی مشخص شده اعمال خواهد شد. به طور خاص، این عملیات گزینه‌های هدف‌گیری اختصاص داده شده ارائه شده در BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests را از هر گروه تبلیغاتی حذف می‌کند و سپس گزینه‌های هدف‌گیری اختصاص داده شده ارائه شده در BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests را ایجاد می‌کند.

این روش فقط برای گروه‌های تبلیغاتی Demand Gen پشتیبانی می‌شود.

درخواست HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
advertiserId

string ( int64 format)

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
فیلدها
adGroupIds[]

string ( int64 format)

الزامی. شناسه گروه‌های تبلیغاتی که گزینه‌های هدف‌گیری اختصاص داده شده به آنها تعلق خواهد داشت. حداکثر ۲۵ شناسه گروه تبلیغاتی را می‌توان مشخص کرد.

deleteRequests[]

object ( DeleteAssignedTargetingOptionsRequest )

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

انواع هدف‌گیری پشتیبانی‌شده:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object ( CreateAssignedTargetingOptionsRequest )

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

انواع هدف‌گیری پشتیبانی‌شده:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

بدنه پاسخ

پیام پاسخ برای adGroups.bulkEditAssignedTargetingOptions .

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

نمایش JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
فیلدها
updatedAdGroupIds[]

string ( int64 format)

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

failedAdGroupIds[]

string ( int64 format)

فقط خروجی. شناسه‌های گروه‌های تبلیغاتی که به‌روزرسانی نشدند.

errors[]

object ( Status )

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

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

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .