Entegrasyon Kılavuzu

Özel Anahtar Edinin

İlk Katılım Arayüzünü Kullanma

API ile entegrasyon için bir Google Cloud Projesi oluşturmanız gerekir. Bundan sonra bir hizmet hesabı oluşturun ve özel anahtar alın. Başlamak için aşağıdaki düğmeyi tıklayın:

Hizmet Hesabı Oluşturma

Manuel Olarak Anahtar Oluşturma

Yukarıdaki arayüz başarısız olursa lütfen aşağıdakileri deneyin:

  1. Google Cloud Console'a gidin.
  2. API'ye erişilecek projeyi seçin.
  3. Soldaki IAM ve yönetici menüsünün altında hizmet hesaplarını bulun ve projenin sahibi olacak yeni bir Hizmet Hesabı oluşturun.
  4. Hizmet hesabı oluşturulduktan sonra özel bir anahtar alırsınız.

Hizmet Hesabını Beyaz Listeye Ekleyin

Hizmet hesabı oluşturduktan sonra:

  1. Projenin sahibi olan bir Google hesabıyla mdp-support@google.com adresinden GTAF ekibine ulaşın. Mobil Veri Planı Paylaşımı API uç noktalarına erişmek için Google hesabını izin verilenler listesine ekleriz.
  2. Hizmet hesabını Google İSS Bağlantı Noktası'nda operatörle ilişkilendirin. Operatör bu ilişkilendirmeyi API Erişimi'ne giderek yapabilir.

Kitaplığı Etkinleştir

Beyaz listeye ekleme işlemi tamamlandığında:

  1. Google Cloud Console'u ziyaret edin.
  2. Üstteki menü çubuğundaki açılır listede doğru projeyi seçtiğinizden emin olun.
  3. API Kitaplığı'nda Mobil Veri Planı Paylaşım API'sini etkinleştirin.
  4. API Kitaplığı'nda Preprod Mobile Data Plan sharing API'yi etkinleştirin.

Test API Erişimi

Google yan yöntemlerine erişiminizi test etmek için:

  1. oauth2l uygulamasını yükleyin.

  2. Aşağıdaki şekilde hizmet hesabınız için bir erişim jetonu alın. your-service-account-key-file.json, hizmet hesabınızın önemli bir dosyasıdır.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Erişim jetonunun süresinin yaklaşık bir saat içinde dolacağını unutmayın. Yeni bir erişim jetonu için tekrar komut çalıştırmadan önce, yerel önbelleği temizlemek üzere oauth2l reset komutunu çalıştırın.

  3. Test çağrılarını aşağıdaki gibi yayınlayın. Entegrasyon işlemi sırasında GTAF'yi yapılandırırken bize gönderdiğiniz ASN'lerden biri YOUR-ASN olmalıdır. ACCESS-TOKEN-OBTAINED, oauth2l fetch komutunun sonucudur. PLAN_STATUS, GTAF'a göndermek istediğiniz PlanDurum istek gövdesidir.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Programatik API çağrıları

Aşağıdaki OAuth kapsamıyla Google tarafı yöntemlerine yetkili çağrı yapmak için talimatları uygulayın:

https://www.googleapis.com/auth/dataplansharing

Proje Sahipliğini Paylaşma

İlk kurulum tek bir Google hesabı içeriyor olsa da, yetkilendirilmiş bir kullanıcı grubunun proje sahibi olması iyi bir fikirdir. Google Cloud Console'da IAM ve yönetici menüsünün altında yeni üyeleri (Google grupları hesabı dahil) projenin sahibi olarak ekleyebilirsiniz.