مجوز OAuth 2.0 را اجرا کنید

The YouTube Reporting API and YouTube Analytics API support the OAuth 2.0 protocol for authorizing access to private user data. The following list explains some core OAuth 2.0 concepts:

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

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

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

  برای مثال، یک برنامه وب سمت سرور، توکن برگشتی را با یک توکن دسترسی و یک توکن به‌روزرسانی (refresh token) تعویض می‌کند. توکن دسترسی به برنامه اجازه می‌دهد تا درخواست‌ها را از طرف کاربر تأیید کند و توکن به‌روزرسانی به برنامه اجازه می‌دهد تا پس از انقضای توکن دسترسی اصلی، یک توکن دسترسی جدید بازیابی کند.

Important: To use the OAuth 2.0 Authorization, you need to obtain authorization credentials in the Google API Console .

For more details, see the OAuth 2.0 Authorization Guide .

OAuth 2.0 flows

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

• The server-side web apps flow supports web applications that can securely store persistent information.
• The JavaScript web apps flow supports JavaScript applications running in a browser.
• The mobile and desktop apps flow supports applications installed on a device, such as a phone or computer.
• جریان OAuth 2.0 برای تلویزیون‌ها و دستگاه‌های با ورودی محدود، از دستگاه‌هایی با قابلیت‌های ورودی محدود، مانند کنسول‌های بازی و دوربین‌های فیلمبرداری، پشتیبانی می‌کند. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
• جریان OAuth 2.0 برای جریان حساب سرویس از تعاملات سرور به سرور که به اطلاعات کاربر دسترسی ندارند، پشتیبانی می‌کند. با این حال، YouTube Reporting API و YouTube Analytics API از این جریان پشتیبانی نمی‌کنند. 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.

شناسایی محدوده‌های دسترسی

محدوده‌ها به برنامه شما این امکان را می‌دهند که فقط به منابعی که نیاز دارد درخواست دسترسی کند و در عین حال کاربران را قادر می‌سازد میزان دسترسی که به برنامه شما می‌دهند را کنترل کنند. بنابراین، ممکن است رابطه معکوسی بین تعداد محدوده‌های درخواستی و احتمال کسب رضایت کاربر وجود داشته باشد.

قبل از شروع پیاده‌سازی احراز هویت OAuth 2.0، توصیه می‌کنیم محدوده‌هایی را که برنامه شما برای دسترسی به آنها نیاز به مجوز دارد، شناسایی کنید.

The YouTube Analytics API uses the following scopes:

The YouTube Reporting API uses the following scopes:

سند OAuth 2.0 API Scopes شامل لیست کاملی از scopeهایی است که ممکن است برای دسترسی به APIهای گوگل از آنها استفاده کنید.