REST API'yi Kullanmaya Başlama

Bu eğitim, Fitness REST API'ye erişimi nasıl etkinleştireceğinizi, OAuth erişim jetonlarını nasıl alacağınızı ve HTTP isteklerini kullanarak API yöntemlerini nasıl çağıracağınızı gösterir.

Fitness REST API'yi kullanmak için RESTful web hizmetleri ve JSON temsilleri ile ilgili temel bilgileri anlamanız önemlidir.

Bir Google Hesabı edinin

Fitness REST API'yi kullanmak için bir Google Hesabınızın olması gerekir. Zaten hesabınız varsa hazırsınız demektir. Ayrıca, test amaçlı olarak ayrı bir Google Hesabı oluşturmak da isteyebilirsiniz.

OAuth 2.0 istemci kimliği isteme

Fitness API'si için OAuth 2.0 istemci kimliği istemek için bu adımları uygulayın.

  1. Google API Konsolu'na gidin.
  2. Bir proje seçin veya yeni bir proje oluşturun. Uygulamanızın Android ve REST sürümleri için aynı projeyi kullanın.
  3. Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
  4. Kimlik bilgilerine git'i tıklayın.
  5. Yeni kimlik bilgisi'ni tıklayın ve ardından OAuth İstemci Kimliği'ni seçin.
  6. Uygulama türü bölümünde Web uygulaması'nı seçin.
  7. Yetkili JavaScript kaynakları altında, isteklerin kaynağı olan sitenin temel URL'sini girin (örneğin, https://developers.google.com, OAuth Playground tarafından kullanılan URL'dir).
  8. Yetkili yönlendirme URI'si altında, yanıtların işleneceği sitenin URL'sini girin (ör. https://developers.google.com/oauthplayground, OAuth Playground tarafından kullanılan URL'dir).

  9. Oluştur'u tıklayın. Yeni OAuth 2.0 istemci kimliğiniz ve gizli anahtarınız, projenizin kimlikler listesinde görünür. OAuth 2.0 İstemci Kimliği, aşağıdaki gibi bir karakter dizisidir:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth Playground'da REST API'yi deneyin

OAuth Playground, HTTP istekleri gönderip herhangi bir istemci kodu yazmadan önce yanıtları gözlemleyerek Fitt REST API hakkında bilgi edinmenin en kolay yoludur.

OAuth Playground'da Fitness REST API'yi yetkilendirmek için:

  1. OAuth Playground'a gidin.
  2. 1. Adım: API'leri seçin ve yetkilendirin altında Fitness v1'i genişletin ve kullanılacak Fitness kapsamlarını seçin.
  3. API'leri yetkilendir düğmesini tıklayın, kullanılacak Google API Konsolu projesini seçin ve istendiğinde İzin ver'i tıklayın. Seçilen Google API Konsolu hesabıyla ilişkili verilere erişebilir ve bu verileri değiştirebilirsiniz.
  4. Jetonlar için yetkilendirme kodu takası düğmesini tıklayın. OAuth Playground, HTTP istekleri gönderdiğinizde bu isteği Authorization: istek başlığına otomatik olarak ekler. Erişim jetonunun süresinin 60 dakika (3.600 saniye) sonra sona ereceğini unutmayın.

HTTP istekleri gönderme

Aşağıdaki örneklerde, mevcut tüm veri kaynaklarını listelemek ve yeni bir veri kaynağı oluşturmak için HTTP isteklerinin nasıl gönderileceği gösterilmektedir. Fitness REST API için URI biçimi şu şekildedir:

https://www.googleapis.com/fitness/v1/resourcePath?parameters

Mevcut tüm veri kaynaklarını listelemek için:

  1. HTTP Method (HTTP Yöntemi) bölümünde GET'i seçin.
  2. Request URI (İstek URI'sı) alanına https://www.googleapis.com/fitness/v1/users/me/dataSources yazın.
  3. İsteği gönder'i tıklayın.

İstek ve yanıt, sayfanın sağ tarafında görünür. İstek başarılı olursa yanıt, önceki örnekte bulunan veri kaynağını JSON biçiminde gösterir.

Veri kaynağı oluşturmak için:

  1. HTTP Method (HTTP Yöntemi) bölümünde POST'u seçin.
  2. Request URI (İstek URI'sı) alanına https://www.googleapis.com/fitness/v1/users/me/dataSources yazın.
  3. İstek gövdesini girin'i tıklayın.

  4. Request Body (İstek Gövdesi) penceresine şu JSON'ı kopyalayıp yapıştırın:

    {
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "1"
  }
}

  5. İstek Gövdesi penceresinde Kapat'ı tıklayın.

  6. İsteği gönder'i tıklayın.

İstek ve yanıt, sayfanın sağ tarafında görünür. Bu istek, Authorization başlığında OAuth erişim jetonunu içerir:

Authorization: Bearer ya29.OAuthTokenValue

İstek başarılı olursa yanıtın ilk satırı şu olur:

HTTP/1.1 200 OK

Fit REST API'ye erişmek için cURL'yi kullanın

Fit REST API'ye erişmek için cURL komut satırı aracını kullanabilirsiniz. cURL kullanarak istek göndermek için OAuth erişim jetonuna ihtiyacınız vardır (önceki talimatları inceleyin). Erişim jetonlarının süresinin bir saat sonra sona ereceğini unutmayın. Aşağıdaki örnekte, tüm veri kaynaklarını listelemek için basit bir bash komut dosyası gösterilmektedir.

#!/bin/bash
ACCESS_TOKEN=""
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

Sonraki adımlar

REST API hakkında daha fazla bilgi edinmek için aşağıdaki sayfalara bakın: