Method: networks.assets.adBreaks.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
API permettant de lister les coupures publicitaires dans la diffusion en direct.
Requête HTTP
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Facultatif. Ce champ identifie l'événement LiveStreamEvent auquel cette coupure publicitaire doit être associée à l'aide de la clé de l'élément de flux en direct. Il doit être au format "networks/{network_code}/assets/{asset_code}".
|
Paramètres de requête
| Paramètres |
customParent |
string
Facultatif. Ce champ identifie l'événement LiveStreamEvent auquel cette coupure publicitaire doit être associée à l'aide de la clé d'élément personnalisée. Il doit être au format "networks/{network_code}/customAssets/{asset_code}".
|
content |
string
Facultatif. Il s'agit d'une autre façon d'identifier l'événement LiveStreamEvent, s'il est associé à un contenu dans GAM. Il doit être au format "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}".
|
pageSize |
integer
Facultatif. Nombre maximal de pauses publicitaires à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 10 pauses publicitaires au maximum sont renvoyées. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100.
|
pageToken |
string
Facultatif. Jeton de page reçu d'un appel adBreaks.list précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à adBreaks.list doivent correspondre à l'appel ayant fourni le jeton de page.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de ListAdBreaksResponse.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eThis API allows you to retrieve a list of Ad Breaks associated with a live stream event using the \u003ccode\u003eadBreaks.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eYou can identify the LiveStreamEvent using either the live stream asset key (\u003ccode\u003eparent\u003c/code\u003e), custom asset key (\u003ccode\u003ecustomParent\u003c/code\u003e), or content association within GAM (\u003ccode\u003econtent\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a paginated list of Ad Breaks, with control over the page size and retrieval of subsequent pages using page tokens.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using OAuth scopes, specifically \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.assets.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/{parent=networks/*/assets/*}/adBreaks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path 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\n### Query 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| `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)."]]
