Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

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

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

ردیف‌های YouTube و شرکا را نمی‌توان بااستفاده از API ایجاد یا به‌روزرسانی کرد.

درخواست HTTP

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

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

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

پارامترها
advertiserId

string (int64 format)

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

متن درخواست

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

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

string (int64 format)

الزامی. شناسه ردیف‌هایی که هدف‌یابی آن‌ها درحال به‌روزرسانی است.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

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

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

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUCTION_PACKAGE
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_AUDIO_CONTENT_TYPE
  • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_CARRIER_AND_ISP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_CONTENT_DURATION
  • TARGETING_TYPE_CONTENT_GENRE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_STREAM_TYPE
  • TARGETING_TYPE_DAY_AND_TIME
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_INVENTORY_SOURCE_DEAL
  • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_ON_SCREEN_POSITION
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_SUB_EXCHANGE
  • TARGETING_TYPE_THIRD_PARTY_VERIFIER
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_USER_REWARDED_CONTENT
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

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

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

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUCTION_PACKAGE
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_AUDIO_CONTENT_TYPE
  • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_CARRIER_AND_ISP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_CONTENT_DURATION
  • TARGETING_TYPE_CONTENT_GENRE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_STREAM_TYPE
  • TARGETING_TYPE_DAY_AND_TIME
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_INVENTORY_SOURCE_DEAL
  • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_ON_SCREEN_POSITION
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_SUB_EXCHANGE
  • TARGETING_TYPE_THIRD_PARTY_VERIFIER
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_USER_REWARDED_CONTENT
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

بدنه پاسخ

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

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

string (int64 format)

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

string (int64 format)

فقط خروجی. شناسه‌های موارد سطری که ناموفق بوده‌اند.
errors[]

object (Status)

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

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

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

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

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