OAuth2 Playground'u kullanarak ilk Google Health API çağrınızı yapma

1. Giriş

OAuth 2.0 Playground, Google OAuth 2.0 akışlarını herhangi bir kod yazmadan test etmenize yardımcı olan web tabanlı bir araçtır. Bu codelab'de Google Cloud projenizi nasıl ayarlayacağınız, kimlik bilgilerini nasıl alacağınız, OAuth 2.0 Playground ile yetkilendirme akışını nasıl başlatacağınız ve Google Health API uç noktalarından birine ilk çağrınızı nasıl yapacağınız gösterilmektedir.

Neler öğreneceksiniz?

• Google Cloud Console'da istemci kimliği oluşturma
• OAuth 2.0 Playground'u kullanarak erişim jetonu ve yenileme jetonu almak için Google OAuth 2.0 yetkilendirme akışını nasıl kullanacağınız.
• OAuth 2.0 Playground'u kullanarak Google Health API uç noktalarına nasıl çağrı yapılacağı.

İhtiyacınız olanlar

• Bir Google Hesabı
• Fitbit mobil uygulaması
• OAuth 2.0 Playground

Fitbit mobil uygulamasını kurmak için:

1. Apple App Store veya Google Play Store'da Fitbit mobil uygulamasını arayıp indirin.
2. Uygulama simgesini seçin.
3. Google ile oturum aç'ı tıklayın.
4. Google Hesabınızı seçin ve Devam düğmesine basın.

2. Google Cloud projesi oluşturma

İstemci kimliği oluşturmak ve Google Health API'nin kullanımını etkinleştirmek için Google Cloud Console'u kullanırsınız.

1. Google Cloud Console'da oturum açın.
2. Yeni bir proje oluşturmak için:
   1. Proje seçme aracında Proje seç'i tıklayın.
   2. Sağ üst köşede Yeni Proje'yi seçin.
   3. Proje adınızı girin.
   4. Konumunuzu girin (örneğin, "Kuruluş yok").
   5. Oluştur düğmesini tıklayın.
   6. Projenizi seçin.

Google Health API'yi etkinleştirme

1. Sol üst köşedeki menü simgesini tıklayın:
2. API'ler ve Hizmetler > Kitaplık'ı seçin.
3. "Google Health API"yi arayın ve etkinleştirin.

OAuth kimlik bilgilerinizi ayarlama

Google Cloud Console'da değilseniz Google Cloud Console'a gidin.

1. Sol üst köşedeki menü simgesini tıklayın:
2. API'ler ve Hizmetler > Kimlik bilgileri'ni seçin.
3. Üst orta kısımdan + Kimlik bilgileri oluştur > OAuth istemci kimliği'ni seçin.
4. Kullanıcı rızası ekranını yapılandır düğmesini tıklayın. "Google Auth Platform henüz yapılandırılmadı" mesajı görünürse Başlayın düğmesini tıklayın.
5. 1. bölümde:
   1. Uygulama adını girin.
   2. Kullanıcı desteği e-posta adresini girin.
   3. İleri düğmesini tıklayın.
6. 2. bölümde:
   1. Harici'yi seçin.
   2. İleri düğmesini tıklayın.
7. 3. bölümde:
   1. İletişim bilgileri alanına e-posta adresinizi girin.
   2. İleri düğmesini tıklayın.
8. 4. bölümde:
   1. Google'ın API Hizmetleri Kullanıcı Verileri Politikası'nı kabul etmek için onay kutusunu tıklayın.
   2. Oluştur düğmesini tıklayın.
9. API'ler ve Hizmetler > Kimlik Bilgileri'ne gidin ve + Kimlik Bilgileri Oluştur > OAuth istemci kimliği'ni seçin.
10. Web Uygulaması uygulama türünü seçin.
11. İstemci kimliği adını girin.
12. Yetkilendirilmiş JavaScript kaynakları'nı boş bırakın.
13. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve aşağıdaki URI'leri ekleyin:
    • https://www.google.com
    • https://developers.google.com/oauthplayground
