توجه: رابط برنامهنویسی کاربردی داده یوتیوب (YouTube Data API) برای استفاده شرکای محتوای یوتیوب در نظر گرفته شده است و برای همه توسعهدهندگان یا همه کاربران یوتیوب قابل دسترسی نیست. دسترسی به آن نیاز به یک حساب مدیریت محتوای یوتیوب (YouTube Content Manager) دارد. اگر حساب مدیریت محتوای یوتیوب دارید اما رابط برنامهنویسی کاربردی داده یوتیوب را به عنوان یکی از سرویسهای فهرست شده در کنسول گوگل کلود (Google Cloud Console) نمیبینید، با مدیر شریک یا پشتیبانی شریک تعیینشده خود تماس بگیرید.
YouTube Data API از پروتکل OAuth 2.0 برای مجوز دسترسی به دادههای خصوصی کاربر پشتیبانی میکند. لیست زیر برخی از مفاهیم اصلی OAuth 2.0 را توضیح میدهد:
وقتی کاربری برای اولین بار سعی میکند از ویژگیهایی در برنامه شما استفاده کند که نیاز به ورود به Google Account or YouTube account کاربر دارد، برنامه شما فرآیند احراز هویت OAuth 2.0 را آغاز میکند.
برنامه شما کاربر را به سرور احراز هویت گوگل هدایت میکند. لینک به آن صفحه،
scopeدسترسی مورد درخواست برنامه شما برای حساب کاربری را مشخص میکند. اینscope، منابعی را که برنامه شما میتواند هنگام ایفای نقش کاربر احراز هویت شده، بازیابی، درج، بهروزرسانی یا حذف کند، مشخص میکند.اگر کاربر با اعطای مجوز به برنامه شما برای دسترسی به آن منابع موافقت کند، گوگل یک توکن به برنامه شما برمیگرداند. بسته به نوع برنامه شما، یا توکن را اعتبارسنجی میکند یا آن را با نوع دیگری از توکن تعویض میکند.
برای مثال، یک برنامه وب سمت سرور، توکن برگشتی را با یک توکن دسترسی و یک توکن بهروزرسانی (refresh token) تعویض میکند. توکن دسترسی به برنامه اجازه میدهد تا درخواستها را از طرف کاربر تأیید کند و توکن بهروزرسانی به برنامه اجازه میدهد تا پس از انقضای توکن دسترسی اصلی، یک توکن دسترسی جدید بازیابی کند.
مهم: برای استفاده از مجوز OAuth 2.0، باید اعتبارنامههای مجوز را در کنسول Google Cloud دریافت کنید .
برای جزئیات بیشتر، به راهنمای مجوز OAuth 2.0 مراجعه کنید.
جریانهای OAuth 2.0
API های گوگل از چندین مورد استفاده OAuth 2.0 پشتیبانی میکنند:
- جریان برنامههای وب سمت سرور از برنامههای وب پشتیبانی میکند که میتوانند اطلاعات پایدار را به طور ایمن ذخیره کنند.
- جریان برنامههای وب جاوااسکریپت از برنامههای جاوااسکریپت که در مرورگر اجرا میشوند، پشتیبانی میکند.
- جریان برنامههای موبایل و دسکتاپ از برنامههای نصب شده روی دستگاهی مانند تلفن یا رایانه پشتیبانی میکند.
- جریان تلویزیونها و دستگاههای با ورودی محدود، از دستگاههایی با قابلیتهای ورودی محدود، مانند کنسولهای بازی و دوربینهای ویدیویی، پشتیبانی میکند.
- جریان حساب سرویس از تعاملات سرور به سرور پشتیبانی میکند که به اطلاعات کاربر دسترسی ندارند.