Registro de cambios

API del agente de planes de datos

Diciembre de 2019

1. Se introdujo la definición de la API de register CPID para que la DPA la implemente.
2. Se agregaron sugerencias para generar el CPID y almacenarlo cuando el cliente solicite uno nuevo.
3. Se agregó documentación sobre cómo elegir el CPID que se usará para enviar notificaciones.
4. Se aclaró cómo determinar las preferencias de idioma del usuario cuando GTAF llama a la APD y cuando la DPA llama a GTAF.

octubre de 2019

1. Solicitar un CPID nuevo cada vez que nos comuniquemos con el extremo de CPID Para ello, agrega una marca de tiempo al algoritmo de generación de CPID.
2. Quita planLanguage de Offer, que hasta ahora se marcó como obligatorio.

Septiembre de 2019

1. Se agregó compatibilidad con las notificaciones de vencimiento de datos, que se distinguen de las notificaciones de advertencia de vencimiento de datos.

Julio de 2019

1. Se aclararon los valores posibles del identificador de cliente.
2. Se agregó compatibilidad con las notificaciones de recarga de cuentas.
3. Requisitos de generación de CPID flexibles que requieren un CPID nuevo cada vez que se llama al extremo CPID
4. Agrega documentación para diferentes respuestas de error de GTAF cuando llames a la API de Mobile Data Plan Sharing.

Junio de 2019

1. Se actualizó la especificación de la API de DPA que requiere que los proveedores acepten un _clientid como parámetro de consulta.
2. Se actualizó la API de uso compartido del plan de datos móviles que permite a los proveedores compartir la información del plan de un usuario de un cliente en particular con Google.
3. Es posible que el orden en que se muestran las ofertas al usuario no sea el mismo que el de GTAF.
4. Es posible que GTAF comparta más de 10 planes con la IU del plan de datos móviles.

Mayo de 2019

1. El vencimiento es obligatorio a menos que el plan no venza.
2. Según la RFC 6749, marca token_type como obligatorio en la respuesta del servidor OAuth.
3. Muestra el tipo de notificaciones que se enviaron al usuario cuando el proveedor envía el estado de un plan a GTAF.

Abril de 2019

1. Se requiere AccountInfo para los suscriptores de prepago.
2. Actualiza el método de generación de CPID recomendado para incluir el idioma en el texto sin formato cuando se genere el CPID.
3. Se quitó la compatibilidad con moreInfoUrl, operatorLogoUrl, purchaseUrl de las ofertas. Estos campos no eran compatibles con la IU del plan de datos móviles. El cambio es retrocompatible.
4. Se agregó compatibilidad para enviar notificaciones cuando un usuario gasta el saldo de la cuenta con datos de un plan prepago.
5. Se quitó la compatibilidad con los períodos flexibles de los módulos del plan. El cambio es retrocompatible. Por lo tanto, si un operador nos envía ventanas de tiempo flexible, se aceptará la respuesta.

Marzo de 2019

1. Quita los campos de informationInfo.promoMessage del conjunto de campos obligatorios. MDP no usa este campo cuando muestra ofertas a los usuarios.
2. Corrige el error de documentación que indica que el CPID debe estar codificado para URL. En cambio, GTAF codifica el CPID según la RFC2396.
3. Se agregaron requisitos para las notificaciones push.

Febrero de 2019

1. Se quitó la asistencia para compartir PlanOffer con Google mediante la API de uso compartido del plan de datos.

Enero de 2019

1. Se agregó una guía para actualizar la configuración del proveedor mediante el portal del ISP.
2. Se agregó una guía para la implementación de OAuth para la API del agente de planes de datos.
3. Se cambió el nombre y la organización de la guía de integración de la API de Mobile Data Plan Sharing.

noviembre de 2018

1. Se agregó compatibilidad con las notificaciones de activación del plan.
2. Se agregó compatibilidad para una categoría de tráfico del módulo del plan de APP_STORE.

