Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Ad Manager trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
StreamRequest
classpublic
Một lớp để chỉ định các thuộc tính của yêu cầu truyền phát.
Thuộc tính
adTagParameters
(Đối tượng rỗng hoặc không rỗng có thuộc tính chuỗi)
Bạn có thể ghi đè một nhóm nhỏ các thông số thẻ quảng cáo trong yêu cầu luồng của mình. Giá trị được thêm phải là chuỗi.
Cung cấp thông số nhắm mục tiêu cho luồng của bạn cung cấp thêm thông tin.
Bạn có thể sử dụng các tham số dai-ot và dai-ov cho lựa chọn ưu tiên về biến thể luồng phát.
Hãy xem phần
Ghi đè thông số biến thể trong luồng để biết thêm thông tin.
apiKey
chuỗi
Khoá API yêu cầu truyền trực tuyến. Khoá này được định cấu hình thông qua
Giao diện người dùng quản trị DFP và được cung cấp cho nhà xuất bản để mở khoá nội dung của họ.
Nó xác minh những ứng dụng đang cố gắng truy cập vào nội dung.
authToken
chuỗi
Mã uỷ quyền yêu cầu phát trực tuyến. Được dùng thay cho khoá API để có được quyền uỷ quyền nội dung nghiêm ngặt hơn. Nhà xuất bản có thể kiểm soát từng uỷ quyền luồng nội dung dựa trên mã thông báo này.
định dạng
StreamFormat không rỗng
Định dạng luồng cần yêu cầu. Chấp nhận các giá trị chuỗi sau:
hls (mặc định)
dash
networkCode
chuỗi
Mã mạng của nhà xuất bản đưa ra yêu cầu phát trực tuyến này. Bạn phải có mã Network cho các yêu cầu về luồng phân phát nhóm (PodStreamRequest hoặc PodVodStreamRequest) và các yêu cầu về luồng ghép đám mây (VideoStitcherLiveStreamRequest hoặc VideoStitcherVodStreamRequest). Bạn có thể không cần nhưng nên dùng mã này cho các yêu cầu về luồng dịch vụ đầy đủ (LiveStreamRequest hoặc VODStreamRequest). Mã này được dùng để áp dụng các chế độ cài đặt đã chọn trong giao diện người dùng Ad Manager, chẳng hạn như bật quảng cáo bị hạn chế có lập trình. Đối với cơ chế Phân phát nhóm và Ghép nối trên đám mây, tham số này cũng được dùng để xác định vị trí và phát luồng phát. Để tìm mã mạng, hãy xem bài viết này.
omidAccessModeRules
Đối tượng không rỗng có các thuộc tính OmidAccessMode không rỗng
Đối tượng Cài đặt để liên kết các nhà cung cấp dịch vụ xác minh với Chế độ truy cập OMID.
Các URL tập lệnh xác minh được so khớp nội bộ với các biểu thức chính quy do nhà cung cấp cung cấp để phân giải thành một khoá OmidVerificationVendor. Sau đó, IMA sẽ tra cứu chế độ truy cập cho nhà cung cấp nhất định bằng đối tượng này.
Đối với những URL tập lệnh không phân giải thành một nhà cung cấp đã biết hoặc nếu OmidVerificationVendor đã phân giải không được cung cấp trong đối tượng này, thì IMA sẽ sử dụng chế độ truy cập được cung cấp cho OmidVerificationVendor.OTHER. Nếu bạn không cung cấp OmidVerificationVendor.OTHER, thì chế độ truy cập LIMITED sẽ được dùng.
streamActivityMonitorId
chuỗi
Mã nhận dạng dùng để gỡ lỗi luồng bằng trình giám sát hoạt động truyền phát.
Thông tin này được dùng để cung cấp một cách thuận tiện giúp nhà xuất bản tìm thấy nhật ký luồng phát trong công cụ theo dõi hoạt động phát trực tiếp.
[null,null,["Cập nhật lần gần đây nhất: 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,["# Class: StreamRequest\n\nStreamRequest\n=============\n\nclass public\n\nA class for specifying properties of the stream request.\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\nfor stream variant preference.\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### format\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\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### omidAccessModeRules\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\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."]]
