‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הטמעה: תגובות

שיטת comments.markAsSpam לא נתמכת יותר.

בדוגמאות הבאות מוסבר איך להשתמש ב-YouTube Data API (גרסה 3) כדי לבצע פונקציות שקשורות לתגובות.

כדי לאחזר רשימה של שרשורי תגובות לסרטון, מפעילים את השיטה commentThreads.list. מגדירים את ערכי הפרמטרים הבאים בבקשה:

‫part: מגדירים את ערך הפרמטר ל-snippet אם רוצים לאחזר רק תגובות ברמה העליונה, או ל-snippet,replies אם רוצים לאחזר גם תשובות לתגובות ברמה העליונה. (שימו לב: משאב commentThread לא מכיל בהכרח את כל התשובות לתגובה, ואם רוצים לאחזר את כל התשובות לתגובה מסוימת צריך להשתמש בשיטה comments.list).
‫videoId: מציינים את מזהה הסרטון ב-YouTube של הסרטון שרוצים לאחזר את התגובות שלו.

הבקשה שבהמשך מאחזרת תגובות ותשובות לתגובות שקשורות לסרטון של נאום הפתיחה בכנס Google I/O בשנת 2014, שמזהה הסרטון שלו הוא wtLJPvx7-ys.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

אחזור תגובות שקשורות לערוץ

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

כדי לאחזר תגובות על ערוץ, פועלים לפי ההוראות לאחזור תגובות על סרטון. אבל במקום להגדיר את הפרמטר videoId, מגדירים את הפרמטר channelId כדי לזהות את הערוץ.
כדי לאחזר תגובות שמשויכות לערוץ, פועלים לפי ההוראות לאחזור תגובות לסרטון. אבל במקום להגדיר את הפרמטר videoId, מגדירים את הפרמטר allThreadsRelatedToChannelId כדי לזהות את הערוץ.

הבקשה הבאה מאחזרת את כל שרשורי התגובות שמשויכים לערוץ YouTube‏ GoogleDevelopers:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

הוספת תגובה

מתקשרים אל שיטת commentThreads.insert כדי להוסיף תגובה חדשה ברמה העליונה לערוץ או לסרטון. מגדירים את ערך הפרמטר part של הבקשה ל-snippet. גוף הבקשה הוא commentThread resource שבו המאפיין snippet.topLevelComment[].snippet[].textOriginal מכיל את טקסט התגובה. צריך לאשר את הבקשה הזו באמצעות OAuth 2.0.

כדי להוסיף תגובה לערוץ, משתמשים במאפיין snippet.channelId כדי לזהות את הערוץ.
כדי להוסיף תגובה לסרטון, משתמשים במאפיין snippet.channelId כדי לזהות את הערוץ שהעלה את הסרטון. צריך להשתמש גם במאפיין snippet.videoId כדי לזהות את הסרטון.

בדוגמה הבאה מוצגת בקשה להוספת תגובה לסרטון.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.insert?
part=snippet

הבקשה מוסיפה את המשאב שמוצג למטה.

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

השבה לתגובה

מבצעים קריאה לשיטה comments.insert כדי להשיב לתגובה. מגדירים את ערך הפרמטר part של הבקשה ל-snippet. גוף הבקשה הוא comment resource שבו המאפיין snippet.textOriginal מכיל את טקסט התגובה. המאפיין snippet.parentId מזהה את התגובה שמשויכת לתשובה, והערך שלו הוא commentThread resource's ID. צריך לאשר את הבקשה הזו באמצעות OAuth 2.0.

הבקשה לדוגמה הבאה מוסיפה תשובה לתגובה קיימת.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.insert?
part=snippet

הבקשה מוסיפה את מקור המידע שמוצג למטה. כדי לבצע את הבקשה ב-APIs Explorer, משתמשים בערך של המאפיין snippet.parentId כדי לזהות את התגובה ברמה העליונה שמשויכת לתשובה. במשאב commentThread, המאפיין snippet.topLevelComment[].id מציין את המזהה הייחודי של המשאב.

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

עדכון של תגובה ברמה העליונה או של תשובה לתגובה

כדי לעדכן את הטקסט של תגובה ברמה העליונה או של תשובה לתגובה ברמה העליונה, קוראים לשיטה comments.update. מגדירים את הערך של הפרמטר part בתור snippet. בגוף הבקשה, המאפיין id מזהה את התגובה שאתם משנים ואת הטקסט החדש של התגובה.

