Method: networks.sources.content.adBreaks.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
API для отображения рекламных пауз в прямой трансляции.
HTTP-запрос
GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
content | string Необязательный. Это альтернативный способ идентификации LiveStreamEvent, если он связан с частью контента в GAM. Он должен иметь формат «networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}». |
Параметры запроса
Параметры |
---|
parent | string Необязательный. В этом поле указывается событие LiveStreamEvent, с которым должна быть связана эта рекламная пауза с использованием ключа ресурса прямой трансляции. Он должен иметь формат «networks/{network_code}/assets/{asset_code}». |
customParent | string Необязательный. В этом поле указывается событие LiveStreamEvent, с которым должна быть связана эта рекламная пауза с помощью пользовательского ключа актива. Он должен иметь формат «networks/{network_code}/customAssets/{asset_code}». |
pageSize | integer Необязательный. Максимальное количество рекламных пауз для возврата. Служба может возвращать меньшее значение, чем это значение. Если не указано, будет возвращено не более 10 рекламных пауз. Максимальное значение — 100; значения выше 100 будут приведены к 100. |
pageToken | string Необязательный. Токен страницы, полученный в результате предыдущего вызова adBreaks.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, передаваемые в adBreaks.list должны соответствовать вызову, который предоставил токен страницы. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр ListAdBreaksResponse
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/contentingestion
-
https://www.googleapis.com/auth/video-ads
Дополнительную информацию см. в обзоре OAuth 2.0 .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-21 UTC.
[null,null,["Последнее обновление: 2025-08-21 UTC."],[[["\u003cp\u003eThis API allows you to retrieve a list of ad breaks associated with a live stream event.\u003c/p\u003e\n"],["\u003cp\u003eAd breaks can be identified by their association with either a content ID within GAM or a live stream asset key.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify optional parameters for filtering and pagination of the results, such as parent, customParent, pageSize, and pageToken.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required using OAuth scopes, either \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/video-ads\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: networks.sources.content.adBreaks.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nAPI to list Ad Breaks within the live stream.\n\n### HTTP request\n\n`GET https://admanagervideo.googleapis.com/v1/{content=networks/*/sources/*/content/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `content` | `string` Optional. This is an alternative way to identify the LiveStreamEvent, if it's associated with a piece of content within GAM. It must have the format of \"networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}\" |\n\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Optional. This field identifies the LiveStreamEvent that this ad break should be associated to using the live stream asset key. It must have the format of \"networks/{network_code}/assets/{asset_code}\" |\n| `customParent` | `string` Optional. This field identifies the LiveStreamEvent that this ad break should be associated to using the custom asset key. It must have the format of \"networks/{network_code}/customAssets/{asset_code}\" |\n| `pageSize` | `integer` Optional. The maximum number of ad breaks to return. The service may return fewer than this value. If unspecified, at most 10 ad breaks will be returned. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` Optional. A page token, received from a previous `adBreaks.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `adBreaks.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListAdBreaksResponse](/ad-manager/video/rest/v1/ListAdBreaksResponse).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/contentingestion`\n- `\n https://www.googleapis.com/auth/video-ads`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]