Groups

Ресурс group представляет собой группу YouTube Analytics, которая представляет собой настраиваемую коллекцию из до 500 каналов, видео, плейлистов или объектов.

Все элементы в группе должны представлять один и тот же тип ресурса. Например, вы не можете создать группу, содержащую 100 видео и 100 плейлистов.

Группа Analytics может содержать только те ресурсы, которые вы загрузили или заявили, или которые связаны с каналом, которым вы управляете. В результате владельцы каналов могут создавать группы видео и списки воспроизведения. Владельцы контента могут создавать группы видео, плейлистов, каналов или объектов.

Методы

API поддерживает следующие методы для ресурсов groups :

list
Возвращает список групп, соответствующих параметрам запроса API. Например, вы можете получить все группы, которыми владеет прошедший проверку подлинности пользователь, или вы можете получить одну или несколько групп по их уникальным идентификаторам. Попробуйте прямо сейчас .
insert
Создает группу YouTube Analytics. После создания группы используйте метод groupItems.insert для добавления элементов в группу. Попробуйте прямо сейчас .
update
Изменяет метаданные для группы. В настоящее время единственным свойством, которое можно обновить, является название группы. (Используйте groupItems.insert и groupItems.delete для добавления и удаления элементов группы.) Попробуйте прямо сейчас .
delete
Удаляет группу. Попробуйте прямо сейчас .

Представление ресурсов

В приведенной ниже структуре JSON показан формат ресурса groups :

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе:

Характеристики
kind string
Идентифицирует тип ресурса API. Значение будет youtube#group .
etag etag
Etag этого ресурса.
id string
Идентификатор, который YouTube использует для уникальной идентификации группы.
snippet object
Объект snippet содержит основную информацию о группе, включая дату ее создания и название.
snippet. publishedAt datetime
Дата и время создания группы. Значение указывается в формате ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ).
snippet. title string
Название группы. Значение должно быть непустой строкой.
contentDetails object
Объект contentDetails содержит дополнительную информацию о группе, такую ​​как количество и тип содержащихся в ней элементов.
contentDetails. itemCount unsigned long
Количество элементов в группе.
contentDetails. itemType string
Тип ресурсов, которые содержит группа.

Допустимые значения для этого свойства:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset