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ı. Belirtilmemişse 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 listeleme 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 ile 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'a Genel Bakış başlıklı makaleye bakı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

Reklam biriminin AdMob SDK'sı ile entegrasyon için kullanılabilecek harici olarak görülebilen 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ülebilen kimliği. Örnek: ca-app-pub-9876543210987654~0123456789
displayName

string

Reklam biriminin AdMob kullanıcı arayüzünde gösterilen ve 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. "INTERSTITIAL" - Tam ekran reklam. Desteklenen reklam türleri: "RICH_MEDIA" ve "VIDEO". "NATIVE" - Yerel reklam biçimi. "ÖDÜLLÜ": Görüntülendikten sonra, kullanıcıya ödül verilmesi için görüntülemeyi doğrulayan bir geri arama alan reklamdır. Desteklenen reklam türleri, videonun hariç tutulamadığı "RICH_MEDIA" (etkileşimli) ve videodur. "REWARDED_INTERSTITIAL" - Ödüllü geçiş reklamı biçimi. Yalnızca video reklam türünü destekler. https://support.google.com/admob/answer/9884467 adresine göz atın.
adTypes[]

string

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

"RICH_MEDIA": Metin, resim ve video olmayan diğer medyalar. "VIDEO" - Video medyası.