Method: accounts.adUnits.list

Listet die Anzeigenblöcke unter dem angegebenen AdMob-Konto auf.

HTTP-Anfrage

GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der zurückzugebenden Anzeigenblöcke. Wenn nicht angegeben oder auf 0 festgelegt, werden maximal 10.000 Anzeigenblöcke zurückgegeben. Der Höchstwert beträgt 20.000. Werte über 20.000 werden implizit auf 20.000 umgewandelt.
pageToken

string

Der von der 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 Datenseite 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 dieser Wert nicht leer ist, gibt er an, dass für die Anfrage möglicherweise weitere Anzeigenblöcke vorhanden sind. 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 unter OAuth 2.0 Overview.

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. Format: 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 mit dem AdMob SDK verwendet werden kann. Dies ist eine schreibgeschützte Eigenschaft. 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 Anzeigename des Anzeigenblocks, wie er in der AdMob-Benutzeroberfläche angezeigt wird. Er wird vom Nutzer angegeben. Die maximal zulässige Länge beträgt 80 Zeichen.
adFormat

string

Das Anzeigenformat des Anzeigenblocks. Folgende Werte sind möglich:

„APP_OPEN“: App-Start-Anzeigenformat. „BANNER“: Banneranzeigenformat. „BANNER_INTERSTITIAL“: Legacy-Format, das entweder als Banner oder als Interstitial verwendet werden kann. Dieses Format kann nicht mehr erstellt werden, aber es kann von Vermittlungsgruppen verwendet werden. „INTERSTITIAL“: Eine Vollbildanzeige. Unterstützte Anzeigentypen sind „RICH_MEDIA“ und „VIDEO“. „NATIVE“: Natives Anzeigenformat. „REWARDED“: Eine Anzeige, bei der nach dem Ansehen ein Callback erfolgt, um das Ansehen zu bestätigen, damit der Nutzer eine Prämie erhalten kann. Unterstützte Anzeigentypen sind „RICH_MEDIA“ (interaktiv) und Video, wobei Video nicht ausgeschlossen werden kann. „REWARDED_INTERSTITIAL“: Anzeigenformat „Interstitial mit Prämie“. Unterstützt nur Videoanzeigen. Weitere Informationen finden Sie unter https://support.google.com/admob/answer/9884467.
adTypes[]

string

Von diesem Anzeigenblock unterstützter Anzeigenmediatyp. Folgende Werte sind möglich:

„RICH_MEDIA“: Text, Bilder und andere Nicht-Video-Medien. „VIDEO“: Videomedia.