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 özelliğini kullanıyorsa yetkilendirmenin 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 ilgili kapsamların hassas veya kısıtlı olup olmadığını belirlemeniz ve doğrulama için başvururken ilgili adımları uygulamanız gerekir. Aşağıdaki istek yetkilendirme bölümünün 3. adımına bakın.
OAuth 2.0 kullanarak istekleri yetkilendirme
Fitness API'ye yapılan tüm isteklerin, kimliği doğrulanmış bir kullanıcı tarafından yetkilendirilmesi gerekir.
OAuth 2.0 için yetkilendirme işleminin ("akış") ayrıntıları, yazdığınız uygulamanın türüne bağlıdır. Bu genel süreç 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 listelenmiyorsa bu adımı atlayın.)
- Doğrulama başvurusu yapın ve uygulamanızın neden belirli kapsamlara ihtiyacı olduğuna dair destekleyici bilgileri 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 bir izin ekranı göstererek kullanıcının verilerine erişmesi için uygulamanızı yetkilendirmesini ister.
- 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ğunu belirlerse istenen verileri döndürür.
Fitness API için OAuth kapsamları hakkında daha fazla bilgiye buradan ulaşabilirsiniz. Her bir veri türü için hangi kapsamın gerekli olduğunu öğrenin.