Elegibilidad
GTAF PUEDE emitir la siguiente solicitud de elegibilidad a fin de 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 comprar el plan en nombre del usuario (consulta Compra de datos).
Si no se especifica planId, el APD DEBE mostrar todos los planes que pueda comprar ese usuario.
En Casos de error, se enumeran las respuestas esperadas de la APD en caso de un error. Además, la APD mostrará un error en los siguientes casos:
- La APD muestra un código de error 400 BAD REQUEST para indicarle al GTAF que
planIdno es válido. - La APD muestra un código de error 409 CONFLICT que indica que
planIdno es compatible con el plan de datos del usuario.
De lo contrario, la APD mostrará una respuesta 200-OK. El formato de una ElegibilidadResponse exitosa 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 puede comprar. En los casos en que planId esté vacío y el DPA no admita que se muestre la lista de planes aptos, DEBE mostrar un error 400 BAD REQUEST.
Experiencias de 5G de Android
El GTAF permite que los proveedores compartan el estado de medición por tipo de conexión para los suscriptores. El GTAF puede extraer la información periódicamente o los proveedores pueden enviarla en función de activadores internos.
API de extracción
El dispositivo puede extraer la información de la medición mediante GTAF mediante lo siguiente:
GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo
Ten en cuenta que DPA (agente del plan de datos) representa un servidor de derechos o un GW de API en la red del proveedor.
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 medida de medición se proporciona como ENUM.
DPA mostrará una respuesta 200 OK e incluirá planInfoPerClient. El manejo de errores para DPA se define aquí
En el modelo de extracción, GTAF actúa como un cliente y valida el certificado SSL del DPA. El GTAF se autentica por su cuenta en la APD mediante un procedimiento de OAuth que se define aquí.
API de Push
El proveedor también puede enviar la información de medición con la siguiente información en función de un evento de activación, p.ej., cambio de plan de precios, etcétera.
POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus
El APD debe incluir planInfoPerClient en el cuerpo del mensaje. Las respuestas de los errores de GTAF se definen aquí.
En el modo push, GTAF autentica las solicitudes entrantes de la DPA con el servidor OAuth2 de Google Cloud. Las solicitudes entrantes se deben autenticar como una cuenta de servicio que se incluyó en la lista blanca en el portal de ISP para el ASN que representa el APD. También puede consultar la guía de integración aquí para obtener más detalles.