Kurulum

Bu sayfada, uygulamanızı, oyununuzu veya SDK'nızı Play Integrity API'yi kullanacak şekilde nasıl ayarlayacağınız açıklanmaktadır. API'yi entegre etmek için istek göndermeye başlamak üzere gerekli olan bir Google Cloud projeniz olmalıdır. Ardından Google Cloud projenizi Google Play Console'da (uygulamalar için) veya Google Play SDK Console'da (SDK'lar için) bağlayabilirsiniz. Ek yapılandırma seçeneklerine, test özelliklerine ve API raporlamasına erişmek için projenizi bağlamanız, günlük istek kotanızın artırılmasını talep etmeniz gerekir.

Play Integrity API'yi etkinleştirme

Play Integrity API'yi çağıran her uygulama veya SDK'nın, API'yi kullanmak ve kullanımı izlemek için bir Google Cloud projesi olmalıdır. Bu, tüm entegrasyonlar için zorunlu olan ilk adımdır. Play Integrity API'yi Google Cloud Console'da etkinleştirebilirsiniz. Alternatif olarak, doğrudan Cloud projenizi Google Play'e bağlamaya geçebilirsiniz. Bu durumda Play Integrity API sizin için etkinleştirilir.

Google Cloud Console'da yeni bir Cloud projesi oluşturun veya Play Integrity API ile kullanmak istediğiniz mevcut bir Cloud projesini seçin.

1. API'ler ve hizmetler'e gidin.
2. API'leri ve hizmetleri etkinleştir'i seçin.
3. Play Integrity API'yi arayın.
4. Etkinleştir'i tıklayın.

Artık Play Integrity API'yi uygulamanıza entegre edebilirsiniz. Gelişmiş özelliklere ve kota artışlarına erişmek için bağlama adımına geçmeniz gerekir.

Google Play'e bağlantı oluşturma (önerilir)

Bu talimatları uygulayarak uygulamanızı veya SDK'nızı Google Play'e bağlayın.

Google Play'deki uygulamalar ve oyunlar için

Google Play'de dağıtılan uygulamalar, ek özellikleri etkinleştirmek ve günlük API kotasının artırılmasını istemek için Google Play Console'da Google Cloud projelerini bağlamalıdır.

1. Google Play Console'u açıp uygulamanızı seçin.
2. Test ve sürüm > Uygulama bütünlüğü'ne gidin.
3. Play Integrity API bölümünde Cloud projesi bağla'yı tıklayın.
4. Play Integrity API ile kullanmayı planladığınız Google Cloud projesini seçin. Play Integrity API, proje için henüz etkinleştirilmemişse bağlama işlemi sırasında otomatik olarak etkinleştirilir.

Play SDK Console'daki SDK sağlayıcılar için

Google Play SDK Console'u kullanan SDK sağlayıcılar, Google Cloud projelerini bağlayarak API kullanımını SDK'ya atfedebilir (bunu kullanan tek tek uygulamalara değil), ek özellikleri etkinleştirebilir ve günlük API kotasının artırılmasını isteyebilir. Google Play SDK Console'a erişimin uygunluk ölçütlerine tabi olduğunu unutmayın.

1. Google Play SDK Console'u açıp SDK'nızı seçin.
2. SDK bütünlüğü'ne gidin.
3. Play Integrity API bölümünde Cloud projesi bağla'yı tıklayın.
4. Play Integrity API ile kullanmayı planladığınız Google Cloud projesini seçin. Play Integrity API proje için henüz etkinleştirilmemişse bağlama işlemi sırasında otomatik olarak etkinleştirilir.

Play Integrity API kullanım sınırlarını anlama

Uygulamanız veya SDK'nız, ilişkili Cloud Proje Numarası'na bağlı olarak günlük toplam 10.000 istek sınırına sahiptir. Daha yüksek bir hacim bekliyorsanız kota artışı isteğinde bulunabilirsiniz.

Günlük maksimum istek sayınızı artırma

Kota artışı, uygunluk ölçütlerine tabidir. Kota artışları hem istemci tarafı jeton oluşturma hem de sunucu tarafı şifre çözme çağrıları için geçerlidir. İsteklerin işlenmesi bir hafta kadar sürebilir. Google Cloud Console'da Play Integrity API kullanımınızı izlemenizi ve hizmetinizde kesinti olmaması için kota uyarıları ayarlamanızı öneririz.

Kota yükseltilse bile kullanıcı pili ve veri kullanımını korumak için klasik istekleri sınırlamaya devam ederek yalnızca nadiren, yüksek değerli işlemlerle ilgili olanlara izin verin.

Google Play'deki uygulamalar ve oyunlar için

Kota artışı için uygulamanızın diğer dağıtım kanallarının yanı sıra Google Play'de de kullanıma sunulmuş olması gerekir. Google Cloud projenizi Play Console'da uygulamanıza bağlamanız gerekir. Bağlantısı kaldırılmış projelerden gelen kota istekleri reddedilir.

