Method: accounts.adUnits.list

इस अनुरोध में दिए गए AdMob खाते से जुड़ी विज्ञापन यूनिट की सूची दिखाता है.

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

GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. उस खाते का संसाधन नाम जिसके लिए विज्ञापन यूनिट की सूची बनानी है. उदाहरण: accounts/pub-9876543210987654

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

पैरामीटर
pageSize

integer

विज्ञापन यूनिट की ज़्यादा से ज़्यादा संख्या. अगर इसे तय नहीं किया गया है या इसकी वैल्यू 0 है, तो ज़्यादा से ज़्यादा 10,000 विज्ञापन यूनिट दिखाई जाएंगी. इसकी ज़्यादा से ज़्यादा वैल्यू 20,000 हो सकती है. इससे ज़्यादा वैल्यू को 20,000 पर सेट कर दिया जाएगा.
pageToken

string

यह वैल्यू, आखिरी ListAdUnitsResponse से मिलती है. इससे पता चलता है कि यह adUnits.list कॉल, पिछले adUnits.list कॉल का ही हिस्सा है. साथ ही, सिस्टम को डेटा का अगला पेज दिखाना चाहिए.

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

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

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

विज्ञापन यूनिट की सूची के अनुरोध के लिए जवाब.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
adUnits[]

object (AdUnit)

अनुरोध किए गए खाते के लिए, नतीजे के तौर पर मिली विज्ञापन यूनिट.
nextPageToken

string

अगर यह खाली नहीं है, तो इसका मतलब है कि अनुरोध के लिए और भी विज्ञापन यूनिट हो सकती हैं. इस वैल्यू को नए ListAdUnitsRequest में पास किया जाना चाहिए.

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

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

  • https://www.googleapis.com/auth/admob.readonly

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

AdUnit

AdMob विज्ञापन यूनिट के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
फ़ील्ड
name

string

इस विज्ञापन यूनिट के लिए संसाधन का नाम. फ़ॉर्मैट: accounts/{publisherId}/adUnits/{ad_unit_id_fragment} उदाहरण: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

विज्ञापन यूनिट का ऐसा आईडी जो बाहरी तौर पर दिखता है. इसका इस्तेमाल, AdMob SDK के साथ इंटिग्रेट करने के लिए किया जा सकता है. यह सिर्फ़ पढ़ने के लिए उपलब्ध प्रॉपर्टी है. उदाहरण: ca-app-pub-9876543210987654/0123456789
appId

string

यह उस ऐप्लिकेशन का आईडी होता है जिससे यह विज्ञापन यूनिट जुड़ी है. यह आईडी, बाहरी तौर पर दिखता है. उदाहरण: ca-app-pub-9876543210987654~0123456789
displayName

string

विज्ञापन यूनिट का डिसप्ले नेम, जैसा कि AdMob के यूज़र इंटरफ़ेस (यूआई) में दिखता है. इसे उपयोगकर्ता ने दिया है. ज़्यादा से ज़्यादा 80 वर्ण इस्तेमाल किए जा सकते हैं.
adFormat

string

विज्ञापन यूनिट का AdFormat. इन वैल्यू का इस्तेमाल किया जा सकता है:

"APP_OPEN" - ऐप्लिकेशन ओपन विज्ञापन फ़ॉर्मैट. "BANNER" - बैनर विज्ञापन फ़ॉर्मैट. "BANNER_INTERSTITIAL" - यह लेगसी फ़ॉर्मैट है. इसका इस्तेमाल बैनर या इंटरस्टीशियल के तौर पर किया जा सकता है. अब इस फ़ॉर्मैट को नहीं बनाया जा सकता. हालांकि, इसे मीडिएशन ग्रुप के ज़रिए टारगेट किया जा सकता है. "INTERSTITIAL" - यह फ़ुल स्क्रीन विज्ञापन होता है. इस्तेमाल किए जा सकने वाले विज्ञापन टाइप "RICH_MEDIA" और "VIDEO" हैं. "NATIVE" - नेटिव विज्ञापन फ़ॉर्मैट. "REWARDED" - ऐसा विज्ञापन जिसे देखने के बाद, कॉलबैक फ़ंक्शन यह पक्का करता है कि उपयोगकर्ता ने विज्ञापन देख लिया है. इससे उपयोगकर्ता को इनाम दिया जा सकता है. विज्ञापन के इन टाइप के साथ काम करता है: "RICH_MEDIA" (इंटरैक्टिव) और वीडियो. वीडियो को हटाया नहीं जा सकता. "REWARDED_INTERSTITIAL" - इनाम वाला इंटरस्टीशियल विज्ञापन फ़ॉर्मैट. सिर्फ़ वीडियो विज्ञापन टाइप के साथ काम करता है. https://support.google.com/admob/answer/9884467 पर जाएं.
adTypes[]

string

इस विज्ञापन यूनिट के साथ काम करने वाला विज्ञापन मीडिया टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है:

"RICH_MEDIA" - टेक्स्ट, इमेज, और वीडियो के अलावा अन्य मीडिया. "VIDEO" - वीडियो मीडिया.