Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

ویرایش‌های انبوه گزینه‌های هدف‌یابی برای چندین گروه آگهی.

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

این روش فقط برای گروه‌های آگهی «تولید تقاضا» پشتیبانی می‌شود.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل 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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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 مراجعه کنید.