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
  }
}

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

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