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 Studio. |
גוף הבקשה
אין לספק גוף בקשה כשמבצעים קריאה ל-method הזה.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה קוד תגובה 204 של HTTP (No Content).
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-16 (שעון UTC).
[null,null,["עדכון אחרון: 2024-08-16 (שעון UTC)."],[[["\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`)."]]
