REST Resource: networks.assets.adBreaks
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: AdBreak
Métadonnées de coupures publicitaires utilisées pour choisir les annonces à diffuser lors d'une coupure publicitaire dans un événement vidéo en direct.
Représentation JSON |
{
"name": string,
"expectedDuration": string,
"customParams": string,
"scte35CueOut": string,
"podTemplateName": string,
"breakState": enum (BreakState )
} |
Champs |
name |
string
Uniquement en sortie. Nom de ressource de la coupure publicitaire. Ce champ se présentera comme suit : "networks//assets//adBreaks/". network_code est le code de réseau Google Ad Manager auquel ce contenu appartient. asset_key est la clé de l'événement de diffusion en direct dans Google Ad Manager à l'aide duquel la coupure publicitaire a été créée. adBreakId est la clé de la coupure publicitaire. RÉSULTAT UNIQUEMENT.
|
expectedDuration |
string (Duration format)
Obligatoire. Durée de coupure prévue. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s ". Exemple : "3.5s"
|
customParams |
string
Paires clé-valeur à inclure dans les demandes d'annonces pour cette coupure publicitaire pour le ciblage par critères personnalisés dans Ad Manager. Exemple : 'key1=value&key2=value2,value22'
|
scte35CueOut |
string
Données encodées en base64 à partir du point de sortie scte35. Peut inclure la commande splice_insert() ou time_signal(). Exemples: - with time_signal(): "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - with splice_insert(): "/DAvAAAAAAAA///wFAVIPff+/+c2nALv4UVBAUsWLZ1"
|
podTemplateName |
string
Nom du modèle de série d'annonces Google Ad Manager.
|
breakState |
enum (BreakState )
État actuel de la coupure publicitaire.
|
BreakState
État d'une coupure publicitaire.
Enums |
BREAK_STATE_UNSPECIFIED |
L'état de la coupure publicitaire est inconnu. |
BREAK_STATE_DECISIONED |
La prise de décision concernant les coupures publicitaires a commencé, mais n'a pas encore été diffusée auprès des utilisateurs. |
BREAK_STATE_COMPLETE |
La coupure publicitaire a été diffusée auprès des utilisateurs. |
Méthodes |
|
pour créer une coupure publicitaire dans la diffusion en direct. |
|
API pour lister les coupures publicitaires dans la diffusion en direct. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]