14. Oluştur düğmesini tıklayın.
15. Google Console, istemci kimliğinizin oluşturulduğunu belirten bir mesaj gösterir. İstemci kimliğini ve istemci gizli anahtarını indirmek için JSON'ı indir bağlantısını tıklayın veya değerleri not alın. Müşterinizin gizli anahtarını daha sonra kurtaramazsınız.
16. Tamam'ı tıklayın. "OAuth 2.0 İstemci Kimlikleri" sayfasına yönlendirilirsiniz.
17. İstemci kimliğiniz projenize eklenir. Ayrıntıları görmek için müşteri kimliği URL'sini tıklayın.

Not: İstemci gizli anahtarınızı indirmediyseniz veya kaydetmediyseniz tekrar görüntüleyemeyeceğiniz için yeni bir anahtar oluşturmanız gerekir. Tamam'ı tıklayın. Ardından, Kimlik Bilgileri sayfasında OAuth 2.0 İstemci Kimlikleri bölümünden istemci kimliğinizi seçin. İstemci Gizli Anahtarları bölümüne gidip + GİZLİ ANAHTAR EKLE'yi seçin. Yeni bir istemci gizli anahtarı oluşturulur. Bu anahtarı indirmeniz veya kaydetmeniz gerekir. Güvenlik nedeniyle, artık kullanılmayan tüm istemci sırlarını sil simgesine basarak silmeniz gerekir.

Test kullanıcıları ekleme

1. Sol bölmede Kitle'yi seçin. "Yayınlama durumu"nun Test, "Kullanıcı türü"nün ise Harici olarak ayarlandığını görürsünüz.
2. "Test kullanıcıları" bölümünde + Kullanıcı ekle düğmesini tıklayın. Verilerini almak istediğiniz kullanıcıların e-posta adresini girin.
3. Kaydet düğmesini tıklayın.

İstemci kimliğine kapsam ekleme

1. Sol bölmede Veri Erişimi'ni seçin.
2. Kapsam ekle veya kaldır düğmesini tıklayın.
3. API sütununda "Google Health API"yi arayın. Bu codelab'de .../auth/googlehealth.activity_and_fitness.readonly kapsamını kullanıyoruz.
4. Kapsamı seçtikten sonra Veri Erişimi sayfasına dönmek için Güncelle düğmesine basın.
5. Kaydet düğmesini tıklayın.

Müşteri kimliğinizi ayarlamayı tamamladınız.

3. Fitbit mobil uygulamasına veri ekleme

Fitbit'i yeni kullanmaya başlayanlar, Fitbit hesaplarında sorgulanacak veriye sahip olmayabilir. Uç noktalardan biri aracılığıyla sorgulayabileceğimiz bir egzersiz günlüğünü manuel olarak ekleyeceğiz. Bir egzersizi manuel olarak kaydetmek için şu adımları uygulayın:

1. Cihazınızda Fitbit mobil uygulamasını açın. Gerekirse Fitbit hesabınızda oturum açın.
2. Ekranın sağ alt köşesindeki + düğmesine dokunun.
3. "Manuel olarak kaydet" bölümünde Etkinlik'e dokunun.
4. Yürüyüş egzersiz türünü arayıp seçin.
5. Bugün için bir başlangıç saati girin.
6. Süreyi 15 dakika olarak değiştirin.
7. Mesafeyi 1,6 km olarak bırakın.
8. Ekle'ye dokunun.
9. Ekrana uzun basıp aşağı kaydırarak mobil uygulamayı Fitbit sunucularıyla senkronize edin. Parmağınızı bıraktığınızda mobil uygulamanın senkronize edildiğini görürsünüz.
10. "Etkinlik" bölümünde, manuel olarak kaydedilen Yürüyüş girişinizi görmeniz gerekir.

4. OAuth 2.0 Playground'da yetkilendirme

OAuth 2.0 Playground'a gidin.

Google Health API, Playground ile kendi OAuth kimlik bilgilerinizi kullanmanızı gerektirir.

1. Sağ üstteki OAuth 2.0 Yapılandırması dişli simgesini tıklayın.
2. Kendi OAuth kimlik bilgilerinizi kullanın'ı seçin.
3. Google Cloud proje kurulumu sırasında aldığınız OAuth istemci kimliği ve OAuth istemci gizli anahtarını girin.

Playground arayüzü, izleyeceğimiz üç ana adıma ayrılmıştır:

