Kayıt ve API anahtarları

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

Tüm Android uygulamaları, özel anahtara sahip olduğunuz dijital bir sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için uygulamanızı imzalama ile ilgili Android rehberine bakın.

Android API anahtarları, belirli sertifika paketi çiftlerine bağlıdır. Uygulamada kaç kullanıcınız olursa olsun her sertifika için yalnızca bir anahtar gerekir.

Uygulamanız için anahtar elde etmek üzere uygulamanız gereken birkaç adım bulunuyor. Bunlar, bu kılavuzda ayrıntılı olarak açıklanan şekilde özetlenmiştir:

  1. Uygulamanızın sertifikası hakkında bilgi edinin.
  2. Google Developers Console'da bir proje kaydedin ve User Context API'yi proje için hizmet olarak 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 SHA-1 parmak izi olarak bilinen kısa bir biçimini temel alı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 sertifika arasından seçim yapabilirsiniz:

  • Hata ayıklama sertifikası: Android SDK araçları, hata ayıklama derlemesi oluşturduğunuzda bu sertifikayı otomatik olarak oluşturur. Bu sertifikayı yalnızca test ettiğiniz uygulamalarla kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulama 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.
  • Sürüm sertifikası: Sürüm derlemesi oluşturduğunuzda Android SDK araçları bu sertifikayı oluşturur. Bu sertifikayı keytool programıyla da oluşturabilirsiniz. Uygulamanızı yayınlamaya hazır olduğunuzda bu sertifikayı kullanın.

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

Hata ayıklama sertifikası

Hata ayıklama sertifikası parmak izini görüntüleyin

Bir sertifikanın SHA-1 parmak izini görüntülemek için -v parametresini kullanarak keytool programını kullanın. Bunun için aşağıdaki adımları uygulayın:

  1. Hata ayıklama anahtar deposu dosyanızı bulun. Dosya adı debug.keystore olup projenizi ilk kez oluşturduğunuzda oluşturulur. Varsayılan olarak, Android Sanal Cihaz (AVD) dosyalarınızla aynı dizinde depolanır:

    • OS X ve Linux: ~/.android/
    • Windows Vista ve Windows 7: C:\Users\your_user_name\.android\

  2. SHA-1 parmak izini listeleyin:

    • Linux veya OS X için bir terminal penceresi açın ve aşağıdakileri girin:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Windows Vista ve Windows 7 için aşağıdakileri çalıştırın:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Şuna benzer bir çıkış alırsınız:

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
Sürüm sertifikası

Sürüm sertifikası parmak izini görüntüle

Bir sertifikanın SHA-1 parmak izini görüntülemek için -v parametresini kullanarak keytool programını kullanın. Bunun için aşağıdaki adımları uygulayın:

  1. Sürüm sertifika anahtar deposu dosyanızı bulun. Sürüm anahtar deposunun varsayılan konumu veya adı yoktur. Uygulamanızı yayınlanmak üzere derlediğinizde bir derleme belirtmezseniz derleme, .apk özelliğinizi imzalanmaz ve yayınlamadan önce imzalamanız gerekir. Sürüm sertifikası için sertifika takma adı, anahtar deposunun şifreleri ve sertifikaya da ihtiyacınız vardır.

  2. Bir anahtar deposundaki tüm anahtarların takma adlarını listelemek için aşağıdakileri girin:

    keytool -list -keystore your_keystore_name
  3. your_keystore_name öğesini tam anahtar yolunun ve anahtar deposunun adıyla değiştirin. .keystore uzantısını ekleyin. İstendiğinde anahtar deposunun şifresini girin. Ardından keytool, anahtar deposundaki tüm takma adları görüntüler.

  4. Bir terminal veya komut istemine aşağıdakileri girin:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. your_keystore_name değerini anahtar deposunun tam nitelikli yolu ve adıyla değiştirin. .keystore uzantısını ekleyin.
  6. your_alias_name ifadesini, oluşturduğunuz sertifikaya atadığınız takma adla değiştirin.

Şuna benzer bir çıkış alırsınız:

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ır, sertifikanın SHA-1 parmak izini içerir. Parmak izi, iki nokta işaretiyle ayrılmış 20 basamaklı onaltılık 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. İşlem boyunca size rehberlik eden ve Awareness API'yi otomatik olarak etkinleştiren Google Developers Console'a bağlanır.

Anahtar al

Alternatif olarak, bir 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 aşağıdaki örnekte gösterildiği gibi uygulamanızın SHA-1 parmak izi ve paket adını 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. Create'i (Oluştur) tıklayın. Yeni Android API anahtarınız, projeniz için API anahtarları listesinde görünür. API anahtarı, aşağıdaki gibi bir karakter dizesidir:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

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

Ek API'leri etkinleştirme

Awareness API, işaretçiler gibi birden fazla içerik verisi türüne erişmenize olanak tanır. Bu türleri kullanmak için Google Developers Console'da ilgili API'leri etkinleştirmeniz gerekir.

Hizmet Awareness API yöntemleri Etkinleştirilecek API
İşaretçiler SnapshotApi.getBeaconState(), FenceApi.BeaconFence Nearby Messages API