Method: accounts.adUnits.list

Belirtilen AdMob hesabı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 ListAdUnitsResponse çağrısının devamı olduğunu ve sistemin verilerin sonraki sayfasını döndürmesi gerektiğini belirtir.adUnits.list

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

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 gösterir. 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 sayfasına bakın.

AdUnit

Bir AdMob reklam birimini açıklar.

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_fragment} Örnek: accounts/pub-9876543210987654/adUnits/0123456789

adUnitId

string

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

appId

string

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

displayName

string

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

adFormat

string

Reklam biriminin AdFormat'ı. 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 arabuluculuk grupları tarafından hedeflenebilir. "INTERSTITIAL": Tam ekran reklam. Desteklenen reklam türleri "RICH_MEDIA" ve "VIDEO"dur. "NATIVE": Doğal reklam biçimi. "REWARDED": Görüntülendiğinde, görüntülemeyi doğrulayan bir geri çağırma işlemi gerçekleştirilerek kullanıcıya ödül verilmesini sağlayan reklam. Desteklenen reklam türleri "RICH_MEDIA" (etkileşimli) ve videonun hariç tutulamadığı video reklamdır. "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 medya türleri. "VIDEO": Video medyası.