Method: networks.sources.content.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/{content=networks/*/sources/*/content/*}/adBreaks
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
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}”.
|
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}”.
|
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}”.
|
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.\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)."]]
