Method: networks.assets.adBreaks.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
API zum Auflisten von Werbeunterbrechungen im Livestream.
HTTP-Anfrage
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Optional. In diesem Feld wird das LiveStreamEvent angegeben, dem diese Werbeunterbrechung zugeordnet werden soll. Dazu wird der Assetschlüssel des Livestreams verwendet. Er muss das Format „networks/{network_code}/assets/{asset_code}“ haben.
|
Abfrageparameter
| Parameter |
customParent |
string
Optional. In diesem Feld wird das LiveStreamEvent angegeben, dem die Werbeunterbrechung zugeordnet werden soll. Dazu wird der benutzerdefinierte Assetschlüssel verwendet. Er muss das Format „networks/{network_code}/customAssets/{asset_code}“ haben.
|
content |
string
Optional. Dies ist eine alternative Möglichkeit, das LiveStreamEvent zu identifizieren, wenn es mit einem Inhalt in GAM verknüpft ist. Er muss das Format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}“ haben.
|
pageSize |
integer
Optional. Die maximale Anzahl der zurückzugebenden Werbeunterbrechungen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Falls nicht angegeben, werden maximal 10 Werbeunterbrechungen zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden implizit auf 100 umgewandelt.
|
pageToken |
string
Optional. Ein Seitentoken, das von einem vorherigen adBreaks.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für adBreaks.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ListAdBreaksResponse.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-21 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
