- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह उन विज्ञापन देने वालों की सूची बनाता है जो मौजूदा उपयोगकर्ता के लिए उपलब्ध हैं.
यह क्रम, orderBy
पैरामीटर से तय होता है.
एक partnerId
होना ज़रूरी है. क्रॉस-पार्टनर लिस्टिंग की सुविधा उपलब्ध नहीं है.
एचटीटीपी अनुरोध
GET https://displayvideo.googleapis.com/v2/advertisers
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
partnerId |
ज़रूरी है. उस पार्टनर का आईडी जिससे विज्ञापन देने वाले व्यक्ति या कंपनी को फ़ेच किया गया है. सिस्टम एक बार में सिर्फ़ एक पार्टनर के लिए विज्ञापन देने वालों की लिस्टिंग को दिखाता है. |
pageSize |
अनुरोध किए गए पेज का साइज़. यह |
pageToken |
एक टोकन, जो सर्वर को दिखाए जाने वाले नतीजों के पेज की पहचान करता है. आम तौर पर, यह |
orderBy |
वह फ़ील्ड जिसके हिसाब से सूची को क्रम से लगाना है. स्वीकार की जाने वाली वैल्यू ये हैं:
क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. किसी फ़ील्ड के घटते क्रम में तय करने के लिए फ़ील्ड के नाम में "ब्यौरा" सफ़िक्स जोड़ना चाहिए. उदाहरण के लिए, |
filter |
विज्ञापन देने वाले के फ़ील्ड के हिसाब से फ़िल्टर करने की सुविधा मिलती है. इस्तेमाल किया जा सकने वाला सिंटैक्स:
इस्तेमाल किए जा सकने वाले फ़ील्ड:
उदाहरण:
इस फ़ील्ड में 500 से ज़्यादा वर्ण नहीं होने चाहिए. ज़्यादा जानकारी के लिए, फ़िल्टर |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"advertisers": [
{
object ( |
फ़ील्ड | |
---|---|
advertisers[] |
विज्ञापन देने वालों की सूची. अगर कोई सूची खाली होगी, तो यह नहीं दिखेगी. |
nextPageToken |
नतीजों का अगला पेज फिर से पाने के लिए टोकन. नतीजों का अगला पेज वापस पाने के लिए, |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/display-video
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.