Method: accounts.apps.list

Hiermit werden die Apps für das angegebene AdMob-Konto aufgelistet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl von Apps, die zurückgegeben werden sollen. Wenn nicht angegeben oder 0, werden maximal 10.000 Apps zurückgegeben. Der Höchstwert ist 20.000. werden Werte über 20.000 in 20.000 umgewandelt.
pageToken

string

Der von der letzten ListAppsResponse zurückgegebene Wert. gibt an, dass dies eine Fortsetzung eines vorherigen apps.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 App-Liste.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Felder
apps[]

object (App)

Die resultierenden Apps für das angeforderte Konto.
nextPageToken

string

Falls nicht leer: Gibt an, dass möglicherweise weitere Apps für die Anfrage vorhanden sind. Dieser Wert sollte in einem neuen ListAppsRequest ü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.

App

Beschreibt eine AdMob-App für eine bestimmte Plattform, z. B. Android oder iOS.

JSON-Darstellung 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Felder
name

string

Ressourcenname für diese Anwendung. Das Format ist accounts/{publisherId}/apps/{app_id_fragment}. Beispiel: accounts/pub-9876543210987654/apps/0123456789
appId

string

Die extern sichtbare ID der App, die für die Integration in das AdMob SDK verwendet werden kann. Dies ist eine schreibgeschützte Eigenschaft. Beispiel: ca-app-pub-9876543210987654~0123456789
platform

string

Beschreibt die Plattform der App. Begrenzt auf „IOS“ und „ANDROID“.
manualAppInfo

object (ManualAppInfo)

Die Informationen zu einer App, die mit keinem App-Shop verknüpft ist.

Nachdem eine App verknüpft wurde, können diese Informationen weiterhin abgerufen werden. Wenn bei der Erstellung kein Name für die App angegeben wird, wird ein Platzhaltername verwendet.
linkedAppInfo

object (LinkedAppInfo)

Nicht veränderbar. Die Informationen für eine App, die mit einem App-Shop verknüpft ist.

Dieses Feld ist nur vorhanden, wenn die App mit einem App-Shop verknüpft ist.
appApprovalState

enum (AppApprovalState)

Nur Ausgabe. Der Genehmigungsstatus für die App. Das Feld ist schreibgeschützt.

ManualAppInfo

Informationen für manuelle Apps, die nicht mit einem App-Shop verknüpft sind, z. B. Google Play oder App Store.

JSON-Darstellung 
{
  "displayName": string
}
Felder
displayName

string

Der vom Nutzer bereitgestellte Anzeigename der App, wie er auf der AdMob-Benutzeroberfläche angezeigt wird. Die maximal zulässige Länge beträgt 80 Zeichen.

LinkedAppInfo

Informationen aus dem App-Shop, wenn die App mit einem App-Shop verknüpft ist

JSON-Darstellung 
{
  "appStoreId": string,
  "displayName": string
}
Felder
appStoreId

string

Die App-Shop-ID der App wenn die App mit einem App-Shop verknüpft ist.

Wird die App zum Google Play Store hinzugefügt, ist dies die App-ID der App. Beispiel: „com.beispiel.meineapp“. Weitere Informationen finden Sie unter https://developer.android.com/studio/build/application-id.

Wird die App zum Apple App Store hinzugefügt, ist es die App Store-ID. Beispiel: „105169111“.

Das Festlegen der App Store-ID kann nicht rückgängig gemacht werden. Sobald eine App verknüpft ist, kann die Verknüpfung nicht mehr aufgehoben werden.
displayName

string

Nur Ausgabe. Der angezeigte Name der App, wie er im App-Shop angezeigt wird. Dieses Feld dient nur zur Ausgabe und kann leer sein, wenn die App nicht im Store gefunden wird.

AppApprovalState

Der Genehmigungsstatus für eine mobile App.

Enums
APP_APPROVAL_STATE_UNSPECIFIED Standardwert für ein nicht festgelegtes Feld. Nicht verwenden.
ACTION_REQUIRED Für die App ist eine zusätzliche Nutzeraktion erforderlich, die genehmigt werden muss. Weitere Informationen finden Sie unter https://support.google.com/admob/answer/10564477.
IN_REVIEW Die Überprüfung der App steht noch aus.
APPROVED Die App wurde freigegeben und es können dort Anzeigen ausgeliefert werden.