스트림 요청에서 제한된 광고 태그 매개변수 집합을 재정의할 수 있습니다. 추가된 값은 문자열이어야 합니다. 타겟팅 매개변수를 스트림에 공급하기에서 자세한 내용을 확인하세요. 스트림 변형 환경설정에 dai-ot 및 dai-ov 매개변수를 사용할 수 있습니다. 자세한 내용은 스트림 변형 매개변수 재정의를 참고하세요.
apiKey
문자열
스트림 요청 API 키입니다. 이 코드는 DFP 관리 UI를 통해 구성되며 게시자가 콘텐츠를 잠금 해제할 수 있도록 제공됩니다. 콘텐츠에 액세스하려고 하는 애플리케이션을 확인합니다.
authToken
문자열
스트림 요청 승인 토큰입니다. 더 엄격한 콘텐츠 승인을 위해 API 키 대신 사용됩니다. 게시자는 이 토큰을 기반으로 개별 콘텐츠 스트림 승인을 제어할 수 있습니다.
형식
null이 아닌 StreamFormat
요청할 스트림 형식입니다. 다음 문자열 값을 허용합니다.
hls(기본)
dash
networkCode
문자열
이 스트림 요청을 하는 게시자의 네트워크 코드입니다. 네트워크 코드는 포드 서빙 스트림 요청 (PodStreamRequest 또는 PodVodStreamRequest) 및 클라우드 스티칭 스트림 요청(VideoStitcherLiveStreamRequest 또는 VideoStitcherVodStreamRequest)에 필요하며 전체 서비스 스트림 요청(LiveStreamRequest 또는 VODStreamRequest)에는 선택사항이지만 권장됩니다. 이 코드는 프로그래매틱 방식의 제한적인 광고 사용 설정과 같은 Ad Manager UI에서 선택한 설정을 적용하는 데 사용됩니다. 포드 제공 및 클라우드 스티칭의 경우 스트림을 찾아 재생하는 데도 사용됩니다. 네트워크 코드를 찾으려면 이 도움말을 참고하세요.
확인 공급업체를 OMID 액세스 모드에 매핑하기 위한 설정 객체입니다. 인증 스크립트 URL은 내부적으로 공급업체에서 제공한 정규 표현식과 일치하여 OmidVerificationVendor 키로 확인됩니다. 그런 다음 IMA는 이 객체를 사용하여 지정된 공급업체의 액세스 모드를 조회합니다.
알려진 공급업체로 확인되지 않는 스크립트 URL의 경우 또는 확인된 OmidVerificationVendor가 이 객체에 제공되지 않는 경우 IMA는 OmidVerificationVendor.OTHER에 제공된 액세스 모드를 사용합니다. OmidVerificationVendor.OTHER가 제공되지 않으면 제한된 액세스 모드가 사용됩니다.
streamActivityMonitorId
문자열
스트림 활동 모니터링 도구로 스트림을 디버깅하는 데 사용할 ID입니다. 이는 게시자가 스트림 활동 모니터링 도구에서 스트림 로그를 찾을 수 있는 편리한 방법을 제공하는 데 사용됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-21(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."]]