Method: accounts.apps.list

Wyświetla listę aplikacji na określonym 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

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 nie podasz tej wartości lub ustawisz ją na 0, zwrócimy maksymalnie 10 000 aplikacji. Maksymalna wartość to 20 000. Wartości powyżej 20 000 zostaną ograniczone do 20 000.
pageToken

string

Wartość zwrócona przez ostatni znak ListAppsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania ListAppsResponse, a system powinien zwrócić następną stronę danych.apps.list

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)

Aplikacje powiązane z danym kontem.
nextPageToken

string

Jeśli nie jest pusta, oznacza, że w odpowiedzi na żądanie może być więcej aplikacji. Tę wartość należy przekazać w nowym parametrze ListAppsRequest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

Promująca aplikację

Opisuje aplikację AdMob na konkretną platformę (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 tej aplikacji. Format to accounts/{publisherId}/apps/{app_id_fragment}. Przykład: accounts/pub-9876543210987654/apps/0123456789
appId

string

Widoczny na zewnątrz identyfikator aplikacji, którego można używać do integracji z pakietem AdMob SDK. Jest to właściwość tylko do odczytu. Przykład: ca-app-pub-9876543210987654~0123456789
platform

string

Opisuje platformę aplikacji. Ograniczona do wartości „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 jej nazwy, zostanie użyta nazwa zastępcza.
linkedAppInfo

object (LinkedAppInfo)

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

To pole jest obecne 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 podane w przypadku aplikacji wprowadzonych ręcznie, które nie są połączone ze sklepem z aplikacjami (np. Google Play, App Store).

Zapis JSON 
{
  "displayName": string
}
Pola
displayName

string

Nazwa wyświetlana aplikacji widoczna w interfejsie AdMob, podana przez użytkownika. Maksymalna dozwolona długość to 80 znaków.

LinkedAppInfo

Informacje ze sklepu z aplikacjami, jeśli aplikacja jest z nim połączona.

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

string

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

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

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

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

string

Tylko dane wyjściowe. Wyświetlana nazwa aplikacji widoczna w sklepie z aplikacjami. Jest to pole tylko do odczytu, które 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 pola, które nie zostało skonfigurowane. Nie używać.
ACTION_REQUIRED Aplikacja wymaga dodatkowego działania użytkownika, aby została zatwierdzona. Szczegóły i dalsze instrukcje 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.