Comments: update

שינוי של תגובה.

ההשפעה של המכסה: קריאה לשיטה הזו כוללת עלות מכסה של 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

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
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.