Subscriptions: delete

מחיקת מינוי.

השפעה על המכסה: קריאה ל-method הזה מנצלת 50 יחידות מהמכסה.

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

DELETE https://www.googleapis.com/youtube/v3/subscriptions

אישור

הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.

פרמטרים
פרמטרים נדרשים
id string
הפרמטר id מציין את מזהה המינוי ב-YouTube של המשאב שנמחק. במשאב subscription, המאפיין id מציין את מזהה המינוי ל-YouTube.

גוף הבקשה

כשמפעילים את ה-method הזו, לא צריך לספק גוף בקשה.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה קוד תגובה של HTTP‏ 204 ‏ (No Content).

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים זמינים במסמכי התיעוד של הודעת השגיאה.

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) subscriptionForbidden הבקשה לא מאומתת כמו שצריך או שהיא לא נתמכת בערוץ הזה.
notFound (404) subscriptionNotFound המינוי שניסית למחוק לא נמצא. צריך לבדוק את הערך של הפרמטר id בבקשה ולוודא שהוא נכון.

רוצה לנסות?

משתמשים ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.