Method: accounts.apps.list

Listet die Apps im angegebenen AdMob-Konto auf.

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

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der Apps, die zurückgegeben werden sollen. Wenn nicht angegeben oder auf 0 festgelegt, werden maximal 10.000 Apps 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 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 Datenseite zurückgeben soll.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Anfrage für die 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

Wenn dieser Wert nicht leer ist, gibt er an, 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 unter OAuth 2.0 Overview.

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 mit dem AdMob SDK verwendet werden kann. Dies ist eine schreibgeschützte Eigenschaft. Beispiel: ca-app-pub-9876543210987654~0123456789
platform

string

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

object (ManualAppInfo)

Die Informationen für eine App, die nicht mit einem 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 Platzhalternamen verwendet.
linkedAppInfo

object (LinkedAppInfo)

Nicht veränderbar. 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 der App. Das Feld ist schreibgeschützt.

ManualAppInfo

Informationen zu manuellen Apps, die nicht mit einem App-Shop (z. B. Google Play oder App Store) verknüpft sind.

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

string

Der Anzeigename der App, wie er in der AdMob-Benutzeroberfläche angezeigt wird. Er wird vom Nutzer angegeben. 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. Sie ist nur vorhanden, wenn die App mit einem App-Shop verknüpft ist.

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

Wenn die App im Apple App Store hinzugefügt wird, ist es die App-Store-ID. Beispiel: „105169111“.

Hinweis: Das Festlegen der App-Shop-ID gilt als irreversible Aktion. Sobald eine App verknüpft ist, kann die Verknüpfung nicht mehr aufgehoben werden.
displayName

string

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

AppApprovalState

Die App-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 Genehmigung der App 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 Die Überprüfung der App steht noch aus.
APPROVED Die App wurde genehmigt und es können Anzeigen ausgeliefert werden.