Septiembre de 2018

1. Se agregó una API para informar el consentimiento de los usuarios a los operadores.
2. Se agregó compatibilidad con los planes que actualizan su cuota de forma periódica a PlanModule y Offer.
3. Se agregó compatibilidad con las notificaciones de vencimiento.
4. Se cambió el nombre de PlanModuleState a PlanState. Este es un cambio en la documentación que no debería afectar a los operadores.

Agosto de 2018

1. Se agregó la capacidad para que los proveedores especifiquen el saldo de la cuenta como parte de un PlanStatus.

Junio de 2018

1. Se quitaron las actualizaciones y se obtuvieron métodos para conocer el estado y las ofertas del plan.
2. Se permitió que el nivel de balanceo aproximado se propague al mismo tiempo cuando se completa el saldo de bytes o de tiempo.
3. Se agregó el tipo de conexión a una Oferta.
4. Se agregó el campo plan module state a PlanModule para permitir que un operador indique los planes que compró el usuario, pero que aún no se activaron. Este campo no es obligatorio.
5. Se cambió el nombre de DataPlan a Plan. Este es un cambio de documentación que no debería afectar a los operadores.
6. Se agregó el campo formOfPayment a PlanOffer, lo que permite que un operador especifique cómo se le cobrará al usuario por la compra. Esta opción predeterminada se deduce del saldo del plan.

Mayo de 2018

1. Se actualizó la respuesta CPID para que la respuesta sea retrocompatible.
2. Se agregó un título para un PlanStatus. El título se usará para propagar el encabezado en la IU de configuración.
3. Se agregó el nombre del módulo y los bytes usados para un PlanModule.
4. Se agregó una llamada de respuesta a la compra a GTAF.

Marzo de 2018

Esta actualización incluye los siguientes cambios en la API del Agente de planes de datos. Estos cambios se relacionan con la API de Plan de datos v4.2 aquí.

1. Se dieron de baja las siguientes llamadas a la API:
   1. Consultando la cuenta de usuario (DPA_URL/{data_plan_key_string}/account)
   2. Consultar planes comprados (DPA_URL/{data_plan_key_string}/purchasedPlans)
2. Cambia la URL a la que llamamos para el estado del plan de datos. La nueva URL se describe aquí. Se espera que el DPA muestre una instancia de PlanStatus.
3. Cambia la URL a la que llamamos para recibir ofertas del plan. La nueva URL se describe aquí. Se espera que el DPA muestre una instancia de PlanOffer.
4. Cambia el cuerpo de la solicitud enviada a la APD cuando compra un plan. Ten en cuenta que la llamada a la API es la misma. El cuerpo de la solicitud ahora contiene una instancia de TransactionRequest. Ten en cuenta la eliminación de un nivel de anidamiento en comparación con la versión anterior de la API.
5. La respuesta a una solicitud de compra cambió. Aprovechamos el tipo de moneda definido por el protobuf de Google. En respuesta a una compra exitosa, se espera que el cuerpo de la respuesta contenga una instancia de TransactionResponse.
6. Si no se especifica un plan_id, la API de elegibilidad DEBE mostrar todos los planes de datos para los que el usuario es apto. Anteriormente, era opcional.
7. Agrega un extremo de registro de MSISDN a GTAF a fin de registrar MSISDN para notificaciones con el DPA.

API de uso compartido de planes de datos de Google para celulares

Marzo de 2018

Esta actualización incluye los siguientes cambios en la API de uso compartido del plan de datos móviles de Google:

1. Se presentan nuevas llamadas a la API que permiten que un operador envíe información de ofertas de venta vertical al GTAF para que se envíe más abajo a los dispositivos de los usuarios. Estas nuevas llamadas permiten a un operador enviar ofertas a Google.
2. Presenta un campo de hora de última actualización en un PlanGroup.
3. Quita el campo de porcentaje de crédito de datos del período flexible.