Comments: insert

יצירת תשובה לתגובה קיימת. הערה: כדי ליצור תגובה ברמה העליונה, משתמשים בשיטה commentThreads.insert.

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

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

בקשה

בקשת HTTP

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

אישור

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

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

פרמטרים

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

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

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

גוף הבקשה

מציינים משאב תגובה בגוף הבקשה. במשאב הזה:

  • חובה לציין ערך למאפיינים האלה:

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

תשובה

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

שגיאות

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

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

רוצה לנסות?

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