Ek Kullanım Alanları

Uygunluk

GTAF, kullanıcının plan satın almaya uygun olup olmadığını kontrol etmek için aşağıdaki uygunluk isteğini gönderebilir.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

planId, planı kullanıcı adına satın almak için kullanılabilecek planın benzersiz tanımlayıcısıdır (bkz. Veri Satın Alma). planId belirtilmezse DPA, kullanıcı tarafından satın alınabilecek tüm planları döndürmelidir.

Hata durumları, hata durumunda DPA'dan beklenen yanıtları listeler. Ayrıca, Veri İşleme Sözleşmesi AŞAĞIDAKİ hata durumlarında hata döndürür:

• DPA, GTAF'ye planId öğesinin geçersiz olduğunu belirten bir 400 BAD REQUEST hata kodu döndürür.
• DPA, planId'nın kullanıcının veri planıyla uyumlu olmadığını belirten bir 409 CONFLICT hata kodu döndürür.

Aksi takdirde, DPA 200-OK yanıtı DÖNDÜRMELİDİR. Başarılı bir EligibilityResponse'un biçimi şöyledir:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

İstek planId içerdiğinde yanıtta yalnızca bu plan yer alır. Aksi takdirde, listede kullanıcının satın almaya uygun olduğu tüm planlar yer alır. planId boş olduğunda ve DPA, uygun planların listesini döndürmeyi desteklemediğinde 400 BAD REQUEST hatası döndürmelidir.

Android 5G Deneyimleri

GTAF, operatörlerin aboneler için bağlantı türü başına ölçüm durumunu paylaşmasına olanak tanır. Bilgiler, GTAF tarafından düzenli olarak alınabilir veya operatörler, bilgileri dahili tetikleyicilere göre gönderebilir.

Pull API

Cihaz, aşağıdakileri kullanarak GTAF üzerinden ölçülü bağlantı bilgilerini alabilir:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

DPA'nın (Veri Planı Aracısı) operatörün ağındaki bir API GW'yi veya Yetkilendirme sunucusunu temsil ettiğini unutmayın.

userKey, burada tanımlandığı gibi ilk kimlik doğrulama aşamasında oluşturulan kimlik doğrulama jetonudur.

client_id, AndroidSystemInfo'dur.

Ölçüm durumu ENUM olarak sağlanır.

DPA, 200 OK yanıtı döndürmeli ve planInfoPerClient'ı içermelidir. DPA için hata işleme burada tanımlanmıştır.

Çekme modelinde GTAF, istemci olarak hareket eder ve DPA'nın SSL sertifikasını doğrular. GTAF, burada tanımlanan OAuth prosedürünü kullanarak DPA'da kimliğini doğrular.

Push API

Operatör, aşağıdaki yöntemleri kullanarak ölçüm bilgisi gönderebilir. Bu yöntemler, tetikleyici bir etkinliğe (ör. fiyat planı değişikliği vb.) dayanır.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

Sözleşme, iletinin gövdesinde planInfoPerClient öğesini içermelidir. GTAF'den gelen hata yanıtları burada tanımlanmıştır.

GTAF, push modunda Google Cloud OAuth2 sunucusunu kullanarak DPA'dan gelen isteklerin kimliğini doğrular. Gelen isteklerin, DPA'nın temsil ettiği ASN için ISP Portal'da beyaz listeye alınmış bir hizmet hesabı olarak kimliği doğrulanmalıdır. Ayrıca, daha fazla bilgi için buradaki entegrasyon kılavuzuna bakın.