OAuth 2.0 Yetkilendirmesini Uygulama

YouTube Reporting API ve YouTube Analytics API, özel kullanıcı verilerine erişimi yetkilendirmek için OAuth 2.0 protokolünü destekler. Aşağıdaki listede bazı temel OAuth 2.0 kavramlar açıklanmaktadır:

  • Kullanıcı, uygulamanızda ilk kez Google Account or YouTube account oturumunun açılmasını gerektiren özellikleri kullanmaya çalıştığında uygulamanız OAuth 2.0 yetkilendirme sürecini başlatır.

  • Uygulamanız, kullanıcıyı Google'ın yetkilendirme sunucusuna yönlendirir. Bu sayfanın bağlantısında, uygulamanızın kullanıcı hesabına erişmek için istediği scope belirtilir. scope, kimliği doğrulanmış kullanıcı olarak hareket ederken uygulamanızın alabileceği, ekleyebileceği, güncelleyebileceği veya silebileceği kaynakları belirtir.

  • Kullanıcı, uygulamanızın bu kaynaklara erişmesine izin verirse Google, uygulamanıza bir jeton döndürür. Uygulamanızın türüne bağlı olarak jetonu doğrular veya farklı bir jeton türüyle değiştirir.

    Örneğin, sunucu tarafı bir web uygulaması, döndürülen jetonu erişim jetonu ve yenileme jetonuyla değiştirir. Erişim jetonu, uygulamanın kullanıcı adına istekleri yetkilendirmesine olanak tanır. Yenileme jetonu ise uygulamanın, orijinal erişim jetonunun süresi dolduğunda yeni bir erişim jetonu almasına olanak tanır.

Önemli: OAuth 2.0 yetkilendirmesini kullanmak için Google API Konsolu'nda yetkilendirme kimlik bilgilerini edinmeniz gerekir.

Daha fazla bilgi için OAuth 2.0 Yetkilendirme Kılavuzu'na bakın.

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ışan JavaScript uygulamalarını destekler.
  • Mobil ve masaüstü uygulamaları akışı, telefon veya bilgisayar gibi bir cihaza 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ş özelliklerine 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 sunucudan sunucuya 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ını sağlar. Ayrıca, kullanıcıların uygulamanıza verdiği erişim miktarını kontrol etmesine de olanak tanır. Bu nedenle, istenen kapsam sayısı ile kullanıcı izni alma olasılığı arasında ters bir ilişki olabilir.

OAuth 2.0 yetkilendirmesini uygulamaya başlamadan önce, uygulamanızın erişim izni gerektireceği kapsamları belirlemenizi öneririz.

YouTube Analytics API aşağıdaki kapsamları kullanır:

Kapsam Açıklama
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 YouTube'daki varlıklarınızı ve ilişkili içeriği görüntüleyin ve yönetin
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube içeriğiniz için finansal ve finansal 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:

Kapsam Açıklama
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube içeriğiniz için finansal ve finansal 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ında, Google API'lerine erişmek için kullanabileceğiniz kapsamların tam listesi yer alır.