Method: networks.assets.adBreaks.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ライブ ストリーム内の広告ブレークを一覧表示する API。
HTTP リクエスト
GET https://admanagervideo.googleapis.com/v1/{parent=networks/*/assets/*}/adBreaks
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
parent |
string
省略可。このフィールドは、ライブ ストリーム アセットキーを使用して、このミッドロール挿入点を関連付ける LiveStreamEvent を識別します。「networks/{network_code}/assets/{asset_code}」の形式で指定します。
|
クエリ パラメータ
パラメータ |
customParent |
string
省略可。このフィールドは、カスタム アセットキーを使用してこの広告ブレークを関連付ける LiveStreamEvent を識別します。「networks/{network_code}/customAssets/{asset_code}」の形式にする必要があります。
|
content |
string
省略可。これは、LiveStreamEvent が GAM 内のコンテンツに関連付けられている場合に、LiveStreamEvent を識別する別の方法です。「networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}」の形式である必要があります。
|
pageSize |
integer
省略可。返す広告ブレークの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 10 個の広告ブレークが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます。
|
pageToken |
string
省略可。前回の adBreaks.list 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。 ページ分割を行う場合、adBreaks.list に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には ListAdBreaksResponse
のインスタンスが含まれます。
認証スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
詳細については、OAuth 2.0 の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[null,null,["最終更新日 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)."]]