Method: accounts.apps.list

Hiermit werden die Apps im angegebenen 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 Maximalwert beträgt 20.000. Für Werte über 20.000 wird eine Umwandlung von 20.000 vorgenommen.
pageToken

string

Der vom letzten ListAppsResponse zurückgegebene Wert. Gibt an, dass es sich um eine Fortsetzung eines vorherigen apps.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 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 Apps für das angeforderte Konto.
nextPageToken

string

Wenn nicht leer, bedeutet das, dass es möglicherweise weitere Apps für die Anfrage gibt. 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 App. 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 ein schreibgeschütztes Attribut. Beispiel: ca-app-pub-9876543210987654~0123456789
platform

string

Beschreibt die Plattform der App. Beschränkt auf „IOS“ und „ANDROID“.
manualAppInfo

object (ManualAppInfo)

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

Diese Informationen können auch nach dem Verknüpfen einer App abgerufen werden. Wenn bei der Erstellung der App kein Name angegeben wird, wird ein Platzhaltername verwendet.
linkedAppInfo

object (LinkedAppInfo)

Nicht veränderbar. Die Informationen zu einer 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 manuell erstellte 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 in der AdMob-Benutzeroberfläche angezeigte Anzeigename der App, der vom Nutzer bereitgestellt wird. Es sind maximal 80 Zeichen zulässig.

LinkedAppInfo

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

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

string

App-Shop-ID der App; vorhanden, wenn und nur wenn die App mit einem App-Shop verknüpft ist

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

Wenn die App dem Apple App Store hinzugefügt wird, ist dies 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 Anzeigename der App, wie er im App-Shop angezeigt wird Dieses Feld dient nur zur Ausgabe und kann leer sein, wenn die App im Store nicht 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 Damit die App genehmigt werden kann, ist eine zusätzliche Nutzeraktion erforderlich. Weitere Informationen und die nächsten Schritte finden Sie unter https://support.google.com/admob/answer/10564477.
IN_REVIEW Für die App steht die Überprüfung aus.
APPROVED Die App wurde genehmigt und es können Anzeigen ausgeliefert werden.