Registro modifiche

API Data Plan Agent

Dicembre 2019

  1. È stata introdotta la definizione dell'API register CPID per l'implementazione del DPA.
  2. Sono stati aggiunti suggerimenti su come generare l'ID cliente e memorizzarlo quando il cliente richiede un nuovo ID cliente.
  3. Aggiunta la documentazione su come scegliere l'ID contenuto da utilizzare per l'invio delle notifiche.
  4. È stato chiarito come determinare le preferenze di lingua dell'utente quando GTAF chiama il DPA e quando il DPA chiama GTAF.

Ottobre 2019

  1. Richiedi un nuovo CPID ogni volta che contattiamo l'endpoint CPID. Ciò può essere ottenuto aggiungendo un timestamp all'algoritmo di generazione dell'ID contenuto.
  2. Rimuovi planLanguage da Offer, che fino ad ora era contrassegnato come campo obbligatorio.

Settembre 2019

  1. È stato aggiunto il supporto per le notifiche di scadenza dei dati, distinte dalle notifiche di avviso di scadenza dei dati.

Luglio 2019

  1. Sono stati chiariti i possibili valori dell'identificatore client.
  2. È stato aggiunto il supporto per le notifiche di ricarica dell'account.
  3. Requisiti di generazione CPID meno rigidi, che non richiedono un nuovo CPID ogni volta che viene chiamato l'endpoint CPID.
  4. Aggiungi documentazione per le diverse risposte di errore di GTAF quando chiami l'API Mobile Data Plan Sharing.

Giugno 2019

  1. Specifiche dell'API DPA aggiornate che richiedono ai corrieri di accettare un _clientid come parametro di ricerca.
  2. API Mobile Data Plan Sharing aggiornata che consente agli operatori di condividere con Google le informazioni sul piano di un utente per un determinato client.
  3. L'ordine in cui le offerte vengono mostrate all'utente potrebbe non corrispondere a quello in cui vengono fornite a GTAF.
  4. GTAF potrebbe condividere più di 10 piani con l'interfaccia utente di Piano dati mobili.

Maggio 2019

  1. ExpirationTime è obbligatorio, a meno che il piano non scada.
  2. In base alla RFC 6749, contrassegna token_type come obbligatorio nella risposta del server OAuth.
  3. Restituisce il tipo di notifiche inviate all'utente quando l'operatore invia uno stato del piano a GTAF.

Aprile 2019

  1. AccountInfo è obbligatorio per gli abbonati prepagati.
  2. Aggiorna il metodo di generazione dell'ID CPID consigliato in modo da includere la lingua nel testo normale durante la generazione dell'ID CPID.
  3. Rimozione del supporto per moreInfoUrl, operatorLogoUrl e purchaseUrl dalle offerte. Questi campi non erano supportati dall'interfaccia utente del piano dati mobile. La modifica è compatibile con le versioni precedenti.
  4. È stato aggiunto il supporto per l'invio di notifiche quando un utente spende il saldo dell'account utilizzando i dati in uno stato di pagamento a consumo.
  5. È stato rimosso il supporto per le finestre di orario flessibile dai moduli del piano. La modifica è compatibile con le versioni precedenti. Pertanto, se un operatore ci invia finestre temporali flessibili, la risposta verrà accettata.

Marzo 2019

  1. Rimuovi offerInfo.promoMessage dal set di campi obbligatori. MDP non utilizza questo campo quando mostra le offerte agli utenti.
  2. Correggi il bug della documentazione che indica che l'ID CPID deve essere codificato nell'URL. GTAF codifica l'ID CPID in base a RFC2396.
  3. Aggiunti requisiti per le notifiche push.

Febbraio 2019

  1. È stato rimosso il supporto per la condivisione di PlanOffer con Google utilizzando l'API per la condivisione dei piani dati.

Gennaio 2019

  1. È stata aggiunta una guida per l'aggiornamento della configurazione dell'operatore utilizzando il portale ISP.
  2. È stata aggiunta una guida per l'implementazione di OAuth per l'API Data Plan Agent.
  3. È stata rinominata e riorganizzata la guida all'integrazione dell'API Mobile Data Plan Sharing.

