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 содержит информацию, идентифицирующую ресурс, добавленный в канал.