API Anahtarlarını Kullanma

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Platform seçin: Android iOS JavaScript

Bu konu, Android için Haritalar SDK'sı için API anahtarının nasıl oluşturulacağını, uygulamanıza nasıl ekleneceğini ve anahtarı kısıtlayarak uygulamanın nasıl güvenli hale getirileceğini açıklar. SDK'yı kullanan tüm uygulamalara API anahtarı eklemeniz gerekir.

Başlamadan önce

Android için Haritalar SDK'sını kullanmaya başlamadan önce faturalandırma hesabı olan bir projeye ve Android için Haritalar SDK'sına sahip olmanız gerekir. Daha fazla bilgi edinmek için Cloud Console'da kurma başlıklı makaleye bakın.

API anahtarları oluşturma

API anahtarı, kullanım ve faturalandırma amaçları için projenizle ilişkilendirilen isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.

API anahtarı oluşturmak için:

Konsol

  1. Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.

    Kimlik bilgisi sayfasına git

  2. Kimlik bilgileri sayfasında Kimlik bilgisi oluştur ve API anahtarı'nı tıklayın.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturduğunuz API anahtarı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasında API anahtarları altında listelenir.
    (API'yi üretimde kullanmadan önce anahtarı kısıtlamayı unutmayın.)

Google Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, Google Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

API anahtarlarını kısıtlama

Google, API anahtarlarınızın kullanımını yalnızca uygulamanız için gereken API'lerle sınırlandırarak önemle tavsiye eder. API anahtarlarının kısıtlanması, uygulamanızı istenmeyen isteklerden koruyarak uygulamanıza güvenlik ekler. Daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar bölümüne bakın.

API anahtarınızı kısıtladığınızda uygulamayı imzalamak için kullanılan imzalama anahtarının SHA-1 sertifika parmak izini sağlamanız gerekir. İki sertifika türü vardır:

  • Hata ayıklama sertifikası: Bu sertifika türünü yalnızca test ettiğiniz uygulamalar ve üretim dışı diğer kodlarla kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulamayı yayınlamayı denemeyin. Android SDK araçları, bir hata ayıklama derlemesi çalıştırdığınızda bu sertifikayı otomatik olarak oluşturur.
  • Sürüm sertifikası: Uygulamanızı bir uygulama mağazasına yayınlamaya hazır olduğunuzda bu sertifikayı kullanın. Android SDK araçları, bir sürüm derlemesi çalıştırdığınızda bu sertifikayı oluşturur.

Dijital sertifikalar hakkında daha fazla bilgi için Uygulamanızı imzalama kılavuzuna bakın.

Sertifikanızın dijital parmak izini alma hakkında bilgi edinmek için İstemcinizin Kimlik Doğrulamasını inceleyin. Bunun yerine Play Uygulama İmzalama'yı kullanıyorsanız sertifika parmak izinizi almak için Play Console'daki uygulama imzalama sayfasına gitmeniz gerekir.

Bir API anahtarını kısıtlamak için:

Konsol

  1. Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.

    Kimlik bilgisi sayfasına git

  2. Kısıtlama ayarlamak istediğiniz API anahtarını seçin. API anahtarı mülk sayfası görünür.
  3. Anahtar kısıtlamaları altında, aşağıdaki kısıtlamaları ayarlayın:
    • Uygulama kısıtlamaları:
      1. Android uygulamaları'nı seçin.
      2. + Paket adı ve parmak izi ekle'yi tıklayın.
      3. Paket adınızı ve SHA-1 sertifika parmak izini girin. Örneğin:
        com.example.android.mapexample
        BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    • API kısıtlamaları:
      1. Anahtarı kısıtla'yı tıklayın.
      2. API'leri seç açılır listesinden Android için Haritalar SDK'sı seçeneğini belirleyin. Android için Haritalar SDK'sı listelenmiyorsa SDK'yı etkinleştirmeniz gerekir.
  4. Değişikliklerinizi tamamlamak için Kaydet'i tıklayın.

Google Cloud SDK

Mevcut anahtarları listeleyin.

gcloud services api-keys list --project="PROJECT"

Mevcut anahtardaki mevcut kısıtlamaları temizleyin.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Mevcut anahtar için yeni kısıtlamalar belirleyin.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="maps-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK, Google Cloud SDK yüklemesi ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:

Sırada ne var?

Artık bir API anahtarınız olduğuna göre Android Studio Projesi oluşturma bölümünde açıklandığı gibi bir proje oluşturup yapılandırın.