Novembre 2018

  1. È stato aggiunto il supporto per le notifiche di attivazione del piano.
  2. Aggiunto il supporto per una categoria di traffico del modulo del piano APP_STORE.

Settembre 2018

  1. È stata aggiunta un'API per segnalare il consenso degli utenti agli operatori.
  2. È stato aggiunto il supporto per i piani che aggiornano periodicamente la quota a PlanModule e Offer.
  3. È stato aggiunto il supporto per le notifiche di scadenza.
  4. Rinominato PlanModuleState in PlanState. Si tratta di una modifica della documentazione che non dovrebbe influire sugli operatori.

Agosto 2018

  1. È stata aggiunta la possibilità per gli operatori di specificare il saldo dell'account come parte di un PlanStatus.

Giugno 2018

  1. Sono stati rimossi i metodi di aggiornamento e recupero per lo stato del piano e le offerte del piano.
  2. Il livello di saldo approssimativo consentito deve essere compilato contemporaneamente al saldo dei byte o del tempo.
  3. Aggiunto il tipo di connessione a un'offerta.
  4. È stato aggiunto il campo Stato del modulo del piano a PlanModule per consentire a un operatore di indicare i piani che l'utente ha acquistato ma non sono ancora stati attivati. Questo campo non è obbligatorio.
  5. DataPlan è stato rinominato in Piano. Si tratta di una modifica della documentazione che non dovrebbe influire sugli operatori.
  6. È stato aggiunto il campo formOfPayment a PlanOffer, consentendo a un operatore di specificare come verrà addebitato l'acquisto all'utente. Per impostazione predefinita, l'importo viene detratto dal saldo del piano.

Maggio 2018

  1. Aggiornamento della risposta CPID per mantenere la compatibilità con le versioni precedenti.
  2. Aggiunto il titolo per un PlanStatus. Il titolo verrà utilizzato per compilare l'intestazione nella UI delle impostazioni.
  3. Aggiunti nome del modulo e byte utilizzati per un PlanModule.
  4. È stato aggiunto un callback di risposta all'acquisto a GTAF.

Marzo 2018

Questo aggiornamento include le seguenti modifiche all'API Data Plan Agent. Queste modifiche sono relative all'API Data Plan v4.2 ospitata qui.

  1. Ritira le seguenti chiamate API:
    1. Query dell'account utente (DPA_URL/{data_plan_key_string}/account).
    2. Query sui piani acquistati (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Modifica l'URL che chiamiamo per lo stato del piano dati. Il nuovo URL è descritto qui. Il DPA dovrebbe restituire un'istanza di PlanStatus.
  3. Modifica l'URL che chiamiamo per le offerte dei piani. Il nuovo URL è descritto qui. È previsto che DPA restituisca un'istanza di PlanOffer.
  4. Modifica il corpo della richiesta inviata a DPA quando acquisti un piano. Tieni presente che la chiamata API è la stessa. Il corpo della richiesta ora contiene un'istanza di TransactionRequest. Tieni presente la rimozione di un livello di nidificazione rispetto alla versione precedente dell'API.
  5. La risposta a una richiesta di acquisto è cambiata. Sfruttiamo il tipo di valuta definito da Google protobuf. In risposta a un acquisto riuscito, prevediamo che il corpo della risposta contenga un'istanza di TransactionResponse.
  6. Se non viene specificato un plan_id, l'API di idoneità DEVE restituire tutti i piani tariffari per cui l'utente è idoneo. In precedenza, questo campo era facoltativo.
  7. Aggiunge un endpoint di registrazione MSISDN per GTAF per registrare MSISDN per le notifiche con il DPA.

API Google Mobile Data Plan Sharing

Marzo 2018

Questo aggiornamento include le seguenti modifiche all'API Google Mobile Data Plan Sharing:

  1. Introduce nuove chiamate API che consentono a un operatore di inviare informazioni sulle offerte di upselling a GTAF, che a sua volta le invia ai dispositivi degli utenti. Queste nuove chiamate consentono a un operatore di inviare offerte a Google.
  2. Introduce un campo dell'ora dell'ultimo aggiornamento in un PlanGroup.
  3. Rimuove il campo della percentuale di credito dati dalla finestra temporale flessibile.