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,
      }
    },
    "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 – (в данный момент не возвращен)
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • 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. 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 содержит информацию, идентифицирующую ресурс, добавленный в канал.