Method: accounts.apps.list

Lista os apps na conta especificada da AdMob.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Nome do recurso da conta para listar os apps. Exemplo: accounts/pub-9876543210987654

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de apps a serem retornados. Se não for especificado ou 0, no máximo 10.000 apps serão retornados. O valor máximo é 20.000. Valores acima de 20.000 serão convertidos para 20.000.
pageToken

string

O valor retornado pelo último ListAppsResponse; indica que essa é uma continuação de uma chamada apps.list anterior e que o sistema precisa retornar a próxima página de dados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para a solicitação da lista de apps.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Campos
apps[]

object (App)

Os apps resultantes para a conta solicitada.
nextPageToken

string

Se não estiver vazio, indica que pode haver mais apps para a solicitação. Esse valor precisa ser transmitido em um novo ListAppsRequest.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

App

Descreve um aplicativo da AdMob para uma plataforma específica (por exemplo: Android ou iOS).

Representação JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Campos
name

string

O nome do recurso para este app. O formato é accounts/{publisherId}/apps/{app_id_fragment}. Exemplo: accounts/pub-9876543210987654/apps/0123456789
appId

string

O ID externamente visível do app que pode ser usado para integração com o SDK da AdMob. Esta é uma propriedade somente leitura. Exemplo: ca-app-pub-9876543210987654~0123456789
platform

string

Descreve a plataforma do app. Limitado a "IOS" e "ANDROID".
manualAppInfo

object (ManualAppInfo)

As informações de um app que não está vinculado a nenhuma app store.

Depois que um app é vinculado, essas informações ainda podem ser recuperadas. Se nenhum nome for fornecido para o app na criação, um marcador de posição será usado.
linkedAppInfo

object (LinkedAppInfo)

Imutável. As informações de um aplicativo vinculado a uma app store.

Esse campo estará presente somente se o aplicativo estiver vinculado a uma app store.
appApprovalState

enum (AppApprovalState)

Apenas saída. O estado de aprovação do app. O campo é somente leitura.

ManualAppInfo

Informações fornecidas para apps manuais não vinculados a uma loja de aplicativos (por exemplo, Google Play, App Store).

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

O nome de exibição do app, conforme mostrado na interface da AdMob, fornecido pelo usuário. O tamanho máximo permitido é de 80 caracteres.

LinkedAppInfo

Informações da app store, se o app estiver vinculado a uma delas.

Representação JSON 
{
  "appStoreId": string,
  "displayName": string
}
Campos
appStoreId

string

O ID da app store. Apresentará apenas se o aplicativo estiver vinculado a uma app store.

Se o app for adicionado à Google Play Store, ele será o ID do aplicativo. Por exemplo: "com.example.myapp". Consulte https://developer.android.com/studio/build/application-id.

Se o aplicativo foi adicionado à Apple App Store, ele será o ID da app store. Por exemplo, "105169111".

Definir o ID da app store é considerado uma ação irreversível. Não é possível desvincular um app depois que ele é vinculado.
displayName

string

Apenas saída. O nome do aplicativo como ele aparece na app store. Esse campo é somente de saída e poderá ficar vazio se o app não puder ser encontrado na loja.

AppApprovalState

Os estados de aprovação de um aplicativo para dispositivos móveis.

Enums
APP_APPROVAL_STATE_UNSPECIFIED Valor padrão para um campo não definido. Não use.
ACTION_REQUIRED O app exige ações adicionais do usuário para ser aprovado. Consulte https://support.google.com/admob/answer/10564477 para ver detalhes e as próximas etapas.
IN_REVIEW A revisão do app está pendente.
APPROVED O app foi aprovado e pode veicular anúncios.