جف پوسنیک، روابط توسعه‌دهنده YouTube - ژوئن 2013
بیش از یک سال است که می‌توان نمایه‌های +Google را با کانال‌های YouTube پیوند داد، و ما در مورد اینکه چگونه برخی از پاسخ‌های Data API v2 در نتیجه پیوند نمایه تغییر کرده‌اند، وبلاگ‌نویسی کرده‌ایم . اخیراً، ایجاد کانال‌های YouTube جدید که نام کاربری سنتی YouTube با آنها مرتبط نیست و در عوض، تنها با نمایه +Google آنها شناسایی می‌شوند، ممکن شده است. بسیاری از اطلاعات آن پست وبلاگ همچنان اعمال می شود، اما این چین و چروک اضافی برخی از مفروضات اساسی در مورد کانال های YouTube را باطل می کند - مانند اینکه هر کدام همیشه با یک نام کاربری منحصر به فرد YouTube مرتبط هستند - و ما می خواستیم برخی از بهترین روش های اضافی را دنبال کنیم. کدی بنویسید که با تمام سلیقه های کانال کار کند.
شناسه‌های کانال در Data API نسخه 3
تمام عملیات نسخه 3 که با کانال ها کار می کنند از شناسه کانال منحصراً به عنوان وسیله ای برای شناسایی آن کانال ها استفاده می کنند. شناسه کانال یک کاربر YouTube خاص در نسخه 2 و 3 API یکسان است و انتقال بین نسخه ها را ساده می کند. این اتکای کامل به شناسه‌های کانال ممکن است برای توسعه‌دهندگانی که قبلاً به انتقال نام‌های کاربری YouTube به روش‌های API عادت داشتند، گیج‌کننده باشد، اما نسخه 3 برای برخورد یکسان با کانال‌های دارای نام کاربری قدیمی و بدون نام کاربری قدیمی طراحی شده است و این به معنای استفاده از شناسه کانال در همه جا است.
اگر از نسخه 3 استفاده می کنید و می خواهید شناسه کانال مربوط به کاربر مجاز فعلی را بازیابی کنید، می توانید با روش channels.list(part="id", mine=true) تماس بگیرید. این معادل درخواست نمایه کانال کاربر default در نسخه 2 است.
اگر زمانی با نام کاربری دلخواه و قدیمی YouTube مواجه شدید که باید آن را با استفاده از نسخه 3 API به یک شناسه کانال ترجمه کنید، می‌توانید یک channels.list(part="id", forUsername=" username ") تماس بگیرید API.
اگر فقط یک نام نمایشی می دانید و به دنبال یافتن کانال مربوطه هستید، روش search.list(part="snippet", type="channel", q=" display name ") مفید خواهد بود. شما باید آماده باشید تا با امکان پاسخگویی تماس به بیش از یک مورد در پاسخ، مقابله کنید، زیرا نام های نمایشی منحصر به فرد نیستند.
شناسه‌های کانال در Data API v2
توجه: YouTube Data API (v2) از 26 فوریه 2014 منسوخ شده است و API رد شده است. برنامه هایی که هنوز از v2 API استفاده می کنند باید فوراً به API v3 مهاجرت کنند.
بزرگترین نکته برای توسعه دهندگانی که از Data API نسخه 2 قدیمی استفاده می کنند این است که باید بدانید که هر کانال YouTube یک نام کاربری منحصر به فرد ندارد . خوشبختانه، هر کانال YouTube تضمین شده است که یک شناسه کانال منحصر به فرد مرتبط با آن داشته باشد، که با مقدار موجود در تگ <yt:channelId> نشان داده شده است، و این مقداری است که ما به توسعه دهندگان توصیه می کنیم به جای نام کاربری از آن استفاده کنند. برای مثال، اگر پایگاه داده‌ای دارید که نام‌های کاربری YouTube را به اطلاعات مربوط به آن کانال نگاشت می‌کند، ورودی‌های قدیمی‌تر شما باید به کار خود ادامه دهند. (کانال‌های موجود نام کاربری خود را از دست نمی‌دهند.) با این حال، با گذشت زمان، این احتمال بیشتر و بیشتر می‌شود که مجبور شوید با کانال‌هایی کار کنید که نمی‌توانند به طور منحصربه‌فرد با نام کاربری شناسایی شوند.
چند عامل انتقال از نام کاربری به شناسه کانال را ساده می کند. ابتدا، Data API v2 شناسه‌های کانال را در URLهای درخواستی هر جا که نام‌های کاربری YouTube را می‌پذیرد، می‌پذیرد، به این معنی که می‌توانید به طور یکپارچه شناسه کانال را با کد موجود خود عوض کنید. برای مثال، از آنجایی که UC_x5XG1OV2P6uZZ5FSM9Ttw شناسه کانال برای کانال با نام کاربری قدیمی GoogleDevelopers است، دو نشانی وب زیر درخواست‌های API معادل هستند:
https://gdata.youtube.com/feeds/api/users/GoogleDevelopers?v=2.1https://gdata.youtube.com/feeds/api/users/UC_x5XG1OV2P6uZZ5FSM9Ttw?v=2.1
نکته دیگری که باید در نظر داشته باشید این است که هر زمان که درخواست‌های تایید شده نسخه 2 را انجام می‌دهید، هرگز نیازی به وارد کردن نام کاربری کانال مجاز در هنگام ساخت URL های درخواستی ندارید. همیشه می توانید مقدار default به جای نام کاربری (یا شناسه کانال) استفاده کنید. بنابراین، برای مثال، اگر می‌خواهید فید آپلود ویدیو را برای کاربر مجاز فعلی بازیابی کنید، می‌توانید این کار را در https://gdata.youtube.com/feeds/api/users/default/uploads?v=2.1 انجام دهید.