Comments

משאב comment מכיל מידע על תגובה אחת ב-YouTube. comment משאב יכול לייצג תגובה על סרטון או על ערוץ. בנוסף, התגובה יכולה להיות תגובה ברמה העליונה או תשובה לתגובה ברמה העליונה.

Methods

ה-API תומך בשיטות הבאות למשאבי comments:

list
הפונקציה מחזירה רשימה של תגובות שתואמות לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.
הוספה
יצירת תשובה לתגובה קיימת. הערה: כדי ליצור תגובה ברמה העליונה, משתמשים בשיטה commentThreads.insert. אני רוצה לנסות
update
‫
Modifies a comment. כדאי לנסות עכשיו.
מחיקה
מחיקת תגובה. כדאי לנסות עכשיו.
setModerationStatus
‫
Sets the moderation status of one or more comments. הבקשה ל-API צריכה להיות מאושרת על ידי הבעלים של הערוץ או הסרטון שאליהם משויכות התגובות. כדאי לנסות עכשיו.

ייצוג משאבים

מבנה ה-JSON הבא מציג את הפורמט של משאב comments:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime,
    "imageUrl": string
  }
}

מאפיינים

בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:

מאפיינים
kind ‫string
מזהה את סוג משאב ה-API. הערך יהיה youtube#comment.
etag etag
ה-Etag של מקור המידע הזה.
id string
המזהה שמשמש את YouTube כדי לזהות את התגובה באופן ייחודי.
snippet object
האובייקט snippet מכיל פרטים בסיסיים על התגובה.
snippet.authorDisplayName string
השם המוצג של המשתמש שפרסם את התגובה.
snippet.authorProfileImageUrl string
כתובת ה-URL של הדמות של המשתמש שפרסם את התגובה.
snippet.authorChannelUrl string
כתובת ה-URL של ערוץ YouTube של כותב התגובה, אם זמינה.
snippet.authorChannelId object
האובייקט הזה מכיל מידע על ערוץ YouTube של כותב התגובה, אם הוא זמין.
snippet.authorChannelId.value string
המזהה של ערוץ YouTube של כותב התגובה, אם הוא זמין.
snippet.channelId string
המזהה של ערוץ YouTube שמשויך לתגובה.
snippet.textDisplay string
הטקסט של התגובה. אפשר לאחזר את הטקסט כטקסט פשוט או כ-HTML. (השיטות comments.list ו-commentThreads.list תומכות שתיהן בפרמטר textFormat, שמציין את פורמט הטקסט שנבחר).

גם הטקסט הפשוט עשוי להיות שונה מטקסט התגובה המקורי. לדוגמה, יכול להיות שהיא תחליף קישורים לסרטונים בשמות של סרטונים.
snippet.textOriginal string
הטקסט המקורי של התגובה, כפי שהוא פורסם בהתחלה או כפי שהוא עודכן לאחרונה. הטקסט המקורי מוחזר רק למשתמש מאומת שהוא מחבר התגובה.
snippet.parentId string
המזהה הייחודי של תגובת ההורה. המאפיין הזה מוגדר רק אם התגובה נשלחה כתשובה לתגובה אחרת.
snippet.canRate boolean
ההגדרה הזו מציינת אם הצופה הנוכחי יכול לדרג את התגובה.
snippet.viewerRating string
הדירוג שה��ופה נתן לתגובה הזו. המאפיין הזה לא מזהה דירוגים של dislike, אבל יכול להיות שההתנהגות הזו תשתנה. בינתיים, ערך המאפיין הוא like אם הצופה דירג את התגובה באופן חיובי. הערך הוא none בכל שאר המקרים, כולל אם המשתמש נתן לתגובה דירוג שלילי או לא דירג את התגובה.

הערכים התקינים של המאפיין הזה הם:
  • like
  • none
snippet.likeCount unsigned integer
המספר הכולל של הלייקים (דירוגים חיוביים) שהתגובה קיבלה.
snippet.moderationStatus string
סטטוס הבקרה של התגובה. המאפיין הזה מוחזר רק אם בקשת ה-API אושרה על ידי הבעלים של הערוץ או של הסרטון שבו פורסמו התגובות המבוקשות. בנוסף, המאפיין הזה לא מוגדר אם בקשת ה-API השתמשה בפרמטר המסנן id.

הערכים התקינים של המאפיין הזה הם:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
התאריך והשעה שבהם התגובה פורסמה במקור. הערך מצוין בפורמט ISO 8601.
snippet.updatedAt datetime
התאריך והשעה שבהם התגובה עודכנה לאחרונה. הערך מצוין בפורמט ISO 8601.
snippet.imageUrl string
כתובת ה-URL של התמונה או של קובץ ה-GIF המונפש שמצורפים לתגובה, אם יש כאלה. המאפיין הזה מופיע רק אם התגובה מכילה תמונה או קובץ GIF. כתובת ה-URL מוגשת כקישור חתום עם אורך חיים (TTL) של שש שעות, והתוקף שלה פג שש שעות אחרי השליפה.