Method: advertisers.insertionOrders.listAssignedTargetingOptions

टारगेटिंग के अलग-अलग टाइप में, इंसर्शन ऑर्डर के असाइन किए गए टारगेटिंग विकल्पों की सूची बनाता है.

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

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:listAssignedTargetingOptions

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

insertionOrderId

string (int64 format)

ज़रूरी है. इंसर्शन ऑर्डर का आईडी, जिसके लिए टारगेटिंग के विकल्पों को असाइन किया गया है.

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

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

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

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

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

  • targetingType
  • inheritance

उदाहरण:

  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST या TARGETING_TYPE_CHANNEL टारगेटिंग टाइप के AssignedTargetingOption संसाधन: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • AssignedTargetingOption संसाधन, जिनकी इनहेरिटेंस स्थिति NOT_INHERITED या INHERITED_FROM_PARTNER है: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

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

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

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

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

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

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

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

object (AssignedTargetingOption)

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

अगर यह सूची खाली होगी, तो यह नहीं होगी.

nextPageToken

string

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

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

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

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

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