Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

एक साथ कई विज्ञापन ग्रुप के लिए, टारगेटिंग के विकल्पों में एक साथ बदलाव करना.

मिटाने और बनाने के अनुरोधों का एक ही सेट, चुने गए सभी विज्ञापन ग्रुप पर लागू होगा. खास तौर पर, यह कार्रवाई हर विज्ञापन ग्रुप से, BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests में दिए गए असाइन किए गए टारगेटिंग विकल्पों को मिटा देगी. इसके बाद, BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests में दिए गए असाइन किए गए टारगेटिंग विकल्पों को बनाएगी.

यह तरीका सिर्फ़ मांग बढ़ाने में मदद करने वाले विज्ञापन ग्रुप के लिए काम करता है.

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

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)

ज़रूरी है. उन विज्ञापन ग्रुप के आईडी जिनसे असाइन किए गए टारगेटिंग विकल्प जुड़े होंगे. ज़्यादा से ज़्यादा 25 विज्ञापन ग्रुप आईडी तय किए जा सकते हैं.

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 देखें.