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

उदाहरण:

  • AssignedTargetingOption टारगेटिंग टाइप TARGETING_TYPE_PROXIMITY_LOCATION_LIST या TARGETING_TYPE_CHANNEL के संसाधन: 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 Overview देखें.