Değişiklik günlüğü

Data Plan Agent API

Aralık 2019

1. DPA'nın uygulaması için register CPID API tanımı kullanıma sunuldu.
2. İstemci yeni bir CPID istediğinde CPID'nin nasıl oluşturulacağı ve depolanacağıyla ilgili öneriler eklendi.
3. Bildirim göndermek için kullanılacak CPID'nin nasıl seçileceğiyle ilgili doküman eklendi.
4. GTAF, DPA'yı çağırdığında ve DPA, GTAF'yi çağırdığında kullanıcı dil tercihlerinin nasıl belirleneceği netleştirildi.

Ekim 2019

1. CPID uç noktasıyla her iletişim kurduğumuzda yeni bir CPID gerektirir. Bu, CPID oluşturma algoritmasına zaman damgası eklenerek yapılabilir.
2. Şimdiye kadar zorunlu alan olarak işaretlenen planLanguage, Offer'dan kaldırıldı.

Eylül 2019

1. Veri geçerlilik bitişi uyarı bildirimlerinden farklı olarak veri geçerlilik bitişi bildirimleri için destek eklendi.

Temmuz 2019

1. Olası istemci tanımlayıcı değerleri netleştirildi.
2. Hesaba para yükleme bildirimleri için destek eklendi.
3. CPID uç noktası her çağrıldığında yeni bir CPID oluşturulmasını gerektiren CPID oluşturma koşulları gevşetildi.
4. Mobile Data Plan Sharing API çağrılırken GTAF'den gelen farklı hata yanıtları için dokümanlar eklendi.

Haziran 2019

1. Taşıyıcıların _clientid değerini sorgu parametresi olarak kabul etmesini gerektiren güncellenmiş DPA API spesifikasyonu.
2. Operatörlerin belirli bir istemci için kullanıcının plan bilgilerini Google ile paylaşmasına olanak tanıyan Mobile Data Plan Sharing API güncellendi.
3. Tekliflerin kullanıcıya gösterilme sırası, GTAF'ye verilme sırasıyla aynı olmayabilir.
4. GTAF, Mobil Veri Planı kullanıcı arayüzü ile 10'dan fazla plan paylaşabilir.

Mayıs 2019

1. Planın süresi dolmuyorsa ExpirationTime gerekli değildir.
2. RFC 6749 uyarınca, OAuth sunucu yanıtında token_type'ı zorunlu olarak işaretleyin.
3. Operatör, GTAF'ye plan durumu gönderdiğinde kullanıcıya gönderilen bildirim türünü döndürür.

Nisan 2019

1. AccountInfo, ön ödemeli aboneler için gereklidir.
2. CPID oluşturulurken düz metne dilin de dahil edilmesi için önerilen CPID oluşturma yöntemi güncellendi.
3. Tekliflerde moreInfoUrl, operatorLogoUrl ve purchaseUrl desteği kaldırıldı. Bu alanlar, mobil veri planı kullanıcı arayüzü tarafından desteklenmiyordu. Bu değişiklik geriye dönük uyumludur.
4. Kullanıcı, kullandıkça öde durumundaki verileri kullanarak hesap bakiyesini harcadığında bildirim gönderme desteği eklendi.
5. Plan modüllerinde esnek zaman aralıkları desteği kaldırıldı. Bu değişiklik geriye dönük uyumludur. Bu nedenle, bir operatör bize esnek zaman aralıkları gönderiyorsa yanıt kabul edilir.

Mart 2019

1. Zorunlu alanlar kümesinden offerInfo.promoMessage'ı kaldırın. MDP, kullanıcılara teklif gösterirken bu alanı kullanmaz.
2. CPID'nin URL kodlamalı olması gerektiğini belirten doküman hatası düzeltildi. Bunun yerine, GTAF, CPID'yi RFC2396 uyarınca kodlar.
3. Push bildirimleriyle ilgili şartlar eklendi.

Şubat 2019

1. Veri planı paylaşımı API'si kullanılarak PlanOffer'ın Google ile paylaşılması desteği kaldırıldı.

Ocak 2019

1. İSS portalını kullanarak operatör yapılandırmasını güncelleme kılavuzu eklendi.
2. Veri Planı Aracısı API'si için OAuth uygulamasına yönelik kılavuz eklendi.
3. Mobile Data Plan Sharing API entegrasyon kılavuzunun adı değiştirildi ve kılavuz yeniden düzenlendi.

Kasım 2018

1. Plan etkinleştirme bildirimleri için destek eklendi.
2. APP_STORE plan modülü trafik kategorisi için destek eklendi.

