یک منبع activity شامل اطلاعاتی درباره عملی است که یک کانال یا کاربر خاص در یوتیوب انجام داده است. اقدامات گزارش شده در فیدهای فعالیت شامل اشتراکگذاری ویدیو، آپلود ویدیو و غیره است. هر منبع activity نوع عمل، کانال مرتبط با عمل و منبع(های) مرتبط با عمل، مانند ویدیویی که رتبهبندی یا آپلود شده است را مشخص میکند.
روشها
این API از روشهای زیر برای منابع activities پشتیبانی میکند:
- list
- لیستی از رویدادهای فعالیت کانال را که با معیارهای درخواست مطابقت دارند، برمیگرداند. برای مثال، میتوانید رویدادهای مرتبط با یک کانال خاص یا کانال خود کاربر را بازیابی کنید. اکنون آن را امتحان کنید .
نمایش منابع
ساختار 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
},
"comment": {
"resourceId": {
"kind": string,
"videoId": 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برچسب E این منبع. |
id | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد فعالیت از آن استفاده میکند. |
snippet | objectشیء snippet شامل جزئیات اولیه در مورد فعالیت، از جمله نوع فعالیت و شناسه گروه آن است. |
snippet. publishedAt | datetimeتاریخ و زمانی که فعالیت رخ داده است. مقدار در قالب ISO 8601 مشخص شده است. |
snippet. channelId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد کانال مرتبط با فعالیت از آن استفاده میکند. |
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شناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیوی آپلود شده استفاده میکند. |
contentDetails. comment | objectشیء comment حاوی اطلاعاتی درباره منبعی است که کامنت دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type comment باشد. |
contentDetails.comment. resourceId | objectشیء resourceId حاوی اطلاعاتی است که منبع مرتبط با نظر را مشخص میکند. |
contentDetails.comment.resourceId. kind | stringنوع منبع API. |
contentDetails.comment.resourceId. videoId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیوی مرتبط با یک نظر استفاده میکند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails.comment.resourceId. channelId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد کانال مرتبط با یک نظر استفاده میکند. این ویژگی فقط در صورتی وجود دارد که 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شناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیویی که به لیست پخش اضافه شده است، استفاده میکند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind برابر youtube#video باشد. |
contentDetails.playlistItem. playlistId | stringمقداری که یوتیوب برای شناسایی منحصر به فرد لیست پخش استفاده میکند. |
contentDetails.playlistItem. playlistItemId | stringمقداری که یوتیوب برای شناسایی منحصر به فرد آیتم در لیست پخش استفاده میکند. |
contentDetails. recommendation | objectشیء recommendation ) حاوی اطلاعاتی در مورد یک منبع توصیه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type recommendation باشد. |
contentDetails.recommendation. resourceId | objectشیء resourceId حاوی اطلاعاتی است که منبع پیشنهادی را مشخص میکند. |
contentDetails.recommendation.resourceId. kind | stringنوع منبع API. |
contentDetails.recommendation.resourceId. videoId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیو استفاده میکند، اگر منبع پیشنهادی یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. |
contentDetails.recommendation.resourceId. channelId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد کانال استفاده میکند، اگر منبع پیشنهادی یک کانال باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد. |
contentDetails.recommendation. reason | stringدلیل توصیه منبع به کاربر. مقادیر معتبر برای این ویژگی عبارتند از:
|
contentDetails.recommendation. seedResourceId | objectشیء seedResourceId حاوی اطلاعاتی در مورد منبعی است که باعث توصیه شده است. |
contentDetails.recommendation.seedResourceId. kind | stringنوع منبع API. |
contentDetails.recommendation.seedResourceId. videoId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیو استفاده میکند، در صورتی که توصیه توسط یک ویدیوی خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind برابر youtube#video باشد. |
contentDetails.recommendation.seedResourceId. channelId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد کانال استفاده میکند، در صورتی که توصیه توسط یک کانال خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind برابر youtube#channel باشد. |
contentDetails.recommendation.seedResourceId. playlistId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد لیست پخش استفاده میکند، در صورتی که توصیه توسط یک لیست پخش خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که 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شناسهای که یوتیوب برای شناسایی منحصر به فرد ویدیوی نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک ویدیو اشاره داشته باشد، استفاده میکند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#video باشد. |
contentDetails.social.resourceId. channelId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد کانال نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک کانال اشاره داشته باشد، استفاده میکند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#channel باشد. |
contentDetails.social.resourceId. playlistId | stringشناسهای که یوتیوب برای شناسایی منحصر به فرد لیست پخش نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک لیست پخش اشاره داشته باشد، استفاده میکند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind برابر youtube#playlist باشد. |
contentDetails.social. author | stringنویسنده پست شبکه اجتماعی. |
contentDetails.social. referenceUrl | stringآدرس اینترنتی (URL) پست شبکه اجتماعی. |
contentDetails.social. imageUrl | stringتصویری از نویسندهی پست. |
contentDetails. channelItem | objectشیء channelItem شامل جزئیاتی درباره منبعی است که به کانال اضافه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type channelItem باشد. |
contentDetails.channelItem. resourceId | objectشیء resourceId حاوی اطلاعاتی است که منبعی را که به کانال اضافه شده است، شناسایی میکند. |