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 से ज़्यादा की वैल्यू को 20,000 तक सीमित कर दिया जाएगा.
pageToken

string

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

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

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

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

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

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

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

object (AdUnit)

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

string

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

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

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

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

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

AdUnit

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

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

string

इस विज्ञापन यूनिट के लिए संसाधन का नाम. फ़ॉर्मैट, accounts/{publisherId}/adUnits/{ad_unit_id_ उदाहरणों} का इस्तेमाल करता है: 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

विज्ञापन यूनिट का विज्ञापन फ़ॉर्मैट. आपको ये वैल्यू दिख सकती हैं:

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

string

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

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