Method: firstAndThirdPartyAudiences.list

पहले और तीसरे पक्ष की ऑडियंस की सूची बनाता है.

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

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

GET https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences

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

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

पैरामीटर
pageSize

integer

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

string

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

string

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

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

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

string

पहले और तीसरे पक्ष के ऑडियंस फ़ील्ड के हिसाब से फ़िल्टर करने की अनुमति देता है.

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

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

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

  • displayName

उदाहरण:

  • पहले और तीसरे पक्ष की वे सभी ऑडियंस जिनके लिए डिसप्ले नेम में "Google" शामिल है: displayName:"Google".

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

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

string (int64 format)

उस पार्टनर का आईडी जिसके पास, फ़ेच की गई पहले और तीसरे पक्ष की ऑडियंस का ऐक्सेस है.
advertiserId

string (int64 format)

विज्ञापन देने वाले उस व्यक्ति का आईडी जिसके पास, फ़ेच की गई पहले और तीसरे पक्ष की ऑडियंस का ऐक्सेस है.

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "firstAndThirdPartyAudiences": [
    {
      object (FirstAndThirdPartyAudience)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
firstAndThirdPartyAudiences[]

object (FirstAndThirdPartyAudience)

पहले और तीसरे पक्ष की ऑडियंस की सूची. ऑडियंस साइज़ की प्रॉपर्टी शामिल नहीं की जाएंगी.

खाली होने पर, यह सूची नहीं दिखेगी.
nextPageToken

string

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

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

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

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

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