برای جزئیات بیشتر، لطفاً به مرکز راهنمایی YouTube مراجعه کنید.
یک بولتن برای یک کانال خاص ارسال می کند. (کاربر ارسال کننده درخواست باید مجاز باشد از طرف کانال اقدام کند.)
توجه: حتی اگر یک منبع activity
میتواند حاوی اطلاعاتی درباره اقداماتی مانند رتبهبندی کاربر به یک ویدیو یا علامتگذاری ویدیو بهعنوان مورد علاقه باشد، باید از سایر روشهای API برای تولید آن منابع activity
استفاده کنید. برای مثال، videos.rate()
API برای رتبهبندی یک ویدیو و از متد playlistItems.insert()
برای علامتگذاری یک ویدیو بهعنوان مورد علاقه استفاده میکنید.
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.
درخواست
درخواست HTTP
POST https://www.googleapis.com/youtube/v3/activities
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
مولفه های
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
مولفه های | ||
---|---|---|
پارامترهای مورد نیاز | ||
part | string پارامتر part در این عملیات دو هدف را دنبال می کند. ویژگی هایی را که عملیات نوشتن تنظیم می کند و همچنین ویژگی هایی را که پاسخ API شامل می شود شناسایی می کند.لیست زیر شامل نام part است که می توانید در مقدار پارامتر بگنجانید:
|
درخواست بدن
یک منبع فعالیت در بدنه درخواست ارائه دهید. برای آن منبع:
شما باید یک مقدار برای این ویژگی ها مشخص کنید:
-
snippet.description
-
شما می توانید مقادیری را برای این ویژگی ها تنظیم کنید:
-
snippet.description
-
contentDetails.bulletin.resourceId
-
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع فعالیت را در بدنه پاسخ باز می گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.
نوع خطا | جزئیات خطا | شرح |
---|---|---|
badRequest (400) | bulletinTextRequired | درخواست باید از ویژگی description شی snippet برای ارائه متن برای پست بولتن استفاده کند. |
badRequest (400) | invalidMetadata | ویژگی kind با نوع شناسه ارائه شده مطابقت ندارد. |
forbidden (403) | forbidden | درخواست به درستی مجاز نیست. |
notFound (404) | playlistNotFound | YouTube نمیتواند ویدیویی را که میخواهید با پست بولتن مرتبط کنید پیدا کند. مقدار ویژگی contentDetails.bulletinPosted.playlistId را بررسی کنید. |
notFound (404) | videoNotFound | YouTube نمیتواند ویدیویی را که میخواهید با پست بولتن مرتبط کنید پیدا کند. مقدار ویژگی contentDetails.bulletinPosted.videoId را بررسی کنید. |
userRateLimitExceeded (403) | rateLimitExceeded | درخواست تکمیل نمی شود زیرا شما از سهمیه خود فراتر رفته اید. |