Method: accounts.apps.list

Obtén una lista de las apps incluidas 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 de 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 especifica o se muestran 0, se mostrarán 10,000 apps como máximo. El valor máximo es 20,000. los valores superiores a 20,000 se convertirán en 20,000.

pageToken

string

El valor que muestra el último ListAppsResponse; indica que esta 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 para 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 un ListAppsRequest nuevo.

Alcances 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.

Aplicación

Describe una app 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

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 de la aplicación que es visible externamente y que se puede usar para integrarla con 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. Limitado 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 que se vincula una app, esta información aún se puede recuperar. 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 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, App Store).

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

string

Indica el nombre visible de la aplicación como se muestra en la IU de AdMob que proporciona el usuario. La longitud máxima permitida es de 80 caracteres.

LinkedAppInfo

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

Es el ID de la tienda de aplicaciones de la app. 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.example.myapp”. 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 aplicación, no se puede desvincular.

displayName

string

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

AppApprovalState

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

Enumeraciones
APP_APPROVAL_STATE_UNSPECIFIED Valor predeterminado para un campo no establecido. No lo utilices.
ACTION_REQUIRED La app requiere una acción adicional del usuario para estar aprobada. Consulta https://support.google.com/admob/answer/10564477 para obtener más detalles y los próximos pasos.
IN_REVIEW La app está pendiente de revisión.
APPROVED La app está aprobada y puede publicar anuncios.