Artış isteğinde bulunmak için:

1. İlgili Google Cloud projesini Play Console'da bağlayın.
2. Uygun yeniden deneme stratejileri de dahil olmak üzere API mantığını doğru şekilde uyguladığınızı doğrulayın.
3. Kota isteği formunu gönderin.

Play SDK Console'daki SDK sağlayıcılar için

Kota artışı için uygun olmak istiyorsanız SDK'nızın Google Play SDK Console'da hak talebinde bulunulmuş olması ve Cloud projenizin SDK'nıza bağlı olması gerekir. Google Play SDK Console'a erişim uygunluk ölçütlerine tabidir.

Artış isteğinde bulunmak için:

1. Google Play SDK Console'da Google Cloud projenizi bağlayın.
2. Google Play SDK Console destek formunu doldurun.

Açık yorumlar bölümünde kullanım alanınızı, yaptığınız API isteklerinin türünü (standart, klasik veya her ikisi), istekleri ne sıklıkta yaptığınızı ve istediğiniz günlük maksimum istek sayısını açıklayın.

Play Integrity API'yi uygulamanıza entegre etme

Play Integrity API'yi uygulamanıza veya SDK'nıza entegre etmek için geliştirme ortamınıza bağlı olarak aşağıdakilerden birini yapın:

Kotlin veya Java

Play Integrity API'nin en yeni Android kitaplığı Google'ın Maven deposunda mevcuttur. Uygulamanızın build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

implementation 'com.google.android.play:integrity:1.6.0'

Unity

Aşağıdaki bölümlerde, desteklenen Unity sürümleri, yükleme yöntemleri ve ortam kurulumu da dahil olmak üzere Unity projeleri için Google Play Integrity API'nin nasıl entegre edileceği ve ayarlanacağı açıklanmaktadır.

Desteklenen Unity sürümleri

• 2019.x, 2020.x ve daha yeni sürümlerin tümü desteklenmektedir.
• Unity 2018.x kullanıyorsanız 2018.4 veya daha yeni sürümler desteklenir.
• Unity 2017.x ve daha eski sürümler desteklenmez.

Geliştirme ortamınızı kurma

openupm add com.google.play.integrity

Unreal Engine

Aşağıdaki bölümlerde, Unreal Engine projeleri için Google Play Integrity API'nin nasıl entegre edileceği ve ayarlanacağı açıklanmaktadır.

Desteklenen Unreal Engine sürümleri

Eklenti, Unreal Engine 5.0 ve sonraki tüm sürümleri destekler.

Geliştirme ortamınızı kurma

1. Play Unreal Engine Plugin'i GitHub deposundan indirin.

2. Unreal Engine projenizdeki Plugins klasörünün içindeki GooglePlay klasörünü kopyalayın.

3. Unreal Engine projenizi açın ve Edit → Plugins'i (Düzenle → Eklentiler) tıklayın.

4. Google Play'i arayın ve Etkin onay kutusunu işaretleyin.

5. Oyun projesini yeniden başlatın ve derleme işlemini tetikleyin.

6. Projenizin Build.cs dosyasını açın ve PlayIntegrity modülünü PublicDependencyModuleNames bölümüne ekleyin:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayIntegrity");
   
       // ...
     }
   }
   

Yerel

Yerel kurulum kılavuzunu uygulayın. Daha fazla bilgi için Play Integrity'nin yerel API referans belgelerine bakın.

API yanıtlarını yapılandırma (isteğe bağlı)

API yanıtı, her istekte döndürülen varsayılan kararları içerir. Cloud projenizi Play Console veya Play SDK Console'da bağladıysanız API yanıtınızı ek bilgiler içerecek şekilde özelleştirebilirsiniz.

Varsayılan bütünlük kararları

Play Integrity API yanıtında varsayılan olarak aşağıdaki bütünlük değerlendirmeleri döndürülür:

Google Play Games for PC

PC Üzerinde Google Play Games'e dağıtım yapıyorsanız cihaz bütünlüğü kararında ek bir etiket almayı otomatik olarak kabul edersiniz:

İsteğe bağlı bütünlük değerlendirmeleri

Cloud projenizi Play Console veya Play SDK Console'da bağladıysanız ek bilgiler almayı etkinleştirebilirsiniz.

Değişiklik yapmak için Play Console'u ziyaret edip Test etme ve yayınlama > Uygulama bütünlüğü'ne gidin. Play Integrity API'nin yanındaki Ayarlar'ı tıklayın. Yanıtları değiştir'i tıklayın, değişikliklerinizi düzenleyip kaydedin.

Cihaz bilgileri

