Uygulamanızın Fitness API'ye gönderdiği her istek bir yetkilendirme jetonu içermelidir. Bu jeton ayrıca uygulamanızı Google'a tanıtır.
Yetkilendirme protokolü
Uygulamanız, istekleri yetkilendirmek için OAuth 2.0 kullanmalıdır. Başka hiçbir yetkilendirme protokolü desteklenmez. Uygulamanız Google ile Oturum Açma işlevini kullanırsa yetkilendirme işleminin bazı kısımları sizin için gerçekleştirilir.
Uygulamanızın erişmek istediği veri türleri, kapsamlara karşılık gelir. Veri türlerine erişebilmek için önce ilgili kapsamlarının hassas veya kısıtlı olup olmadığını tanımlamanız ve doğrulama için başvururken ilgili adımları uygulamanız gerekir. Aşağıdaki istekleri yetkilendirme işleminin 3. adımına bakın.
OAuth 2.0 kullanarak istekleri yetkilendirme
Fitness API'sine yapılan tüm isteklerin, kimliği doğrulanmış bir kullanıcı tarafından yetkilendirilmesi gerekir.
OAuth 2.0 için yetkilendirme sürecinin veya "akışın" ayrıntıları, yazdığınız uygulamanın türüne bağlıdır. Bu genel işlem tüm uygulama türleri için geçerlidir:
- Uygulamanızı oluştururken Google API Konsolu'nu kullanarak kaydedin. Ardından Google, daha sonra ihtiyaç duyacağınız bilgiler (ör. istemci kimliği ve istemci gizli anahtarı) sağlar.
- Google API Konsolu'nda Fitness API'yi etkinleştirin. (API, API Konsolu'nda listelenmemişse bu adımı atlayın.)
- Doğrulama başvurusu yapın ve uygulamanızın belirli kapsamlara neden ihtiyaç duyduğuna dair alakalı destek bilgilerini gönderin. Uygulamanızın erişmesi gereken veri türleri, uygulamanızın istemesi gereken kapsamlara karşılık gelir.
- Uygulamanız doğrulanırsa Google, kullanıcıya söz konusu kullanıcının verilerine erişmesi için uygulamanızı yetkilendirmesini isteyen bir izin ekranı görüntüler.
- Kullanıcı onaylarsa Google, uygulamanıza kısa süreli bir erişim jetonu verir.
- Uygulamanız, erişim jetonunu isteğe ekleyerek kullanıcı verileri için istekte bulunur.
- Google, isteğinizin ve jetonun geçerli olduğuna kanaat getirirse istenen verileri döndürür.
Fitness API'sinin OAuth kapsamları hakkında daha fazla bilgiyi burada bulabilirsiniz. Her veri türü için hangi kapsamın gerekli olduğunu öğrenin.