Änderungsprotokoll

Data Plan Agent API

Dezember 2019

  1. Es wurde die register CPID API-Definition für den zu implementierenden DPA eingeführt.
  2. Es wurden Vorschläge zum Erstellen und Speichern der CPID hinzugefügt, wenn der Client eine neue CPID anfordert.
  3. Es wurde eine Dokumentation zur Auswahl der CPID hinzugefügt, die zum Senden von Benachrichtigungen verwendet werden soll.
  4. Es wurde klargestellt, wie die Spracheinstellungen des Nutzers beim Aufrufen der Datenschutzaufsichtsbehörde durch den GTAF und beim Aufrufen der GTAF durch die DPA festgelegt werden.

Oktober 2019

  1. Bei jedem Kontakt mit dem CPID-Endpunkt eine neue CPID verlangen. Fügen Sie dem Algorithmus zur CPID-Generierung einen Zeitstempel hinzu.
  2. Entfernen Sie planLanguage aus Offer, das bis jetzt als Pflichtfeld gekennzeichnet war.

September 2019

  1. Unterstützung für Benachrichtigungen bei Ablauf von Daten, getrennt von Warnungen zu Datenablauf.

Juli 2019

  1. Die möglichen Werte der Clientkennung wurden klarer formuliert.
  2. Kontoaufladebenachrichtigungen werden jetzt unterstützt.
  3. Die Anforderungen der CPID-Generierung müssen gelockert werden, sodass bei jedem Aufruf des CPID-Endpunkts eine neue CPID erforderlich ist.
  4. Dokumentation für verschiedene Fehlerantworten der GTAF beim Aufrufen der Mobile Data Plan Sharing API hinzufügen.

Juni 2019

  1. Die DPA API-Spezifikation wurde aktualisiert. Mobilfunkanbieter müssen eine _client-ID als Abfrageparameter akzeptieren.
  2. Wir haben die Mobile Data Plan Sharing API aktualisiert, damit Mobilfunkanbieter Tarifinformationen für einen bestimmten Kunden an Google senden können.
  3. Die Reihenfolge, in der dem Nutzer Angebote angezeigt werden, entspricht möglicherweise nicht der Reihenfolge, in der Angebote für GTAF angezeigt werden.
  4. GTAF kann mehr als 10 Pläne mit der Benutzeroberfläche für den mobilen Datentarif teilen.

Mai 2019

  1. ExpirationTime ist erforderlich, es sei denn, der Plan läuft nicht ab.
  2. Markieren Sie nach RFC 6749 „token_type“ in der OAuth-Serverantwort als erforderlich.
  3. Gibt den Benachrichtigungstyp zurück, der an den Nutzer gesendet wurde, wenn der Mobilfunkanbieter einen Tarifstatus an GTAF gesendet hat.

April 2019

  1. Für Prepaid-Abonnenten sind Kontoinformationen erforderlich.
  2. Aktualisieren Sie die empfohlene Methode zur CPID-Generierung, damit beim Generieren der CPID Sprache in den Nur-Text-Text aufgenommen wird.
  3. Die Unterstützung für „moreInfoUrl“, „operatorLogoUrl“ und „purchaseUrl“ wurde aus Angeboten entfernt. Diese Felder wurden von der Benutzeroberfläche für mobile Datentarife nicht unterstützt. Die Änderung ist abwärtskompatibel.
  4. Das Senden von Benachrichtigungen wird jetzt unterstützt, wenn ein Nutzer das Kontoguthaben mit „Pay as you go“-Daten nutzt.
  5. Die Unterstützung für flexible Zeiträume aus Planmodulen wurde entfernt. Die Änderung ist abwärtskompatibel. Wenn also ein Operator uns flexible Zeitfenster sendet, wird die Antwort akzeptiert.

März 2019

  1. Entfernen Sie „offerInfo.promoMessage“ aus den Pflichtfeldern. MDP verwendet dieses Feld nicht, wenn Nutzern Angebote angezeigt werden.
  2. Fehler in der Dokumentation beheben, bei dem die CPID URL-codiert sein muss. Stattdessen codiert GTAF die CPID nach RFC2396.
  3. Anforderungen für Push-Benachrichtigungen wurden hinzugefügt.

Februar 2019

  1. Die Unterstützung für die gemeinsame Nutzung von PlanOffer und Google über die Datenfreigabe-API wurde entfernt.

Januar 2019

  1. Eine Anleitung zum Aktualisieren der Mobilfunkanbieter-Konfiguration über das ISP-Portal wurde hinzugefügt.
  2. Es wurde ein Leitfaden für die OAuth-Implementierung für die Data Plan Agent API hinzugefügt.
  3. Der Integrationsleitfaden für die Mobile Data Plan Sharing API wurde umbenannt und umstrukturiert.

