Method: networks.customAssets.adBreaks.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs API do wyświetlania przerw na reklamy w transmisji na żywo.
Żądanie HTTP
GET https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
customParent |
string
Opcjonalnie. To pole identyfikuje zdarzenie LiveStreamEvent, z którym ma być powiązana ta przerwa na reklamę, za pomocą niestandardowego klucza zasobu. Musi mieć format „networks/{network_code}/customAssets/{asset_code}”.
|
Parametry zapytania
| Parametry |
parent |
string
Opcjonalnie. To pole identyfikuje zdarzenie LiveStreamEvent, z którym ma być powiązana przerwa na reklamę, za pomocą klucza zasobu transmisji na żywo. Musi mieć format „networks/{network_code}/assets/{asset_code}”.
|
content |
string
Opcjonalnie. Jest to alternatywny sposób identyfikowania elementu LiveStreamEvent, jeśli jest on powiązany z treścią w GAM. Musi mieć format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}”.
|
pageSize |
integer
Opcjonalnie. Maksymalna liczba przerw na reklamy do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwracanych będzie maksymalnie 10 przerw na reklamy. Maksymalna wartość to 100. Wartości powyżej 100 zostaną zmienione na 100.
|
pageToken |
string
Opcjonalnie. Token strony otrzymany z poprzedniego wywołania adBreaks.list. Podaj ten token, aby pobrać kolejną stronę. Podczas paginacji wszystkie inne parametry przekazane do funkcji adBreaks.list muszą być zgodne z wywołaniem, które dostarczyło token strony.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ListAdBreaksResponse.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Więcej informacji znajdziesz w omówieniu OAuth 2.0.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
