Эта страница переведена с помощью Cloud Translation API.

GroupItems: list

Важно: запросы API к этому методу требуют доступа к:

область https://www.googleapis.com/auth/youtube
или
область действия https://www.googleapis.com/auth/youtube.readonly
и
область https://www.googleapis.com/auth/yt-analytics.readonly

Первый вариант использует одну область, которая является областью чтения и записи, а второй вариант использует две области только для чтения.

Возвращает коллекцию элементов группы, соответствующих параметрам запроса API.

Запрос

HTTP-запрос

GET 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.

Параметры

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

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

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

В случае успеха этот метод возвращает тело ответа следующей структуры:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе:

Характеристики
`kind`	`string` Идентифицирует тип ресурса API. Значением будет `youtube#groupItemListResponse` .
`etag`	`etag` Этаг этого ресурса.
`items[]`	`list` Список элементов, содержащихся в группе. Каждый элемент в списке представляет ресурс `groupItem` .

Ошибки

API не определяет каких-либо сообщений об ошибках, уникальных для этого метода API. Однако этот метод по-прежнему может возвращать общие ошибки API, перечисленные в документации по сообщениям об ошибках .

Попробуйте!

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