Watermarks: unset
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لحذف صورة العلامة المائية للقناة
تأثير الحصة: تحتوي إحدى المكالمات إلى هذه الطريقة على تكلفة حصة تبلغ 50 وحدة.
الطلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/watermarks/unset
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).
النطاق |
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المَعلمات
يسرد الجدول التالي المعلَمات التي يتيحها طلب البحث هذا. كلّ المَعلمات المدرَجة هي مَعلمات طلب بحث.
المَعلمات |
المَعلمات المطلوبة |
channelId |
string
تحدّد المَعلمة channelId معرّف قناة YouTube الذي يتم إلغاء ضبط العلامة المائية له. |
المَعلمات الاختيارية |
onBehalfOfContentOwner |
string
ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.
تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدِّد مستخدم نظام إدارة محتوى YouTube الذي يتصرّف نيابةً عن مالك المحتوى المحدَّد في قيمة المَعلمة. هذه المعلمة مخصصة لشركاء المحتوى في YouTube الذين يملكون العديد من القنوات المختلفة على YouTube ويديرونها. يسمح هذا البرنامج لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات القنوات والفيديوهات الخاصة بهم، بدون الحاجة إلى تقديم بيانات اعتماد مصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى الذي يصادقه المستخدم مرتبطًا بمالك المحتوى المحدد على YouTube. |
نص الطلب
لا تقدِّم نص طلب عند استدعاء هذه الطريقة.
الإجابة
في حال نجاحها، تعرض هذه الطريقة رمز استجابة HTTP 204
(No Content
).
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
forbidden |
لا يمكن إلغاء ضبط العلامة المائية للقناة المحدّدة. قد يكون الطلب غير مصرّح به بشكل صحيح أو تم ضبط المَعلمة channelId على قيمة غير صالحة. |
تجربة
يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-04-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-04-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API method removes a watermark image from a specified YouTube channel.\u003c/p\u003e\n"],["\u003cp\u003eA successful call to this API returns an HTTP \u003ccode\u003e204\u003c/code\u003e response, indicating no content.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization using \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe required parameter \u003ccode\u003echannelId\u003c/code\u003e specifies the YouTube channel from which the watermark is being removed.\u003c/p\u003e\n"],["\u003cp\u003eThe optional \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter is available for YouTube content partners to manage multiple channels under one authorization.\u003c/p\u003e\n"]]],["This API method deletes a channel's watermark image. It requires authorization with specific scopes and incurs a quota cost of 50 units per call. The request is made via a POST request to the specified URL, requiring the `channelId` parameter, and optionally `onBehalfOfContentOwner`. A successful call returns a `204` response, while a `403` error indicates issues with authorization or an invalid `channelId`. No request body is used for the call.\n"],null,[]]