GroupItems: insert

Создает групповой элемент.

Запрос

HTTP-запрос

POST https://youtubeanalytics.googleapis.com/v2/groupItems

Авторизация

Для этого запроса требуется авторизация хотя бы с одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Области применения
https://www.googleapis.com/auth/yt-analytics.readonly	Просматривайте отчеты YouTube Analytics для вашего контента YouTube. Эта область обеспечивает доступ к показателям активности пользователей, таким как количество просмотров и рейтингов.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	Просматривайте финансовые отчеты YouTube Analytics для вашего контента YouTube. Эта область обеспечивает доступ к показателям активности пользователей, а также к показателям предполагаемого дохода и эффективности рекламы.
https://www.googleapis.com/auth/youtube	Управляйте своим аккаунтом YouTube. В API YouTube Analytics владельцы каналов используют эту область для управления группами и элементами групп YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner	Просматривайте ресурсы YouTube и связанный с ними контент на YouTube и управляйте ими. В API YouTube Analytics владельцы контента используют эту область для управления группами и элементами групп YouTube Analytics.

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Дополнительные параметры
onBehalfOfContentOwner	string Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube, которые владеют и управляют множеством различных каналов YouTube. Параметр onBehalfOfContentOwner указывает, что учетные данные авторизации запроса идентифицируют пользователя YouTube, который действует от имени владельца контента, указанного в значении параметра. Это позволяет владельцам контента один раз пройти аутентификацию и получить доступ ко всем своим видео и данным каналов без необходимости предоставлять учетные данные аутентификации для каждого отдельного канала. Учетная запись, под которой проходит аутентификация пользователя, должна быть связана с указанным владельцем контента YouTube.

Тело запроса

Укажите ресурс groupItem в теле запроса. Для этого ресурса необходимо указать значение для следующих свойств.

• groupId
• resource.id

Ответ

Если элемент успешно вставлен, этот метод возвращает ресурс groupItem в теле ответа.

Если элемент, указанный в запросе, уже был включен в группу до того, как был сделан запрос, этот метод возвращает код ответа HTTP 204 ( No Content ).

Ошибки

В таблице ниже указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .

Тип ошибки	Детализация ошибки	Описание
forbidden (403)	groupContainsMaximumNumberOfItems	Группа уже содержит максимально допустимое количество элементов.

Попробуйте!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.