Time Zone API ile API Anahtarlarını Kullanma

Google Haritalar Platformu ürünleri, API çağrılarını doğru kimlik doğrulama bilgileri sağlayanlarla sınırlandırarak yetkisiz kullanıma karşı korunur. Bu kimlik bilgileri, Google faturalandırma hesabınızı projenizle ve belirli bir API veya SDK ile ilişkilendiren benzersiz bir alfanümerik dize olan API anahtarı biçimindedir.

Bu kılavuzda, Google Haritalar Platformu için API anahtarınızı nasıl oluşturacağınız, kısıtlayacağınız ve kullanacağınız açıklanmaktadır.

Başlamadan önce

Time Zone API'yi kullanmaya başlamadan önce, faturalandırma hesabı ve Time Zone API'nin etkin olduğu bir proje gerekir. Daha fazla bilgi için Cloud Console'da kurulum bölümünü inceleyin.

API anahtarları oluşturma

API anahtarı, kullanım ve faturalandırma amacıyla 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 > API anahtarı'nı tıklayın.
    API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarı gösterilir.
  3. Kapat'ı tıklayın.
    Yeni API anahtarı, Kimlik bilgileri sayfasındaki API anahtarları bölümünde listelenir.
    (Üretimde kullanmadan önce API API'sini 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 kurulumu 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 kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı istenmeyen isteklerden koruyarak güvenliği artırır. Daha fazla bilgi için API güvenliği en iyi uygulamaları konusuna bakın.

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ı özellik sayfası görüntülenir.
  3. Temel kısıtlamalar bölümünde aşağıdaki kısıtlamaları ayarlayın:
    • Uygulama kısıtlamaları:
      1. Sağladığınız web sunucusu IP adresleri listesinden gelen istekleri kabul etmek için Uygulama kısıtlamaları listesinden IP adresleri (web sunucuları, cron işleri vb.) seçeneğini belirleyin. CIDR gösterimini kullanarak bir veya daha fazla IPv4 ya da IPv6 adresi veya alt ağ belirtin. IP adresleri, Google Haritalar Platformu sunucularının gözlemlediği kaynak adresiyle eşleşmelidir. Ağ adresi çevirisi (NAT) kullanırsanız bu genellikle makinenizin herkese açık IP adresine karşılık gelir.
    • API kısıtlamaları:
      1. Anahtarı kısıtla'yı tıklayın.
      2. API seçin açılır listesinden Saat Dilimi API'si seçeneğini belirleyin. Time Zone API listede yoksa 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="timezone-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

API anahtarını isteğinize ekleme

Her Time Zone API isteğine bir API anahtarı eklemeniz gerekir. Aşağıdaki örnekte YOUR_API_KEY öğesini API anahtarınızla değiştirin.

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

API anahtarı kullanan istekler için HTTPS gerekir.