Entegrasyon Kılavuzu

Özel anahtarı edinme

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

API ile entegrasyon için Google Cloud projesi oluşturmanız gerekir. Ardından, bir hizmet hesabı oluşturun ve özel anahtar edinin. Başlamak için aşağıdaki düğmeyi tıklayın:

Hizmet Hesabı Oluşturma

Anahtarı Manuel Olarak Oluşturma

Yukarıdaki arayüz çalışmazsa lütfen aşağıdakileri deneyin:

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

Hizmet hesabını izin verilenler listesine ekleme

Hizmet hesabı oluşturduktan sonra:

  1. Projenin sahibi olan bir Google Hesabı ile mdp-support@google.com adresinden GTAF ekibiyle iletişime geçin. Mobile Data Plan Sharing API uç noktalarına erişmek için Google Hesabı'nı beyaz listeye ekleriz.
  2. Hizmet hesabını Google ISP Portal'da operatörle ilişkilendirin. Operatör, API Erişimi'ne giderek bu ilişkilendirmeyi yapabilir.

Kitaplığı etkinleştirme

İzin verilenler listesine ekleme işlemi tamamlandıktan sonra:

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

Test API Access

Google tarafı yöntemlere erişiminizi test etmek için:

  1. oauth2l uygulamasını yükleyin.

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

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

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

  3. Aşağıdaki şekilde test aramaları yapın. YOUR-ASN, entegrasyon işlemi sırasında GTAF'yi yapılandırırken bize gönderdiğiniz ASNs'lerden biri olmalıdır. ACCESS-TOKEN-OBTAINED, yukarıdaki oauth2l fetch komutunun çıkışıdır. PLAN_STATUS, GTAF'ye göndermek istediğiniz PlanStatus 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ılar yapmak için talimatları uygulayın:

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

Proje sahipliğini paylaşma

İlk kurulum tek bir Google Hesabı ile yapılsa da yetkili kullanıcı grubunun projenin sahibi olması iyi bir fikirdir. Google Cloud Console'da, IAM ve yönetici menüsünde projeye sahip olacak yeni üyeler (Google Grupları hesabı dahil) ekleyebilirsiniz.