Method: combinedAudiences.list

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

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

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

GET https://displayvideo.googleapis.com/v4/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 करने के अनुरोध से जुड़ी हमारी गाइड देखें.
ज़रूरी है. इससे यह पता चलता है कि अनुरोध, DV360 की किस इकाई के लिए किया जा रहा है. LIST अनुरोध सिर्फ़ उन मिली-जुली ऑडियंस इकाइयों को दिखाएगा जिन्हें accessor में पहचाने गए DV360 खाते से ऐक्सेस किया जा सकता है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 Overview देखें.