Kurulum

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu sayfada, uygulamanızı veya oyununuzu Play Integrity API'yi kullanacak şekilde nasıl ayarlayacağınız açıklanmaktadır. API'nin yanıtlarını etkinleştirdikten sonra API'yi uygulamanıza ve uygulamanızın arka uç sunucusuna entegre etmeniz gerekir. Google Play Console'da Play Integrity API için kullandığınız Google Cloud projesini bağladıktan sonra ek yapılandırma seçeneklerini, test özelliklerini ve raporlamayı kullanabilirsiniz.

Play Integrity API yanıtlarını etkinleştirme

Play Integrity API'yi çağıran her uygulama veya SDK'nın, API kullanımını izlemek için bir Google Cloud projesi kullanması gerekir. Google Play'deki uygulamalar, Play Integrity API yanıtlarını etkinleştirmek için Google Play Console'da bir Cloud projesi bağlayabilir. Yeni bir Cloud projesi oluşturmak istiyorsanız veya uygulamanız yalnızca Google Play dışında dağıtılıyorsa Play Integrity API yanıtlarını Google Cloud Console'dan etkinleştirebilirsiniz.

Google Play Console'da ayarlama (önerilir)

Google Play Console'da Play Integrity API yanıtlarını etkinleştirerek ek yapılandırma seçeneklerine, test özelliklerine ve API raporlarına erişebilirsiniz. Bu seçenek yalnızca Google Play'de dağıtılan uygulamalar tarafından kullanılabilir. Sürüm > Uygulama bütünlüğü'ne gidin. Play Integrity API bölümünde Cloud projesi bağla'yı seçin. Uygulamanıza bağlamak istediğiniz Cloud projesini seçin. Bu işlem, Play Integrity API yanıtlarını etkinleştirir. Artık Play Integrity API'yi uygulamanıza entegre edebilirsiniz.

Google Cloud Console'da ayarlama

Google Cloud Console'da yeni bir Cloud projesi oluşturun veya Play Integrity API ile kullanmak istediğiniz mevcut bir Cloud projesini seçin. API'ler ve hizmetler'e gidin. API'leri ve hizmetleri etkinleştir'i seçin. Play Integrity API'yi arayıp etkinleştirin. Artık Play Integrity API'yi uygulamanıza entegre edebilirsiniz.

SDK sağlayıcılar için kurulum talimatları

SDK sağlayıcılar, Play Integrity API'yi çağırmak için kendi Google Cloud projelerini kullanmalıdır. Böylece API kullanımı, SDK'yı kullanan tekil uygulamalara değil, SDK'ya atfedilir. Bu, SDK'nızı kullanan uygulamaların Play Integrity API'yi ayrı ayrı ayarlamasının gerekmediği anlamına gelir. Play Integrity API'ye gönderdiğiniz istekler, uygulama yerine SDK'nızın API kullanımı için otomatik olarak sayılır.

SDK geliştiricileri, Play Integrity API'yi ayarlamak için Google Play SDK Console veya Google Cloud Console'u kullanabilir.

Google Play SDK Console'u kullanma (önerilir)

Google Play SDK Console'da Play Integrity API yanıtlarını etkinleştirerek ek yapılandırma seçeneklerine erişebilirsiniz. SDK bütünlüğü'ne gidin ve Ayarlar'ı tıklayın. Proje yapılandırması bölümünde Cloud projesi bağla'yı seçin. SDK'nıza bağlamak istediğiniz Cloud projesini seçin. Bu işlem, Play Integrity API yanıtlarını etkinleştirir. Artık Play Integrity API'yi SDK'nıza entegre edebilirsiniz. Google Play SDK Console'a erişimin uygunluk ölçütlerine tabi olduğunu unutmayın.

Google Cloud Console'u kullanma

Play Integrity API yanıtlarını Google Cloud Console'dan etkinleştirebilirsiniz. Google Cloud Console'da yeni bir Cloud projesi oluşturun veya Play Integrity API ile kullanmak istediğiniz mevcut bir Cloud projesini seçin. API'ler ve hizmetler'e gidin. API'leri ve hizmetleri etkinleştir'i seçin. Play Integrity API'yi arayıp etkinleştirin. Artık Play Integrity API'yi SDK'nıza entegre edebilirsiniz.

SDK'nızın günlük Play Integrity API istek sayısını artırma

Günlük maksimum istek sayısını artırmak isteyen SDK sağlayıcılar kota isteği formunu doldurmalıdır. Açık yorumlar bölümünde, SDK isteği gönderdiğinizi belirtin ve Maven koordinatlarınızı (groupId:artifactId) veya SDK'nızın URL'sini ekleyin.

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

Uygulamanız,uygulama başına günde maksimum 10.000 istek sınırına tabi olur. Uygulamanızın kullanıcılarından çok fazla istek geliyorsa aşağıdaki talimatları uygulayarak günlük sınırın yükseltilmesini talep edebilirsiniz.

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

