Kayıt ve API anahtarları

Google Awareness API'yi kullanmak için uygulamanıza bir Google API anahtarı eklemeniz gerekir. İhtiyacınız olan API anahtarı türü, Android API anahtarıdır.

Tüm Android uygulamaları, özel anahtarını elinizde bulundurduğunuz bir dijital sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için uygulamanızı imzalama ile ilgili Android kılavuzuna bakın.

Android API anahtarları, belirli sertifika-paket çiftlerine bağlanır. Uygulamanızın kullanıcı sayısı ne olursa olsun, her sertifika için yalnızca bir anahtar gerekir.

Uygulamanız için anahtar almak üzere birkaç adım uygulamanız gerekir. Bu adımlar bu kılavuzda ayrıntılı olarak açıklanmış ve aşağıdaki şekilde özetlenmiştir:

1. Uygulamanızın sertifikası hakkında bilgi edinin.
2. Google Developers Console'da bir proje kaydedin ve projeye hizmet olarak User Context API'yi ekleyin.
3. Anahtar isteğinde bulunun.
4. Anahtarı uygulamanıza ekleyin. Bunu yapmak için uygulama manifestinize bir öğe ekleyin.

Uygulamanızın sertifika bilgilerini bulma

API anahtarı, uygulamanızın dijital sertifikasının kısa biçimine (SHA-1 parmak izi olarak bilinir) dayanır. Sertifikanızın SHA-1 parmak izini görüntülemek için önce doğru sertifikayı kullandığınızdan emin olun. Aşağıdaki iki sertifikadan birini seçebilirsiniz:

• Hata ayıklama sertifikası: Android SDK araçları, hata ayıklama derlemesi yaptığınızda bu sertifikayı otomatik olarak oluşturur. Bu sertifikayı yalnızca test ettiğiniz uygulamalarda kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulamayı yayınlamaya çalışmayın. Hata ayıklama sertifikası, Android geliştirici belgelerindeki Hata ayıklama derlemenizi imzalama bölümünde daha ayrıntılı olarak açıklanmıştır.
• Yayın sertifikası: Android SDK araçları, yayın derlemesi yaptığınızda bu sertifikayı oluşturur. Bu sertifikayı keytool programıyla da oluşturabilirsiniz. Uygulamanızı dünya genelinde yayınlamaya hazır olduğunuzda bu sertifikayı kullanın.

keytool hakkında daha fazla bilgi için Oracle dokümanlarına bakın.

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 ile başlayan satırda sertifikanın SHA-1 parmak izi bulunur. Parmak izi, iki nokta ile ayrılmış 20 adet iki basamaklı on altılı sayı dizisidir.

Google Developers Console'dan API anahtarı alma

Google Awareness API'yi kullanmaya başlamak için Anahtar al düğmesini tıklayın. Bu araç, işlem boyunca size yol gösteren ve Awareness API'yi otomatik olarak etkinleştiren Google Developers Console'a bağlanır.

Anahtar alma

Alternatif olarak, API anahtarı almak için aşağıdaki adımları uygulayın:

1. Google Developers Console'a gidin.
2. Bir proje seçin veya yeni bir proje oluşturun.
3. Awareness API'yi etkinleştirmek için Devam'ı tıklayın.

4. "Kimlik bilgileri" sayfasında bir Android anahtarı oluşturun ve API kimlik bilgilerini ayarlayın.

5. "Anahtar oluştur" iletişim kutusunda, kullanımınızı Android uygulamalarıyla kısıtlamanız gerekir. Bunu yapmak için uygulamanızın SHA-1 parmak izini ve paket adını aşağıdaki örnekte olduğu gibi girin:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
   
   com.example.android.awareness-example
   

6. Oluştur'u tıklayın. Yeni Android API anahtarınız, projenizin API anahtarları listesinde görünür. API anahtarı, aşağıdaki gibi bir karakter dizisidir:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

API anahtarınız olduğuna göre, Başlarken kılavuzunda açıklandığı gibi bu anahtarı uygulamanızın manifest dosyasına ekleyebilirsiniz.

Ek API'leri etkinleştirme

Awareness API, beacon'lar gibi çeşitli bağlamsal verilere erişmenizi sağlar. Bu türleri kullanmak için Google Developers Console'da ilgili API'leri etkinleştirmeniz gerekir.