REST API'yi Kullanmaya Başlama

Bu eğitimde, Fitness REST API'ye erişimi nasıl etkinleştireceğiniz, OAuth erişimi nasıl elde edeceğiniz gösterilmektedir yapabilir ve HTTP isteklerini kullanarak API yöntemlerini çağırabilir.

Fitness REST API'yi kullanmak için temel kavramları öğrenmeniz gerekir. RESTful web hizmetleri ve JSON temsilleri.

Bir Google Hesabı edinin

Fitness REST API'yi kullanmak için bir Google Hesabınız olmalıdır. Halihazırda bir hesabınız varsa hazırsınız demektir. Ayrıca isterseniz test amacıyla ayrı bir Google Hesabı oluşturmalıdır.

OAuth 2.0 istemci kimliği isteyin

Fitness API için OAuth 2.0 istemci kimliği istemek üzere aşağıdaki adımları uygulayın.

  1. gidin. Google API Konsolu.
  2. Bir proje seçin veya yeni bir proje oluşturun. Android için aynı projeyi kullan ve REST sürümleri oluşturun.
  3. Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
  4. Kimlik bilgilerine git'i tıklayın.
  5. New credentials'ı (Yeni kimlik bilgileri) tıklayın ve ardından OAuth Client ID (OAuth İstemci Kimliği) seçin.
  6. Uygulama türü bölümünde Web uygulaması'nı seçin.
  7. Yetkili JavaScript kaynakları altında, sitenin temel URL'sini girin İsteklerin kaynaklanacağı yer (ö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şlenecek (örneğin, 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 listede görünür ortaya çıkarır. OAuth 2.0 Client-ID, karakterlerden oluşan bir dizedir. şunun gibi bir şey:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth Playground'da REST API'yi deneyin

OAuth Playground, OAuth Playground'u tanımanın en kolay yoludur ve Önceden HTTP istekleri göndererek ve yanıtları inceleyerek Fitness REST API'yi istemci kodu yazabilirsiniz.

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

  1. OAuth Playground'a gidin.
  2. 1. Adım'ın altında, API'leri yetkilendirin, Fitness v1'i genişletin ve emin olun.
  3. API'leri Yetkilendir düğmesini tıklayın, yapılacak Google API Konsolu projesini seçin kullanıyorsanız ve istendiğinde İzin ver'i tıklayın. Şuna erişebilir: seçili Google API Konsolu hesabıyla ilişkili verileri değiştirme.
  4. Jetonlar için yetkilendirme kodu değiş tokuşu yap düğmesini tıklayın. OAuth Playground bu başlığı otomatik olarak Authorization: içine ekler istek başlığını girin. Erişim jetonunun süresi 60 dakika (3.600 saniye) sonra sona erer.

HTTP istekleri gönderme

Aşağıdaki örnekler, tüm mevcut veri kaynaklarını gözden geçirmek ve yeni bir veri kaynağı oluşturmak. Fitness REST İçin API'nin 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 (GET) seçin.
  2. İstek URI'si 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. Öğe isteği başarılı olursa yanıt, önceki sayfanın veri kaynağı JSON biçiminde bir örnek.

Veri kaynağı oluşturmak için:

  1. HTTP Method (HTTP Yöntemi) bölümünde POST'u seçin.
  2. İstek URI'si 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) penceresinde aşağıdaki JSON'u 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. İstek Authorization üst bilgisinde OAuth erişim jetonunu içerir:

Authorization: Bearer ya29.OAuthTokenValue

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

HTTP/1.1 200 OK

Fit REST API'ye erişmek için cURL'yi kullanma

Şuraya erişmek için cURL komut satırı aracını kullanabilirsiniz: Fit REST API. İstekte bulunmak için OAuth erişim jetonuna ihtiyacınız olacaktır cURL kullanarak (önceki talimatlara bakın). Erişim jetonlarının süresinin bir saat sonra sona ereceğini unutmayın. Aşağıdaki örnekte bir basit bash komut dosyası ile tüm veri kaynaklarını listeler.

#!/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 şu sayfalara göz atın: