ما در حال به‌روزرسانی Data API هستیم تا با نحوه شمارش بازدیدهای YouTube برای Shorts مطابقت داشته باشد.
بیشتر بدانید
Watermarks: set
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک تصویر واترمارک را در YouTube آپلود می کند و آن را برای یک کانال تنظیم می کند.
این روش از آپلود رسانه پشتیبانی می کند. فایل های آپلود شده باید با این محدودیت ها مطابقت داشته باشند:
- حداکثر حجم فایل: 10 مگابایت
- انواع MIME رسانه پذیرفته شده:
image/jpeg ، image/png ، application/octet-stream
تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/upload/youtube/v3/watermarks/set
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد. برای مطالعه بیشتر درباره احراز هویت و مجوز، به اجرای مجوز OAuth 2.0 مراجعه کنید.
| دامنه |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
پارامترها
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
| پارامترها |
|---|
| پارامترهای مورد نیاز |
channelId | string
پارامتر channelId شناسه کانال YouTube را که واترمارک برای آن ارائه شده است مشخص می کند. |
| پارامترهای اختیاری |
onBehalfOfContentOwner | string
توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است.
پارامتر onBehalfOfContentOwner نشان می دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می کند که از طرف مالک محتوا مشخص شده در مقدار پارامتر عمل می کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا امکان می‌دهد یک بار احراز هویت کنند و به تمام داده‌های ویدیویی و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت می‌کند باید به مالک محتوای YouTube مشخص شده مرتبط باشد. |
درخواست بدن
یک منبع watermark در بدنه درخواست ارائه دهید.
پاسخ
در صورت موفقیت آمیز بودن، این روش کد وضعیت HTTP 204 No Content برمی گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. برای جزئیات بیشتر، YouTube Data API - Errors را ببینید.
| نوع خطا | جزئیات خطا | توضیحات |
|---|
badRequest (400) | imageFormatUnsupported | تصویری که ارائه کردید در قالب پشتیبانی نشده است. |
badRequest (400) | imageTooTall | تصویری که ارائه کردید خیلی بلند است. |
badRequest (400) | imageTooWide | تصویری که ارائه کردید بسیار گسترده است. |
badRequest (400) | mediaBodyRequired | درخواست شامل محتوای تصویر نمی شود. |
forbidden (403) | forbidden | واترمارک را نمی توان برای کانال مشخص شده تنظیم کرد. ممکن است درخواست به درستی مجاز نباشد، یا پارامتر channelId روی یک مقدار نامعتبر تنظیم شده باشد. |
آن را امتحان کنید!
از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-11-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-11-23 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis method enables uploading a watermark image to YouTube and applying it to a specific channel, supporting file sizes up to 10MB.\u003c/p\u003e\n"],["\u003cp\u003eAccepted image formats for the watermark include JPEG and PNG, and the method uses \u003ccode\u003eapplication/octet-stream\u003c/code\u003e as an accepted MIME type.\u003c/p\u003e\n"],["\u003cp\u003eSetting a watermark using this method consumes 50 quota units, and requires proper authorization using at least one of the specified scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003echannelId\u003c/code\u003e is a required parameter, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter meant only for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a \u003ccode\u003e204 No Content\u003c/code\u003e status, and common errors include unsupported image format, incorrect image dimensions, and missing image content.\u003c/p\u003e\n"]]],["The content describes uploading a watermark image to a YouTube channel using the `watermarks/set` method. This process involves a POST request to the API endpoint, requiring a `channelId` parameter and authorization with specific scopes. The image file must be under 10MB and of `image/jpeg`, `image/png`, or `application/octet-stream` MIME type. This operation costs 50 quota units. A successful request returns a `204` status; errors can include invalid format, size issues, or authorization problems.\n"],null,["# Watermarks: set\n\nUploads a watermark image to YouTube and sets it for a channel.\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 10MB\n- **Accepted Media MIME types:** `image/jpeg`, `image/png`, `application/octet-stream`\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/upload/youtube/v3/watermarks/set\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authorization](/youtube/v3/guides/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube.upload` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `channelId` | `string` The **channelId** parameter specifies the YouTube channel ID for which the watermark is being provided. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** This parameter is intended exclusively for YouTube content partners. The **onBehalfOfContentOwner** parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. |\n\n### Request body\n\nProvide a [watermark](/youtube/v3/docs/watermarks#resource) resource in the request body.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204 No Content` status code.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Data API - Errors](/youtube/v3/docs/errors).\n\n| Error type | Error detail | Description |\n|--------------------|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `badRequest (400)` | `imageFormatUnsupported` | The image you provided is in an unsupported format. |\n| `badRequest (400)` | `imageTooTall` | The image you provided is too tall. |\n| `badRequest (400)` | `imageTooWide` | The image you provided is too wide. |\n| `badRequest (400)` | `mediaBodyRequired` | The request does not include the image content. |\n| `forbidden (403)` | `forbidden` | The watermark can't be set for the specified channel. The request may not be properly authorized, or the `channelId` parameter is set to an invalid value. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
