Method: networks.customAssets.adBreaks.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Canlı yayındaki reklam aralarını listeleyen API.
HTTP isteği
GET https://admanagervideo.googleapis.com/v1/{customParent=networks/*/customAssets/*}/adBreaks
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
customParent |
string
İsteğe bağlıdır. Bu alan, özel öğe anahtarı kullanılarak bu reklam arasının ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{network_code}/customAssets/{asset_code}" biçiminde olmalıdır.
|
Sorgu parametreleri
| Parametreler |
parent |
string
İsteğe bağlıdır. Bu alan, canlı yayın öğesi anahtarı kullanılarak bu reklam arasının ilişkilendirilmesi gereken LiveStreamEvent'i tanımlar. "networks/{network_code}/assets/{asset_code}" biçiminde olmalıdır.
|
content |
string
İsteğe bağlıdır. Bu, LiveStreamEvent'in GAM'deki bir içerikle ilişkilendirilmesi durumunda kullanılabilen alternatif bir tanımlama yöntemidir. "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" biçiminde olmalıdır.
|
pageSize |
integer
İsteğe bağlıdır. Döndürülecek maksimum reklam arası sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse en fazla 10 reklam arası döndürülür. Maksimum değer 100'dür. 100'ün üzerindeki değerler 100'e zorlanır.
|
pageToken |
string
İsteğe bağlıdır. Önceki bir adBreaks.list çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi yapılırken adBreaks.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, ListAdBreaksResponse öğesinin bir örneğini içerir.
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
