Comments

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

Methods

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

list

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

הוספה

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

עדכון

‫

Modifies a comment. כדאי לנסות עכשיו.

מחיקה

מחיקת תגובה. כדאי לנסות עכשיו.

setModerationStatus

הגדרת סטטוס הניהול של תגובה אחת או יותר. הבקשה ל-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
  }
}

מאפיינים

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

מאפיינים
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.