Log delle modifiche

API Data Plan Agent

Dicembre 2019

  1. Introdotta la definizione dell'API registrazione CPID per la DPA da implementare.
  2. Sono stati aggiunti suggerimenti su come generare il CPID e archiviarlo quando il client richiede un nuovo CPID.
  3. È stata aggiunta la documentazione su come scegliere il CPID da utilizzare per l'invio delle notifiche.
  4. È stato chiarito come determinare le preferenze relative alla lingua degli utenti quando GTAF chiama l'ETD e quando DPA lo chiama.

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 CPID.
  2. Rimuovi planLanguage da Offer, che fino a questo momento era contrassegnato come campo obbligatorio.

Settembre 2019

  1. Aggiunto il supporto per le notifiche di scadenza dei dati, che si distinguono dalle notifiche di avviso di scadenza dei dati.

Luglio 2019

  1. È stato chiarito i possibili valori dell'identificatore client.
  2. Aggiunto il supporto per le notifiche di ricarica dell'account.
  3. Requisiti di generazione CPID rilassati per richiedere un nuovo CPID ogni volta che viene chiamato l'endpoint CPID.
  4. Aggiungi la documentazione per le diverse risposte di errore di GTAF quando chiami l'API Mobile Data Plan Sharing.

Giugno 2019

  1. Specifica dell'API DPA aggiornata che richiede l'accettazione da parte degli operatori di un id client come parametro di ricerca.
  2. Aggiornamento dell'API Mobile Data Plan Sharing che consente agli operatori di condividere con Google le informazioni sui piani di un utente per un determinato cliente.
  3. L'ordine in cui le offerte vengono mostrate all'utente potrebbe non corrispondere a quello in cui le offerte vengono inviate a GTAF.
  4. GTAF può condividere più di 10 piani con l'UI del piano dati mobili.

Maggio 2019

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

Aprile 2019

  1. Per gli abbonati che prepagano sono necessari accountInfo.
  2. Aggiorna il metodo di generazione CPID consigliato per includere un linguaggio in testo normale al momento della generazione del CPID.
  3. È stato rimosso il supporto di moreInfoUrl, operatorLogoUrl, purchaseUrl dalle offerte. Questi campi non erano supportati dall'interfaccia utente del piano dati mobili. La modifica è compatibile con le versioni precedenti.
  4. Aggiunto il supporto per l'invio di notifiche quando un utente sta spendendo il saldo dell'account utilizzando i dati con pagamento a consumo.
  5. Rimosso il supporto per le finestre temporali flessibili 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 dall'insieme di campi obbligatori. MDP non utilizza questo campo quando mostra le offerte agli utenti.
  2. Correggi il bug della documentazione secondo cui il CPID deve essere codificato nell'URL. GTAF codifica invece il CPID in base al documento RFC2396.
  3. Sono stati aggiunti requisiti per le notifiche push.

Febbraio 2019

  1. Rimosso il supporto per la condivisione di PlanOffer con Google utilizzando l'API di condivisione del piano dati.

Gennaio 2019

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

Novembre 2018

  1. 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 dell'utente agli operatori.
  2. Aggiunto il supporto per i piani che aggiornano periodicamente la loro quota in PlanModule e Offerta.
  3. Aggiunto il supporto per le notifiche relative alla scadenza.
  4. PlanModuleState rinominato in PlanState. Questa è una modifica alla documentazione che non dovrebbe influire sugli operatori.

Agosto 2018

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

Giugno 2018

  1. Aggiornamento rimosso, visualizzazione dei metodi per lo stato e le offerte del piano.
  2. Livello di saldo approssimativo consentito da compilare nello stesso momento in cui viene completato il saldo byte o il saldo temporale.
  3. Tipo di connessione aggiunto 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 che non sono ancora stati attivati. Questo campo non è obbligatorio.
  5. DataPlan rinominato in Plan. Questa è una modifica alla documentazione che non dovrebbe influire sugli operatori.
  6. Aggiunto il campo formOfPayment a PlanOffer per consentire a un operatore di specificare la modalità di addebito per l'acquisto sull'utente. Il valore predefinito verrà detratto dal saldo del piano.

Maggio 2018

  1. È stata aggiornata la risposta CPID per mantenere la risposta compatibile con le versioni precedenti.
  2. Titolo aggiunto per un PlanStatus. Il titolo verrà utilizzato per completare l'intestazione nella UI delle impostazioni.
  3. Sono stati aggiunti il nome del modulo e i byte utilizzati per un PlanModule.
  4. Aggiunta una chiamata di risposta all'acquisto a GTAF.

Marzo 2018

Questo aggiornamento include le seguenti modifiche all'API del piano dati. Queste modifiche riguardano l'API Data Plan v4.2 ospitata qui.

  1. Ritira le seguenti chiamate API:
    1. Esecuzione di query sull'account utente (DPA_URL/{data_plan_key_string}/account).
    2. Esecuzione di 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. L'ETD dovrebbe restituire un'istanza di PlanStatus.
  3. Modifica l'URL che chiamiamo per le offerte del piano. Il nuovo URL è descritto qui. La DPA dovrebbe restituire un'istanza di PlanOffer.
  4. Modifica il corpo della richiesta inviata a DPA quando acquista un piano. Tieni presente che la chiamata API è la stessa. Il corpo della richiesta ora contiene un'istanza di TransactionRequest. Nota la rimozione di un livello di nidificazione rispetto alla versione precedente dell'API.
  5. La risposta a una richiesta di acquisto è cambiata. Utilizziamo il tipo di valuta definito dal protocollo Google. In risposta a un acquisto riuscito, ci aspettiamo che il corpo della risposta contenga un'istanza di TransactionResponse.
  6. Se plan_id non è specificato, l'API di idoneità DEVE restituire tutti i piani di dati per cui l'utente è idoneo. In precedenza, questa operazione era facoltativa.
  7. Aggiunge un endpoint di registrazione MSISDN per GTAF per registrare i MSISDN per le notifiche con l'ETD.

API Google Mobile Data Plan Sharing

Marzo 2018

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

  1. Introduce nuove chiamate API che consentono a un operatore di effettuare il push dell'upsell delle informazioni a GTAF, per estenderle ulteriormente ai dispositivi degli utenti. Queste nuove chiamate consentono a un operatore di inviare le offerte a Google.
  2. Presenta un campo Ultimo aggiornamento in un PlanGroup.
  3. Rimuove il campo percentuale di credito dati dalla finestra temporale flessibile.