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 kein Wert oder 0 angegeben ist, werden maximal 10.000 Anzeigenblöcke zurückgegeben. Der Höchstwert ist 20.000. werden Werte über 20.000 in 20.000 umgewandelt.

pageToken

string

Der von der letzten ListAdUnitsResponse zurückgegebene Wert. gibt an, dass dies eine Fortsetzung eines vorherigen adUnits.list-Aufrufs ist 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

Falls das Feld nicht leer ist, bedeutet dies, 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 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 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 vom Nutzer bereitgestellte Anzeigename des Anzeigenblocks, wie er auf der AdMob-Benutzeroberfläche angezeigt wird. Die maximal zulässige Länge beträgt 80 Zeichen.

adFormat

string

Anzeigenformat des Anzeigenblocks. Folgende Werte sind möglich:

APP_OPEN – App-Start-Anzeigenformat. „BANNER“ - Banneranzeigenformat. „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: RICH_MEDIA und "VIDEO". „NATIVE“ – Natives Anzeigenformat. „BELOHNT“ – Eine Anzeige, die nach dem Ansehen einen Callback zur Bestätigung des Aufrufs erhält, damit der Nutzer eine Prämie erhält. Unterstützte Anzeigentypen: RICH_MEDIA (interaktiv) und Videos, bei denen Videos nicht ausgeschlossen werden können. „REWARDED_INTERSTITIAL“ – Anzeigenformat „Interstitial-Anzeige mit Prämie“. Unterstützt nur Videoanzeigentypen. 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 Nicht-Video-Medien. "VIDEO" - Videomedien