Comments: update

שינוי תגובה.

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

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

בקשה

בקשת HTTP

PUT https://www.googleapis.com/youtube/v3/comments

אישור

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

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

פרמטרים

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

פרמטרים
פרמטרים נדרשים
part string
הפרמטר part מזהה את המאפיינים שהתגובה מה-API תכלול. צריך לכלול לפחות את החלק snippet בערך הפרמטר, כי החלק הזה מכיל את כל המאפיינים שאפשר לעדכן באמצעות בקשת ה-API.

הרשימה הבאה מכילה את השמות part שאפשר לכלול בערך הפרמטר:
  • id
  • snippet

גוף הבקשה

צריך לספק משאב תגובה בגוף הבקשה. במשאב הזה:

  • אפשר להגדיר ערכים למאפיינים הבאים:

    • snippet.textOriginal

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) commentTextTooLong המשאב comment שמתעדכן מכיל יותר מדי תווים במאפיין snippet.textOriginal.
badRequest (400) invalidCommentMetadata המטא-נתונים של הבקשה לא תקינים.
badRequest (400) operationNotSupported אפשר לעדכן רק תגובות שמבוססות על Google+.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מציינת שהקלט של הבקשה לא תקין. בודקים את המבנה של המשאב comment בגוף הבקשה כדי לוודא שהוא תקין.
forbidden (403) forbidden לא ניתן לעדכן את התגובה בגלל שאין מספיק הרשאות. יכול להיות שהבקשה לא מורשית כראוי.
forbidden (403) ineligibleAccount כדי לעדכן תגובה או שרשור תגובות, צריך למזג את חשבון YouTube שמשמש לאישור בקשת ה-API עם חשבון Google של המשתמש.
notFound (404) commentNotFound לא ניתן היה למצוא את התגובה שצוינה. צריך לבדוק את הערך של המאפיין id בגוף הבקשה ולוודא שהוא נכון.

רוצה לנסות?

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