Groups

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

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

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

Методы

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
Этаг этого ресурса.
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
,

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

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

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

Методы

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
Этаг этого ресурса.
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