توجه: YouTube Content ID API برای استفاده شرکای محتوای YouTube در نظر گرفته شده است و برای همه توسعه دهندگان یا همه کاربران YouTube قابل دسترسی نیست. اگر API شناسه محتوای YouTube را بهعنوان یکی از سرویسهای فهرست شده در Google API Console نمیبینید، برای کسب اطلاعات بیشتر درباره YouTube Partner Program به مرکز راهنمایی YouTube مراجعه کنید.
زمینه
حساب سرویس یک حساب Google است که میتواند بدون هیچ گونه تعامل با کاربر برای اجازه تماسهای API استفاده شود. برخلاف سایر جریانهای OAuth 2.0، احراز هویت و مجوز دسترسی با استفاده از جریان حسابهای سرویس OAuth 2.0 در مرورگر وب انجام نمیشود. در عوض، OAuth 2.0 برای حساب های خدماتی به امضاهای ��مزنگاری برای اجازه دسترسی متکی است. تا زمانی که کد شما به کلید رمزنگاری زیرین دسترسی داشته باشد، میتواند به برقراری تماسهای API بدون نگرانی در مورد بهروزرسانی و دسترسی به توکنها ادامه دهد. برای برنامههای خودکاری که بدون دخالت انسان روی سرورها اجرا میشوند، عالی است.
اکنون میتوانید از OAuth 2.0 برای جریان حسابهای سرویس برای تأیید درخواستهای API شناسه محتوای YouTube استفاده کنید. همچنین میتوانید از این جریان برای تأیید فراخوانی YouTube Data API و YouTube Analytics API به روشهایی استفاده کنید که از پارامترهای تفویض اختیار پشتیبانی میکنند. در همه این موارد، برنامهای که از این جریان استفاده میکند، درخواست API را بهعنوان شریک محتوای YouTube (با استفاده از حساب YouTube CMS) به جای مالک کانال YouTube مجوز میدهد.
حساب سرویس خود را تنظیم کنید
اسکرینشاتهای زیر روند ایجاد یک حساب سرویس مرتبط با پروژه API شما را نشان میدهند، که باید مطمئن شوید که قبلاً APIهای مناسب (API دادههای YouTube نسخه 3، YouTube Analytics API، YouTube Content ID API و غیره) را فعال کرده است.
- از https://cloud.google.com/console دیدن کنید و پروژه API موجود خود را انتخاب کنید (یا یک پروژه جدید ایجاد کنید).
- در نوار کناری سمت چپ، APIs & auth را انتخاب کنید.
- مطمئن شوید YouTube Content ID API برای پروژه شما فعال است.
- در نوار کناری سمت چپ، اعتبارنامه ها را انتخاب کنید.
- روی دکمه Create new client ID کلیک کنید.
- حساب سرویس را از گزینه های فهرست شده انتخاب کنید و روی ایجاد شناسه مشتری کلیک کنید. کلید خصوصی برای حساب سرویس شما در دستگاه شما دانلود می شود. این تنها کپی کلید است و باید کلید را در مکانی امن ذخیره کنید که برنامه شما بتواند از آن بخواند.
- آدرس ایمیل حساب سرویس را یادداشت کنید. (آدرس ایمیل در صفحه اعتبارنامه ظاهر میشود.) برای اعطای امکان دسترسی به حساب کاربری YouTube CMS به این آدرس نیاز دارید.
- از https://www.youtube.com/content_owner_users دیدن کنید و روی دکمه کاربر جدید کلیک کنید.
- آدرس ایمیل حساب سرویس را از مرحله 7 در قسمت آدرس ایمیل وارد کنید و نقش مناسب برای کاربر را انتخاب کنید. سپس روی دکمه دعوت کلیک کنید.
- حساب سرویس شما بهطور خودکار دعوتنامه را میپذیرد، و آن حساب میتواند متعاقباً به APIهای YouTube که از طرف حساب YouTube CMS شما عمل میکنند، دسترسی داشته باشد.
- دستورالعملهای جریان حساب سرویس OAuth 2.0 را در راهنمای درخواستهای مجوز برای تأیید درخواستها با استفاده از حساب سرویس خود دنبال کنید.
برقراری تماس های API
کتابخانه های مشتری اکثر زبان ها از OAuth 2.0 برای جریان حساب خدمات پشتیبانی می کنند. باید بتوانید از مثالهای موجود در اسناد کتابخانه پیروی کنید تا مجوز اولیه را با حوزههای YouTube API مناسب انجام دهید.
مهمترین چیزی که باید در نظر داشته باشید این است که باید از پارامترهای تفویض اختیار مناسب برای اقدام از طرف یک کانال معین که به حساب CMS شما پیوند شده است استفاده کنید. برای مشاهده لیستی از کانال های مرتبط با حساب CMS خود، از https://cms.youtube.com/edit_user_accounts دیدن کنید.