- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AdUnit
- Örnekler
- Deneyin.
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 |
Zorunlu. Reklam birimlerinin listeleneceği hesabın kaynak adı. Örnek: accounts/pub-9876543210987654 |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
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 |
Son |
İ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 ( |
Alanlar | |
---|---|
adUnits[] |
İstenen hesap için elde edilen reklam birimleri. |
nextPageToken |
Boş değilse, istek için daha fazla reklam birimi olabileceğini belirtir. Bu değer, yeni bir |
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 |
Bu reklam biriminin kaynak adı. Biçim: accounts/{publisherId}/adUnits/{ad_unit_id_segment} Örnek: accounts/pub-9876543210987654/adUnits/0123456789 |
adUnitId |
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 |
Bu reklam biriminin ilişkili olduğu uygulamanın harici olarak görülebilen kimliği. Örnek: ca-app-pub-9876543210987654~0123456789 |
displayName |
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 |
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[] |
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ı. |