Method: accounts.apps.list

Wyświetl listę aplikacji powiązanych z określonym kontem 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

Wymagane. Nazwa zasobu konta, dla którego chcesz wyświetlić listę 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 wartość 0, zwrócony zostanie maksymalnie 10 000 aplikacji. Maksymalna wartość to 20 000. wartości powyżej 20 000 zostaną zmienione na 20 000.
pageToken

string

Wartość zwracana przez ostatnie działanie funkcji ListAppsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania funkcji apps.list i że system powinien zwrócić następną stronę danych.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie wyświetlenia 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)

Znalezione aplikacje dla żądanego konta.
nextPageToken

string

Jeśli pole nie jest puste, oznacza to, że dla żądania może być więcej aplikacji. tę wartość należy przekazać w nowym formacie 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 działającą na określonej platformie (np. Android lub iOS).

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

string

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

string

Widoczny z zewnątrz identyfikator aplikacji, którego można użyć do integracji z pakietem SDK AdMob. Ta usługa jest dostępna tylko do odczytu. Przykład: ca-app-pub-9876543210987654~0123456789
platform

string

Opisuje platformę aplikacji. Tylko „iOS” i „ANDROID”.
manualAppInfo

object (ManualAppInfo)

Informacje o aplikacji, która nie jest powiązana z żadnym sklepem z aplikacjami.

Gdy to zrobisz, te informacje będzie można odzyskać. Jeśli podczas tworzenia aplikacji nie podasz nazwy, zostanie użyta nazwa zastępcza.
linkedAppInfo

object (LinkedAppInfo)

Stały. Informacje o aplikacji, która jest połączona ze sklepem z aplikacjami.

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

enum (AppApprovalState)

Tylko dane wyjściowe. Stan zatwierdzenia aplikacji. 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 lub App Store).

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Wyświetlana nazwa aplikacji podana przez użytkownika w taki sposób, jak 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 sklepu z aplikacjami, w którym znajduje się aplikacja; występuje tylko wtedy, gdy aplikacja jest powiązana ze sklepem z aplikacjami.

Jeśli dodasz aplikację do Sklepu Google Play, będzie to jej identyfikator. Na przykład: „com.example.mojaaplikacja”. Więcej informacji znajdziesz na stronie https://developer.android.com/studio/build/application-id.

Jeśli dodasz aplikację do Apple App Store, będzie to identyfikator w sklepie z aplikacjami. Przykład: „105169111”.

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

string

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

AppApprovalState

Stany zatwierdzenia aplikacji mobilnej.

Wartości w polu enum
APP_APPROVAL_STATE_UNSPECIFIED Wartość domyślna pola nieskonfigurowanego. Nie używać.
ACTION_REQUIRED Zatwierdzenie aplikacji wymaga dodatkowego działania użytkownika. Więcej informacji i dalsze kroki znajdziesz na stronie https://support.google.com/admob/answer/10564477.
IN_REVIEW Aplikacja oczekuje na sprawdzenie.
APPROVED Aplikacja została zatwierdzona i może wyświetlać reklamy.