Method: accounts.apps.list

Перечислите приложения, относящиеся к указанному аккаунту AdMob.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Имя ресурса учетной записи, для которой нужно вывести список приложений. Пример: accounts/pub-9876543210987654

Параметры запроса

Параметры
pageSize

integer

Максимальное количество возвращаемых приложений. Если значение не указано или равно 0, будет возвращено не более 10 000 приложений. Максимальное значение — 20 000; значения выше 20 000 будут преобразованы в 20 000.

pageToken

string

Значение, возвращаемое последним ListAppsResponse , указывает на то, что это продолжение предыдущего вызова apps.list , и система должна вернуть следующую страницу данных.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ответ на запрос списка приложений.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Поля
apps[]

object ( App )

Полученные приложения для запрошенной учетной записи.

nextPageToken

string

Если значение не пустое, это указывает на то, что для запроса могут быть и другие приложения; это значение следует передавать в новом объекте ListAppsRequest .

Области полномочий

Требуется следующая область действия OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

Приложение

Описывает приложение AdMob для конкретной платформы (например, Android или iOS).

JSON-представление 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Поля
name

string

Имя ресурса для этого приложения. Формат: accounts/{publisherId}/apps/{app_id_fragment}. Пример: accounts/pub-9876543210987654/apps/0123456789

appId

string

Внешний идентификатор приложения, который можно использовать для интеграции с SDK AdMob. Это свойство доступно только для чтения. Пример: ca-app-pub-9876543210987654~0123456789

platform

string

Описывает платформу приложения. Доступно только для iOS и Android.

manualAppInfo

object ( ManualAppInfo )

Информация о приложении, не связанном ни с одним магазином приложений.

После того, как приложение будет связано, эта информация по-прежнему будет доступна. Если при создании приложения не указано имя, будет использовано имя-заполнитель.

linkedAppInfo

object ( LinkedAppInfo )

Неизменяемая информация. Информация о приложении, связанная с магазином приложений.

Это поле присутствует только в том случае, если приложение связано с магазином приложений.

appApprovalState

enum ( AppApprovalState )

Только для вывода. Состояние одобрения приложения. Поле доступно только для чтения.

ManualAppInfo

Информация предоставлена ​​для приложений, созданных вручную и не связанных с магазином приложений (например, Google Play, App Store).

JSON-представление 
{
  "displayName": string
}
Поля
displayName

string

Отображаемое имя приложения, как оно отображается в пользовательском интерфейсе AdMob, предоставляется пользователем. Максимально допустимая длина — 80 символов.

LinkedAppInfo

Информация из магазина приложений, если приложение связано с каким-либо магазином приложений.

JSON-представление 
{
  "appStoreId": string,
  "displayName": string
}
Поля
appStoreId

string

Идентификатор приложения в магазине приложений; присутствует только в том случае, если приложение связано с магазином приложений.

Если приложение добавлено в магазин Google Play, оно будет иметь идентификатор приложения. Например: "com.example.myapp". См. https://developer.android.com/studio/build/application-id .

Если приложение добавлено в Apple App Store, оно получит идентификатор магазина приложений. Например, "105169111".

Обратите внимание, что установка идентификатора в магазине приложений считается необратимым действием. После того, как приложение будет связано, его нельзя будет отменить.

displayName

string

Только для вывода. Отображаемое название приложения в том виде, в котором оно указано в магазине приложений. Это поле предназначено только для вывода и может быть пустым, если приложение не найдено в магазине.

AppApprovalState

В документе об одобрении приложения указано, что оно предназначено для мобильного приложения.

Перечисления
APP_APPROVAL_STATE_UNSPECIFIED Значение по умолчанию для незаданного поля. Не использовать.
ACTION_REQUIRED Для одобрения приложения требуются дополнительные действия со стороны пользователя. Подробную информацию и дальнейшие шаги см. по ссылке https://support.google.com/admob/answer/10564477 .
IN_REVIEW Приложение находится на рассмотрении.
APPROVED Приложение одобрено и может показывать рекламу.