REST Resource: networks.assets.adBreaks
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: AdBreak
Metadaten für Werbeunterbrechungen, die bei der Entscheidung für Anzeigen für eine Werbeunterbrechung in einem Live-Videoereignis verwendet werden.
JSON-Darstellung |
{
"name": string,
"expectedDuration": string,
"customParams": string,
"scte35CueOut": string,
"podTemplateName": string,
"breakState": enum (BreakState )
} |
Felder |
name |
string
Nur Ausgabe. Der Ressourcenname der Werbeunterbrechung. Dieses Feld hat das Format "networks//assets//adBreaks/". network_code ist der Netzwerkcode in Google Ad Manager, zu dem dieser Content gehört. asset_key ist der Schlüssel des Livestream-Ereignisses in Google Anzeigenverwaltung, unter dem die Werbeunterbrechung erstellt wurde. adBreakId ist der Schlüssel der Werbeunterbrechung. NUR AUSGABE.
|
expectedDuration |
string (Duration format)
Erforderlich. Erwartete Unterbrechungsdauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s ". Beispiel: "3.5s" .
|
customParams |
string
Schlüssel/Wert-Paare, die in Anzeigenanfragen für diese Werbeunterbrechung für das Targeting nach benutzerdefinierten Kriterien in Ad Manager aufgenommen werden sollen. Beispiel: „Schlüssel1=Wert&Schlüssel2=Wert2,Wert22“
|
scte35CueOut |
string
Base64-codierte Daten aus dem scte35-Cue-out. Kann den Befehl splice_insert() oder time_signal() enthalten. Beispiele: - mit time_signal(): "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - mit splice_insert(): "/DAvAAAAAAAA///wFAVINAACPfbow/JACAAAAAAA1n
|
podTemplateName |
string
Name der Google Ad Manager-Pod-Vorlage.
|
breakState |
enum (BreakState )
Der aktuelle Status der Werbeunterbrechung.
|
BreakState
Der Status einer Werbeunterbrechung.
Enums |
BREAK_STATE_UNSPECIFIED |
Der Status der Werbeunterbrechung ist unbekannt. |
BREAK_STATE_DECISIONED |
Die Entscheidung über Werbeunterbrechungen hat begonnen, den Nutzern aber noch nicht zugestellt. |
BREAK_STATE_COMPLETE |
Die Werbeunterbrechung wurde Nutzern bereitgestellt. |
Methoden |
|
API zum Erstellen einer Werbeunterbrechung im Livestream |
|
Die API zum Auflisten von Werbeunterbrechungen im Livestream. |
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\u003eAdBreak resource stores ad break metadata for live video events, including duration, custom parameters, and SCTE-35 cue-out data.\u003c/p\u003e\n"],["\u003cp\u003eAdBreaks can be created and listed using the provided APIs for live stream management within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eBreakState indicates the current status of an Ad Break, ranging from initial decisioning to complete delivery to users.\u003c/p\u003e\n"],["\u003cp\u003eAd Manager pod template names can be associated with AdBreaks to facilitate ad serving and targeting.\u003c/p\u003e\n"]]],["This document outlines the `AdBreak` resource, used for ad decisioning in live video events. Key details include the `name`, `expectedDuration`, `customParams`, `scte35CueOut`, `podTemplateName`, and `breakState`. `breakState` tracks the ad break's progress, with possible states like \"DECISIONED\" or \"COMPLETE\". Two API methods are provided: `create` to generate new ad breaks, and `list` to view existing ones within a live stream.\n"],null,["# REST Resource: networks.assets.adBreaks\n\n- [Resource: AdBreak](#AdBreak)\n - [JSON representation](#AdBreak.SCHEMA_REPRESENTATION)\n - [BreakState](#AdBreak.BreakState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdBreak\n-----------------\n\nAd break metadata used to decision ads for an ad break in a live video event.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expectedDuration\": string, \"customParams\": string, \"scte35CueOut\": string, \"podTemplateName\": string, \"breakState\": enum (/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the Ad Break. This field will have the format of \"networks//assets//adBreaks/\". network_code is the network code in Google Ad Manager to which this content belongs. asset_key is the key of the Live Stream Event in Google Ad Manage under which the Ad Break was created. adBreakId is the key of the Ad Break. OUTPUT ONLY. |\n| `expectedDuration` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Required. Expected break duration. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `customParams` | `string` Key-value pairs to be included on ad requests for this break for custom criteria targeting in Ad Manager. Example: 'key1=value\\&key2=value2,value22' |\n| `scte35CueOut` | `string` Base 64 encoded data from the scte35 cue out. May include splice_insert() or time_signal() command. Examples: - with time_signal(): \"/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==\" - with splice_insert(): \"/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=\" |\n| `podTemplateName` | `string` Google Ad Manager pod template name. |\n| `breakState` | `enum (`[BreakState](/ad-manager/video/rest/v1/networks.assets.adBreaks#AdBreak.BreakState)`)` The current state of the Ad Break. |\n\n### BreakState\n\nThe state of an Ad Break.\n\n| Enums ||\n|---------------------------|--------------------------------------------------------------|\n| `BREAK_STATE_UNSPECIFIED` | The Ad Break state is unknown. |\n| `BREAK_STATE_DECISIONED` | Ad Break decisioning started but not yet delivered to users. |\n| `BREAK_STATE_COMPLETE` | Ad Break was delivered to users. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|---------------------------------------------------|\n| ### [create](/ad-manager/video/rest/v1/networks.assets.adBreaks/create) | API to create an Ad Break within the live stream. |\n| ### [list](/ad-manager/video/rest/v1/networks.assets.adBreaks/list) | API to list Ad Breaks within the live stream. |"]]