Google Play Integrity API: Cloud projesi bağlantısı ve kota kılavuzu

Google Play Integrity API,Google Play Console'da bir uygulamaya veya Play SDK Console'da bir SDK'ya bağlı olmayan Google Cloud projelerinden gelen trafiğe günde 10.000 istek sınırı uygular. Bu sınır, çoğu Google Cloud projesinde zaten etkindir. Daha önce artırılmış kotaya sahip az sayıda projeye, sınır uygulanmadan önce bağlantı işlemini tamamlamaları için 16 Şubat 2027'ye kadar ek süre tanındı.

Bu kılavuzda, proje bağlamanın kotanızı nasıl etkilediği ve Google Cloud projelerinizi uygulamanıza veya SDK'nıza nasıl bağlayacağınız açıklanmakta ve sık sorulan sorular yanıtlanmaktadır.

Kısa Özet

Önemli Ayrıntı Açıklama
Yaptırım Tarihi Çoğu proje için zaten etkindir.
Son tarih bildirimi alan projeler için 16 Şubat 2027.
Politika Uygulamanıza veya SDK'nıza bağlı olmayan Cloud projelerinden gelen Play Integrity API istekleri, projede daha yüksek bir özel kota yapılandırılmış olsa bile günde 10.000 istekle sınırlıdır.
Kimler etkilenir? Uygulamaya (Google Play Console'da) veya SDK'ya (Google Play SDK Console'da) bağlı olmayan bir Google Cloud projesi kullanarak günde 10.000'den fazla istekte bulunan uygulamalar ve SDK'lar.
İşlem Gerekli Google Cloud projelerinizi Google Play Console'da uygulamanıza veya Google Play SDK Console'da SDK'nıza bağlayın.
Kota Aşıldı Hatası Bağlantısı kaldırılan istekler,günde 10.000'i aşarsa TOO_MANY_REQUESTS hatası (hata kodu -8) ile başarısız olur.

Sık Sorulan Sorular

Play Integrity API,her Google Cloud projesine günlük 10.000 istekten oluşan varsayılan bir kota sağlar. Daha yüksek hacme ihtiyaç duyan geliştiriciler kota artışı isteğinde bulunabilir.

Uygulamanızı veya SDK'nızı korumak ve yetkisiz üçüncü tarafların kotanızı tüketmesini önlemek için artırılmış günlük kota, yalnızca Google Play Console'da uygulamanıza veya Google Play SDK Console'da SDK'nıza bağlı Google Cloud projeleriyle sınırlıdır.

Uygulamalar için (Google Play Console):

  1. Google Play Console'da oturum açıp uygulamanızı seçin.
  2. Soldaki gezinme menüsünde Google Play ile korunanlar bölümüne gidin.
  3. Play Integrity API'nin yanındaki Başlayın'ı (veya Yönet'i) seçin.
  4. Cloud projesi bağla'yı (veya bağlı projeleriniz varsa Proje ekle'yi) tıklayın.
  5. Bağlamak istediğiniz Google Cloud proje numarasını seçin veya girin ve onaylayın.

SDK'lar için (Google Play SDK Console):

  1. Google Play SDK Console'da oturum açıp SDK'nızı seçin.
  2. Soldaki gezinme menüsünde SDK bütünlüğü'ne gidin.
  3. Play Integrity API'nin yanındaki Ayarlar'ı tıklayın.
  4. Cloud projesi bağla'yı (veya zaten bağlı projeleriniz varsa Başka bir proje ekle'yi) tıklayın.
  5. Bağlamak istediğiniz Google Cloud proje numarasını seçin veya girin ve onaylayın.

Gerekli İzinler:

  • Google Play Console (uygulamalar için): Uygulama için "Üretim sürümüne yayınlama, cihazları hariç tutma ve Google Play Uygulama İmzalama'yı kullanma" iznine sahip olmanız gerekir.
  • Google Play SDK Console (SDK'lar için): SDK için "Yönetme" izninizin olması gerekir.
  • Google Cloud (her ikisi): Hedef Google Cloud projesinde "serviceusage.services.enable" ve "resourcemanager.projects.get" izinlerine sahip olmanız gerekir.

Uygulamalar için (Google Play Console):

  1. Google Play Console > Google Play ile Korunuyor > Google Play Integrity API > Yönet'i açın.
  2. Proje yapılandırması bölümünü kontrol edin.
  3. Listelenen proje numarasının, Play Integrity API'yi çağırmak için kullanılan numarayla eşleştiğinden emin olun.

SDK'lar için (Google Play SDK Console):

  1. Google Play SDK Console > SDK bütünlüğü > Ayarlar'ı açın.
  2. Proje yapılandırması bölümünü kontrol edin.
  3. Listelenen proje numarasının, Play Integrity API'yi çağırmak için kullanılan numarayla eşleştiğinden emin olun.

S4: Uygulamam veya SDK'm Google Play'de değilse Cloud projemi nasıl bağlarım?

Google Cloud projesi bağlama özelliği yalnızca Google Play Console'da yönetilen uygulamalar ve Google Play SDK Console'da kayıtlı SDK'lar için kullanılabilir.

Uygulamanız yalnızca Google Play dışında dağıtılıyorsa veya SDK'nız Play SDK Console'da yer almıyorsa Google Cloud projesi bağlayamazsınız. Bu durumda Play Integrity API trafiği, varsayılan olarak günlük 10.000 istekle sınırlı olur. Daha yüksek kotadan yararlanabilmek için uygulamanızı Google Play'de yayınlayın veya uygun SDK'nızı Google Play SDK Console'a kaydedip Cloud projenizi bağlayın.

S5: Birden fazla Google Cloud projesi bağlayabilir miyim veya bir projeyi uygulamalar ya da SDK'lar arasında paylaşabilir miyim?

  • Uygulama veya SDK başına birden fazla proje: Tek bir uygulamaya veya SDK'ya en fazla beş Google Cloud projesi bağlayabilirsiniz.
  • Birden fazla uygulamada tek bir proje: Aynı Google Cloud projesini Google Play Console'da birden fazla uygulamaya bağlayabilirsiniz. Aynı Google Cloud projesini birden fazla SDK'ya veya bir SDK ile bir uygulamaya bağlamak desteklenmez.

S6: Uygulamayı veya SDK'yı ben yönetiyorsam ancak Google Cloud projesinin sahibi kuruluşumdaki başka bir kullanıcıysa ne olur?

Bağlantının tamamlanması için Google Play Console'da (veya Google Play SDK Console'da) işlemi gerçekleştiren kullanıcının Google Cloud projesinde de gerekli izinlere sahip olması gerekir. Bunu iki şekilde yapabilirsiniz:

  • A seçeneği: Google Cloud projesinde IAM erişimini yönetebilen birinden, Google Hesabınıza geçici olarak "serviceusage.services.enable" ve "resourcemanager.projects.get" izinlerini vermesini isteyin. Bağlantı oluşturulduktan sonra günlük işlemler için bu izinler artık gerekli değildir.
  • B seçeneği: Google Cloud projesinde "serviceusage.services.enable" ve "resourcemanager.projects.get" izinlerine sahip bir ekip üyesine gerekli Console iznini vererek bağlama adımını gerçekleştirmesini sağlayın:
    • Uygulamalar için (Play Console): Uygulama için "Üretim sürümüne yayınlama, cihazları hariç tutma ve Play Uygulama İmzalama'yı kullanma" izni verin.
    • SDK'lar için (Google Play SDK Console): SDK için "Yönet" izni verin.

S7: Cloud projemi 16 Şubat 2027'den önce bağlamazsam ne olur?

Bir uygulama veya SDK, 16 Şubat 2027'den sonra bağlantılı olmayan bir Google Cloud projesi kullanarak Play Integrity API istekleri gönderirse:

  1. Günde 10.000'e kadar istek: İstekler,varsayılan temel kota kapsamında normal şekilde başarılı olmaya devam eder.
  2. Günde 10.000'den fazla istek: Bağlantısı kaldırılan proje günde 10.000 isteğe ulaştığında istekler TOO_MANY_REQUESTS hatasıyla (hata kodu -8) reddedilir.

Anında Self Servis Çözüm:

Uygulamanız veya SDK'nız, son tarihten sonra bir Cloud projesi bağlanmadığı için TOO_MANY_REQUESTS hataları alırsa eksik Google Cloud projesini Google Play Console veya Google Play SDK Console'a bağlayarak sorunu çözebilirsiniz.

S8: Play Integrity API'yi kullanmıyorum. Neden Cloud projemi bağlamamı isteyen bir mesaj aldım?

Google Cloud projeniz günde 10.000'den fazla bağlantısız Play Integrity API isteği oluşturduğu için bu bildirimi aldınız. Bu durumun yaygın nedenlerinden bazıları şunlardır:

  1. Cloud proje numaranızla yapılandırılmış bir kitaplık veya SDK: Bazı kitaplıklar, Google Cloud projenizi kullanarak Play Integrity API'yi çağırır. Uygulamanız veya SDK'nız bu tür bir kitaplık kullanıyorsa ilgili projeyi Play Console'da uygulamanıza veya Google Play SDK Console'da SDK'nıza bağlayın.
  2. Kuruluşunuzdaki başka bir uygulama veya ekip: Başka bir ekip, bu Google Cloud projesini kendi uygulamasında veya SDK'sında kullanıyor olabilir. Uygulamayı veya SDK'yı tanımlamak için mühendislik ekiplerinizle görüşün, ardından projeyi Google Play Console'a veya Google Play SDK Console'a bağlayın.
  3. Yetkisiz trafik veya kullanımdan kaldırılmış bir entegrasyon: Yetkisiz veya klonlanmış uygulamalar proje numaranızla istek gönderiyorsa ya da API'yi artık kullanmıyorsanız herhangi bir işlem yapmanız gerekmez. Günlük 10.000 bağlantısız istek sınırının geçerli olması,istenmeyen trafiği sınırlandırır.

İletişim ve destek

Cloud projenizi bağlama veya Play Integrity API kotanızı yönetme hakkında sorularınız varsa: