Method: accounts.apps.list

Liste 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 for 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 uma nova 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 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 na 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)

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

Mesmo que um app seja vinculado, essas informações poderão ser recuperadas. Se o app não for nomeado na criação, um marcador de posição vai ser usado.
linkedAppInfo

object (LinkedAppInfo)

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

Esse campo só vai aparecer se o app 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 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, que é fornecida pelo usuário. O tamanho máximo permitido é de 80 caracteres.

LinkedAppInfo

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

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

string

O ID da app store do aplicativo. presente se, e somente se, o aplicativo estiver vinculado a uma app store.

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

Se o app tiver sido adicionado à App Store da Apple, ele terá um ID da app store. Por exemplo, "105169111".

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

string

Apenas saída. Nome de exibição do app como aparece na app store. Este é um campo somente para saída e poderá ficar vazio se o app não puder ser encontrado na Play Store.

AppApprovalState

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

Enums
APP_APPROVAL_STATE_UNSPECIFIED Valor padrão de um campo não definido. Não use.
ACTION_REQUIRED O app exige outra ação do usuário para ser aprovado. Consulte https://support.google.com/admob/answer/10564477 para saber mais 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.