1. API'leri seçme ve yetkilendirme
2. Jetonlar için yetkilendirme kodu değiş tokuşu yapma
3. API'ye istek gönderme

API'leri seçme ve yetkilendirme

İstediğiniz API kapsamlarını buradan seçebilirsiniz.

1. 1. adımda API listesinde Google Health API v4'ü bulun ve genişletin.
2. https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly seçeneğini belirleyin. İhtiyacınız olan kapsam listede gösterilmiyorsa "Kendi kapsamlarınızı girin" alanına manuel olarak girebilirsiniz.
3. API'leri yetkilendir'i tıklayın.
4. Google'ın OAuth 2.0 yetkilendirme uç noktasına bir istek gönderilir, seçilen kapsamlar isteğe dahil edilir ve ardından Google Hesabı kullanıcı rızası ekranına yönlendirilirsiniz.
5. Google Cloud projesini ayarlama bölümünde yapılandırdığınız bir test kullanıcı hesabıyla oturum açın (henüz oturum açmadıysanız).
6. İstenen izinleri inceleyin ve erişim izni vermek için Devam'ı tıklayın.

İzin verdiğinizde Google sizi Playground'a yönlendirir ve sonraki adımda kullanılacak olan yetkilendirme kodunu araca sağlar.

Sağ taraftaki İstek / Yanıt panelinde HTTP yönlendirme akışının tamamı gösterilir.

İlk yetkilendirme isteğine verilen yanıt bir 302 Found yönlendirmesidir:

HTTP/1.1 302 Found
Location: https://accounts.google.com/o/oauth2/v2/auth?redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplayground&prompt=consent&response_type=code&client_id=your_client_id&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgooglehealth.activity_and_fitness.readonly&access_type=offline

Sonuçta elde edilen ve Playground'a geri yönlendirilen istek, yetkilendirme kodunu içerir:

GET /oauthplayground/?iss=https://accounts.google.com&code=authorization_code&scope=https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly HTTP/1.1
Host: developers.google.com

Yetkilendirme kodu, GET isteği URL'sinde code= ile &scope arasında authorization_code ile gösterilen alfanümerik değerdir. Bu örnekte değer şuna benzer: 4/0AbPOj...

Jetonlar için yetkilendirme kodu değiş tokuşu yapma

Bu adımda kod, API istekleri yapmanıza olanak tanıyan jetonlarla değiştirilir.

API'leri seçin ve yetkilendirin adımını tamamladıktan sonra Playground, yetkilendirme kodu alanını otomatik olarak doldurur. Puanı jetonlarla değiştirmek için:

1. 2. adımda Jetonlar için yetkilendirme kodu değiş tokuşu yap düğmesini tıklayın.
2. access_token ve refresh_token, sağdaki Request/Response (İstek/Yanıt) panelinde görünür.

Şuna benzer bir yanıt görmeniz gerekir:

{
  "access_token": "ya29.a0AFH6S....",
  "refresh_token_expires_in": 604799,
  "expires_in": 3599,
  "token_type": "Bearer",
  "scope": "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly",
  "refresh_token": "1/og..."
}

Yenileme jetonları hakkında

Yetkilendirme kodunu değiştirdiğinizde yanıtta access_token'ye ek olarak refresh_token da bulunabilir. access_token kısa ömürlüdür (genellikle 1 saat). Bir access_token sona erdiğinde, kullanıcının tekrar oturum açmasını veya izin vermesini gerektirmeden yeni bir access_token almak için refresh_token kullanmanız gerekir. Yetkilendirme isteğimize access_type=offline eklediğimiz için bu işlem mümkündür.

Yanıtın içinde refresh_token görmüyorsanız bunun nedeni, bu uygulama ve kapsamlar için izni daha önce vermiş olmanız olabilir. Yenileme jetonları genellikle yalnızca bir kullanıcı uygulamanız için ilk kez izin verdiğinde veya yetkilendirme URL'sine prompt=consent eklenerek kullanıcı rızası ekranının sonraki yetkilendirmelerde de görünmesi zorlandığında verilir.

refresh_token uzun ömürlüdür ancak 6 ay boyunca kullanılmazsa, kullanıcı uygulamanıza erişimi iptal ederse veya başka nedenlerle süresi dolabilir ya da geçersiz hale gelebilir. refresh_token değerini ileride kullanmak üzere güvenli bir şekilde saklamanız gerekir.

