Method: accounts.apps.list

Lista os apps na conta da AdMob especificada.

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 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 for 0, no máximo 10.000 apps serão retornados. O valor máximo é 20.000. Valores maiores serão convertidos para 20.000.
pageToken

string

O valor retornado pelo último ListAppsResponse indica que esta é uma continuação de uma chamada apps.list anterior e que o sistema deve 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 OAuth 2.0 Overview.

App

Descreve um app 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

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

string

O ID visível externamente do app, que pode ser usado para integração com o SDK da AdMob. Essa é 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 nome de marcador de posição será usado.
linkedAppInfo

object (LinkedAppInfo)

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

Esse campo só aparece se o app estiver vinculado a uma loja de apps.
appApprovalState

enum (AppApprovalState)

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

ManualAppInfo

Informações fornecidas para apps manuais que não estã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 e fornecido pelo usuário. O comprimento máximo permitido é de 80 caracteres.

LinkedAppInfo

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

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

string

O ID da app store do app, presente se e somente se o app 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". Acesse https://developer.android.com/studio/build/application-id.

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

Definir o ID da app store é considerado uma ação irreversível. Depois que um app é vinculado, não é possível desvincular.
displayName

string

Apenas saída. Nome de exibição do app conforme aparece na app store. Este é um campo somente de saída e pode estar vazio se o app não for encontrado na loja.

AppApprovalState

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

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