Cómo comenzar

Para empezar a hacer llamadas a la API, deberás configurar el acceso a la API para tu cuenta de desarrollador de Google Play. Esto implica cambios en Google Play Console y Google Cloud Console. En las siguientes instrucciones, se explican los cuatro pasos necesarios para comenzar a usar la API de Google Play Developer.

  1. Vincula tu cuenta de desarrollador con un proyecto de Google Cloud nuevo o existente.
  2. Habilita la API de Google Play Developer para tu proyecto vinculado de Google Cloud.
  3. Autoriza una clave de API para la API de Google Play Developer en tu proyecto vinculado de Google Cloud.
  4. Configura una cuenta de servicio con los permisos adecuados de Google Play Console para acceder a la API de Google Play Developer.

Vincula tu cuenta y proyecto

Antes de acceder a la API de Google Play Developer, debes vincular tu cuenta de desarrollador de Google Play a un proyecto de Google Cloud. En la mayoría de los casos, te recomendamos que crees un proyecto de Google Cloud nuevo dedicado a tu cuenta de desarrollador de Google Play, pero puedes vincular uno existente. Recuerda que cada cuenta de desarrollador de Google Play puede vincularse únicamente a un proyecto de Google Cloud. Si tienes varias apps en la misma cuenta de desarrollador de Google Play, todas deben compartir el mismo proyecto de Google Cloud.

Crea un proyecto nuevo

  1. Ve a la página Acceso a la API de Google Play Console.
  2. Haz clic en Crear proyecto nuevo.

El proyecto de Google Cloud se creará automáticamente y se vinculará a tu cuenta de desarrollador de Google Play.

Usa un proyecto existente

Si ya eres usuario de Google Cloud Console, puedes vincular tu proyecto de Google Cloud existente mediante los siguientes pasos:

  1. Ve a la página Acceso a la API de Google Play Console.
  2. Elige el proyecto que quieras vincular. Si tu proyecto no aparece en la lista, verifica que tu cuenta de usuario esté designada como Propietario en el proyecto de Google Cloud que desees vincular.
  3. Haz clic en Vincular un proyecto existente.

Habilita la API

Una vez que hayas configurado el proyecto vinculado de Google Cloud, deberás habilitar la API de Google Play Developer para ese proyecto. Debes ser propietario del proyecto de Google Cloud para hacerlo.

  1. Ve a la página Acceso a la API de Google Play Console.
  2. En API, busca la API de Google Play Developer y haz clic en Activar.

Se actualizará directamente el proyecto de Google Cloud, y se aplicará el cambio de inmediato.

Autoriza una clave de API

A fin de usar la API, necesitas una clave de API en tu proyecto vinculado de Google Cloud que esté autorizada para usar la API de Google Play Developer. Configura esto en Google Play Console.

Configura cuentas de servicio y OAuth

Debes configurar el acceso a la API de Google Play Developer con una cuenta de servicio o un cliente de OAuth. En la mayoría de los casos, debes usar una cuenta de servicio para acceder a la API.

Las cuentas de servicio deben usarse en un entorno seguro, como tu servidor. Las credenciales de la cuenta de servicio deben administrarse de forma segura para que no se muestren a nadie que no esté autorizado a usar la API.

Si necesitas acceder a la API en nombre de un usuario individual, debes usar el ID de cliente de OAuth. Por ejemplo, si tu sitio web necesita acceder a la API de Google Play Developer desde el cliente web en nombre del usuario, puedes usar el ID de cliente. El usuario se autenticará con su Cuenta de Google en lugar de la cuenta de servicio. Esto te permite realizar llamadas a la API en nombre de un usuario sin comprometer las credenciales de la cuenta de servicio.

  • Cuenta de servicio: Un servicio de software seguro accederá a la API (más común)
  • Clientes de OAuth: Un usuario accederá a la API

Usa una cuenta de servicio

