پیاده‌سازی اصالت‌سنجی OAuth 2.0

‫YouTube Live Streaming API از پروتکل OAuth 2.0 برای مجاز کردن دسترسی به داده‌های خصوصی کاربر پشتیبانی می‌کند. فهرست زیر برخی‌از مفاهیم اصلی OAuth 2.0 را توضیح می‌دهد:

  • وقتی کاربر برای اولین‌بار تلاش می‌کند از ویژگی‌های برنامه شما که نیاز دارد کاربر در Google Account or YouTube account وارد سیستم شود استفاده کند، برنامه شما فرایند صدور مجوز OAuth 2.0 را آغاز می‌کند.

  • برنامه شما کاربر را به سرور صدور مجوز Google هدایت می‌کند. پیوند آن صفحه scope دسترسی را که برنامه شما برای حساب کاربر درخواست می‌کند مشخص می‌کند. scope منابعی را مشخص می‌کند که برنامه شما می‌تواند هنگام عمل کردن به‌عنوان کاربر اصالت‌سنجی‌شده بازیابی، درج، به‌روزرسانی، یا حذف کند.

  • اگر کاربر با صدور مجوز برای برنامه شما جهت دسترسی به آن منابع موافقت کند، Google یک توکن به برنامه شما برمی‌گرداند. بسته به نوع برنامه، یا نشان را اعتبارسنجی می‌کند یا آن را با نوع دیگری از نشان مبادله می‌کند.

    برای مثال، یک برنامه وب سمت سرور، ژتون برگردانده‌شده را با یک کد دسترسی و یک ژتون بازآوری مبادله می‌کند. کد دسترسی به برنامه اجازه می‌دهد درخواست‌ها را ازطرف کاربر مجاز کند و کد بازآوری به برنامه اجازه می‌دهد وقتی کد دسترسی اصلی منقضی شد، کد دسترسی جدیدی را بازیابی کند.

مهم: برای استفاده از «مجوز OAuth 2.0»، باید اعتبارنامه‌های مجوز را در کنسول Google Cloud دریافت کنید.

برای جزئیات بیشتر، راهنمای مجوز OAuth 2.0 را ببینید.

توجه: کانال باید برای استفاده از ویژگی YouTube Live تأیید شود، که به مالک کانال اجازه می‌دهد محتوای زنده را در آن کانال جاری‌سازی کند. اگر درخواست‌های API را ازطرف کاربر اصالت‌سنجی‌شده‌ای ارسال کنید که کانال او برای جاری‌سازی محتوای زنده فعال یا واجدشرایط نیست، API خطای insufficientPermissions را برمی‌گرداند.

جریان‌های OAuth 2.0

‫Google API از چندین مورد استفاده OAuth 2.0 پشتیبانی می‌کند:

  • جریان برنامه‌های وب سمت سرور از برنامه‌های وبی پشتیبانی می‌کند که می‌توانند اطلاعات پایدار را به‌طور ایمن ذخیره کنند.
  • جریان برنامه‌های وب جاوا اسکریپت از برنامه‌های جاوا اسکریپت که در مرورگر اجرا می‌شوند پشتیبانی می‌کند.
  • جریان برنامه‌های تلفن همراه و رایانه از برنامه‌های نصب‌شده در دستگاهی مانند تلفن یا رایانه پشتیبانی می‌کند.
  • جریان تلویزیون‌ها و دستگاه‌های ورودی محدود از دستگاه‌هایی با قابلیت‌های ورودی محدود، مانند کنسول‌های بازی و دوربین‌های ویدیویی، پشتیبانی می‌کند.
  • جریان OAuth 2.0 برای جریان حساب سرویس از تعاملات سرور به سرور که به اطلاعات کاربر دسترسی ندارند پشتیبانی می‌کند. بااین‌حال، YouTube Live Streaming API از این جریان پشتیبانی نمی‌کند. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate a NoLinkedYouTubeAccount error.