Создает групповой элемент.
Запрос
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.
Создает групповой элемент.
Запрос
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.
Создает групповой элемент.
Запрос
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.
Создает групповой элемент.
Запрос
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.