Ek Kullanım Alanları

Uygunluk

GTAF, bir 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ın kullanıcı adına plan satın almak için kullanılabilecek benzersiz tanımlayıcısıdır (Veri Satın Alma'ya bakın). planId belirtilmezse DPA'nın bu kullanıcı tarafından satın alınabilir tüm planları döndürmesi ZORUNLUDUR.

Hata durumları, hata durumunda DPA'dan beklenen yanıtları listeler. Ayrıca DPA, aşağıdaki hata durumlarında bir hata SAĞLAR:

• DPA, GTAF'ya planId öğesinin geçersiz olduğunu gösteren bir 400 BAD REQUEST hata kodu döndürür.
• DPA, planId ürünü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ı verir. Başarılı bir uygunlukResponse biçimi şu şekildedir:

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

İstek bir planId içeriyorsa yanıt yalnızca bu planı içerir. Aksi takdirde liste, kullanıcının satın almaya uygun olduğu tüm planları içerir. planId öğesinin boş olduğu ve DPA'nın uygun planların listesinin döndürülmesini desteklemediği durumlarda 400 BAD REQUEST hatası döndürmesi gerekir.

Android 5G Deneyimleri

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

Pull API'si

Cihaz, aşağıdaki bilgileri kullanarak sayaç bilgilerini GTAF üzerinden alabilir:

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

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

userKey, ilk kimlik doğrulama aşamasında burada tanımlanan kimlik doğrulama jetonudur.

client_id: AndroidSystemInfo

Metre durumu ENUM olarak sağlanır

DPA, 200 OK yanıtı döndürür ve planInfoPerClient değerini içerir DPA için hata işleme burada açıklanmıştır

Pull modelinde GTAF, istemci olarak çalışır ve DPA'nın SSL sertifikasını doğrular. GTAF, burada tanımlanan OAuth prosedürünü kullanarak DPA için kimliğini doğrular.

Push API

Operatör ayrıca bir tetikleme etkinliğine (ör. fiyat planı değişikliği) göre aşağıdakileri kullanarak sayaçlı bilgileri aktarabilir.

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

DPA, mesajın gövdesine planInfoPerClient ifadesini ekler. GTAF'dan gelen hata yanıtları burada tanımlanmaktadır

İtme modunda, GTAF DPA'dan gelen isteklerin kimliğini Google Cloud OAuth2 sunucusunu kullanarak doğrular. Gelen isteklerin, DPA'nın temsil ettiği ASN için İSS Portalı'nda beyaz listeye eklenmiş bir hizmet hesabı olarak kimliği doğrulanmalıdır. Daha fazla bilgi için buradaki entegrasyon kılavuzunu da inceleyin.