Method: accounts.apps.list

Enumera las aplicaciones de 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

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la cuenta para la que se enumerarán las apps. Ejemplo: accounts/pub-9876543210987654

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de apps que se devolverán. Si no se especifica o se establece en 0, se devolverán, como máximo, 10,000 apps. El valor máximo es 20,000,y los valores superiores se convertirán a 20,000.
pageToken

string

Es el valor que devolvió el último ListAppsResponse y que indica que se trata de una continuación de una llamada anterior a apps.list y que el sistema debe devolver la siguiente página de datos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta a 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)

Son 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 un nuevo ListAppsRequest.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

Aplicación

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}. Por ejemplo: accounts/pub-9876543210987654/apps/0123456789
appId

string

Es el ID visible de forma externa de la app que se puede usar para la integración con el SDK de AdMob. Esta propiedad es 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 app que no está vinculada a ninguna tienda de aplicaciones.

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

object (LinkedAppInfo)

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

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

enum (AppApprovalState)

Solo salida. Es el estado de aprobación de la app. Este campo es de solo lectura.

ManualAppInfo

Es la información que se proporciona para las apps 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 que se muestra en la IU de AdMob y que proporciona el usuario. La longitud máxima permitida es de 80 caracteres.

LinkedAppInfo

Información de la tienda de aplicaciones si la app está vinculada a una.

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

string

Es el ID de la tienda de aplicaciones de la app, que está presente solo si la app está vinculada a una tienda de aplicaciones.

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

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

Ten en cuenta que establecer 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. Nombre visible de la app tal como aparece en Play Store. Este campo es solo de salida y puede estar vacío si no se encuentra la app en la tienda.

AppApprovalState

Son los estados de aprobación de una app para dispositivos móviles.

Enums
APP_APPROVAL_STATE_UNSPECIFIED Es el valor predeterminado para un campo no establecido. No lo utilices.
ACTION_REQUIRED La app requiere que se apruebe una acción adicional del usuario. Consulta https://support.google.com/admob/answer/10564477 para obtener detalles y conocer los próximos pasos.
IN_REVIEW La app está pendiente de revisión.
APPROVED La app está aprobada y puede publicar anuncios.