Activities

YouTube прекратил поддержку функции сводки каналов. 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
Этаг этого ресурса.
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
  • bulletin (устаревший)
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 содержит информацию, идентифицирующую ресурс, добавленный в канал.