מחיקה של רצועת כתוביות שצוינה.
השפעה על המכסה: קריאה לשיטה הזו מחייבת עלות מכסה של 50 יחידות.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
DELETE https://www.googleapis.com/youtube/v3/captions
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאה, קראו את המאמר הטמעת הרשאה של OAuth 2.0.
| היקף |
|---|
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtubepartner |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמפורטים הם פרמטרים של שאילתות.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
id |
stringהפרמטר id מזהה את רצועת הכיתוב שנמחקת. הערך הוא מזהה של טראק כתוביות כפי שזוהה על ידי המאפיין id במשאב caption. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringאפשר להשתמש בפרמטר הזה רק בבקשה מורשית. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של הבקשה מזהים משתמש במערכת ניהול התוכן של YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן ב-YouTube שיש להם בעלות על ערוצי YouTube רבים ושהם מנהלים אותם. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לכל ערוץ בנפרד. חשבון ה-CMS בפועל שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוין ב-YouTube. |
|
גוף הבקשה
אין לספק גוף בקשה בקריאה ל-method הזה.
תשובה
אם הפעולה מצליחה, השיטה הזו מחזירה קוד סטטוס HTTP 204 No Content.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. מידע נוסף זמין במאמר YouTube Data API – שגיאות.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
forbidden |
ההרשאות שמשויכות לבקשה לא מספיקות כדי למחוק את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי. |
notFound (404) |
captionNotFound |
לא נמצאה רצועת כתוביות. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון. |
נסה בעצמך!
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה ואת התשובה של ה-API.