Method: accounts.apps.list

Enumera las apps en la cuenta de AdMob especificada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Nombre del recurso de la cuenta para la que se enumeran las apps. Ejemplo: accounts/pub-9876543210987654

Parámetros de consulta

Parámetros
pageSize

integer

La cantidad máxima de apps que se mostrarán. Si no se especifican o 0, se mostrarán 10,000 apps como máximo. El valor máximo es 20,000; los valores superiores a 20,000 se forzarán a 20,000.
pageToken

string

Valor que mostró el último ListAppsResponse; indica que es una continuación de una llamada a apps.list anterior y que el sistema debe mostrar la siguiente página de datos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta de la solicitud de la lista de apps.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "apps": [
    {
      object (App)
    }
  ],
  "nextPageToken": string
}
Campos
apps[]

object (App)

Las apps resultantes para la cuenta solicitada.
nextPageToken

string

Si no está vacío, indica que puede haber más apps para la solicitud. Este valor se debe pasar en una ListAppsRequest nueva.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

App

Describe una aplicación de AdMob para una plataforma específica (por ejemplo: Android o iOS).

Representación JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Campos
name

string

Es el nombre del recurso de esta app. El formato es accounts/{publisherId}/apps/{app_id_fragment}. Ejemplo: accounts/pub-9876543210987654/apps/0123456789
appId

string

El ID visible externamente de la aplicación, que se puede usar para integrar el SDK de AdMob. Esta es una propiedad de solo lectura. Ejemplo: ca-app-pub-9876543210987654~0123456789
platform

string

Describe la plataforma de la app. Se limita a "IOS" y "ANDROID".
manualAppInfo

object (ManualAppInfo)

Es la información de una aplicación que no está vinculada a ninguna tienda de aplicaciones.

Después de vincular una app, esta información aún se puede recuperar. Si no se proporciona un nombre para la app en el momento de su creación, se usará un nombre de marcador de posición.
linkedAppInfo

object (LinkedAppInfo)

Inmutable. Es la información de una aplicación que está vinculada a una tienda de aplicaciones.

Este campo está presente solo si la aplicación está vinculada a una tienda de aplicaciones.
appApprovalState

enum (AppApprovalState)

Solo salida. El estado de aprobación de la app. El campo es de solo lectura.

ManualAppInfo

Información proporcionada para las aplicaciones manuales que no están vinculadas a una tienda de aplicaciones (por ejemplo, Google Play o App Store).

Representación JSON 
{
  "displayName": string
}
Campos
displayName

string

Es el nombre visible de la app, tal como se muestra en la IU de AdMob y que proporciona el usuario. La longitud máxima permitida es de 80 caracteres.

LinkedAppInfo

Es la información de la tienda de aplicaciones (si la aplicación está vinculada a una tienda de aplicaciones).

Representación JSON 
{
  "appStoreId": string,
  "displayName": string
}
Campos
appStoreId

string

El ID de la tienda de aplicaciones; presente solo si la aplicación está vinculada a una tienda de aplicaciones.

Si la aplicación se agrega a Google Play Store, será el ID de aplicación de la aplicación. Por ejemplo, "com.ejemplo.miapp". Consulta https://developer.android.com/studio/build/application-id.

Si la aplicación se agrega a la App Store de Apple, será el ID de la tienda de aplicaciones. Por ejemplo: “105169111”.

Ten en cuenta que configurar el ID de la tienda de aplicaciones se considera una acción irreversible. Una vez que se vincula una app, no se puede desvincular.
displayName

string

Solo salida. Es el nombre visible de la app tal como aparece en la tienda de aplicaciones. Este campo es de solo salida y puede estar vacío si la app no se encuentra en la tienda.

AppApprovalState

Los estados de aprobación de la app para dispositivos móviles

Enumeradores
APP_APPROVAL_STATE_UNSPECIFIED Valor predeterminado para un campo no establecido. No lo utilices.
ACTION_REQUIRED La app requiere que el usuario realice acciones adicionales para que se apruebe. Para obtener más información y conocer los próximos pasos, consulte https://support.google.com/admob/answer/10564477.
IN_REVIEW La app está pendiente de revisión.
APPROVED La app debe estar aprobada y puede publicar anuncios.