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. Zaten 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 isteme

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. 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. 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. Yetkilendirilmiş JavaScript kaynakları alanına, isteklerin gönderileceği sitenin temel URL'sini girin (örneğin, OAuth Playground tarafından kullanılan URL https://developers.google.com'dir).
  8. Yetkilendirilmiş yönlendirme URI'si bölümüne, yanıtların işleneceği sitenin URL'sini girin (örneğin, OAuth Playground tarafından kullanılan URL https://developers.google.com/oauthplayground'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 ya da mevcut kimlik bilgilerini tanımlamaya çalışın. 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: API'leri seçin ve yetkilendirin bölümünde Fitness v1'i genişletin ve kullanılacak Fitness kapsamlarını seçin.
  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 60 dakika (3.600 saniye) sonra geçerliliğini yitireceğ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'si için URI biçimi:

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 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'i 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 bir saat sonra geçerliliğini yitirdiğ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: