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.
- Google API Konsolu'na gidin.
- 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.
- Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
- Kimlik bilgilerine git'i tıklayın.
- Yeni kimlik bilgisi'ni tıklayın ve ardından OAuth İstemci Kimliği'ni seçin.
- Uygulama türü bölümünde Web uygulaması'nı seçin.
- 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). - 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). 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:
- OAuth Playground'a gidin.
- 1. Adım: API'leri seçin ve yetkilendirin altında Fitness v1'i genişletin ve kullanılacak Fitness kapsamlarını seçin.
- 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.
- 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:
- HTTP Method (HTTP Yöntemi) bölümünde GET'i seçin.
- Request URI (İstek URI'sı) alanına
https://www.googleapis.com/fitness/v1/users/me/dataSources
yazın. - İ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:
- HTTP Method (HTTP Yöntemi) bölümünde POST'u seçin.
- Request URI (İstek URI'sı) alanına
https://www.googleapis.com/fitness/v1/users/me/dataSources
yazın. - İstek gövdesini girin'i tıklayın.
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" } }
İstek Gövdesi penceresinde Kapat'ı tıklayın.
İ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: