เรากำลังอัปเดต Data API ให้สอดคล้องกับวิธีที่ YouTube นับยอดดูสำหรับ Shorts
ดูข้อมูลเพิ่มเติม
Watermarks
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
watermark ทรัพยากรจะระบุรูปภาพที่แสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังระบุช่องเป้าหมายที่รูปภาพจะลิงก์ไปถึง รวมถึงรายละเอียดเวลาที่กำหนดเวลาที่ลายน้ำจะปรากฏในระหว่างการเล่นวิดีโอและความยาวของเวลาที่มองเห็นได้
เมธอด
API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร watermarks
- ตั้งค่า
- อัปโหลดรูปภาพลายน้ำไปยัง YouTube และตั้งค่าให้ช่อง
- unset
- ลบรูปภาพลายน้ำของช่อง
ลองใช้เลย
พร็อพเพอร์ตี้
ตารางต่อไปนี้กำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
| พร็อพเพอร์ตี้ |
timing |
object
ออบเจ็กต์ timing จะห่อหุ้มข้อมูลเกี่ยวกับเวลาในระหว่างการเล่นวิดีโอเมื่อรูปภาพลายน้ำของช่องจะแสดง |
timing.type |
string
วิธีการกำหนดเวลาที่กำหนดว่ารูปภาพลายน้ำจะแสดงเมื่อใดระหว่างการเล่นวิดีโอ หากค่าเป็น offsetFromStart ฟิลด์ offsetMs จะแสดงออฟเซ็ตจากจุดเริ่มต้นของวิดีโอ หากค่าเป็น offsetFromEnd ฟิลด์ offsetMs จะแสดงออฟเซ็ตจากตอนท้ายของวิดีโอ |
timing.offsetMs |
unsigned long
ออฟเซ็ตเวลาที่ระบุเป็นมิลลิวินาที ซึ่งกำหนดเวลาที่สินค้าที่โปรโมตจะปรากฏในระหว่างการเล่นวิดีโอ ค่าของพร็อพเพอร์ตี้ type จะกำหนดว่าออฟเซ็ตจะวัดจากจุดเริ่มต้นหรือจุดสิ้นสุดของวิดีโอ |
timing.durationMs |
unsigned long
ระยะเวลาเป็นมิลลิวินาทีที่ควรแสดงรูปภาพลายน้ำ |
position |
object
ออบเจ็กต์ position จะห่อหุ้มข้อมูลเกี่ยวกับตำแหน่งเชิงพื้นที่ภายในวิดีโอที่รูปภาพลายน้ำจะแสดง |
position.type |
string
ลักษณะที่วางตำแหน่งสินค้าที่โปรโมตในวิดีโอเพลเยอร์
ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ |
position.cornerPosition |
string
มุมของเพลเยอร์ที่รายการที่โปรโมตจะปรากฏ รายการจะปรากฏที่มุมขวาบนของเพลเยอร์เสมอ
ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ |
imageUrl |
string
URL ของรูปภาพลายน้ำของช่อง YouTube จะสร้าง URL นี้และส่งกลับในการตอบกลับ API สำหรับคำขอ watermark.set |
imageBytes |
bytes
ขนาดของรูปภาพลายน้ำในหน่วยไบต์ |
targetChannelId |
string
รหัสช่อง YouTube ของช่องที่รูปภาพลายน้ำลิงก์ไป |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-21 UTC
[null,null,["อัปเดตล่าสุด 2025-08-21 UTC"],[[["\u003cp\u003eA watermark resource displays an image during a channel's video playbacks, with the option to link to a target channel.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides \u003ccode\u003eset\u003c/code\u003e and \u003ccode\u003eunset\u003c/code\u003e methods to upload and delete watermark images respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etiming\u003c/code\u003e object controls when a watermark appears, using \u003ccode\u003etype\u003c/code\u003e to determine if it's measured from the start or end of a video and \u003ccode\u003eoffsetMs\u003c/code\u003e for the time offset, with \u003ccode\u003edurationMs\u003c/code\u003e defining its display length.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eposition\u003c/code\u003e object defines the watermark's location within the video, with \u003ccode\u003ecornerPosition\u003c/code\u003e specifically determining the corner.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etargetChannelId\u003c/code\u003e property is used to indicate the YouTube channel ID that the image links to when interacted with.\u003c/p\u003e\n"]]],["A watermark resource is an image displayed during a channel's video playbacks. Key actions include setting a watermark by uploading an image and specifying its `targetChannelId` for linking. The `timing` object defines when the image appears using `type`, `offsetMs`, and `durationMs`. The `position` object, set to 'corner', determines the spatial location, specifically `topRight`. Watermarks can be removed using the `unset` method. The API response provides an `imageUrl` and `imageBytes`.\n"],null,["# Watermarks\n\nA **watermark** resource identifies an image that displays during playbacks of a specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears during video playbacks and the length of time it is visible.\n\nMethods\n-------\n\nThe API supports the following methods for `watermarks` resources:\n\n[set](/youtube/v3/docs/watermarks/set)\n: Uploads a watermark image to YouTube and sets it for a channel.\n\n[unset](/youtube/v3/docs/watermarks/unset)\n: Deletes a channel's watermark image.\n [Try it now](/youtube/v3/docs/watermarks/unset#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `watermarks` resource: \n\n```carbon\n{\n \"#timing\": {\n \"#timing.type\": string,\n \"#timing.offsetMs\": unsigned long,\n \"#timing.durationMs\": unsigned long\n },\n \"#position\": {\n \"#position.type\": string,\n \"#position.cornerPosition\": string\n },\n \"#imageUrl\": string,\n \"#imageBytes\": bytes,\n \"#targetChannelId\": string\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `timing` | `object` The `timing` object encapsulates information about the time during a video playback when a channel's watermark image will display. |\n| timing.`type` | `string` The timing method that determines when the watermark image is displayed during the video playback. If the value is `offsetFromStart`, then the `offsetMs` field represents an offset from the start of the video. If the value is `offsetFromEnd`, then the `offsetMs` field represents an offset from the end of the video. |\n| timing.`offsetMs` | `unsigned long` The time offset, specified in milliseconds, that determines when the promoted item appears during video playbacks. The `type` property's value determines whether the offset is measured from the start or end of the video. |\n| timing.`durationMs` | `unsigned long` The length of time, in milliseconds, that the watermark image should display. |\n| `position` | `object` The `position` object encapsulates information about the spatial position within the video where the watermark image will display. |\n| position.`type` | `string` The manner in which the promoted item is positioned in the video player. Valid values for this property are: - corner |\n| position.`cornerPosition` | `string` The corner of the player where the promoted item will appear. The item always appears in the upper right corner of the player. Valid values for this property are: - `topRight` |\n| `imageUrl` | `string` The URL for the channel's watermark image. YouTube will generate this URL and return it in the API response to a `watermark.set` request. |\n| `imageBytes` | `bytes` The size of the watermark image, in bytes. |\n| `targetChannelId` | `string` The YouTube channel ID of the channel that the watermark image links to. |"]]