November 2018

  1. Benachrichtigungen über Tarifaktivierungen werden jetzt unterstützt.
  2. Unterstützung einer Traffic-Kategorie für das APP_STORE-Abomodul hinzugefügt.

September 2018

  1. API wurde hinzugefügt, um Operatoren die Nutzereinwilligung zu melden.
  2. Es werden jetzt Pläne unterstützt, bei denen das Kontingent regelmäßig auf PlanModule und Offer aktualisiert wird.
  3. Benachrichtigungen für Ablaufzeiten werden jetzt unterstützt.
  4. PlanModulState wurde in PlanState umbenannt. Diese Änderung an der Dokumentation hat keine Auswirkungen auf Operatoren.

August 2018

  1. Mobilfunkanbieter können den Kontostand im Rahmen eines PlanStatus angeben.

Juni 2018

  1. Update entfernt, Methoden zum Tarifstatus und Tarifangebote abrufen.
  2. Zulässiger grober Kontostand, der gleichzeitig mit Byte- oder Zeitsaldo gefüllt wird.
  3. Ein Verbindungstyp wurde zu einem Angebot hinzugefügt.
  4. Dem Feld PlanModule wurde das Feld Planmodulstatus hinzugefügt, damit ein Operator angeben kann, welche Pläne der Nutzer erworben, aber noch nicht aktiviert hat. Dies ist kein Pflichtfeld.
  5. DataPlan wurde in Plan umbenannt. Dies ist eine Änderung an der Dokumentation, die keine Auswirkungen auf Operatoren haben sollte.
  6. Das Feld formOfPayment wurde zu PlanOffer hinzugefügt, sodass ein Operator angeben kann, wie dem Nutzer der Kauf in Rechnung gestellt wird. Standardmäßig wird der Betrag vom Planguthaben abgezogen.

Mai 2018

  1. Die CPID-Antwort wurde aktualisiert, um die Antwort abwärtskompatibel zu halten.
  2. Titel für PlanStatus wurde hinzugefügt. Der Titel wird in der Überschrift der Einstellungs-UI verwendet.
  3. Modulname wurde hinzugefügt und Bytes für PlanModule wurden verwendet.
  4. Dem GTAF wurde ein Rückruf für die Kaufantwort hinzugefügt.

März 2018

Dieses Update umfasst die folgenden Änderungen an der Data Plan Agent API. Diese Änderungen beziehen sich auf die hier gehostete Data Plan API v4.2.

  1. Die folgenden API-Aufrufe werden eingestellt:
    1. Das Nutzerkonto (DPA_URL/{data_plan_key_string}/account) wird abgefragt.
    2. Gekaufte Pläne abfragen (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Ändert die URL, die für den Datentarifstatus aufgerufen wird. Die neue URL wird hier beschrieben. Der DPA muss eine Instanz von PlanStatus zurückgeben.
  3. Ändert die URL, die wir für Tarifangebote nennen. Die neue URL wird hier beschrieben. Der DPA muss eine Instanz von PlanOffer zurückgeben.
  4. Ändert den Text der Anfrage, die beim Kauf eines Plans an die Datenschutzbehörde gesendet wird. Der API-Aufruf ist identisch. Der Text der Anfrage enthält jetzt eine Instanz von TransactionRequest. Die Verschachtelungsebene im Vergleich zur vorherigen API-Version wurde entfernt.
  5. Die Antwort auf eine Kaufanfrage hat sich geändert. Wir nutzen den von Google Protokoll definierten Währungstyp. Nach einem erfolgreichen Kauf wird davon ausgegangen, dass der Antworttext eine Instanz von TransactionResponse enthält.
  6. Wenn plan_id nicht angegeben ist, MUSS die Eignungs-API alle Datenpläne zurückgeben, für die der Nutzer berechtigt ist. Bisher war das optional.
  7. Fügt einen MSISDN-Registrierungsendpunkt für GTAF hinzu, um MSISDNs für Benachrichtigungen beim DPA zu registrieren.

Google Mobile Data Plan Sharing API

März 2018

Dieses Update umfasst die folgenden Änderungen an der Google Mobile Data Plan Sharing API:

  1. Führt neue API-Aufrufe ein, mit denen ein Betreiber Upselling-Angebotsinformationen an GTAF senden kann, um sie weiter an die Nutzergeräte zu übertragen. Mit diesen neuen Aufrufen kann ein Betreiber Angebote an Google senden.
  2. Ein Feld für die letzte aktualisierte Zeit in einer PlanGroup wird eingeführt.
  3. Entfernt das Feld für den Prozentsatz der Datenguthaben aus dem Flex-Zeitfenster.