Method: combinedAudiences.list

यह मिली-जुली ऑडियंस की सूची बनाता है.

क्रम, orderBy पैरामीटर से तय होता है.

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

GET https://displayvideo.googleapis.com/v2/combinedAudiences

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

orderBy

string

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

  • combinedAudienceId (डिफ़ॉल्ट)
  • displayName

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

filter

string

इससे, अलग-अलग सूचियों से मिले-जुले दर्शकों के फ़ील्ड के हिसाब से फ़िल्टर करने की सुविधा मिलती है.

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

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

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

  • displayName

उदाहरण:

  • ऐसी सभी ऑडियंस जिनके डिसप्ले नेम में "Google" शामिल है: displayName : "Google".

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

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

यूनियन पैरामीटर accessor. ज़रूरी है. इससे पता चलता है कि किस DV360 इकाई के लिए अनुरोध किया जा रहा है. LIST अनुरोध सिर्फ़ उन संयुक्त दर्शक इकाइयों को दिखाएगा, जो accessor में पहचानी गई DV360 इकाई के लिए ऐक्सेस की जा सकती हैं. accessor इनमें से सिर्फ़ एक हो सकता है:
partnerId

string (int64 format)

उस पार्टनर का आईडी जिसके पास मिली-जुली ऑडियंस का ऐक्सेस है.

advertiserId

string (int64 format)

विज्ञापन देने वाले उस व्यक्ति का आईडी जिसके पास मिली-जुली ऑडियंस का ऐक्सेस है.

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

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

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

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

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

object (CombinedAudience)

मिली-जुली ऑडियंस की सूची.

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

nextPageToken

string

नतीजों का अगला पेज वापस पाने के लिए टोकन. नतीजों का अगला पेज वापस पाने के लिए, अगली कॉल combinedAudiences.list तरीके में इस वैल्यू को pageToken फ़ील्ड में पास करें.

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

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

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

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