YouTube Reporting API ve YouTube Analytics API, gizli kullanıcı verilerine erişim yetkisi vermek için OAuth 2.0 protokolünü destekler. Aşağıdaki listede bazı temel OAuth 2.0 kavramları açıklanmaktadır:
-
Bir kullanıcı, uygulamanızda, kullanıcının Google Account or YouTube account giriş yapmasını gerektiren bir işlevi ilk kez kullanmayı denediğinde, uygulamanız OAuth 2.0 yetkilendirme işlemini başlatır.
-
Uygulamanız, kullanıcıyı Google'ın yetkilendirme sunucusuna yönlendiriyor. Bu sayfanın bağlantısı, uygulamanızın kullanıcının hesabı için istediği erişim
scope
bilgisini belirtir.scope
, uygulamanızın kimliği doğrulanmış kullanıcı olarak hareket ederken alabileceği, ekleyebileceği, güncellayabileceği veya silebileceği kaynakları belirtir. -
Kullanıcı, uygulamanıza bu kaynaklara erişmesi için yetki vermeyi kabul ederse Google, uygulamanıza bir jeton gönderir. Uygulamanızın türüne bağlı olarak, jetonu doğrular veya farklı bir jeton türüyle değiştirir.
Örneğin, bir sunucu tarafı web uygulaması, döndürülen jetonu bir erişim jetonu ve yenileme jetonuyla değiştirir. Erişim jetonu, uygulamanın kullanıcı adına istekleri yetkilendirmesini sağlar. Yenileme jetonu ise, orijinal erişim jetonunun süresi dolduğunda uygulamanın yeni bir erişim jetonu alabilmesini sağlar.
Önemli: OAuth 2.0 yetkilendirmesini kullanabilmek için Google API Konsolu'ndan yetkilendirme kimlik bilgileri edinmeniz gerekir.
OAuth 2.0 akışları
Google API'leri, çeşitli OAuth 2.0 kullanım alanlarını destekler:
- Sunucu tarafı web uygulamaları akışı, kalıcı bilgileri güvenli bir şekilde depolayabilen web uygulamalarını destekler.
- JavaScript web uygulamaları akışı, tarayıcıda çalıştırılan JavaScript uygulamalarını destekler.
- Mobil ve masaüstü uygulamaları akışı, telefon veya bilgisayar gibi cihazlara yüklenen uygulamaları destekler.
- TV'ler ve sınırlı giriş cihazları için OAuth 2.0 akışı, oyun konsolları ve video kameralar gibi sınırlı giriş özelliğine sahip cihazları destekler. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
- Hizmet hesabı akışı için OAuth 2.0 akışı, kullanıcı bilgilerine erişmeyen sunucular arası etkileşimleri destekler. Ancak YouTube Reporting API ve YouTube Analytics API bu akışı desteklemez. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.
Erişim kapsamlarını belirleme
Kapsamlar, uygulamanızın yalnızca ihtiyaç duyduğu kaynaklara erişim isteğinde bulunmasına ve aynı zamanda kullanıcıların uygulamanıza verdikleri erişim miktarını kontrol etmesine olanak tanır. Bu nedenle, istenen kapsam sayısı ile kullanıcıdan izin alma olasılığı arasında ters bir ilişki olabilir.
OAuth 2.0 yetkilendirmesini uygulamaya başlamadan önce, uygulamanızın erişmesi için izin gerektirecek kapsamları belirlemenizi öneririz.
YouTube Analytics API aşağıdaki kapsamları kullanır:
Kapsamlar | |
---|---|
https://www.googleapis.com/auth/youtube | YouTube hesabınızı yönetin |
https://www.googleapis.com/auth/youtube.readonly | YouTube hesabınızı görüntüleyin |
https://www.googleapis.com/auth/youtubepartner | Varlıklarınızı ve ilişkili içeriği YouTube'da görüntüleyin ve yönetin |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | YouTube içeriğiniz için parasal ve parasal olmayan YouTube Analytics raporlarını görüntüleyin |
https://www.googleapis.com/auth/yt-analytics.readonly | YouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin |
YouTube Reporting API aşağıdaki kapsamları kullanır:
Kapsamlar | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | YouTube içeriğiniz için parasal ve parasal olmayan YouTube Analytics raporlarını görüntüleyin |
https://www.googleapis.com/auth/yt-analytics.readonly | YouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin |
OAuth 2.0 API Kapsamları dokümanı, Google API'lerine erişmek için kullanabileceğiniz kapsamların tam listesini içerir.