Method: accounts.adUnits.list

Belirtilen AdMob hesabı altındaki reklam birimlerini listeleyin.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Reklam birimlerinin listeleneceği hesabın kaynak adı. Örnek: accounts/pub-9876543210987654

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum reklam birimi sayısı. Belirtilmezse veya 0 ise en fazla 10.000 reklam birimi döndürülür. Maksimum değer 20.000'dir; 20.000'in üzerindeki değerler 20.000'e zorlanır.
pageToken

string

Son ListAdUnitsResponse tarafından döndürülen değer; bunun önceki bir adUnits.list çağrısının devamı olduğunu ve sistemin sonraki veri sayfasını döndürmesi gerektiğini belirtir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Reklam birimleri listesi isteğinin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Alanlar
adUnits[]

object (AdUnit)

İstenen hesap için elde edilen reklam birimleri.
nextPageToken

string

Boş değilse istek için daha fazla reklam birimi olabileceğini belirtir. bu değer yeni bir ListAdUnitsRequest içinde iletilmelidir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

AdUnit

Bir AdMob reklam birimini tanımlar.

JSON gösterimi 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
Alanlar
name

string

Bu reklam biriminin kaynak adı. Biçim: accounts/{publisherId}/adUnits/{ad_unit_id_segment} Örnek: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

AdMob SDK'sı ile entegrasyon için kullanılabilen reklam biriminin harici olarak görünür kimliği. Bu, salt okunur bir özelliktir. Örnek: ca-app-pub-9876543210987654/0123456789
appId

string

Bu reklam biriminin ilişkili olduğu uygulamanın harici olarak görünür kimliği. Örnek: ca-app-pub-9876543210987654~0123456789
displayName

string

AdMob kullanıcı arayüzünde gösterilen ve reklam biriminin kullanıcı tarafından sağlanan görünen adı. İzin verilen maksimum uzunluk 80 karakterdir.
adFormat

string

Reklam biriminin Reklam Biçimi. Olası değerler şunlardır:

"APP_OPEN" - Uygulama açılış reklamı biçimi. "BANNER" - Banner reklam biçimi. "BANNER_INTERSTITIAL" - Banner veya geçiş reklamı olarak kullanılabilen eski biçim. Bu biçim artık oluşturulamaz ancak uyumlulaştırma grupları tarafından hedeflenebilir. "GEÇİCİ" - Tam ekran reklam. Desteklenen reklam türleri şunlardır: "RICH_MEDIA" "VIDEO" ve "VIDEO" öğelerini seçin. "DOĞAL" - Yerel reklam biçimi. "ÖDÜLLÜ" - Bir reklam görüntülendiğinde, kullanıcıya ödül verilebilmesi için görüntülemeyi doğrulayan bir geri arama yapılır. Desteklenen reklam türleri şunlardır: "RICH_MEDIA" (etkileşimli) ve videonun hariç tutulamayacağı video. "REWARDED_INTERSTITIAL" - Ödüllü geçiş reklamı biçimi. Yalnızca video reklam türünü destekler. https://support.google.com/admob/answer/9884467 adresini ziyaret edin.
adTypes[]

string

Bu reklam birimi tarafından desteklenen reklam medya türü. Olası değerler:

"RICH_MEDIA" - Metin, resim ve video olmayan diğer medyalar. "VİDEO" - Video medya içerikleri.