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 liste bazı temel OAuth 2.0 kavramları açıklamaktadı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. O sayfaya verilen bağlantı şunu belirtiyor:scope Uygulamanızın kullanıcının hesabına erişim için talep ettiği izinler. 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 belirteç (token) döndürür. Uygulamanızın türüne bağlı olarak, ya belirteci doğrular ya da farklı bir belirteç türüyle değiştirir.

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

Önemli: OAuth 2.0 Yetkilendirmesini kullanmak için Google API Konsolunda yetkilendirme kimlik bilgilerini edinmeniz gerekir.

Daha fazla ayrıntı 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üklenmiş uygulamaları destekler.
  • TV'ler ve sınırlı giriş özellikli 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şim sağlamayan sunucu-sunucu etkileşimlerini destekler. Ancak YouTube Reporting API ve YouTube Analytics API bu akışı desteklemiyor. 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.