یک منبع activity حاوی اطلاعاتی درباره اقدامی است که یک کانال یا کاربر خاص در YouTube انجام داده است. اقدامات گزارش شده در فیدهای فعالیت شامل رتبه بندی یک ویدیو، اشتراک گذاری یک ویدیو، علامت گذاری یک ویدیو به عنوان مورد علاقه، آپلود یک ویدیو و غیره است. هر منبع 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
},
"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 | etagEtag این منبع |
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 | stringURL تصویر |
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 حاوی اطلاعاتی است که منبع اضافه شده به کانال را مشخص می کند. |