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 URL-адрес публикации в социальной сети. |
contentDetails.social. imageUrl | string Изображение автора поста. |
contentDetails. channelItem | object Объект channelItem содержит сведения о ресурсе, добавленном в канал. Это свойство присутствует только в том случае, если snippet.type имеет channelItem . |
contentDetails.channelItem. resourceId | object Объект resourceId содержит информацию, идентифицирующую ресурс, добавленный в канал. |