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

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

string

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

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

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

इन फ़ील्ड के लिए यह सुविधा उपलब्ध है:

  • targetingType

उदाहरण:

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

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

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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 Overview देखें.

AdGroupAssignedTargetingOption

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

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

string (int64 format)

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

object (AssignedTargetingOption)

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