CommentThreads: insert

יוצרת תגובה חדשה ברמה העליונה. כדי להוסיף תשובה לתגובה קיימת, צריך להשתמש ב-method‏ comments.insert.

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

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

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/commentThreads

אישור

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

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

פרמטרים

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

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

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

גוף הבקשה

צריך לספק commentThread resource בגוף הבקשה.

עבור המשאב הזה, צריך לציין ערך למאפיינים הבאים:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelOrVideoIdMissing כל שרשור תגובות חייב להיות מקושר לסרטון. צריך לוודא שהמשאב מציין ערכים למאפיינים snippet.channelId ו-snippet.videoId. תגובה לסרטון מופיעה בדף הצפייה של הסרטון.
badRequest (400) commentTextRequired במשאב comment שמוסיפים צריך לציין ערך למאפיין snippet.topLevelComment.snippet.textOriginal. חובה להוסיף הערות.
badRequest (400) commentTextTooLong המשאב comment שנוסף מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata המטא-נתונים של הבקשה לא תקינים.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מצביעה על כך שהקלט של הבקשה לא תקין. בודקים את המבנה של המשאב commentThread בגוף הבקשה כדי לוודא שהוא תקין.
forbidden (403) forbidden אי אפשר ליצור את שרשור התגובות כי אין מספיק הרשאות. יכול להיות שהבקשה לא מורשית כראוי.
forbidden (403) ineligibleAccount כדי להוסיף תגובה או שרשור תגובות, צריך למזג את חשבון YouTube שמשמש לאישור בקשת ה-API עם חשבון Google של המשתמש.
notFound (404) channelNotFound הערוץ שצוין לא נמצא. צריך לבדוק את הערך של המאפיין snippet.channelId ולוודא שהוא נכון.
notFound (404) videoNotFound הסרטון שצוין לא נמצא. צריך לבדוק את הערך של המאפיין snippet.videoId ולוודא שהוא נכון.

רוצה לנסות?

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