Method: firstPartyAndPartnerAudiences.list

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

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

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

GET https://displayvideo.googleapis.com/v4/firstPartyAndPartnerAudiences

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

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

पैरामीटर
pageSize

integer

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

string

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

string

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

  • FirstPartyAndPartnerAudienceId (डिफ़ॉल्ट)
  • 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 फ़ॉर्मैट में दिखाया गया है 
{
  "firstPartyAndPartnerAudiences": [
    {
      object (FirstPartyAndPartnerAudience)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
firstPartyAndPartnerAudiences[]

object (FirstPartyAndPartnerAudience)

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

अगर यह सूची खाली होगी, तो यह मौजूद नहीं होगी.
nextPageToken

string

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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