Method: accounts.apps.list

Wymień aplikacje na wybranym koncie AdMob.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Nazwa zasobu konta, dla którego ma zostać wyświetlona lista aplikacji. Przykład: accounts/pub-9876543210987654

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba aplikacji do zwrócenia. Jeśli wartość nie jest określona lub ma wartość 0, zwróconych zostanie maksymalnie 10 000 aplikacji. Maksymalna wartość to 20 000, a wartości powyżej 20 000 zostaną zmienione na 20 000.
pageToken

string

Wartość zwrócona przez ostatnie ListAppsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania apps.list i system powinien zwrócić kolejną stronę danych.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie listy aplikacji.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Pola
apps[]

object (App)

Powstałe aplikacje dla żądanego konta.
nextPageToken

string

Jeśli pole nie jest puste, oznacza, że może być więcej aplikacji dla żądania. Ta wartość należy przekazać w nowym obiekcie ListAppsRequest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/admob.readonly

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Promująca aplikację

Opisuje aplikację AdMob na potrzeby określonej platformy (np. Androida lub iOS).

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

string

Nazwa zasobu tej aplikacji. Format to accounts/{publisherId}/apps/{identyfikator_aplikacji} Przykład: accounts/pub-9876543210987654/apps/0123456789
appId

string

Widoczny zewnętrznie identyfikator aplikacji, który umożliwia integrację z pakietem AdMob SDK. Ta właściwość jest tylko do odczytu. Przykład: ca-app-pub-9876543210987654~0123456789
platform

string

Opisuje platformę aplikacji. Ograniczona do systemów „IOS” i „ANDROID”.
manualAppInfo

object (ManualAppInfo)

Informacje o aplikacji, która nie jest połączona z żadnym sklepem z aplikacjami.

Po połączeniu aplikacji te informacje są nadal dostępne. Jeśli podczas tworzenia aplikacji nie podasz nazwy, zostanie użyta nazwa zastępcza.
linkedAppInfo

object (LinkedAppInfo)

Niezmienne. Informacje o aplikacji połączonej ze sklepem z aplikacjami.

To pole jest widoczne tylko wtedy, gdy aplikacja jest połączona ze sklepem z aplikacjami.
appApprovalState

enum (AppApprovalState)

Tylko dane wyjściowe. Stan zatwierdzenia aplikacji. To pole jest tylko do odczytu.

ManualAppInfo

Informacje podawane w przypadku aplikacji ręcznych, które nie są powiązane ze sklepem z aplikacjami (np. Google Play, App Store).

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Wyświetlana przez użytkownika nazwa aplikacji widoczna w interfejsie AdMob. Maksymalna dozwolona długość to 80 znaków.

LinkedAppInfo

informacje ze sklepu z aplikacjami, jeśli aplikacja jest połączona ze sklepem z aplikacjami;

Zapis JSON 
{
  "appStoreId": string,
  "displayName": string
}
Pola
appStoreId

string

Identyfikator aplikacji w sklepie z aplikacjami, widoczny tylko wtedy, gdy aplikacja jest połączona ze sklepem z aplikacjami.

Jeśli aplikacja zostanie dodana do Sklepu Google Play, będzie to jej identyfikator, np. „com.example.mojaaplikacja”. Więcej informacji znajdziesz na stronie https://developer.android.com/studio/build/application-id.

Jeśli aplikacja zostanie dodana do sklepu Apple App Store, będzie to identyfikator ze sklepu z aplikacjami. np. „105169111”.

Pamiętaj, że ustawienie identyfikatora sklepu z aplikacjami jest uznawane za działanie nieodwracalne. Połączonej aplikacji nie można odłączyć.
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa aplikacji w postaci, w jakiej jest widoczna w sklepie z aplikacjami. To pole jest przeznaczone tylko do danych wyjściowych i może być puste, jeśli nie można znaleźć aplikacji w sklepie.

AppApprovalState

Stany zatwierdzenia aplikacji mobilnej.

Wartości w polu enum
APP_APPROVAL_STATE_UNSPECIFIED Wartość domyślna nieskonfigurowanego pola. Nie używać.
ACTION_REQUIRED Aby aplikacja mogła zostać zatwierdzona, użytkownik musi wykonać dodatkowe czynności. Więcej informacji i dalsze kroki znajdziesz na stronie https://support.google.com/admob/answer/10564477.
IN_REVIEW Aplikacja czeka na sprawdzenie.
APPROVED Aplikacja została zatwierdzona i może wyświetlać reklamy.