5. API'ye istek gönderme

Artık erişim jetonunuzu kullanarak Google Health API'ye istek gönderebilirsiniz. Playground'daki 3. adımda Request URI (İstek URI'si), HTTP Method (HTTP Yöntemi), başlıklar ve istek gövdesini belirterek HTTP isteğinizi yapılandırın.

1. HTTP Method'u (HTTP Yöntemi) GET olarak ayarlayın.
2. İstek URI'si'ni https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints olarak ayarlayın.
3. İsteği gönder'i tıklayın.

Yanıt aşağıdaki gibi görünmelidir:

{
  "dataPoints": [
    {
      "name": "users/2515055256096816351/dataTypes/exercise/dataPoints/8896720705097069096",
      "dataSource": {
        "recordingMethod": "MANUAL",
        "platform": "FITBIT"
      },
      "exercise": {
        "interval": {
          "startTime": "2026-02-23T13:10:00Z",
          "startUtcOffset": "-18000s",
          "endTime": "2026-02-23T13:25:00Z",
          "endUtcOffset": "-18000s"
        },
        "exerciseType": "WALKING",
        "metricsSummary": {
          "caloriesKcal": 16,
          "distanceMillimiters": 1609344,
          "steps": "2038",
          "averagePaceSecondsPerMeter": 0.55923407301360051,
          "activeZoneMinutes": "0"
        },
        "exerciseMetadata": {},
        "displayName": "Walk",
        "activeDuration": "900s",
        "exerciseEvents": [
          {
            "eventTime": "2026-02-23T13:10:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "START"
          },
          {
            "eventTime": "2026-02-23T13:25:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "STOP"
          }
        ],
        "updateTime": "2026-02-24T01:19:22.450466Z"
      }
    },
    {
      "name": "users/2515055256096816351/dataTypes/exercise/dataPoints/5870930690409355408",
      "dataSource": {
        "recordingMethod": "MANUAL",
        "platform": "FITBIT"
      },
      "exercise": {
        "interval": {
          "startTime": "2026-02-23T06:00:00Z",
          "startUtcOffset": "-18000s",
          "endTime": "2026-02-23T06:15:00Z",
          "endUtcOffset": "-18000s"
        },
        "exerciseType": "WALKING",
        "metricsSummary": {
          "caloriesKcal": 17,
          "distanceMillimiters": 1609344,
          "steps": "2038",
          "averagePaceSecondsPerMeter": 0.55923407301360051,
          "averageHeartRateBeatsPerMinute": "81",
          "activeZoneMinutes": "0",
          "heartRateZoneDurations": {
            "lightTime": "900s"
          }
        },
        "exerciseMetadata": {},
        "displayName": "Walk",
        "activeDuration": "900s",
        "exerciseEvents": [
          {
            "eventTime": "2026-02-23T06:00:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "START"
          },
          {
            "eventTime": "2026-02-23T06:15:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "STOP"
          }
        ],
        "updateTime": "2026-02-23T08:29:39.480437Z"
      }
    }
  ],
  "nextPageToken": ""
}

Birçok uç nokta, filtreleme veya sayfalama için sorgu parametrelerini destekler. Örneğin, belirli bir zaman aralığındaki egzersizleri listelemek için istek URI'sini bir filtre parametresi içerecek şekilde değiştirin:

https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints?filter=exercise.interval.civil_start_time >= "2026-02-22T00:00:00"

Filtrelenmiş sonuçları görmek için İsteği gönder'i tekrar tıklayın.

6. Tebrikler

Tebrikler!

Temel codelab'i tamamladınız ve OAuth 2.0 yetkilendirmesini test etmek ve Google Health API uç noktalarına çağrı yapmak için OAuth2 Playground'u nasıl kullanacağınızı başarıyla öğrendiniz.

Google Health API ekosistemiyle entegre olan uygulamalar geliştirmekten keyif alacağınızı umuyoruz. Daha fazla bilgi için referans dokümanlarındaki diğer Google Health API uç noktalarını inceleyin ve Web Sunucusu Uygulamaları için Google OAuth 2.0 hakkında daha fazla bilgi edinin.