Stay organized with collections Save and categorize content based on your preferences.
StreamRequest
classpublic
A class for specifying properties of the stream request.
Properties
adTagParameters
(null or non-null Object with string properties)
You can override a limited set of ad tag parameters on your stream request. Values added must be strings. Supply targeting parameters to your stream provides more information. You can use the dai-ot and dai-ov parameters for stream variant preference. See Override Stream Variant Parameters for more information.
apiKey
string
The stream request API key. It's configured through the DFP Admin UI and provided to the publisher to unlock their content. It verifies the applications that are attempting to access the content.
authToken
string
The stream request authorization token. Used in place of the API key for stricter content authorization. The publisher can control individual content streams authorizations based on this token.
format
non-null StreamFormat
The stream format to request. Accepts the following string values:
hls (default)
dash
networkCode
string
The network code for the publisher making this stream request. Network codes are required for Pod serving stream requests (PodStreamRequest or PodVodStreamRequest) and Cloud stitching stream requests (VideoStitcherLiveStreamRequest or VideoStitcherVodStreamRequest) and are optional but recommended for Full service stream requests (LiveStreamRequest or VODStreamRequest). The code is used to apply settings selected in the Ad Manager UI such as programmatic limited ads enablement. For Pod serving and Cloud stitching it is also used to locate and play the stream. To find the network code, see this article.
Settings object for mapping verification vendors to OMID Access Modes. Verification script URLs are internally matched against vendor provided regular expressions to resolve to an OmidVerificationVendor key. IMA then looks up the access mode for the given vendor using this object.
For script URLs that don't resolve to a known vendor, or if the resolved OmidVerificationVendor is not provided in this object, IMA will use the access mode provided for OmidVerificationVendor.OTHER. If OmidVerificationVendor.OTHER is not provided, then the LIMITED access mode will be used.
streamActivityMonitorId
string
The ID to be used to debug the stream with the stream activity monitor. This is used to provide a convenient way to allow publishers to find a stream log in the stream activity monitor tool.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003e\u003ccode\u003eStreamRequest\u003c/code\u003e is a class used for defining the properties of a stream request, including authorization, format, and ad parameters.\u003c/p\u003e\n"],["\u003cp\u003eIt allows publishers to control content access through an API key or a more restrictive authorization token.\u003c/p\u003e\n"],["\u003cp\u003eStream format can be specified as either \u003ccode\u003ehls\u003c/code\u003e (default) or \u003ccode\u003edash\u003c/code\u003e, and ad tag parameters can be customized to target specific audiences.\u003c/p\u003e\n"],["\u003cp\u003eNetwork code is recommended for applying Ad Manager settings and is required for certain stream request types.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eomidAccessModeRules\u003c/code\u003e allows publishers to configure Open Measurement Interface Definition (OMID) access modes for verification vendors.\u003c/p\u003e\n"]]],[],null,["StreamRequest \nclass public\n\nA class for specifying properties of the stream request.\n\nProperties\n\nadTagParameters\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\nfor stream variant preference.\nSee [Override Stream Variant Parameters](//support.google.com/dfp_premium/answer/7320898) for more information.\n\napiKey\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\nauthToken\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\nformat\n\nnon-null StreamFormat\n\nThe stream format to request. Accepts the following string values:\n\n- `hls` (default)\n- `dash`\n\n| Note: Values must be lowercase.\n\nnetworkCode\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\nomidAccessModeRules\n\nnon-null Object with non-null [OmidAccessMode](/ad-manager/dynamic-ad-insertion/sdk/html5/reference/js/global#OmidAccessMode) properties\n\nSettings object for mapping verification vendors to OMID Access Modes.\nVerification script URLs are internally matched against vendor provided\nregular expressions to resolve to an OmidVerificationVendor key. IMA then\nlooks up the access mode for the given vendor using this object.\n\nFor script URLs that don't resolve to a known vendor, or if the\nresolved OmidVerificationVendor is not provided in this object, IMA will\nuse the access mode provided for OmidVerificationVendor.OTHER. If\nOmidVerificationVendor.OTHER is not provided, then the LIMITED access\nmode will be used.\n\nstreamActivityMonitorId\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."]]