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 ואת התשובה.