במשאב commentThread, שמזהה תגובה ברמה העליונה, המאפיין snippet.topLevelComment[].id מציין את המזהה הייחודי של התגובה.
במשאב comment, שיכול לזהות תגובה ברמה העליונה או תשובה לתגובה, המאפיין id מציין את המזהה הייחודי של התגובה.

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

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.update?
part=snippet

גוף הבקשה מכיל את קטע הקוד ב-JSON שמוצג בהמשך. כדי לבצע את הבקשה ב-APIs Explorer, מגדירים את הערך של המאפיין id כדי לזהות את התגובה שאתם מעדכנים. הבקשה צריכה להיות מאושרת על ידי האדם שכתב את התגובה.

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

הגדרת סטטוס ניהול התגובות

כדי להגדיר את סטטוס הבקרה של תגובה, צריך לבצע קריאה לשיטה comments.setModerationStatus. הפעולה הזו מתבצעת כשהבעלים של הערוץ מנהלים את התגובות בערוץ או בסרטונים של הערוץ.

כשקוראים לשיטה הזו, צריך להגדיר את הערך של הפרמטר id כדי לזהות את התגובה. צריך גם להגדיר את הפרמטר moderationStatus לסטטוס הרצוי. רק הבעלים של הערוץ שבו התגובה מופיעה יכולים לשנות את הסטטוס שלה.

שלב 1: אחזור תגובות שמוחזקות לבדיקה

קוראים ל-method‏ commentThreads.list כדי לאחזר תגובות לערוץ או לסרטון. מגדירים את הערך של הפרמטר moderationStatus בתור heldForReview. אפשר להשתמש בתגובה מה-API כדי להציג רשימה של תגובות עם אפשרות לבעל הערוץ לפרסם או לדחות כל אחת מהן.
שלב 2: עדכון סטטוס הניהול של תגובה

מפעילים את השיטה comments.setModerationStatus כדי לעדכן את סטטוס התגובה. משתמשים בערך של הפרמטר id כדי לציין את המזהה הייחודי של התגובה. מגדירים את הפרמטר moderationStatus לערך published או rejected. אם אתם דוחים תגובה, אתם יכולים גם להגדיר את הפרמטר banAuthor לערך true כדי למנוע מהכותב להוסיף תגובות נוספות בערוץ או בסרטון.

הערה: אין אפשרות להשתמש ב-API כדי להציג רשימה של תגובות שנדחו או לגלות אותן בדרך אחרת. עם זאת, עדיין אפשר לשנות את סטטוס הניהול של תגובה שנדחתה ל-published אם המזהה הייחודי של התגובה ידוע. בנוסף, אחרי שסטטוס הניהול של תגובה מתעדכן ל-published או ל-rejected, אי אפשר לשנות אותו בחזרה ל-heldForReview.

הסרת תגובה

בדוגמה הזו מוסבר איך למחוק תגובה. בדוגמה הזו יש את השלבים הבאים:

שלב 1: מאחזרים את מזהה התגובה

כדי לאחזר רשימה של תגובות לסרטון או לערוץ, פועלים לפי השלבים שמפורטים למעלה. חשוב לזכור שרק מחבר התגובה יכול למחוק אותה. לכן, כדי לקבוע אם המשתמש יכול למחוק תגובה מסוימת, צריך להשוות בין הערך של המאפיין snippet.authorChannelId.value במשאב comment לבין מזהה הערוץ של המשתמש המאומת.
שלב 2: מוחקים את התגובה או את שרשור התגובות

אחרי שמזהים את המזהה של שרשור התגובות או התגובה שרוצים למחוק, קוראים לשיטה comments.delete כדי למחוק את התגובה. משתמשים בערך הפרמטר id כדי לזהות את מזהה התגובה או את מזהה שרשור התגובות שרוצים למחוק. הבקשה חייבת להיות מאושרת באמצעות OAuth 2.0. אם אתם בודקים את השאילתה הזו בכלי APIs Explorer, תצטרכו להחליף את ערך הפרמטר id בבקשה שלמטה במזהה תגובה או במזהה שרשור תגובות תקינים.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
id=COMMENT_ID
```

הטמעה: תגובות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

אחזור תגובות לסרטון