Registro de cambios

API de Data Plan Agent

Diciembre de 2019

  1. Se introdujo la definición de la API de register CPID para que el DPA la implemente.
  2. Se agregaron sugerencias para generar el CPID y almacenarlo cuando el cliente solicita 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 al DPA y cuando el DPA llama a GTAF.

Octubre de 2019

  1. Se requiere un CPID nuevo cada vez que nos comunicamos con el extremo de CPID. Esto se puede lograr agregando una marca de tiempo al algoritmo de generación de CPID.
  2. Se quitó planLanguage de Offer, que hasta ahora se marcaba como un campo 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 posibles valores del identificador del cliente.
  2. Se agregó compatibilidad con las notificaciones de recarga de la cuenta.
  3. Se relajaron los requisitos de generación de CPID, ya que ya no se requiere un CPID nuevo cada vez que se llama al extremo de CPID.
  4. Se agregó documentación para las diferentes respuestas de error de GTAF cuando se llama a la API de Mobile Data Plan Sharing.

Junio de 2019

  1. Se actualizó la especificación de la API de DPA para que los operadores acepten un _clientid como parámetro de consulta.
  2. Se actualizó la API de Mobile Data Plan Sharing, que permite a los operadores compartir con Google la información del plan de un usuario para un cliente en particular.
  3. El orden en que se muestran las ofertas al usuario puede no ser el mismo que el orden en que se proporcionan las ofertas al 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. ExpirationTime es obligatorio, a menos que el plan no venza.
  2. Según RFC 6749, marca token_type como obligatorio en la respuesta del servidor de OAuth.
  3. Devuelve el tipo de notificaciones que se enviaron al usuario cuando el operador envía un estado del plan a GTAF.

Abril de 2019

  1. AccountInfo es obligatorio para los suscriptores prepagos.
  2. Se actualizó el método recomendado de generación de CPID para incluir el idioma en el texto sin formato cuando se genera el CPID.
  3. Se quitó la compatibilidad con moreInfoUrl, operatorLogoUrl y 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 en un estado de pago por uso.
  5. Se quitó la compatibilidad con los períodos flexibles de los módulos de planificación. El cambio es retrocompatible. Por lo tanto, si un operador nos envía períodos flexibles, se aceptará la respuesta.

Marzo de 2019

  1. Quita offerInfo.promoMessage del conjunto de campos obligatorios. El MDP no usa este campo cuando muestra ofertas a los usuarios.
  2. Se corrigió un error en la documentación que indicaba que el CPID debía estar codificado como URL. En cambio, GTAF codifica el CPID según RFC2396.
  3. Se agregaron requisitos para las notificaciones push.

Febrero de 2019

  1. Se quitó la compatibilidad para compartir PlanOffer con Google a través de la API de uso compartido de planes de datos.

Enero de 2019

  1. Se agregó una guía para actualizar la configuración del operador con el portal del ISP.
  2. Se agregó una guía para la implementación de OAuth en la API de Data Plan Agent.
  3. Se cambió el nombre y se reorganizó 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 de planes.
  2. Se agregó compatibilidad con una categoría de tráfico del módulo de planes de APP_STORE.

Septiembre de 2018

  1. Se agregó una API para informar el consentimiento del usuario a los operadores.
  2. Se agregó compatibilidad con los planes que actualizan periódicamente su cuota en 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 operadores especifiquen el saldo de la cuenta como parte de un PlanStatus.

Junio de 2018

  1. Se quitaron los métodos de actualización y obtención del estado y las ofertas del plan.
  2. Nivel de saldo aproximado permitido que se puede completar al mismo tiempo que el saldo de bytes o el saldo de tiempo.
  3. Se agregó el tipo de conexión a una oferta.
  4. Se agregó el campo estado del módulo de plan a PlanModule para permitir que un operador indique los planes que compró el usuario, pero que aún no se activaron. Este no es un campo obligatorio.
  5. Se cambió el nombre de DataPlan a Plan. Este es un cambio en la 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 la compra. De forma predeterminada, se deduce del saldo del plan.

Mayo de 2018

  1. Se actualizó la respuesta de CPID para mantener la compatibilidad con versiones anteriores.
  2. Se agregó un título para un PlanStatus. El título se usará para completar el encabezado en la IU de configuración.
  3. Se agregaron el nombre del módulo y los bytes usados para un PlanModule.
  4. Se agregó una devolución de llamada de respuesta de compra a GTAF.

Marzo de 2018

Esta actualización incluye los siguientes cambios en la API de Data Plan Agent. Estos cambios se relacionan con la versión 4.2 de la API de Data Plan, que se aloja aquí.

  1. Se dejaron de usar las siguientes llamadas a la API:
    1. Consulta de la cuenta de usuario (DPA_URL/{data_plan_key_string}/account).
    2. Consultar los planes comprados (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Cambia la URL a la que llamamos para obtener el estado del plan de datos. La nueva URL se describe aquí. Se espera que la DPA devuelva una instancia de PlanStatus.
  3. Cambia la URL a la que llamamos para las ofertas de planes. La nueva URL se describe aquí. Se espera que el DPA devuelva una instancia de PlanOffer.
  4. Cambia el cuerpo de la solicitud que se envía al DPA cuando se 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 que se quitó un nivel de anidación en comparación con la versión anterior de la API.
  5. Cambió la respuesta a una solicitud de compra. Aprovechamos el tipo de moneda definido por Google protobuf. En respuesta a una compra exitosa, esperamos que el cuerpo de la respuesta contenga una instancia de TransactionResponse.
  6. Si no se especifica un plan_id, la API de elegibilidad DEBE devolver todos los planes de datos para los que el usuario es apto. Anteriormente, esta opción era opcional.
  7. Agrega un extremo de registro de MSISDN para que GTAF registre MSISDNs para notificaciones con la DPA.

API de Google Mobile Data Plan Sharing

Marzo de 2018

Esta actualización incluye los siguientes cambios en la API de Google Mobile Data Plan Sharing:

  1. Se introducen nuevas llamadas a la API que permiten que un operador envíe información de ofertas de ventas adicionales al GTAF para que se envíe a los dispositivos de los usuarios. Estas nuevas llamadas permiten que un operador envíe ofertas a Google.
  2. Se introduce 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.