Method: networks.customAssets.adBreaks.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
API para enumerar las pausas publicitarias dentro de la transmisión en vivo.
Solicitud HTTP
GET https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
customParent |
string
Opcional. Este campo identifica el LiveStreamEvent al que se debe asociar esta pausa publicitaria con la clave del activo personalizada. Debe tener el formato "networks/{network_code}/customAssets/{asset_code}".
|
Parámetros de consulta
| Parámetros |
parent |
string
Opcional. Este campo identifica el LiveStreamEvent con el que se debe asociar esta pausa publicitaria a través de la clave del activo de la transmisión en vivo. Debe tener el formato "networks/{network_code}/assets/{asset_code}".
|
content |
string
Opcional. Esta es una forma alternativa de identificar el LiveStreamEvent si está asociado con una parte de contenido en GAM. Debe tener el formato "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}".
|
pageSize |
integer
Opcional. Es la cantidad máxima de pausas publicitarias que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 10 pausas publicitarias. El valor máximo es 100, y los que superen esta cifra se convertirán a 100.
|
pageToken |
string
Opcional. Un token de página, recibido desde una llamada adBreaks.list anterior. Proporciona esto para recuperar la página siguiente. Cuando se pagina, todos los demás parámetros proporcionados a adBreaks.list deben coincidir con la llamada que proporcionó el token de la página.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListAdBreaksResponse.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Para obtener más información, consulta la Descripción general de OAuth 2.0.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 2025-08-21 (UTC)"],[[["\u003cp\u003eThis API allows you to retrieve a list of ad breaks associated with a live stream event using either a custom asset key, a live stream asset key, or a content ID within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify optional parameters such as parent, content, pageSize, and pageToken to filter and paginate the results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response will contain a ListAdBreaksResponse object.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, you will need authorization with either the \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/video-ads\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: networks.customAssets.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/{customParent=networks/*/customAssets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\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| `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| `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)."]]
