Method: accounts.adUnits.list

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

string

Erforderlich. Ressourcenname des Kontos, für das Anzeigenblöcke aufgelistet werden sollen Beispiel: accounts/pub-9876543210987654

Abfrageparameter

Parameter
pageSize

integer

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

string

Der vom letzten ListAdUnitsResponse zurückgegebene Wert. Gibt an, dass es sich um eine Fortsetzung eines vorherigen adUnits.list-Aufrufs handelt und dass das System die nächste Seite mit Daten zurückgeben soll.

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 (AdUnit)
    }
  ],
  "nextPageToken": string
}
Felder
adUnits[]

object (AdUnit)

Die resultierenden Anzeigenblöcke für das angeforderte Konto.
nextPageToken

string

Wenn nicht leer, bedeutet das, dass es möglicherweise weitere Anzeigenblöcke für die Anfrage gibt. Dieser Wert sollte in einem neuen ListAdUnitsRequest übergeben werden.

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

string

Ressourcenname für diesen Anzeigenblock. Das Format ist accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Beispiel: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

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

string

Die extern sichtbare ID der App, mit der dieser Anzeigenblock verknüpft ist. Beispiel: ca-app-pub-9876543210987654~0123456789
displayName

string

Der in der AdMob-Benutzeroberfläche angezeigte Anzeigename des Anzeigenblocks, der vom Nutzer bereitgestellt wird. Es sind maximal 80 Zeichen zulässig.
adFormat

string

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[]

string

Der von diesem Anzeigenblock unterstützte Anzeigenmedientyp. Mögliche Werte:

"RICH_MEDIA" – Text-, Bild- und andere Medien ohne Video "VIDEO" – Videomedien