activities.list
هنوز بولتن های کانال را بر نمی گرداند و روش activities.insert
دیگر پشتیبانی نمی شود. برای جزئیات بیشتر، لطفاً به مرکز راهنمایی YouTube مراجعه کنید. یک منبع activity
حاوی اطلاعاتی درباره اقدامی است که یک کانال یا کاربر خاص در YouTube انجام داده است. اقدامات گزارش شده در فیدهای فعالیت شامل رتبه بندی یک ویدیو، اشتراک گذاری یک ویدیو، علامت گذاری یک ویدیو به عنوان مورد علاقه، آپلود یک ویدیو و غیره است. هر منبع activity
، نوع اقدام، کانال مرتبط با اقدام، و منبع(های) مرتبط با اقدام، مانند ویدیویی که رتبهبندی یا آپلود شده را مشخص میکند.
روش ها
API از روش های زیر برای منابع activities
پشتیبانی می کند:
- list
- فهرستی از رویدادهای فعالیت کانال را برمیگرداند که با معیارهای درخواست مطابقت دارند. به عنوان مثال، می توانید رویدادهای مرتبط با یک کانال خاص یا با کانال خود کاربر را بازیابی کنید. اکنون آن را امتحان کنید .
روش activities.insert
دیگر پشتیبانی نمی شود.
نمایندگی منابع
ساختار JSON زیر فرمت یک منبع activities
را نشان می دهد:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
kind | string نوع منبع API را مشخص می کند. مقدار youtube#activity خواهد بود. |
etag | etag Etag این منبع |
id | string شناسهای که YouTube برای شناسایی منحصربهفرد فعالیت استفاده میکند. |
snippet | object شی snippet حاوی جزئیات اساسی در مورد فعالیت است، از جمله نوع فعالیت و شناسه گروه. |
snippet. publishedAt | datetime تاریخ و ساعتی که فعالیت انجام شده است. مقدار در قالب ISO 8601 مشخص شده است. |
snippet. channelId | string شناسهای که YouTube برای شناسایی منحصربهفرد کانال مرتبط با فعالیت استفاده میکند. |
snippet. title | string عنوان منبعی که در درجه اول با فعالیت مرتبط است. |
snippet. description | string شرح منبعی که در درجه اول با فعالیت مرتبط است. |
snippet. thumbnails | object نقشه ای از تصاویر بندانگشتی مرتبط با منبعی که عمدتاً با فعالیت مرتبط است. برای هر شی در نقشه، کلید نام تصویر بند انگشتی است و مقدار آن شیئی است که حاوی اطلاعات دیگری در مورد تصویر کوچک است. |
snippet.thumbnails. (key) | object مقادیر کلیدی معتبر عبارتند از:
|
snippet.thumbnails.(key). url | string URL تصویر |
snippet.thumbnails.(key). width | unsigned integer عرض تصویر |
snippet.thumbnails.(key). height | unsigned integer ارتفاع تصویر |
snippet. channelTitle | string عنوان کانال برای کانال مسئول این فعالیت |
snippet. type | string نوع فعالیتی که منبع توصیف می کند. مقادیر معتبر برای این ویژگی عبارتند از:
|
snippet. groupId | string شناسه گروه مرتبط با فعالیت. شناسه گروهی رویدادهای کاربر را که با همان کاربر و منبع مرتبط هستند شناسایی می کند. به عنوان مثال، اگر کاربر به یک ویدیو امتیاز دهد و همان ویدیو را به عنوان مورد علاقه علامتگذاری کند، ورودیهای آن رویدادها دارای همان شناسه گروه در فید فعالیت کاربر خواهند بود. در رابط کاربری خود، می توانید با گروه بندی رویدادها با همان مقدار groupId از تکرار جلوگیری کنید. |
contentDetails | object شی contentDetails حاوی اطلاعاتی در مورد محتوای مرتبط با فعالیت است. برای مثال، اگر مقدار snippet.type videoRated باشد، محتوای شی contentDetails ویدیوی رتبهبندی شده را شناسایی میکند. |
contentDetails. upload | object شیء upload حاوی اطلاعاتی درباره ویدیوی آپلود شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type upload باشد. |
contentDetails.upload. videoId | string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی آپلود شده استفاده می کند. |
contentDetails. like | object شی like حاوی اطلاعاتی در مورد منبعی است که امتیاز مثبت (مثل) دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type like باشد. |
contentDetails.like. resourceId | object شی resourceId حاوی اطلاعاتی است که منبع رتبه بندی شده را شناسایی می کند. |
contentDetails.like.resourceId. kind | string نوع منبع API. |
contentDetails.like.resourceId. videoId | string شناسهای که YouTube برای شناسایی منحصربهفرد ویدیو استفاده میکند، اگر منبع رتبهبندی شده یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails. favorite | object شی favorite حاوی اطلاعاتی درباره ویدیویی است که به عنوان ویدیوی مورد علاقه علامت گذاری شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type favorite باشد. |
contentDetails.favorite. resourceId | object شی resourceId حاوی اطلاعاتی است که منبعی را که به عنوان مورد علاقه علامت گذاری شده است، مشخص می کند. |
contentDetails.favorite.resourceId. kind | string نوع منبع API. |
contentDetails.favorite.resourceId. videoId | string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی مورد علاقه استفاده می کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.توجه: روش activities.list در حال حاضر منابعی را برای نظرات جدید برنمیگرداند. |
contentDetails. comment | object شی comment حاوی اطلاعاتی در مورد منبعی است که نظر دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type comment باشد. |
contentDetails.comment. resourceId | object شی resourceId حاوی اطلاعاتی است که منبع مرتبط با نظر را شناسایی می کند. |
contentDetails.comment.resourceId. kind | string نوع منبع API. |
contentDetails.comment.resourceId. videoId | string شناسهای که YouTube برای شناسایی منحصربهفرد ویدیوی مرتبط با نظر استفاده میکند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails.comment.resourceId. channelId | string شناسهای که YouTube برای شناسایی منحصربهفرد کانال مرتبط با نظر استفاده میکند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد. |
contentDetails. subscription | object شیء subscription حاوی اطلاعاتی در مورد کانالی است که کاربر در آن مشترک شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type subscription باشد. |
contentDetails.subscription. resourceId | object شی resourceId حاوی اطلاعاتی است که منبعی را که کاربر در آن مشترک شده است شناسایی می کند. |
contentDetails.subscription.resourceId. kind | string نوع منبع API. |
contentDetails.subscription.resourceId. channelId | string شناسه ای که YouTube برای شناسایی منحصر به فرد کانالی که کاربر در آن مشترک شده است استفاده می کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد. |
contentDetails. playlistItem | object شی playlistItem حاوی اطلاعاتی در مورد یک آیتم لیست پخش جدید است. این ویژگی فقط در صورتی وجود دارد که snippet.type playlistItem باشد. |
contentDetails.playlistItem. resourceId | object شی resourceId حاوی اطلاعاتی است که منبعی را که به لیست پخش اضافه شده است مشخص می کند. |
contentDetails.playlistItem.resourceId. kind | string نوع منبع API. |
contentDetails.playlistItem.resourceId. videoId | string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیویی که به لیست پخش اضافه شده است استفاده می کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails.playlistItem. playlistId | string مقداری که YouTube برای شناسایی منحصر به فرد لیست پخش استفاده می کند. |
contentDetails.playlistItem. playlistItemId | string مقداری که YouTube برای شناسایی منحصر به فرد مورد در لیست پخش استفاده می کند. |
contentDetails. recommendation | object شیء recommendation حاوی اطلاعاتی در مورد یک منبع توصیه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type recommendation باشد. |
contentDetails.recommendation. resourceId | object شی resourceId حاوی اطلاعاتی است که منبع توصیه شده را شناسایی می کند. |
contentDetails.recommendation.resourceId. kind | string نوع منبع API. |
contentDetails.recommendation.resourceId. videoId | string شناسهای که YouTube برای شناسایی منحصربهفرد ویدیو استفاده میکند، اگر منبع توصیهشده یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails.recommendation.resourceId. channelId | string شناسهای که YouTube برای شناسایی منحصربهفرد کانال استفاده میکند، اگر منبع توصیهشده یک کانال باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد. |
contentDetails.recommendation. reason | string دلیل اینکه منبع به کاربر توصیه می شود. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.recommendation. seedResourceId | object شی seedResourceId حاوی اطلاعاتی در مورد منبعی است که باعث ایجاد توصیه شده است. |
contentDetails.recommendation.seedResourceId. kind | string نوع منبع API. |
contentDetails.recommendation.seedResourceId. videoId | string شناسهای که YouTube برای شناسایی منحصربهفرد ویدیو استفاده میکند، در صورتی که این توصیه به دلیل یک ویدیوی خاص باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind youtube#video باشد. |
contentDetails.recommendation.seedResourceId. channelId | string شناسهای که YouTube برای شناسایی منحصربهفرد کانال استفاده میکند، اگر این توصیه توسط یک کانال خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind youtube#channel باشد. |
contentDetails.recommendation.seedResourceId. playlistId | string شناسهای که YouTube برای شناسایی منحصربهفرد فهرست پخش استفاده میکند، در صورتی که توصیه توسط یک لیست پخش خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind youtube#playlist باشد. |
contentDetails. social | object شی social حاوی جزئیاتی در مورد یک پست شبکه اجتماعی است. این ویژگی فقط در صورتی وجود دارد که snippet.type social باشد. |
contentDetails.social. type | string نام شبکه اجتماعی. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.social. resourceId | object شی resourceId اطلاعاتی را در بر می گیرد که منبع مرتبط با یک پست شبکه اجتماعی را شناسایی می کند. |
contentDetails.social.resourceId. kind | string نوع منبع API. |
contentDetails.social.resourceId. videoId | string شناسهای که YouTube برای شناسایی منحصربهفرد ویدیوی نمایش داده شده در یک پست شبکه اجتماعی استفاده میکند، در صورتی که پست به یک ویدیو اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#video باشد. |
contentDetails.social.resourceId. channelId | string شناسهای که YouTube برای شناسایی منحصربهفرد کانالی که در یک پست شبکه اجتماعی نشان داده شده است، استفاده میکند، در صورتی که پست به یک کانال اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#channel باشد. |
contentDetails.social.resourceId. playlistId | string شناسهای که YouTube برای شناسایی منحصربهفرد فهرست پخش در یک پست شبکه اجتماعی استفاده میکند، اگر پست به یک لیست پخش اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#playlist باشد. |
contentDetails.social. author | string نویسنده پست شبکه اجتماعی. |
contentDetails.social. referenceUrl | string آدرس پست شبکه اجتماعی. |
contentDetails.social. imageUrl | string تصویری از نویسنده پست |
contentDetails. channelItem | object شی channelItem حاوی جزئیاتی در مورد منبعی است که به یک کانال اضافه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type channelItem باشد. |
contentDetails.channelItem. resourceId | object شی resourceId حاوی اطلاعاتی است که منبع اضافه شده به کانال را مشخص می کند. |