OAuth 2.0 Yetkilendirmesini Uygulama

YouTube Reporting API ve YouTube Analytics API, gizli kullanıcı verilerine erişim yetkilendirmesi 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 bir Google Account or YouTube account uygulamasına giriş yapmasını gerektiren özellikleri ilk kez kullanmaya çalıştığında, 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ı hesabı için istediği erişim scope adresini belirtir. scope, uygulamanızın kimliği doğrulanmış kullanıcı olarak hareket ederken alabileceği, ekleyebileceği, güncelleyebileceği veya silebileceği kaynakları belirtir.

  • Kullanıcı, uygulamanızın bu kaynaklara erişmesi için yetkilendirilmesini kabul ederse 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 bir erişim jetonu ve bir yenileme jetonu olarak değiştirir. Erişim jetonu, uygulamanın kullanıcı adına istekleri yetkilendirmesine olanak tanır. Yenileme jetonu ise orijinal erişim jetonunun süresi dolduğunda uygulamanın 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 cihazda yüklü 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şemeyen 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ğlarken kullanıcıların da uygulamanıza verdikleri erişim miktarını kontrol etmesine olanak tanır. Bu nedenle, istenen kapsamların 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şmek için izne ihtiyaç duyacağı kapsamları belirlemenizi öneririz.

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

Kapsamlar
https://www.googleapis.com/auth/youtubeYouTube hesabınızı yönetin
https://www.googleapis.com/auth/youtube.readonlyYouTube hesabınızı görüntüleyin
https://www.googleapis.com/auth/youtubepartnerYouTube'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.readonlyYouTube içeriğiniz için finansal ve finansal olmayan YouTube Analytics raporlarını görüntüleyin
https://www.googleapis.com/auth/yt-analytics.readonlyYouTube 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.readonlyYouTube içeriğiniz için finansal ve finansal olmayan YouTube Analytics raporlarını görüntüleyin
https://www.googleapis.com/auth/yt-analytics.readonlyYouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin

OAuth 2.0 API Kapsamları belgesi, Google API'lerine erişmek için kullanabileceğiniz kapsamların tam listesini içerir.