Registro de alterações

API Data Plan Agent

Dezembro de 2019

  1. Introdução da definição da API registrar CPID para implementação da DPA.
  2. Adicionamos sugestões sobre como gerar e armazenar o CPID quando o cliente solicita um novo CPID.
  3. Adicionamos documentação sobre como escolher o CPID a ser usado para enviar notificações.
  4. Esclarecemos como determinar as preferências de idioma do usuário quando o GTAF chama o DPA e vice-versa.

Outubro de 2019

  1. Exigir um novo CPID sempre que entrarmos em contato com o endpoint do CPID. Isso pode ser feito adicionando uma marcação de tempo ao algoritmo de geração de CPID.
  2. Remova planLanguage de Offer, que até agora era marcado como um campo obrigatório.

Setembro de 2019

  1. Adicionamos suporte para notificações de expiração de dados, que são diferentes das notificações de aviso de expiração de dados.

Julho de 2019

  1. Esclarecemos os possíveis valores de identificador do cliente.
  2. Adicionamos suporte para notificações de recarga de conta.
  3. Requisitos de geração de CPID flexibilizados, que não exigem um novo CPID sempre que o endpoint de CPID é chamado.
  4. Adicione documentação para diferentes respostas de erro do GTAF ao chamar a API Mobile Data Plan Sharing.

Junho de 2019

  1. Atualização da especificação da API DPA, exigindo que as operadoras aceitem um _clientid como um parâmetro de consulta.
  2. API Mobile Data Plan Sharing atualizada, permitindo que as operadoras compartilhem informações do plano de um usuário para um cliente específico com o Google.
  3. A ordem em que as ofertas são mostradas ao usuário pode não ser a mesma em que são fornecidas ao GTAF.
  4. O GTAF pode compartilhar mais de 10 planos com a interface do plano de dados móveis.

Maio de 2019

  1. ExpirationTime é obrigatório, a menos que o plano não expire.
  2. De acordo com a RFC 6749, marque token_type como obrigatório na resposta do servidor OAuth.
  3. Retorna o tipo de notificações enviadas ao usuário quando a operadora envia um status de plano para o GTAF.

Abril de 2019

  1. AccountInfo é obrigatório para assinantes pré-pagos.
  2. Atualizamos o método recomendado de geração de CPID para incluir o idioma no texto simples ao gerar o CPID.
  3. A compatibilidade com moreInfoUrl, operatorLogoUrl e purchaseUrl foi removida das ofertas. Esses campos não eram compatíveis com a interface do plano de dados móveis. A mudança é compatível com versões anteriores.
  4. Adicionamos suporte para o envio de notificações quando um usuário está gastando o saldo da conta usando dados em um estado de pagamento conforme o uso.
  5. Remoção da compatibilidade com janelas de tempo flexíveis dos módulos de plano. A mudança é compatível com versões anteriores. Portanto, se um operador estiver nos enviando janelas de tempo flexíveis, a resposta será aceita.

Março de 2019

  1. Remova offerInfo.promoMessage do conjunto de campos obrigatórios. A MDP não usa esse campo ao mostrar ofertas aos usuários.
  2. Correção de um bug na documentação que dizia que o CPID precisava ser codificado em URL. Em vez disso, o GTAF codifica o CPID de acordo com a RFC2396.
  3. Adição de requisitos para notificações push.

Fevereiro de 2019

  1. A compatibilidade com o compartilhamento de PlanOffer com o Google usando a API de compartilhamento de plano de dados foi removida.

Janeiro de 2019

  1. Adicionamos um guia para atualizar a configuração da operadora usando o portal do ISP.
  2. Adição de um guia para a implementação do OAuth na API Data Plan Agent.
  3. Renomeamos e reorganizamos o guia de integração da API Mobile Data Plan Sharing.

Novembro de 2018

  1. Adição de suporte para notificações de ativação de plano.
  2. Adição de suporte para uma categoria de tráfego do módulo de plano APP_STORE.

Setembro de 2018

  1. Adicionamos uma API para informar o consentimento do usuário aos operadores.
  2. Adicionamos suporte a planos que atualizam periodicamente a cota para PlanModule e Offer.
  3. Agora é possível receber notificações de expiração.
  4. Renomeação de PlanModuleState para PlanState. Essa é uma mudança na documentação que não deve afetar os operadores.

Agosto de 2018

  1. Adicionamos a capacidade de as operadoras especificarem o saldo da conta como parte de um PlanStatus.

Junho de 2018

  1. Os métodos de atualização e de recebimento de status e ofertas de planos foram removidos.
  2. Permitiu que o nível de saldo aproximado fosse preenchido ao mesmo tempo que o saldo de bytes ou de tempo.
  3. Adição do tipo de conexão a uma Oferta.
  4. Adicionamos o campo plan module state ao PlanModule para permitir que um operador indique os planos que o usuário comprou, mas ainda não foram ativados. Esse campo não é obrigatório.
  5. DataPlan foi renomeado como Plan. Essa é uma mudança na documentação que não deve afetar os operadores.
  6. Adição do campo formOfPayment a PlanOffer para permitir que um operador especifique como o usuário vai pagar pela compra. O padrão é "deduzido do saldo do plano".

Maio de 2018

  1. Atualizamos a resposta de CPID para manter a compatibilidade com versões anteriores.
  2. Adicionamos um título para um PlanStatus. O título será usado para preencher o cabeçalho na interface de configurações.
  3. Adição do nome do módulo e dos bytes usados para um PlanModule.
  4. Adicionamos um callback de resposta de compra ao GTAF.

Março de 2018

Esta atualização inclui as seguintes mudanças na API Data Plan Agent. Essas mudanças são relativas à API Data Plan v4.2 hospedada aqui.

  1. Descontinua as seguintes chamadas de API:
    1. Consulta da conta de usuário (DPA_URL/{data_plan_key_string}/account).
    2. Consultar planos comprados (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Muda o URL que chamamos para o status do plano de dados. O novo URL é descrito aqui. A autoridade de proteção de dados deve retornar uma instância de PlanStatus.
  3. Muda o URL que chamamos para ofertas de plano. O novo URL é descrito aqui. A DPA deve retornar uma instância de PlanOffer.
  4. Muda o corpo da solicitação enviada à DPA ao comprar um plano. Observe que a chamada de API é a mesma. O corpo da solicitação agora contém uma instância de TransactionRequest. Observe a remoção de um nível de aninhamento em comparação com a versão anterior da API.
  5. A resposta a uma solicitação de compra mudou. Aproveitamos o tipo de moeda definido pelo Google protobuf. Em resposta a uma compra bem-sucedida, esperamos que o corpo da resposta contenha uma instância de TransactionResponse.
  6. Se um plan_id não for especificado, a API Eligibility vai retornar todos os planos de dados a que o usuário tem direito. Antes, isso era opcional.
  7. Adiciona um endpoint de registro de MSISDN para o GTAF registrar MSISDNs para notificações com a DPA.

API Google Mobile Data Plan Sharing

Março de 2018

Esta atualização inclui as seguintes mudanças na API Google Mobile Data Plan Sharing:

  1. Introduz novas chamadas de API, permitindo que um operador envie informações de oferta de upselling para o GTAF, que serão enviadas para os dispositivos dos usuários. Essas novas chamadas permitem que um operador envie ofertas ao Google.
  2. Introduz um campo de data/hora da última atualização em um PlanGroup.
  3. Remove o campo de porcentagem de crédito de dados da janela de tempo flexível.