Time Zone API'yi ayarlama

Bu belgede, Saat Dilimi API'sini kullanmaya başlamak için uygulamanız gereken adımlar açıklanmaktadır.

Ön koşullar

Bu prosedür, faturalandırmanın etkin olduğu bir Google Cloud Hesabı ve Google Cloud projesi oluşturma konusunda size yol gösterir. Ayrıca Time Zone API'yi kullanırken nasıl ücretlendirildiğinizi de bilmeniz gerekir.

1. Saat Dilimi API Kullanımı ve Faturalandırması bölümünde kullanım için faturalandırmayı ve maliyeti inceleyin.

2. Google Cloud Hesabınız olduğunu doğrulayın.

   Google Cloud Console'da oturum açın
   Not: Yeni bir kullanıcıysanız ve Google Cloud Hesabınız yoksa (yani konsolda oturum açamıyorsanız) Google Maps Platform'u kullanmaya başlama başlıklı makaleyi inceleyin.

3. Faturalandırmanın etkin olduğu bir Google Cloud projeniz olduğunu doğrulayın.

   Faturalandırma sayfasına gidin
   Not: Yeni bir kullanıcıysanız ve Google Cloud projeniz yoksa Google Maps Platform'u kullanmaya başlama başlıklı makaleyi inceleyin.
1. Faturalandırma sayfasını açmak için projenizi seçin.

2. Faturalandırma sayfasında:

   • Seçilen proje için faturalandırma zaten etkinleştirilmişse ve yalnızca tek bir faturalandırma hesabınız varsa Faturalandırma sayfası açılır.
   • Birden fazla faturalandırma hesabınız varsa projeyle ilişkili faturalandırma hesabı hakkındaki ayrıntıları görmek için Bağlı faturalandırma hesabına git'i seçin.
   • Bir faturalandırma hesabı varsa ancak projeyle ilişkilendirilmemişse bir faturalandırma hesabını projeye bağlamanız istenir.
   • Faturalandırma hesabı yoksa veya yeni bir faturalandırma hesabı oluşturmak istiyorsanız yeni bir faturalandırma hesabı oluşturmak için Faturalandırma Hesaplarını Yönet'i seçin. Daha fazla bilgi için Yeni bir self servis Cloud Faturalandırma Hesabı oluşturma başlıklı makaleyi inceleyin.

API'yi etkinleştirme

Time Zone API'yi kullanabilmek için Google Cloud Console'u veya gcloud komutunu kullanarak Google Cloud projenizde API'yi etkinleştirmeniz gerekir.

Not: Bir API'yi etkinleştirdikten sonra istek gönderebilmek için birkaç dakika beklemeniz gerekebilir.

API'yi etkinleştirmek için:

Konsol

1. Google Cloud Console'da ürün sayfasını açın:

   Saat Dilimi API'sini etkinleştirme

2. Etkinleştir düğmesini tıklayın.

   Not: API zaten etkinleştirilmişse Etkinleştir yerine Yönet düğmesini görürsünüz.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "timezone-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

Saat Dilimi API'si ile kullanmak için API anahtarı alma

Google Haritalar Platformu ürünleri, API çağrılarının bir API anahtarı içermesini zorunlu kılarak yetkisiz kullanıma karşı korunur.

API anahtarı, Cloud Faturalandırma Hesabınızı ve Google Cloud projenizi, uygulamanızın bir Google Haritalar Platformu API'sine veya SDK'sına yaptığı istekle ilişkilendiren benzersiz bir alfanümerik dizedir. Yeni bir anahtar oluşturmak veya mevcut bir anahtara API ya da SDK eklemek için bu talimatları uygulayın.

Konsol

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

   Anahtarlar ve Kimlik Bilgileri sayfasına gidin

2. İstenirse projenizi seçin.