Puedes crear una cuenta de servicio desde Google Play Console.

  1. Ve a la página Acceso a la API de Google Play Console.
  2. En Cuentas de servicio, haz clic en Aprender a crear cuentas de servicio.
  3. Sigue las instrucciones para crear la cuenta de servicio.

    Durante el proceso de creación de esta cuenta, debes otorgarle acceso al proyecto de Google Cloud para que este aparezca en Google Play Console.

  4. Una vez que hayas creado la cuenta de servicio en Google Play Console, haz clic en Listo. La sección Cuentas de servicio de la página Acceso a la API se actualizará automáticamente, y aparecerá tu cuenta de servicio.

  5. Haz clic en Otorgar acceso con el fin de proporcionarle los derechos necesarios para realizar acciones.

    Para usar las API de Facturación Google Play, debes otorgar los siguientes permisos:

    • Ver datos financieros, pedidos y respuestas a la encuesta de cancelación
    • Administrar pedidos y suscripciones

En este punto, ya deberías poder acceder a la API de Google Play Developer a través de la cuenta de servicio. Si quieres obtener más información, consulta Uso de OAuth 2.0 para aplicaciones de servidor a servidor.

Usa clientes de OAuth

Puedes usar un cliente de OAuth para permitir que los usuarios realicen acciones mediante la API con sus propias credenciales, aunque solo podrán llevar a cabo las que se permitan en la página Usuarios y permisos de Google Play Console.

Antes de crear clientes de OAuth, debes configurar la información de marca para tu producto. Si deseas obtener más información, consulta Configura tu pantalla de consentimiento de OAuth.

  1. Ve a la página Acceso a la API de Google Play Console.
  2. En Clientes de OAuth, haz clic en Configurar la pantalla de consentimiento de OAuth.
  3. Configura la información de marca de tu producto.
  4. Cuando termines, haz clic en Actualizar el consentimiento para OAuth. Se actualizará la sección, y ya no verás el mensaje sobre la información de marca.

Para crear un cliente de OAuth con Google Play Console, sigue estos pasos:

  1. Ve a la página Acceso a la API de Google Play Console.
  2. En Clientes de OAuth, haz clic en Crear cliente de OAuth nuevo.
  3. Sigue las instrucciones de la página para crear tu cliente de OAuth.
  4. Una vez que hayas creado el cliente de OAuth en Google Play Console, haz clic en Listo. La sección Clientes de OAuth de la página Acceso a la API se actualizará automáticamente y mostrará tu cliente de OAuth.

    En algunas ocasiones, el nuevo cliente de OAuth no aparecerá de inmediato en la página. Si es así, haz clic en Actualizar clientes de OAuth.

Se mostrarán los detalles del nuevo cliente de OAuth en una lista de esta página.

Información adicional

Usa las siguientes sugerencias y trucos para comenzar a usar la API en Google Play.

Obtén tu ID de desarrollador

Algunas API requieren que proporciones un ID de desarrollador de Google Play Console. Este es un número largo que se asignó cuando se creó la cuenta de desarrollador de Google Play. Puedes encontrar tu ID de desarrollador en la URL de casi cualquier página de Google Play Console, como la página Acceso a la API.

Por ejemplo, considera la URL de Google Play Console:

https://play.google.com/console/developers/1234567890123456789/api-access

En la URL anterior, el ID de desarrollador sería 1234567890123456789.

Nota: Si se transfiere una app de una cuenta de desarrollador de Google Play a otra, cambiará el ID de desarrollador asociado a esa app. Esto significa que, una vez que se complete la transferencia, debes usar el ID de desarrollador de la nueva cuenta de desarrollador de Google Play en las llamadas a la API para esa app.

API especializadas

La API para desarrolladores de Google Play contiene varias API especializadas que permiten realizar tipos específicos de análisis en la app:

API de Reply to Reviews
Permite ver las opiniones de los usuarios sobre tu app y responder estos comentarios.
API de Voided Purchases
Permite revocar el acceso a productos integrados en la aplicación asociados a compras que anularon los usuarios.

Bibliotecas cliente

Proporcionamos bibliotecas cliente que puedes usar para acceder de forma programática a las API de REST. Si deseas obtener más información al respecto, consulta Bibliotecas cliente y muestras de código.