Method: advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions

यह डायलॉग बॉक्स कई तरह के टारगेटिंग टाइप में, कई विज्ञापन ग्रुप के लिए असाइन किए गए टारगेटिंग विकल्प की सूची बनाता है.

इनहेरिट किए गए असाइन किए गए टारगेटिंग विकल्प शामिल नहीं हैं.

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

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups:bulkListAdGroupAssignedTargetingOptions

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. लाइन आइटम, विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी.

क्वेरी पैरामीटर

पैरामीटर
adGroupIds[]

string (int64 format)

ज़रूरी है. उन विज्ञापन ग्रुप का आईडी जिनके लिए, टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के विकल्प असाइन करने हैं.

pageSize

integer

ज़रूरी नहीं. पेज का वह साइज़ जिसके लिए अनुरोध किया गया है. साइज़, 1 और 5000 के बीच का कोई पूर्णांक होना चाहिए. अगर कोई भी वैल्यू सेट नहीं की गई है, तो डिफ़ॉल्ट वैल्यू 5000 होती है. अमान्य वैल्यू दिए जाने पर गड़बड़ी कोड INVALID_ARGUMENT दिखाता है.

pageToken

string

ज़रूरी नहीं. एक टोकन, जिसकी मदद से क्लाइंट नतीजों का अगला पेज फ़ेच कर सकता है. आम तौर पर, यह nextPageToken की वैल्यू होती है, जो पिछली कॉल से adGroups.bulkListAdGroupAssignedTargetingOptions तरीके को मिलती है. अगर इसके बारे में तय नहीं किया गया है, तो नतीजों का पहला पेज दिखाया जाएगा.

orderBy

string

ज़रूरी नहीं. वह फ़ील्ड जिसके आधार पर सूची को क्रम से लगाया जाना है. ये वैल्यू स्वीकार की जा सकती हैं:

  • adGroupId (डिफ़ॉल्ट)
  • assignedTargetingOption.targetingType

क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. किसी फ़ील्ड के घटते क्रम में तय करने के लिए, फ़ील्ड के नाम में "ब्यौरा" सफ़िक्स जोड़ना चाहिए. उदाहरण: targetingType desc.

filter

string

ज़रूरी नहीं. असाइन किए गए टारगेटिंग विकल्प फ़ील्ड के आधार पर फ़िल्टर करने की अनुमति देता है.

इस्तेमाल किया जा सकने वाला सिंटैक्स:

  • फ़िल्टर एक्सप्रेशन में एक या ज़्यादा पाबंदियां होती हैं.
  • लॉजिकल ऑपरेटर OR की मदद से, पाबंदियों को जोड़ा जा सकता है.
  • पाबंदी {field} {operator} {value} के रूप में होती है.
  • सभी फ़ील्ड में EQUALS (=) ऑपरेटर का इस्तेमाल करना ज़रूरी है.

इस्तेमाल किए जा सकने वाले फ़ील्ड:

  • targetingType

उदाहरण:

  • TARGETING_TYPE_YOUTUBE_VIDEO या TARGETING_TYPE_YOUTUBE_CHANNEL टारगेटिंग टाइप के AssignedTargetingOption संसाधन: targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL"

इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए.

ज़्यादा जानकारी के लिए, हमारी फ़िल्टर LIST अनुरोध गाइड देखें.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "adGroupAssignedTargetingOptions": [
    {
      object (AdGroupAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
adGroupAssignedTargetingOptions[]

object (AdGroupAssignedTargetingOption)

रैपर ऑब्जेक्ट की सूची, जिसमें हर एक टारगेटिंग विकल्प और उसे असाइन किया गया विज्ञापन समूह मुहैया कराता है.

खाली होने पर, यह सूची नहीं दिखेगी.

nextPageToken

string

एक टोकन, जो नतीजों के अगले पेज की पहचान करता है. नतीजों का अगला पेज फ़ेच करने के लिए, adGroups.bulkListAdGroupAssignedTargetingOptions को किए जाने वाले बाद के कॉल में, इस वैल्यू को pageToken के तौर पर दिखाया जाना चाहिए. अगर दिखाने के लिए AdGroupAssignedTargetingOption रिसॉर्स नहीं हैं, तो यह टोकन मौजूद नहीं रहेगा.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

AdGroupAssignedTargetingOption

रैपर ऑब्जेक्ट, जो AssignedTargetingOption संसाधन और उसे असाइन किए गए विज्ञापन ग्रुप से जोड़ता है.

जेएसओएन के काेड में दिखाना
{
  "adGroupId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
फ़ील्ड
adGroupId

string (int64 format)

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

assignedTargetingOption

object (AssignedTargetingOption)

असाइन किया गया टारगेटिंग विकल्प संसाधन.