3. Aşağıdakilerden birini yapın:

   • Yeni anahtar oluşturma:

     1. Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
     2. API anahtarı oluştur panelinde API kısıtlamalarını seçin listesini açın.
     3. Bu anahtarın ihtiyaç duymadığı API'leri temizleyin ve Saat Dilimi API'si'nin seçili kaldığından emin olun.
     4. Oluştur'u tıklayın. Panelde yeni API anahtarınız gösterilir.

   • Mevcut bir anahtarı kullanma:

     1. Anahtarın adını tıklayın.
     2. Select API restrictions (API kısıtlamalarını seçin) listesinde Time Zone API'yi (Saat Dilimi API) seçin.
     3. Kaydet'i tıklayın.

   Burada bir API seçmek, API'yi etkinleştirmez. Time Zone API'nin, API Kitaplığı sayfasında etkinleştirildiğinden emin olun.

4. Anahtar dizesini daha sonra görmek için Anahtarlar ve Kimlik Bilgileri sayfasına gidip anahtar için Anahtarı göster'i tıklayın.

Konsol bu adımlardan farklı görünüyorsa Google Cloud belgelerindeki API anahtarı oluşturma ve API kısıtlamaları ekleme bölümlerine bakın.

gcloud

Aşağıdaki komutlarda PROJECT_ID ifadesini proje kimliğinizle değiştirin.

• Yeni anahtar oluşturma: Aşağıdaki komutu çalıştırın ve DISPLAY_NAME yerine anahtarın adını yazın.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=timezone-backend.googleapis.com

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

  • gcloud services api-keys create

• Mevcut bir anahtarı kullanma: Aşağıdaki komutu çalıştırın ve KEY_ID değerini anahtarın kimliğiyle değiştirin. --append işareti, anahtarın halihazırda izin verdiği API'leri korur. Bu parametre kullanılmadığında komut, mevcut etiketleri değiştirir.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=timezone-backend.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  Anahtar kimliği, anahtar dizesi veya görünen ad değildir. Bunu bulmak için gcloud services api-keys list --project="PROJECT_ID" komutunu çalıştırın. Kimlik, name alanının son kısmıdır: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Anahtar dizesini görmek için gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" komutunu çalıştırın.

API isteği gönderme

ABD'nin Nevada eyaletinin saat dilimi bilgilerini içeren bir JSON yanıtı döndürmek için Time Zone API isteği gönderin. Zaman damgası 5 Aralık 2024 olarak ayarlanmıştır. Her isteğe API anahtarınızın alfanümerik dizesini eklemeniz ve API anahtarını içeren istekler için HTTPS kullanmanız gerekir.

1. Anahtarın alfasayısal dizesini eklemek için aşağıdaki kodda API_KEY simgesini tıklayın:

   curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'
   

2. curl komutunu kopyalamak için kod örneğindeki kopyalama simgesini () tıklayın.
3. Komutu bir terminal penceresine yapıştırıp çalıştırın.

Yanıt, aşağıdaki biçimde bir JSON nesnesidir:

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}

API anahtarı kısıtlamaları uygulama

Dikkat: Kısıtlanmamış bir API anahtarı, Time Zone API dahil herhangi bir Google Haritalar Platformu hizmetine istek göndermek için kullanılabilir. Kısıtlanmamış API anahtarlarının kötüye kullanımından kaynaklanan ücretlerden mali olarak siz sorumlu olursunuz.

Google, API anahtarlarınızı yalnızca ihtiyaç duyan API'ler ve uygulamalarla sınırlayarak kısıtlamanızı önemle tavsiye eder. API anahtarlarını kısıtlamak, uygulamanızı haksız isteklere karşı koruyarak güvenliğini artırır. API anahtarları iki tür kısıtlamayı destekler:

• API kısıtlamaları, API anahtarı kullanılarak hangi SDK'ların ve API'lerin çağrılabileceğini belirtir. Konsol ve gcloud CLI, anahtar oluştururken en az bir API kısıtlaması gerektirir.
• Uygulama kısıtlamaları, bir API anahtarını hangi web sitelerinin, IP adreslerinin veya uygulamaların kullanabileceğini belirtir.

Kısıtlama uygulama hakkında daha fazla bilgi için API anahtarlarınızı kısıtlama başlıklı makaleyi inceleyin.

Sırada ne var?

Time Zone API'yi etkinleştirip başarılı bir istek gönderdiğinize göre API'yi kullanma hakkında daha fazla bilgi edinmek için Time Zone istekleri ve yanıtları başlıklı makaleyi inceleyin.