Activities: insert

YouTube ویژگی بولتن کانال را منسوخ کرده است و این روش دیگر پشتیبانی نمی شود.

برای جزئیات بیشتر، لطفاً به مرکز راهنمایی 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 است که می توانید در مقدار پارامتر بگنجانید:
  • contentDetails
  • id
  • snippet

درخواست بدن

یک منبع فعالیت در بدنه درخواست ارائه دهید. برای آن منبع:

  • شما باید یک مقدار برای این ویژگی ها مشخص کنید:

    • 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 درخواست تکمیل نمی شود زیرا شما از سهمیه خود فراتر رفته اید.