Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, treten Sie dem offiziellen Ad Manager-Discord-Kanal auf dem Server der Google Advertising and Measurement Community bei.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
StreamRequest
classpublic
Eine Klasse zum Angeben von Eigenschaften der Streamanfrage.
Konstruktor
StreamRequest
new
StreamRequest()
Attribute
adTagParameters
(Null- oder Nicht-Null-Objekt mit Stringeigenschaften)
Sie können eine begrenzte Anzahl von Anzeigen-Tag-Parametern in Ihrer Streamanfrage überschreiben. Die hinzugefügten Werte müssen Strings sein.
Weitere Informationen finden Sie unter
Targeting-Parameter an einen Stream übertragen.
Du kannst die Parameter „dai-ot“ und „dai-ov“ für die bevorzugte Streamvariante verwenden.
Weitere Informationen findest du unter
Parameter von Streamvarianten überschreiben.
apiKey
String
Der API-Schlüssel für die Streamanfrage. Sie wird über die
DFP-Benutzeroberfläche für die Verwaltung konfiguriert und dem Publisher zur Verfügung gestellt, damit er seine Inhalte entsperren kann.
Es werden die Anwendungen überprüft, die auf die Inhalte zugreifen möchten.
authToken
String
Das Autorisierungstoken für die Streamanfrage. Wird anstelle des API-Schlüssels verwendet, um eine strengere Inhaltsautorisierung zu ermöglichen. Der Publisher kann die Autorisierungen für einzelne Inhaltsstreams basierend auf diesem Token steuern.
Das abzurufende Streamformat. Folgende Stringwerte sind zulässig:
hls (Standard)
dash
.
Wenn ein ungültiger String angegeben wird, wird der Standardwert verwendet.
networkCode
String
Der Netzwerkcode des Publishers, der diese Streamanfrage stellt. Netzwerkcodes sind für Streamanfragen für das Pod-Streaming (PodStreamRequest oder PodVodStreamRequest) und für Streamanfragen für das Cloud-Stitching (VideoStitcherLiveStreamRequest oder VideoStitcherVodStreamRequest) erforderlich. Für Streamanfragen für den Vollservice (LiveStreamRequest oder VODStreamRequest) sind sie optional, werden aber empfohlen. Mit dem Code werden Einstellungen angewendet, die auf der Ad Manager-Benutzeroberfläche ausgewählt wurden, z. B. die Aktivierung der programmatisch eingeschränkten Anzeigenausrichtung. Bei der Pod-Auslieferung und dem Cloud-Stitching wird es auch verwendet, um den Stream zu finden und abzuspielen. Wie du den Netzwerkcode findest, erfährst du hier.
senderCanSkip
boolean
Gibt an, ob der Absender dem Endnutzer eine Benutzeroberfläche zum Überspringen von CAF-Inhalten anzeigt.
Wird verwendet, um überspringbare Anzeigen zu aktivieren.
streamActivityMonitorId
String
Die ID, die für die Fehlerbehebung des Streams mit der Überwachung der Streamingaktivitäten verwendet werden soll.
So können Publisher ganz einfach ein Streamprotokoll im Tool zur Überwachung der Streamingaktivitäten finden.
[null,null,["Zuletzt aktualisiert: 2025-08-21 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eStreamRequest\u003c/code\u003e class defines properties for requesting ad-integrated streams.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes \u003ccode\u003eapiKey\u003c/code\u003e or \u003ccode\u003eauthToken\u003c/code\u003e for content authorization and access control.\u003c/p\u003e\n"],["\u003cp\u003ePublishers can customize ad parameters, stream format (\u003ccode\u003ehls\u003c/code\u003e or \u003ccode\u003edash\u003c/code\u003e), and consent settings.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003enetworkCode\u003c/code\u003e is crucial for Pod/Cloud stitching requests & applying Ad Manager settings.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esenderCanSkip\u003c/code\u003e enables skippable ads and \u003ccode\u003estreamActivityMonitorId\u003c/code\u003e aids in stream debugging.\u003c/p\u003e\n"]]],["The `StreamRequest` class defines stream properties, including: `adTagParameters` for overriding ad tag settings, `apiKey` and `authToken` for content access authorization, and `consentSettings` for regulatory compliance. The `format` property specifies the stream type (`hls` or `dash`). `networkCode` is for publisher network identification, with requirements depending on the stream type. `senderCanSkip` enables skippable ads, and `streamActivityMonitorId` is used for debugging through stream activity monitoring.\n"],null,["# Class: StreamRequest\n\nStreamRequest\n=============\n\nclass public\n\nA class for specifying properties of the stream request.\n\nConstructor\n-----------\n\n### StreamRequest\n\nnew\nStreamRequest()\n\nProperties\n----------\n\n### adTagParameters\n\n(null or non-null Object with string properties)\n\nYou can override a limited set of ad tag parameters on your stream\nrequest. Values added must be strings.\n[Supply targeting parameters to your stream](//support.google.com/dfp_premium/answer/7320899) provides more information.\nYou can use the dai-ot and dai-ov parameters for stream variant\npreference.\nSee [Override Stream Variant Parameters](//support.google.com/dfp_premium/answer/7320898) for more information.\n\n### apiKey\n\nstring\n\nThe stream request API key. It's configured through the\n[DFP Admin UI](//support.google.com/dfp_premium/answer/6381445) and provided to the publisher to unlock their content.\nIt verifies the applications that are attempting to access the content.\n\n### authToken\n\nstring\n\nThe stream request authorization token. Used in place of the API key\nfor stricter content authorization. The publisher can control individual\ncontent streams authorizations based on this token.\n\n### consentSettings\n\n(null or non-null [ConsentSettings](/ad-manager/dynamic-ad-insertion/sdk/cast/reference/js/ConsentSettings))\n\nSettings related to regulations and consent.\n\n### format\n\nstring\n\nThe stream format to request. Accepts the following string values:\n\n- `hls` (default)\n- `dash`\n\n. If an invalid string is provided, the default value will be used. Note: Values must be lowercase.\n\n### networkCode\n\nstring\n\nThe network code for the publisher making this stream request. Network\ncodes are required for Pod serving stream requests (PodStreamRequest or\nPodVodStreamRequest) and Cloud stitching stream requests\n(VideoStitcherLiveStreamRequest or VideoStitcherVodStreamRequest) and\nare optional but recommended for Full service stream requests\n(LiveStreamRequest or VODStreamRequest). The code is used to apply\nsettings selected in the Ad Manager UI such as programmatic limited\nads enablement. For Pod serving and Cloud stitching it is also used to\nlocate and play the stream. To find the network code, see [this article](//support.google.com/admanager/answer/7674889).\n\n### senderCanSkip\n\nboolean\n\nWhether or not the sender(s) display a CAF skip UI to the end user.\nUsed to enable skippable ads.\n\n### streamActivityMonitorId\n\nstring\n\nThe ID to be used to debug the stream with the stream activity monitor.\nThis is used to provide a convenient way to allow publishers to find a\nstream log in the stream activity monitor tool."]]
