Cómo administrar la configuración del proyecto de los Servicios de Play Games en Google Cloud

Es posible que haya instancias en las que quieras ver y editar tu proyecto de Servicios de Play Games directamente en Google Cloud.

Ejemplos de situaciones típicas:

  • Habilitar API adicionales para tu proyecto (como Google Drive)
  • Editar la información de marca de tu juego en el cuadro de diálogo de OAuth 2.0
  • Visualizar tu cuota de API y solicitar más (si fuera necesario)
  • Editar los URIs autorizados o los orígenes de JavaScript en los IDs de cliente que creaste antes

Cómo ver tu proyecto

Para ver tu proyecto en Google Cloud, sigue estos pasos:

  1. Selecciona una credencial para tu juego en la página de Configuración (Crecimiento > Servicios de juego de Play > Configuración y administración > Configuración).
  2. Ve a la sección Autenticación y haz clic en Ver en Google Cloud.

Cómo ajustar las cuotas de uso de las API

En Google Cloud, puedes ver los límites de uso de la API configurados para tu juego y la cantidad de cuota que se usó. También puedes establecer límites por usuario para evitar que un usuario con comportamiento inadecuado (o un cliente de juego con errores) agote la cuota.

Si deseas ver o cambiar los límites de uso de tu proyecto, o solicitar un aumento de la cuota, haz lo siguiente:

  1. Si no tienes una cuenta de facturación para tu proyecto, crea una.
  2. Visita la página de API habilitadas de la biblioteca de API en la Consola de APIs y selecciona una API de la lista.
  3. Si deseas consultar y cambiar la configuración de cuotas, selecciona la opción Cuotas. Para consultar las estadísticas de uso, selecciona la opción Uso.

Ten en cuenta que los "usuarios" se determinan según la dirección IP del cliente que realiza la solicitud de cuota. Por ejemplo, si todas tus solicitudes provienen de un solo servidor, ese servidor puede etiquetarse por error como un usuario generador de spam. Para evitar esto, puedes adjuntar un argumento userIp=x.x.x.x a tus solicitudes de extremo de API.

Para obtener más información sobre cómo establecer cuotas por usuario, consulta Limitar el uso de la API.

Además de un límite por usuario, existe un límite diario para toda la aplicación de la API de Servicios de Google Play Games. Por lo general, no es necesario cambiar el límite asignado previamente. Sin embargo, si prevés un gran aumento en el volumen (por ejemplo, para un evento de lanzamiento próximo), puedes solicitar una cuota adicional haciendo clic en el vínculo Solicitar una cuota mayor.

Cómo activar otras APIs

Cuando creas tu ID de cliente en Play Console, la API de Servicios de Google Play Games se activa automáticamente para tu proyecto. Puedes activar otras APIs de Google desde Google Cloud.

Si deseas habilitar una API para tu proyecto, haz lo siguiente:

  1. Abre la Biblioteca de APIs en la Consola de APIs de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo. La Biblioteca de API muestra todas las API disponibles, agrupadas por familia de productos y popularidad.

  2. Si la API que quieres habilitar no está en la lista, usa la búsqueda para encontrarla.

  3. Selecciona la API que deseas habilitar y, luego, haz clic en el botón Habilitar.

  4. Si se te solicita, habilita la facturación.

  5. Si se te solicita, acepta las Condiciones del Servicio de la API.

Cómo modificar la información de marca

Si deseas modificar la información de marca (título, logotipo, etc.) de tu juego que aparece en el diálogo de OAuth 2.0, configura los atributos en la pantalla de consentimiento de Google Cloud.

Para establecer la pantalla de consentimiento de tu proyecto, haz lo siguiente:

  1. Abre la página de la Pantalla de consentimiento en Play Console. Si se te solicita, selecciona un proyecto o crea uno nuevo.
  2. Completa el formulario y haz clic en Guardar.

Cómo modificar el tipo de usuario de OAuth

Si realizas pruebas en el segmento de pruebas de producción (Prueba y lanzamiento > Producción) con una cuenta de prueba personal, también debes haber configurado el parámetro de configuración de público de OAuth en Google Cloud como Externo. Para obtener más información, consulta Administra el público de la app.

Cómo modificar los atributos relacionados con el ID de cliente

