نحن بصدد تعديل Data API لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
PlaylistImages: delete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لحذف صورة قائمة تشغيل.
تأثير الحصة: تبلغ تكلفة حصة الطلب الذي يتضمّن هذه الطريقة 50 وحدة.
الطلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistImages
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يسرد الجدول التالي المَعلمات التي يتيحها هذا طلب البحث. وجميع المَعلمات المُدرجة هي مَعلمات طلب بحث.
| المعلمات |
| المَعلمات المطلوبة |
id |
string
تحدّد المعلمة id معرّف صورة قائمة التشغيل على YouTube لصورة قائمة التشغيل التي يتم حذفها. في مورد playlistImages، تحدد السمة id المعرّف الخاص بصورة قائمة التشغيل. |
| المَعلمات الاختيارية |
onBehalfOfContentOwner |
string
ملاحظة: إنّ المَعلمة onBehalfOfContentOwner مخصّصة حصريًا لشركاء المحتوى على YouTube ويمكن استخدامها فقط في طلب مفوَّض سليم.
تمّ تصميم هذه المَعلمة لشركاء المحتوى في YouTube الذين يملكون قنوات متعدّدة مختلفة على YouTube ويديرونها. وهي تتيح للمستخدمين التابعين لمالك المحتوى المصادقة مرة واحدة، ثم التمكن من الوصول إلى جميع بيانات القناة والفيديوهات التابعة لمالك المحتوى وإدارتها، بدون الحاجة إلى تقديم بيانات اعتماد للمصادقة لكل قناة على حدة.
عند توفر المعلمة، تحدد قيمتها مالك المحتوى، وتحدد بيانات اعتماد التفويض الخاصة بالطلب مستخدم YouTube المفوّض بالتصرّف نيابةً عن مالك المحتوى هذا. يجب أن يكون الحساب الذي يصادق المستخدم عليه مرتبطًا بمالك المحتوى المحدّد في إعدادات "استوديو YouTube". |
نص الطلب
لا تقدِّم نص طلب عند استدعاء هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، ستعرض هذه الطريقة رمز استجابة HTTP 204 (No Content).
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-16 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis method allows for the deletion of a playlist image using the YouTube Data API.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a playlist image requires authorization with one of the specified scopes, including \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eid\u003c/code\u003e parameter is mandatory and specifies the unique ID of the playlist image to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method has a quota cost of 50 units per request.\u003c/p\u003e\n"],["\u003cp\u003eContent partners managing multiple channels can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter to manage their data.\u003c/p\u003e\n"]]],["This method deletes a specific playlist image on YouTube, identified by its `id`. The request is made via a `DELETE` HTTP request to the `/playlistImages` endpoint. Authorization is required, using one of the specified scopes. A `quota cost` of 50 units is associated with each call. An optional parameter, `onBehalfOfContentOwner`, allows content partners to manage data across multiple channels. Upon successful deletion, a `204` response code is returned. No request body is needed.\n"],null,["# PlaylistImages: delete\n\nDeletes a playlist image.\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```\nDELETE https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\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| `id` | `string` The **id** parameter specifies the YouTube playlist image ID for the playlist image that is being deleted. In a `playlistImages` resource, the `id` property specifies the playlist image's ID. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204` response code (`No Content`)."]]
