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