Eylül 2018

1. Operatörlere kullanıcı izni bildirmek için API eklendi.
2. Kotasını düzenli olarak yenileyen planlar için PlanModule ve Offer desteği eklendi.
3. Son kullanma tarihi bildirimleri için destek eklendi.
4. PlanModuleState, PlanState olarak yeniden adlandırıldı. Bu, operatörleri etkilememesi gereken bir doküman değişikliğidir.

Ağustos 2018

1. Operatörlerin, PlanStatus'un bir parçası olarak hesap bakiyesini belirtme özelliği eklendi.

Haziran 2018

1. Plan durumu ve plan teklifleriyle ilgili yöntemler için güncelleme kaldırıldı.
2. Byte bakiyesi veya süre bakiyesi doldurulurken kaba bakiye düzeyinin aynı anda doldurulmasına izin verilir.
3. Fırsata bağlantı türü eklendi.
4. Bir operatörün, kullanıcının satın aldığı ancak henüz etkinleştirmediği planları belirtmesine olanak tanımak için PlanModule'a plan modülü durumu alanı eklendi. Bu alanın doldurulması zorunlu değildir.
5. DataPlan, Plan olarak yeniden adlandırıldı. Bu, operatörleri etkilememesi gereken bir dokümantasyon değişikliğidir.
6. PlanOffer'a formOfPayment alanı eklendi. Bu alan, operatörün kullanıcının satın alma işlemi için nasıl ücretlendirileceğini belirtmesine olanak tanır. Bu işlem varsayılan olarak plan bakiyesinden düşülür.

Mayıs 2018

1. Yanıtın geriye dönük uyumlu kalması için CPID yanıtı güncellendi.
2. PlanStatus için başlık eklendi. Başlık, ayarlar kullanıcı arayüzündeki başlığı doldurmak için kullanılır.
3. PlanModule için modül adı ve kullanılan baytlar eklendi.
4. GTAF'ye satın alma yanıtı geri araması eklendi.

Mart 2018

Bu güncelleme, Veri Planı Aracısı API'sinde aşağıdaki değişiklikleri içerir. Bu değişiklikler, burada barındırılan Data Plan API v4.2'ye göre yapılmıştır.

1. Aşağıdaki API çağrıları kullanımdan kaldırılıyor:
   1. Kullanıcı hesabı sorgulanıyor (DPA_URL/{data_plan_key_string}/account).
   2. Satın alınan planları sorgulama (DPA_URL/{data_plan_key_string}/purchasedPlans).
2. Veri planı durumu için çağırdığımız URL'yi değiştirir. Yeni URL burada açıklanmaktadır. DPA'nın PlanStatus örneği döndürmesi beklenir.
3. Plan teklifleri için çağırdığımız URL'yi değiştirir. Yeni URL burada açıklanmaktadır. DPA'nın PlanOffer örneği döndürmesi beklenir.
4. Plan satın alırken DPA'ya gönderilen isteğin gövdesini değiştirir. API çağrısının aynı olduğunu unutmayın. İsteğin metni artık TransactionRequest öğesinin bir örneğini içeriyor. API'nin önceki sürümüne kıyasla bir iç içe yerleştirme düzeyinin kaldırıldığını unutmayın.
5. Satın alma isteğine verilen yanıt değişti. Google protobuf tarafından tanımlanan para birimi türünden yararlanırız. Başarılı bir satın alma işlemine yanıt olarak, yanıt gövdesinin TransactionResponse örneğini içermesini bekliyoruz.
6. plan_id belirtilmezse uygunluk API'si, kullanıcının uygun olduğu tüm veri planlarını DÖNDÜRMELİDİR. Daha önce bu işlem isteğe bağlıydı.
7. GTAF'nin, DPA ile bildirimler için MSISDN'leri kaydetmesine olanak tanıyan bir MSISDN kayıt uç noktası ekler.

Google Mobile Data Plan Sharing API

Mart 2018

Bu güncelleme, Google Mobil Veri Planı Paylaşımı API'sinde aşağıdaki değişiklikleri içerir:

1. Bir operatörün, ek satış teklifi bilgilerini GTAF'ye göndermesine ve bu bilgilerin kullanıcı cihazlarına iletilmesine olanak tanıyan yeni API çağrıları sunar. Bu yeni çağrılar, bir operatörün Google'a teklif göndermesine olanak tanır.
2. PlanGroup'a son güncelleme zamanı alanı ekler.
3. Esnek zaman aralığından veri kredisi yüzdesi alanını kaldırır.