Günlük maksimum istek sayınızın artırılması 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. Günlük sınır yükseltilse bile kullanıcı verilerini ve pili korumak için kullanıcı başına klasik istekleri sınırlamaya devam ederek yalnızca nadiren, yüksek değerli işlemlerle ilgili olanlara izin vermelisiniz.

Günlük maksimum istek sayınızda artış talep etmek için aşağıdakileri yapın:

1. Play Console'da Play Integrity API için kullandığınız Google Cloud projesini bağlayın.
2. Önerilen yeniden deneme stratejisi dahil olmak üzere API mantığını doğru şekilde uyguladığınızdan emin olun.
3. Bu formu kullanarak kota artışı isteyin.

Play Integrity API kotasının artırılması bir hafta kadar sürebilir. Bu nedenle, hizmetinizde kesinti yaşanmaması için Play Integrity API kullanımınızı Google Play Console'da veya Google Cloud Console'da izlemenizi önemle tavsiye ederiz. Burada kota uyarıları da ayarlayabilirsiniz.

Kota artışları, hem bütünlük jetonları oluşturmak için istemci çağrısına hem de bütünlük jetonlarının şifresini çözmek ve doğrulamak için sunucu çağrısına otomatik olarak uygulanır.

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 için en yeni Android kitaplığını Google'ın Maven deposundan edinebilirsiniz. Uygulamanızın build.gradle dosyasına aşağıdaki bağımlılık ekleyin:

implementation 'com.google.android.play:integrity:1.4.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

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

Geliştirme ortamınızı kurma

1. GitHub deposundan Play Unreal Engine eklentisini indirin.

2. Unreal Engine projenizdeki Plugins klasörüne GooglePlay klasörünü kopyalayın.

3. Unreal Engine projenizi açıp Düzenle → Eklentiler'i 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'ye ekleyin:

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

Yerel

Play Core Yerel SDK'sı 1.13.0 veya daha yeni bir sürümü yükleyin. Talimatlar için Play Core Native'in geliştirme ortamı kurulum kılavuzuna 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. Play Integrity API entegrasyonunuzu Play Console'da ayarlarsanız API yanıtınızı özelleştirebilirsiniz.

Varsayılan yanıtlar

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

Koşullu yanıtlar

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ı yanıtlar

Play Integrity API entegrasyonunuzu Play Console veya Play SDK Console'da ayarlarsanız API yanıtınızda bilgi almayı etkinleştirebilirsiniz.

API yanıtlarınızda değişiklik yapmak için Play Console'u ziyaret edin ve Sürüm > Uygulama bütünlüğü'ne gidin. Yanıtlar bölümünde, değişikliklerinizi düzenleyip kaydedin.

İsteğe bağlı cihaz bilgileri ve cihaz geri çağırma

Uygulamalar ve SDK'lar, cihaz bütünlüğü kararında ek cihaz etiketlerini etkinleştirebilir. Ek etiketleri almak için kaydolmanızın ardından, etiket kriterlerinin her biri karşılandığı takdirde bütünlük yanıtı aynı cihaz için birden çok etiket içerir. Arka uç sunucunuzu olası yanıtların aralığına göre farklı şekilde davranmak üzere hazırlayabilirsiniz. Örneğin, üç etiket (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY ve MEETS_BASIC_INTEGRITY) döndüren bir cihaz, yalnızca bir etiket (MEETS_BASIC_INTEGRITY) döndüren bir cihaza göre daha güvenilir bulunabilir.

Cihazınızda çalışan Android OS'in Android SDK sürümünü gösteren cihaz özelliklerini etkinleştirebilirsiniz. Gelecekte diğer cihaz özellikleriyle genişletilebilir.

Son cihaz etkinliği'ni etkinleştirebilirsiniz. Son cihaz etkinliği, LEVEL_1 (düşük istek sayısı) ile LEVEL_4 (yüksek istek sayısı) arasında bir düzey döndürür. Örneğin, uygulamanız için normalden çok daha yüksek bir etkinlik düzeyi döndüren bir cihaz, güvenilmeyen cihazlara dağıtılmak üzere çok sayıda bütünlük jetonu oluşturmaya çalışıyor olabilir.

Uygulamalar cihaz geri çağırma özelliğini de etkinleştirebilir. Cihaz geri çağırma, belirli cihazlarla ilişkili bazı özel cihaz verilerini depolamanı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ı cihaz bilgilerini ve cihaz geri çağırmayı etkinleştirdikten sonra API yanıtınız, kararda yeni cihaz bütünlüğü alanları ve yanıtları içerecektir:

İsteğe bağlı ortam ayrıntıları

