سپتامبر 2013 (به روز رسانی 12/02/2013)
- معرفی
- سوالات متداول
- برای نظرات ارسال شده قبل از انتقال چه اتفاقی افتاد؟
- آیا فید نظرات هنوز موجود است؟
- آیا فیدی وجود دارد که قالب فید جدید را نشان دهد؟
- آیا هنوز هم می توانم از طریق API نظر ایجاد کنم؟
- نظرات مبتنی بر Google+ رشتهبندی را ارائه میدهند. این برای پاسخ های نظرات YouTube چه معنایی دارد؟
- وقتی از طریق YouTube API نظر می دهم، در +Google چه اتفاقی می افتد؟
- آیا از زمان تغییر به سیستم نظردهی جدید، نظرات همچنان در فید فعالیت نشان داده می شوند؟
- آیا SUP در API قدیمی برای نظرات کار می کند؟
معرفی
سیستم نظردهی جدید YouTube ، که در نوامبر 2013 راه اندازی شد و توسط Google+ پشتیبانی می شود، به کاربران YouTube امکان می دهد نظرات بیشتری را در هر ویدیو نسبت به گذشته بازیابی کنند. سیستم جدید یافتن مکالمات معنادار را نیز آسانتر میکند، زیرا نظرات بر اساس ارتباط با تک تک کاربران مرتب میشوند.
در حالی که نظرات جدید در حال حاضر در YouTube Data API نسخه 3 پشتیبانی نمیشوند، میتوانید به استفاده از نسخه قدیمیتر API (v2) با چند نکته در زیر (و مزایای ذکر شده در بالا) ادامه دهید.
توصیه میکنیم اکنون که به سیستم نظردهی جدید تغییر دادهایم، تأیید کنید که یکپارچهسازی شما همچنان به کار خود ادامه میدهد و در صورت مواجهه با اشکالی به ما هشدار میدهد ( مشکلات فایل در youtube.com/dev ). با تشکر!
سوالات متداول
برای نظرات ارسال شده قبل از انتقال چه اتفاقی افتاد؟
نظرات ارسال شده قبل از انتقال به سیستم جدید ارائه شده توسط +Google منتقل شده است.
آیا فید نظرات هنوز موجود است؟
بله، به عنوان مثال، اگر از API برای بازیابی نظرات یک ویدیو استفاده میکنید، یک فید از نظرات مرتبشده بر اساس ارتباط، همانطور که در اعلامیه گفته شده است، دریافت میکنید. به صورت پیش فرض سفارش دهید با این حال، همچنان میتوانید با تنظیم مقدار پارامتر orderby
برای published
در درخواست API خود همانطور که در مثال زیر نشان داده شده است، نظرات را به ترتیب زمانی ترتیب دهید:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published
توصیه می کنیم بهترین روش استاندارد استفاده از پیوندهای next
و previous
را در فید نظرات به صفحه از طریق نظرات دنبال کنید. با انجام این کار، شما همچنین از مزایای بیشتری برخوردار خواهید شد که میتوانید تعداد نظرات بیشتری را نسبت به آنچه قبلاً می توانستید انجام دهید، صفحه کنید.
اگر صراحتاً مقداری را برای start-index
به صفحه از طریق فید نظرات تنظیم کنید (توصیه نمی شود)، ممکن است باعث رفتار ناسازگار شود و فقط تعداد کمی از نظرات را برگردانید.
به روز رسانی (11/10/2013):
* بهطور پیشفرض، فیدهای نظرات بر اساس ارتباط کلی و نه ارتباط شخصی مرتب میشوند. به عبارت دیگر، یک درخواست فید نظر احراز هویت شده و احراز هویت نشده نتایج یکسانی را برمیگرداند. API از یک فید نظرات شخصی که شامل پستهای غیر عمومی است پشتیبانی میکند. برای دریافت این فید، به سادگی یک درخواست احراز هویت کنید و مقدار پارامتر relevant-to-me
در درخواست API خود روی true
تنظیم کنید، همانطور که در مثال زیر نشان داده شده است:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true
آیا فیدی وجود دارد که قالب فید جدید را نشان دهد؟
همه فیدهای نظرات اکنون از قالب جدید پشتیبانی می کنند. چند نمونه در زیر آمده است.
- فید مبتنی بر ارتباط:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
- فید بر اساس زمانی:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published
آیا هنوز هم می توانم از طریق API نظر ایجاد کنم؟
بله، اما برای نوشتن نظرات جدید با API v2، چندین الزام وجود دارد:
- کاربر احراز هویت شده باید یک کانال YouTube مرتبط با حساب +Google داشته باشد ( جزئیات API )
- درخواست باید از طریق HTTPS ارسال شود (نسخه های فعلی کتابخانه های مشتری قدیمی به طور پیش فرض از این پشتیبانی می کنند)
اگر یکی از این الزامات برآورده نشود، API یک خطا را برمیگرداند.
نظرات مبتنی بر Google+ رشتهبندی را ارائه میدهند. این برای پاسخ های نظرات YouTube چه معنایی دارد؟
پاسخهای نظری که قبل از انتقال داده شدهاند اکنون بهعنوان نظرات معمولی ظاهر میشوند. علاوه بر این، پاسخ مستقیم به نظرات از طریق YouTube API دیگر پشتیبانی نمیشود. در حال حاضر، هیچ راهی برای پاسخ به یک نظر جدید از طریق API YouTube وجود ندارد.
پاسخها به نظرات سبک جدید YouTube از طریق سایتها و برنامههای YouTube و Google+ با فید نظرات API قدیمی بازگردانده نمیشوند . با این حال، میتوانید پاسخهای واقعی را از طریق APIهای +Google دریافت کنید.
اگر ورودی فید نظر YouTube یک نظر به سبک جدید را نشان دهد، ورودی حاوی یک برچسب <yt:googlePlusUserId>
است. اگر آن برچسب وجود داشته باشد و نظر پاسخی داشته باشد (فقط عنصر <yt:replyCount> را بررسی کنید)، سپس میتوانید شناسه فعالیت +Google را از تگ <id>
ورودی تجزیه کنید. میتوانید از آن شناسه برای فراخوانی روش نظرات: فهرست Google+ API برای بازیابی فهرستی از پاسخهای اخیر به آن نظر استفاده کنید.
گزیده زیر نشان میدهد که چگونه شناسه فعالیت +Google، که با متن پررنگ نشان داده شده است، در ورودی فید نظر ظاهر میشود:
<entry> <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id> <yt:googlePlusUserId>123456789</yt:googlePlusUserId> <yt:replyCount>4</yt:replyCount> <yt:channelId>UCxxxx_xxxxx</yt:channelId> ... </entry>
وقتی از طریق YouTube API نظر می دهم، در +Google چه اتفاقی می افتد؟
گذاشتن نظر از طریق YouTube API پستی در جریان Google+ شما ایجاد نمیکند و اعلان Google+ ایجاد نمیکند.
آیا از زمان تغییر به سیستم نظردهی جدید، نظرات همچنان در فید فعالیت نشان داده می شوند؟
نه الان نه.
آیا SUP در API قدیمی برای نظرات کار می کند؟
نه برای اظهار نظر نیست SUP به فید فعالیت کاربر متکی است. از آنجایی که نظرات دیگر در فید فعالیت نیستند، در SUP نمایش داده نمی شوند.