Method: advertisers.adGroups.targetingTypes.assignedTargetingOptions.list

इस कॉलम में, किसी विज्ञापन ग्रुप को असाइन किए गए टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के विकल्पों की सूची दी जाती है.

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

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

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups/{adGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

string (int64 format)

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

enum (TargetingType)

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

इन टारगेटिंग टाइप का इस्तेमाल किया जा सकता है:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SESSION_POSITION
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

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

पैरामीटर
pageSize

integer

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

string

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

string

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

  • assignedTargetingOptionId (डिफ़ॉल्ट)

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

string

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

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

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

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

  • assignedTargetingOptionId

उदाहरण:

  • AssignedTargetingOption आईडी 1 या 2 वाले संसाधन: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"

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

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

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

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

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

assignedTargetingOptions.list के लिए जवाब का मैसेज.

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

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

object (AssignedTargetingOption)

असाइन किए गए टारगेटिंग विकल्पों की सूची.

अगर यह सूची खाली होगी, तो यह मौजूद नहीं होगी.
nextPageToken

string

यह एक टोकन है, जो नतीजों के अगले पेज की पहचान करता है. नतीजों का अगला पेज फ़ेच करने के लिए, इस वैल्यू को बाद के ListAdGroupAssignedTargetingOptionsRequest में pageToken के तौर पर बताया जाना चाहिए. अगर लौटाने के लिए कोई और AssignedTargetingOption संसाधन नहीं है, तो यह टोकन मौजूद नहीं होगा.

अनुमति पाने के लिंक

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

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

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