deviceIntegrity kararındaki ek cihaz etiketleri, uygulamanın üzerinde çalıştığı cihaz ortamı hakkında daha fazla bilgi verir. Tek bir cihaz, her bir etiketin ölçütlerini karşılıyorsa birden fazla etiket döndürür. Bu etiketleri, kademeli bir yaptırım stratejisi oluşturmak için kullanabilirsiniz. Örneğin, yalnızca bir etiket (MEETS_BASIC_INTEGRITY) döndüren bir cihaza kıyasla üç etiket (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY ve MEETS_BASIC_INTEGRITY) döndüren bir cihaza güvenmeyi tercih edebilirsiniz.

Cihaz özellikleri, cihazdaki Android OS'in Android SDK sürümünü gösterir. Gelecekte diğer cihaz özellikleriyle genişletilebilir.

Son cihaz etkinliği, LEVEL_1 (düşük sayıda istek) ile LEVEL_4 (yüksek sayıda istek) arasında bir düzey döndürür. Yüksek etkinlik seviyeleri, kötüye kullanım amaçlı olarak güvenilmeyen cihazlara dağıtılmak üzere aşırı sayıda jeton oluşturmak için kullanılan bir cihazı gösterebilir.

Cihaz hatırlama, belirli cihazlarla ilgili bazı özel, cihaz bazında verileri saklamanıza olanak tanır. Bu verileri, uygulamanız daha sonra aynı cihaza tekrar yüklendiğinde güvenilir bir şekilde alabilirsiniz.

İsteğe bağlı bilgileri etkinleştirdikten sonra API yanıtınızda kararla ilgili yeni alanlar ve yanıtlar yer alır:

Ortam ayrıntıları

Uygulama erişim riski; ekranı kaydetmek, yer paylaşımı görüntülemek veya cihazı kontrol etmek amacıyla başka uygulamaların çalıştırılıp çalıştırılmadığını bildirir. Google Play'in bildiği doğrulanmış erişilebilirlik hizmetleri bu kararın dışında tutulur.

Play Protect kararı, Google Play Protect'in cihazda etkinleştirilip etkinleştirilmediğini ve bilinen kötü amaçlı yazılım tespit edip etmediğini size bildirir.

İsteğe bağlı bilgileri etkinleştirdikten sonra API yanıtınızda kararla ilgili yeni alanlar ve yanıtlar yer alır:

Klasik istek ayarlarını yapılandırma (isteğe bağlı)

Yalnızca standart API istekleri göndermeyi planlıyorsanız bu bölümü atlayın.

Yanıt şifreleme varsayılan olarak Google Play tarafından yönetilir. Bu nedenle, arka uç çağrılarınız Google'ın sunucusunu arayarak değerlendirmelerin şifresini çözer. Alternatif olarak, güvenli sunucu ortamınızda yerel olarak şifre çözmek için anahtarları kendiniz yönetebilirsiniz.

Yanıt şifrelemenizin Google tarafından yönetilmesine izin verme (önerilir)

Uygulamanızın güvenliğini korumak için Google'ın anahtar oluşturmasına ve yönetmesine izin vermenizi öneririz. Arka ucunuz, yanıtların şifresini çözmek ve doğrulamak için Google Play'in sunucusunu arar.

Kendi şifreleme anahtarlarınızı yönetme

Kendi güvenli sunucu ortamınızda yerel olarak şifre çözmek için Play Console veya Play SDK Console'dan şifreleme anahtarlarını indirebilirsiniz. Bu özelliği kullanabilmek için uygulamanızın Google Play'de mevcut olması gerekir.

Play Console'da yanıt şifreleme yönetimi stratejinizi değiştirmeden önce, kesintileri önlemek için sunucunuzun Google Play'in sunucularındaki bütünlük jetonlarının şifresini çözüp doğrulayacak şekilde doğru yapılandırıldığından emin olun.

Google tarafından yönetilen ve kendi kendine yönetilen şifreleme anahtarları arasında geçiş yapma

1. Play Console'u açıp uygulamanızı seçin .
2. Test ve sürüm > Uygulama bütünlüğü'ne gidin.
3. Play Integrity API'nin yanındaki Ayarlar'ı tıklayın.
4. Klasik istekler bölümünde, Yanıt şifreleme'nin yanındaki Düzenle'yi tıklayın.

Kendinden yönetilen anahtarlara geçmek için:

1. Kendi yanıt şifreleme anahtarlarımı indirip yöneteceğim'i seçin ve ortak anahtarınızı yükleyin.
2. Şifrelenmiş anahtarlarınızı otomatik olarak indirmek için Kaydet'i tıklayın.
3. Güvenli arka uç sunucunuzu, bu anahtarları kullanarak yerel olarak şifre çözme işlemi yapacak şekilde güncelleyin.

Google tarafından yönetilen anahtarlara geçmek için:

1. Yanıt şifrelemem Google tarafından yönetilsin (önerilir)'i seçin.
2. Değişiklikleri kaydet'i tıklayın.