Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

एक से ज़्यादा लाइन आइटम में मौजूद टारगेटिंग के विकल्पों में, एक साथ कई बदलाव करने की सुविधा. यह कार्रवाई BulkEditAssignedTargetingOptionsRequest.delete_requests में दिए गए, असाइन किए गए टारगेटिंग विकल्प मिटा देगी और फिर BulkEditAssignedTargetingOptionsRequest.create_requests में दिए गए असाइन किए गए टारगेटिंग विकल्प बना देगी.

एक ही लाइन आइटम को अपडेट करने वाले नीचे दिए गए अनुरोधों के साथ इस एंडपॉइंट के लिए अनुरोध नहीं किए जा सकते:

YouTube और एपीआई का इस्तेमाल करके पार्टनर लाइन आइटम बनाए या अपडेट नहीं किए जा सकते.

एचटीटीपी अनुरोध

POST https://displayvideo.googleapis.com/v3/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_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
  • 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_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
  • 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 की खास जानकारी देखें.