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
    },
    "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 x 88 пикселей. medium – версия значка с более высоким разрешением. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей. high – версия значка в высоком разрешении. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение размером 800 x 800 пикселей. standard – значок с разрешением, которое выше, чем у значка high. Это изображение доступно для некоторых видео и других ресурсов, которые ссылаются на видео, например элементов плейлиста или результатов поиска. Ширина этого изображения – 640 пкс, а высота – 480 пкс. maxres – версия значка в высоком разрешении. Этот размер доступен для некоторых видео и других ресурсов, связанных с видео, например элементов плейлиста или результатов поиска. Ширина изображения – 1280 пикселей, высота – 720 пикселей. fhd – значок в формате Full HD (1080p). Такой размер доступен для некоторых видео. Ширина изображения – 1920 пикселей, высота – 1080 пикселей. qhd – версия значка в разрешении Quad HD (1440p / 2K). Этот размер доступен для некоторых видео. Ширина этого изображения – 2560 пикселей, а высота – 1440 пикселей. uhd – значок в сверхвысоком разрешении (4K). Такой размер доступен для некоторых видео. Ширина этого изображения – 3840 пикселей, а высота – 2160 пикселей.
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 (в настоящее время не возвращается) 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.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 Причина, по которой ресурс рекомендуется пользователю. Допустимые значения для этого свойства: 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 содержит информацию, которая идентифицирует ресурс, добавленный на канал.