GroupItems: delete
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשה
בקשת HTTP
DELETE https://youtubeanalytics.googleapis.com/v2/groupItems
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).
| טווחים |
| https://www.googleapis.com/auth/yt-analytics.readonly |
עיון בדוחות YouTube Analytics עבור התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדים של פעילות המשתמשים, כמו מספר הצפיות ומספר הדירוגים. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
הצגת דוחות כספיים של YouTube Analytics לתוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדי פעילות המשתמשים ולמדדים של ההכנסות המשוערות וביצועי המודעות. |
| https://www.googleapis.com/auth/youtube |
ניהול חשבון YouTube. ב-YouTube Analytics API, בעלי ערוצים משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים מקובצים ב-YouTube Analytics. |
| https://www.googleapis.com/auth/youtubepartner |
הצגה וניהול של נכסי YouTube ותוכן משויך ב-YouTube. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים מקובצים ב-YouTube Analytics. |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שנתמכים בשאילתה הזו. כל הפרמטרים שמפורטים הם פרמטרים של שאילתות.
| פרמטרים |
| פרמטרים נדרשים |
id |
string
הפרמטר id מציין את מזהה הפריט של קבוצת YouTube של הקבוצה שנמחקת. |
| פרמטרים אופציונליים |
onBehalfOfContentOwner |
string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן ב-YouTube שבבעלותם מנוהלים הרבה ערוצים שונים ב-YouTube.
הפרמטר onBehalfOfContentOwner מציין שהפרטים המזהים של הרשאת הגישה של הבקשה מזהים משתמש ב-YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ שלהם, בלי שיצטרכו לספק פרטי כניסה לאימות לכל ערוץ בנפרד. החשבון שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן ב-YouTube שצוין. |
גוף הבקשה
אין לספק גוף בקשה בקריאה ל-method הזה.
תשובה
אם הפעולה מצליחה, השיטה הזו מחזירה קוד תגובה מסוג HTTP 204 (No Content).
שגיאות
הטבלה הבאה מזהה הודעות שגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. אפשר לקרוא פרטים נוספים בתיעוד של הודעות שגיאה.
| סוג השגיאה |
פרטי השגיאה |
תיאור |
notFound (404) |
groupItemNotFound |
לא ניתן למצוא את הפריט הקבוצתי שזוהה במאפיין id של הבקשה. |
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eThis API endpoint is used to delete a specific item from a YouTube Analytics group using its unique ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization using one of the listed scopes, with varying levels of access to YouTube Analytics data, from readonly to managing account and content.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eid\u003c/code\u003e parameter is mandatory and specifies the unique identifier of the group item to be removed.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter is an optional parameter, exclusively for YouTube content partners, to authorize requests on behalf of a specific content owner.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns an HTTP \u003ccode\u003e204\u003c/code\u003e status code, and a \u003ccode\u003enotFound\u003c/code\u003e error occurs if the specified group item cannot be found.\u003c/p\u003e\n"]]],["This documentation details the process of removing an item from a YouTube Analytics group via a `DELETE` HTTP request to `https://youtubeanalytics.googleapis.com/v2/groupItems`. Authorization is required, using specific scopes like `yt-analytics.readonly`, `yt-analytics-monetary.readonly`, `youtube`, or `youtubepartner`. The request requires the `id` parameter specifying the group item's ID. An optional `onBehalfOfContentOwner` parameter allows content owners to manage multiple channels. Successful deletion returns a `204` status; a `404` error occurs if the item isn't found.\n"],null,[]]