Si deseas modificar los atributos relacionados con tu ID de cliente de OAuth 2.0 (orígenes web y URLs de redireccionamiento para una app web, etc.), sigue estos pasos:

  1. Abre Play Console y navega hasta tu juego.
  2. Selecciona una credencial para tu juego en la página de Configuración (Crecimiento > Servicios de juego de Play > Configuración y administración > Configuración).
  3. Desplázate hasta la parte inferior de la sección de Autenticación y haz clic en Ver en Google Cloud.
  4. En Google Cloud, selecciona tu proyecto.
  5. En la barra lateral izquierda, selecciona API y autenticación. Asegúrate de que el estado de la API de Google Play Games Services esté ACTIVADA en la lista de APIs que se muestra.
  6. En la barra lateral izquierda, selecciona Apps registradas.
  7. Expande la sección de ID de cliente de OAuth 2.0 y busca el atributo que deseas editar.

Cómo migrar clientes de OAuth desde un proyecto de Cloud existente

Para ver tu proyecto en Google Cloud, sigue los pasos que se indican en Cómo ver tu proyecto.

Para configurar los Servicios de Play Games (PGS), se requiere un proyecto único de Google Cloud. Si varios juegos comparten un proyecto de Cloud, debes migrar sus clientes de OAuth de Android a proyectos independientes para garantizar una configuración adecuada.

Vista general de dos juegos que comparten un proyecto de Google Cloud
Figura 1. Ejemplo de Juego 1 y Juego 2 que comparten un proyecto de Google Cloud

En el ejemplo anterior, Juego 1 y Juego 2 crearon sus clientes web y de Android en un solo proyecto de Google Cloud para Acceder con Google. Debemos mover los clientes web y de Android de Juego 2 del proyecto de Google Cloud heredado actual a un proyecto de Google Cloud de destino nuevo.

Vista de alto nivel de la migración del juego 2 a un nuevo proyecto de Google Cloud
Figura 2: Migración de clientes de Juego 2 a un nuevo proyecto de Google Cloud de destino

Paso 1: Preparación del backend

Antes de realizar el cambio, debes adaptar tu backend y tus clientes para controlar la existencia simultánea de los IDs de cliente web antiguos y nuevos.

  • Configuración del servidor: Si tu servidor valida el ID de cliente web dentro del token de ID, deberás actualizar la lógica del servidor para admitir simultáneamente los tokens de ID emitidos por los clientes antiguos en el proyecto de Cloud heredado y los clientes nuevos que necesitas generar en el proyecto de Cloud de destino.
  • Configuración del cliente: Tu aplicación cliente debe admitir varios IDs de cliente web para acceder con el nuevo ID de cliente web cuando cambies. Puedes usar cualquiera de los siguientes métodos:
    • IDs de cliente web 2 integrados en la app cliente, que cambian al nuevo ID de cliente web cuando vence el ID de cliente antiguo
    • Obtén de forma dinámica el ID de cliente web más reciente del servidor para completar el cambio.
  • Crea previamente clientes web: En tu proyecto de destino, debes crear un nuevo cliente web con anticipación para evitar posibles demoras durante el cambio atómico.

Paso 2: Configura nuevos clientes de OAuth web y de Android en el Google Cloud correcto

Paso 2.1: Crea un nuevo cliente de OAuth web para Juego 2 en el proyecto de Google Cloud de destino:

IU de Google Cloud para crear un nuevo ID de cliente web de OAuth
Figura 3. Creación de un nuevo cliente de OAuth web

Paso 2.2: Advertencia: Si modificas el cliente de Android, los usuarios de tu juego no podrán acceder a él con Acceder con Google, por lo que debes asegurarte de realizar el paso 2.3 inmediatamente después del paso 2.2. Se recomienda abrir 2 páginas web simultáneamente para que las operaciones minimicen el intervalo de tiempo entre la modificación y la recreación.

Cambia el nombre del paquete del cliente de Android de Juego 2 en el proyecto de Google Cloud heredado a un valor no válido, como com.noexist.none.

IU de Google Cloud para cambiar el nombre del paquete del cliente de Android
Figura 4. Cambio del nombre del paquete del cliente de Android en el proyecto heredado

Paso 2.3: Crea de inmediato un nuevo cliente de Android para Juego 2 con la misma huella digital SHA-1 y el mismo nombre de paquete de Juego 2 en el proyecto de Google Cloud de destino:

IU de Google Cloud para crear un nuevo ID de cliente de OAuth para Android
Figura 5. Creación de un nuevo cliente de Android en el proyecto de destino

Paso 3: Implementación de la configuración en tiempo real

Después de crear correctamente el nuevo cliente de Android en el proyecto de destino , realiza de inmediato lo siguiente:

  • Redirecciona clientes: Usa tu mecanismo de configuración dinámica (como Remote Config) para cambiar de inmediato la aplicación cliente de modo que comience a usar el nuevo ID de cliente web.
  • Conserva los clientes antiguos: Conserva los clientes de OAuth antiguos como una opción de resguardo para revertir el acceso al cliente de OAuth anterior si surge algún problema.