Requisitos
Es posible que GTAF emita la siguiente solicitud de elegibilidad para verificar si un usuario es apto para comprar un plan.
GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}
Ten en cuenta que planId es el identificador único del plan que se puede usar para comprarlo en nombre del usuario (consulta Compra de datos).
Si no se especifica planId, el DPA DEBE devolver todos los planes que puede comprar ese usuario.
En Casos de error, se enumeran las respuestas que se esperan del DPA en caso de error. Además, el DPA DEBE devolver un error en los siguientes casos:
- El DPA devuelve un código de error 400 BAD REQUEST que indica al GTAF que
planIdno es válido. - La DPA devuelve un código de error 409 CONFLICT que indica que
planIdes incompatible con el plan de datos del usuario.
De lo contrario, la DPA DEBE devolver una respuesta 200-OK. El formato de una EligibilityResponse correcta es el siguiente:
{
"eligiblePlans":
[
{
"planId": string, // Plan identifier. Can be used to
// refer to the plan during
// offers, etc. (req.)
}
]
}
Cuando la solicitud incluye un planId, la respuesta solo incluye ese plan. De lo contrario, la lista incluye todos los planes que el usuario es apto para comprar. En el caso de que planId esté vacío y el DPA no admita la devolución de la lista de planes aptos, DEBE devolver un error 400 BAD REQUEST.
Experiencias 5G en Android
La GTAF permite que los operadores compartan el estado de medición por tipo de conexión para los suscriptores. GTAF puede extraer la información de forma periódica, o bien los operadores pueden enviarla según activadores internos.
API de extracción
El dispositivo puede extraer la información de medición a través de GTAF de la siguiente manera:
GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo
Ten en cuenta que el DPA (agente de planes de datos) representa un servidor de GW de API o de derechos en la red del operador.
userKey es el token de autenticación establecido durante la fase de autenticación inicial, como se define aquí.
client_id es AndroidSystemInfo
El estado de medición de uso se proporciona como un ENUM.
El DPA debe devolver una respuesta 200 OK y debe incluir planInfoPerClient. El control de errores para el DPA se define aquí.
En el modelo de extracción, GTAF actúa como cliente y valida el certificado SSL de la DPA. GTAF se autentica en DPA con el procedimiento de OAuth definido aquí.
API de Push
El operador también puede enviar la información de medición con los siguientes métodos según un evento de activación, p.ej., cambio de plan de precios, etc.
POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus
La DPA debe incluir planInfoPerClient en el cuerpo del mensaje. Las respuestas de error de GTAF se definen aquí.
En el modo de envío, GTAF autentica las solicitudes entrantes del DPA con el servidor OAuth2 de Google Cloud. Las solicitudes entrantes deben autenticarse como una cuenta de servicio que se haya incluido en la lista de entidades permitidas del ISP Portal para el ASN que representa el DPA. Además, consulta la guía de integración aquí para obtener más detalles.