Uygulamalar, ortam hakkında ek kararlar almayı etkinleştirebilir. Uygulama erişim riski; ekranı kaydedebilecek, yer paylaşımı gösterebilecek veya cihazı kontrol edebilecek başka uygulamaların çalışıp çalışmadığını size bildirir. Play Protect kararı, Play Protect'in cihazda etkinleştirilip etkinleştirilmediğini ve bilinen kötü amaçlı yazılım tespit edip etmediğini size bildirir.

Bu kararları almayı etkinleştirdikten sonra API yanıtınızda, kararla birlikte ortam ayrıntıları alanı 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.

Klasik istekler gönderdiğinizde, Google Play'in sunucuları varsayılan olarak uygulamanızın Play Integrity API ile etkileşime geçtiğinde kullandığı yanıt şifrelemesini yönetir. Bu varsayılan seçeneği kullanmanızı öneririz ancak aşağıdaki talimatları uygulayarak yanıt şifreleme anahtarlarınızı yönetmeyi ve indirmeyi de seçebilirsiniz.

Yanıt şifrelemenizi Google'ın yönetmesine izin verin (varsayılan ve önerilen)

Uygulamanızın güvenliğini korumak için Google'ın yanıt şifreleme anahtarlarınızı oluşturmasına ve yönetmesine izin vermeniz önerilir. Arka uç sunucunuz, yanıtların şifresini çözmek için Google Play'in sunucusunu arar.

Kendi yanıt şifreleme anahtarlarımı indirip yöneteceğim

Bütünlük değerlendirmesinin şifresini kendi güvenli sunucu ortamınızda yerel olarak çözmek istiyorsanız yanıt şifreleme anahtarlarınızı yönetebilir ve indirebilirsiniz. Yanıt şifreleme anahtarlarınızı yönetmek ve indirmek için Play Console'u kullanmanız ve uygulamanızın diğer dağıtım kanallarının yanı sıra Google Play'de de kullanılabilir olması gerekir. Google tarafından yönetilen yanıt şifreleme anahtarlarından kendi kendine yönetilen yanıt şifreleme anahtarlarına geçiş yapmak için aşağıdaki talimatları uygulayın.

Alınan jetonun şifresini istemci uygulamanızdan çözmemenizi veya doğrulamamanızı ve şifre çözme anahtarlarını istemci uygulamasına hiçbir zaman göstermemenizi hatırlatmak isteriz.

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

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

Yanıt şifrelemenizi şu anda Google yönetiyorsa ve yanıt şifreleme anahtarlarınızı kendiniz yönetmek ve indirmek istiyorsanız aşağıdaki adımları uygulayın:

1. Play Console'a giriş yapın.
2. Play Integrity API'yi kullanan bir uygulama seçin.
3. Soldaki menünün Sürüm bölümünde Uygulama bütünlüğü'ne gidin.
4. Play Integrity API'nin yanındaki Ayarlar'ı tıklayın.
5. Sayfanın Klasik istekler bölümünde, Yanıt şifrelemesi'nin yanındaki Düzenle'yi tıklayın.
6. Açılan pencerede Kendi yanıt şifreleme anahtarlarımı indirip yöneteceğim'i tıklayın.
7. Ortak anahtar yükleme talimatlarını uygulayın.
8. Pencerede yüklemenin başarılı olduğu gösterildikten sonra Kaydet'i tıklayın. Şifrelenmiş anahtarlarınız otomatik olarak indirilir.
9. Sunucu mantığınızı, yanıt şifreleme anahtarlarınızı kullanarak bütünlük jetonlarının şifresini yerel olarak, kendi güvenli sunucu ortamınızda çözecek ve doğrulayacak şekilde değiştirin.
10. (İsteğe bağlı) Yanıt şifreleme anahtarlarınızı kendiniz yönettiğinizde uygulamanız, yanıtın şifresini çözmek ve doğrulamak için Google Play'in sunucusuna geri dönebilir.

Yanıt şifreleme anahtarlarınızı kendiniz yönetiyorsanız ve yanıt şifrelemenizi Google'ın yönetmesine geçmek istiyorsanız aşağıdaki adımları uygulayın:

1. Sunucu mantığınızı, şifre çözme ve doğrulamayı yalnızca Google sunucularında yapacak şekilde değiştirin.
2. Play Console'a giriş yapın.
3. Play Integrity API'yi kullanan bir uygulama seçin.
4. Soldaki menünün Sürüm bölümünde Uygulama bütünlüğü'ne gidin.
5. Play Integrity API'nin yanındaki Ayarlar'ı tıklayın.
6. Sayfanın Klasik istekler bölümünde, Yanıt şifrelemesi'nin yanındaki Düzenle'yi tıklayın.
7. Açılan pencerede Yanıt şifrelemem Google tarafından yönetilsin (önerilir)'i tıklayın.
8. Değişiklikleri kaydet'i tıklayın.