- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- AdUnit
- Beispiele
- Testen!
Hiermit werden die Anzeigenblöcke im angegebenen AdMob-Konto aufgelistet.
HTTP-Anfrage
GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Ressourcenname des Kontos, für das Anzeigenblöcke aufgelistet werden sollen Beispiel: accounts/pub-9876543210987654 |
Abfrageparameter
Parameter | |
---|---|
pageSize |
Die maximale Anzahl von Anzeigenblöcken, die zurückgegeben werden sollen. Wenn nicht angegeben oder 0, werden maximal 10.000 Anzeigenblöcke zurückgegeben. Der Maximalwert beträgt 20.000. Für Werte über 20.000 wird eine Umwandlung von 20.000 vorgenommen. |
pageToken |
Der vom letzten |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort auf die Anfrage zur Liste der Anzeigenblöcke.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"adUnits": [
{
object ( |
Felder | |
---|---|
adUnits[] |
Die resultierenden Anzeigenblöcke für das angeforderte Konto. |
nextPageToken |
Wenn nicht leer, bedeutet das, dass es möglicherweise weitere Anzeigenblöcke für die Anfrage gibt. Dieser Wert sollte in einem neuen |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admob.readonly
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
AdUnit
Beschreibt einen AdMob-Anzeigenblock.
JSON-Darstellung |
---|
{ "name": string, "adUnitId": string, "appId": string, "displayName": string, "adFormat": string, "adTypes": [ string ] } |
Felder | |
---|---|
name |
Ressourcenname für diesen Anzeigenblock. Das Format ist accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Beispiel: accounts/pub-9876543210987654/adUnits/0123456789 |
adUnitId |
Die extern sichtbare ID des Anzeigenblocks, die für die Integration in das AdMob SDK verwendet werden kann. Dies ist ein schreibgeschütztes Attribut. Beispiel: ca-app-pub-9876543210987654/0123456789 |
appId |
Die extern sichtbare ID der App, mit der dieser Anzeigenblock verknüpft ist. Beispiel: ca-app-pub-9876543210987654~0123456789 |
displayName |
Der in der AdMob-Benutzeroberfläche angezeigte Anzeigename des Anzeigenblocks, der vom Nutzer bereitgestellt wird. Es sind maximal 80 Zeichen zulässig. |
adFormat |
Anzeigenformat des Anzeigenblocks. Folgende Werte sind möglich: "APP_OPEN" – App-Start-Anzeigenformat. "BANNER" – Banner-Anzeigenformat "BANNER_INTERSTITIAL" – altes Format, das als Banner oder Interstitial verwendet werden kann Dieses Format kann nicht mehr erstellt werden, aber Vermittlungsgruppen können darauf ausgerichtet werden. "INTERSTITIAL": Eine Vollbildanzeige. Unterstützte Anzeigentypen sind „RICH_MEDIA“ und „VIDEO“. "NATIVE" – natives Anzeigenformat "PRÄMIE": Eine Anzeige, die angesehen wird, erhält einen Callback zur Bestätigung des Aufrufs, sodass der Nutzer eine Prämie erhält. Unterstützte Anzeigentypen sind RICH_MEDIA (interaktiv) und Videoanzeigen, bei denen Videos nicht ausgeschlossen werden können. "REWARDED_INTERSTITIAL" – Interstitial-Anzeigen mit Prämie Unterstützt nur Videoanzeigen. Weitere Informationen finden Sie unter https://support.google.com/admob/answer/9884467. |
adTypes[] |
Der von diesem Anzeigenblock unterstützte Anzeigenmedientyp. Mögliche Werte: "RICH_MEDIA" – Text-, Bild- und andere Medien ohne Video "VIDEO" – Videomedien |