Method: accounts.apps.list

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

HTTP-запрос

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

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

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

Параметры
parent

string

Необходимый. Имя ресурса учетной записи, для которой будет отображаться список приложений. Пример: account/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 .

Приложение

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

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

string

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

appId

string

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

platform

string

Описывает платформу приложения. Ограничено «IOS» и «ANDROID».

manualAppInfo

object ( ManualAppInfo )

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

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

linkedAppInfo

object ( LinkedAppInfo )

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

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

appApprovalState

enum ( AppApprovalState )

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

РуководствоAppInfo

Информация, предоставленная для устанавливаемых вручную приложений, которые не связаны с магазином приложений (пример: 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 Приложение одобрено и может показывать рекламу.