Ресурс 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 Тип ресурсов, содержащихся в группе. Допустимые значения для этого свойства:
|
Ресурс 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 Тип ресурсов, содержащихся в группе. Допустимые значения для этого свойства:
|