Guía de integración

Obtener clave privada

Cómo usar la interfaz de integración

Para integrar la API, debes crear un proyecto de Google Cloud. Luego, crea una cuenta de servicio y obtén una clave privada. Para comenzar, haz clic en el siguiente botón:

Crear cuenta de servicio

Generando la clave de forma manual

Si la interfaz anterior falla, prueba lo siguiente:

  1. Ve a Google Cloud Console.
  2. Elige el proyecto con el que se accederá a la API.
  3. En el menú de administración de IAM a la izquierda, busca cuentas de servicio y crea una nueva cuenta de servicio que será la propietaria del proyecto.
  4. Una vez creada la cuenta de servicio, deberías recibir una clave privada.

Incluir la cuenta de servicio en la lista blanca

Una vez que hayas creado una cuenta de servicio:

  1. Comunícate con el equipo de GTAF a través de mdp-support@google.com con una Cuenta de Google que sea propietaria del proyecto. Incluiremos la Cuenta de Google en la lista blanca para acceder a los extremos de la API de Mobile Data Plan Sharing.
  2. Asocia la cuenta de servicio al proveedor en el Portal de ISP de Google. Para realizar esta asociación, el proveedor debe dirigirse a Acceso a la API.

Habilitar biblioteca

Una vez que la lista blanca esté lista:

  1. Visita Google Cloud Console.
  2. Asegúrate de haber seleccionado el proyecto correcto en el menú desplegable de la barra de menú superior.
  3. Habilita la API de uso compartido del plan de datos móviles en la Biblioteca de API.
  4. Habilita Preprod Mobile Data Plan Sharing API en la Biblioteca de API.

Prueba el acceso a la API

Para probar tu acceso a los métodos laterales de Google, haz lo siguiente:

  1. Instala oauth2l.

  2. Obtén un token de acceso para tu cuenta de servicio de la siguiente manera. your-service-account-key-file.json es un archivo de claves de tu cuenta de servicio.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Ten en cuenta que el token de acceso vence en aproximadamente una hora. Antes de volver a ejecutar el comando anterior para un nuevo token de acceso, ejecuta oauth2l reset a fin de borrar la caché local.

  3. Realiza llamadas de prueba de la siguiente manera. YOUR-ASN debe ser uno de los ASN que nos envías cuando configuramos GTAF durante el proceso de integración. ACCESS-TOKEN-OBTAINED es el resultado del comando de oauth2l fetch anterior. PLAN_STATUS es el cuerpo de la solicitud PlanStatus que deseas enviar a GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Llamadas a la API programática

Sigue las instrucciones para realizar llamadas autorizadas a los métodos laterales de Google, con el siguiente alcance de OAuth:

https://www.googleapis.com/auth/dataplansharing

Compartir la propiedad del proyecto

Si bien la configuración inicial implica una sola Cuenta de Google, es una buena idea que un grupo de usuarios autorizados tenga la propiedad del proyecto. En Google Cloud Console, en el menú de administración de IAM, puedes agregar miembros nuevos (incluida la cuenta de Grupos de Google) para que sean propietarios del proyecto.