Guía de integración

Cómo obtener la clave privada

Cómo usar la interfaz de integración

Para realizar la integración con la API, debes crear un proyecto de Google Cloud. Después de eso, crea una cuenta de servicio y obtén una clave privada. Para comenzar, haz clic en el siguiente botón:

Crea una cuenta de servicio

Cómo generar 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 IAM y administración de la izquierda, busca las cuentas de servicio y crea una cuenta de servicio nueva que será la propietaria del proyecto.
  4. Una vez que se cree la cuenta de servicio, deberías recibir una clave privada.

Incluye la cuenta de servicio en la lista blanca

Después de crear una cuenta de servicio, haz lo siguiente:

  1. Comunícate con el equipo de GTAF a mdp-support@google.com con una Cuenta de Google que sea propietaria del proyecto. Incluiremos la Cuenta de Google en la lista de entidades permitidas para acceder a los extremos de la API de Mobile Data Plan Sharing.
  2. Asocia la cuenta de servicio con el operador en el portal de ISP de Google. Para ello, el operador debe ir a API Access.

Habilitar la biblioteca

Una vez que se haya completado la inclusión en la lista blanca, haz lo siguiente:

  1. Visita la consola de Google Cloud.
  2. Asegúrate de haber seleccionado el proyecto correcto en el menú desplegable de la barra de menú superior.
  3. Habilita la API de Mobile Data Plan Sharing en la biblioteca de APIs.
  4. Habilita la API de Preprod Mobile Data Plan Sharing en la biblioteca de APIs.

Prueba el acceso a la API

Para probar tu acceso a los métodos del servidor 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 obtener un nuevo token de acceso, ejecuta oauth2l reset para borrar la caché local.

  3. Emite llamadas de prueba de la siguiente manera. YOUR-ASN debe ser uno de los ASN que nos enviaste cuando configuramos GTAF durante el proceso de integración. ACCESS-TOKEN-OBTAINED es el resultado del comando 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áticas

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

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

Cómo compartir la propiedad del proyecto

Si bien la configuración inicial involucra una sola Cuenta de Google, es una buena idea que un grupo de usuarios autorizados sea propietario del proyecto. En la consola de Google Cloud, en el menú IAM y administración, puedes agregar miembros nuevos (incluida la cuenta de grupos de Google) para que sean propietarios del proyecto.