- برنامه من متکی به نظرات، زیرنویس‌ها یا برخی از عملکردهای دیگر است که در YouTube Data API نسخه 3 وجود ندارد. باید چکار کنم؟
- در نسخه 2، من می توانم با استفاده از آدرس ایمیل + رمز عبور از طریق ClientLogin احراز هویت کنم. چگونه می توانم به OAuth 2.0 منتقل شوم؟
- سهمیه در نسخه 2 با نسخه 3 چگونه متفاوت است؟ شباهت ها چیست؟
- Data API v2 از دسترسی ناشناس API برای جستارهای فقط خواندنی مانند جستجوهای ویدیویی پشتیبانی می کند. چرا برای برقراری تماس های فقط خواندنی در نسخه 3 باید ثبت نام کنم؟
- آیا می توانم پس از مهاجرت به v3 از همان کتابخانه های کلاینت استفاده کنم که با v2 استفاده کردم؟
- من قبلاً از YouTube Insight API استفاده می کردم که بخشی از نسخه 2 است. جایگزین من چیست؟
- من به استفاده از GData API (v1 یا v2) برای فیدهای RSS/Atom ویدیوهای YouTube متکی هستم. آیا پس از منسوخ شدن آنها جایگزینی دارم؟
- از آنجایی که من هنوز از برخی از ویژگی های v2 استفاده می کنم که هنوز در نسخه 3 در دسترس نیستند، باید به هر دو نسخه API در یک برنامه دسترسی داشته باشم. برخی از بهترین شیوه ها چیست؟
- برنامه من متکی به نظرات، زیرنویس‌ها یا برخی از عملکردهای دیگر است که در YouTube Data API نسخه 3 وجود ندارد. باید چکار کنم؟
فعلاً می‌توانید از API v2 برای نظرات و بارگذاری زیرنویس‌های ویدیو استفاده کنید، و ما به زودی این قابلیت را به API v3 اضافه خواهیم کرد. در حالی که ما هنوز تاریخ مشخصی نداریم، این قابلیت را منتشر خواهیم کرد تا توسعه دهندگان تا حد امکان زمان بیشتری برای مهاجرت به نسخه 3 داشته باشند.
برای برخی دیگر از ویژگی‌ها، همانطور که یوتیوب به طور کلی به تکامل خود ادامه می‌دهد، برابری 100 درصدی بین APIهای v2 و v3 وجود نخواهد داشت. لطفاً برای جزئیات بیشتر در مورد اینکه چه عملکردی در نسخه 3 پشتیبانی می شود، به مستندات API v3 مراجعه کنید.
- در نسخه 2، من می توانم با استفاده از آدرس ایمیل + رمز عبور از طریق ClientLogin احراز هویت کنم. چگونه می توانم به OAuth 2.0 منتقل شوم؟
لطفاً راهنمای حرکت از ClientLogin به OAuth 2.0 ما را ببینید.
- سهمیه در نسخه 2 با نسخه 3 چگونه متفاوت است؟ شباهت ها چیست؟
هر دو نسخه 2 و 3 از یک سیستم سهمیه مبتنی بر هزینه استفاده می کنند که در آن برخی از عملیات (مانند آپلودها) مقدار بیشتری از سهمیه را نسبت به سایرین مصرف می کنند (مانند جستجوها).
مهم‌ترین تفاوت بین سیستم‌های v2 و v3 این است که v3 یک استخر سهمیه جهانی را فراهم می‌کند، که v2 انجام نداد. در نسخه 2، درخواست‌هایی که با یک کلید توسعه‌دهنده انجام می‌شوند، اما از آدرس‌های IP متمایز یا از کاربران تأیید شده مجزا می‌آیند، نمی‌توانند خطاهای سهمیه جهانی برای آن کلید توسعه‌دهنده ایجاد کنند - بدترین اتفاق ممکن است یک خطای سهمیه محلی مرتبط با آدرس IP یا کانال یوتیوب.
در نسخه 3، یک استخر سهمیه جهانی (50 میلیون واحد در روز) وجود دارد و تمام تماس‌های API که با یک پروژه خاص در کنسول توسعه‌دهنده مرتبط هستند، سهمیه آن را کاهش می‌دهند. بنابراین، از نظر تئوری ممکن است برای یک آدرس IP یا کانال واحد، تمام سهمیه مربوط به ثبت API را مصرف کند، که می تواند منجر به قطعی شود که سایر کاربران را تحت تأثیر قرار می دهد.
با این حال، همچنان می‌توانید در برابر تخلیه سهمیه جهانی توسط یک کاربر محافظت کنید. این مستندات عمومی نحوه تعریف و اعمال محدودیت‌های نرخ سخت‌گیرانه‌تر برای هر کاربر را توضیح می‌دهد.
- Data API v2 از دسترسی ناشناس API برای جستارهای فقط خواندنی مانند جستجوهای ویدیویی پشتیبانی می کند. چرا برای برقراری تماس های فقط خواندنی در نسخه 3 باید ثبت نام کنم؟
v3 API بر روی زیرساخت مدرن Google API ساخته شده است، که در آن استفاده از بسیاری از API های مختلف را می توان به ثبت نام Developer Console خاص مرتبط کرد. این به توسعه دهندگان یک دید یکپارچه از فناوری های Google که استفاده می کنند ارائه می دهد.
برای تماس‌های API که فقط به داده‌های در دسترس عموم دسترسی دارند، مانند جستارهای جستجو، کلاینت‌های API می‌توانند یک کلید API ساده را هنگام درخواست API تعیین کنند. فراخوان‌های API که به داده‌های کاربر خصوصی دسترسی دارند باید نشانه‌های OAuth 2.0 را مشخص کنند.
توسعه‌دهندگان می‌توانند کلیدهای API ساده و اعتبارنامه‌های مورد نیاز برای تولید توکن‌های OAuth 2.0 در Google Developers Console را دریافت کنند. توسعه دهندگان همچنین می توانند API را بدون ایجاد پروژه ابتدا با استفاده از APIs Explorer آزمایش کنند.
- آیا می توانم پس از مهاجرت به v3 از همان کتابخانه های کلاینت استفاده کنم که با v2 استفاده کردم؟
v3 API اساساً با v2 متفاوت است و مجموعه جدیدی از کتابخانه های مشتری برای استفاده وجود دارد. همه آنها از https://developers.google.com/youtube/v3/libraries در دسترس هستند و همه آنها دارای پشتیبانی بومی برای مجوز OAuth 2 هستند.
- من قبلاً از YouTube Insight API استفاده می کردم که بخشی از نسخه 2 است. جایگزین من چیست؟
توصیه می‌کنیم همه برنامه‌نویسان از YouTube Insight API که در سپتامبر 2013 به طور جداگانه منسوخ شده بود، به API جدید YouTube Analytics مهاجرت کنند.
- من به استفاده از GData API (v1 یا v2) برای فیدهای RSS/Atom ویدیوهای YouTube متکی هستم. آیا پس از منسوخ شدن آنها جایگزینی دارم؟
در حال حاضر هیچ جایگزین مستقیمی وجود ندارد. توصیه می‌کنیم به کاربران برنامه خود توانایی مدیریت و بازیابی اشتراک‌های YouTube خود را با استفاده از روش‌های سرویس اشتراک YouTube Data API v3 ارائه دهید.
- از آنجایی که من هنوز از برخی از ویژگی های v2 استفاده می کنم که هنوز در نسخه 3 در دسترس نیستند، باید به هر دو نسخه API در یک برنامه دسترسی داشته باشم. برخی از بهترین شیوه ها چیست؟
می توانید از پشتیبانی OAuth 2.0 در کتابخانه های کلاینت v3 برای به دست آوردن نشانه های مجوز استفاده کنید که برای عملیات نوشتن در نسخه 2 و 3 کار می کنند. هر توکنی که دارای
https://gdata.youtube.comیاhttps://www.googleapis.com/auth/youtubeباشد، برای هر دو API کار خواهد کرد.برای تماس‌های API که به توکن‌های OAuth 2.0 نیاز ندارند، یک کلید API v3 را از https://cloud.google.com/console دریافت کنید و از آن برای نسخه‌های 2 و 3 استفاده کنید.
توصیه می کنیم برنامه خود را برای استفاده از v3 API هر زمان که ممکن است مهاجرت کنید، حتی اگر برای برخی عملکردها همچنان نیاز به تماس با v2 API دارید. با انجام این کار، برنامه خود را قادر می‌سازید تا از عملکرد قوی‌تری که v3 ارائه می‌دهد استفاده کند. همچنین زمانی که ویژگی‌های فقط v2 که در نسخه 3 پشتیبانی می‌شوند در نهایت منتشر شوند، تلاش‌های مهاجرت آینده خود را ساده‌تر می‌کنید.