Activities

Ресурс 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	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 Допустимые значения ключа: default – миниатюра по умолчанию. Миниатюра по умолчанию для видео или ресурса, ссылающегося на видео, например, элемента плейлиста или результата поиска, имеет ширину 120 пикселей и высоту 90 пикселей. Миниатюра по умолчанию для канала имеет ширину 88 пикселей и высоту 88 пикселей. medium — версия миниатюры с более высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей. high – версия миниатюры с высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 800 пикселей. standard – версия миниатюры с ещё более высоким разрешением, чем изображение high разрешением. Это изображение доступно для некоторых видео и других ресурсов, связанных с видео, например, элементов плейлистов или результатов поиска. Размер изображения: 640 пикселей в ширину и 480 пикселей в высоту. maxres – изображение миниатюры с самым высоким разрешением. Этот размер изображения доступен для некоторых видео и других ресурсов, связанных с видео, например, элементов плейлистов или результатов поиска. Ширина изображения составляет 1280 пикселей, а высота – 720 пикселей.
snippet.thumbnails.(key). url	string URL-адрес изображения.
snippet.thumbnails.(key). width	unsigned integer Ширина изображения.
snippet.thumbnails.(key). height	unsigned integer Высота изображения.
snippet. channelTitle	string Название канала, ответственного за эту активность
snippet. type	string Вид деятельности, который описывает ресурс. Допустимые значения для этого свойства: channelItem comment – (в настоящее время не возвращен) favorite like playlistItem promotedItem recommendation social subscription upload
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 Причина, по которой ресурс рекомендуется пользователю. Допустимые значения для этого свойства: videoFavorited videoLiked videoWatched
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 Название социальной сети. Допустимые значения для этого свойства: facebook googlePlus twitter unspecified
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 содержит информацию, идентифицирующую ресурс, добавленный в канал.