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

השיטה 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"
 }
}

השבה לתגובה

כדי להשיב לתגובה, קוראים ל-method‏ 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

הבקשה כוללת את המשאב שמוצג בהמשך. כדי להריץ את הבקשה ב-API 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: מעדכנים את סטטוס הבקרה של תגובה

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

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

הסרת תגובה

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

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

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

• שלב 2: מוחקים את התגובה או את שרשור התגובות

  אחרי שמזהים את המזהה של שרשרת התגובות או התגובה שרוצים למחוק, קוראים ל-method‏ comments.delete כדי למחוק את התגובה. משתמשים בערך הפרמטר id כדי לזהות את מזהה התגובה או את מזהה שרשור התגובות שרוצים למחוק. צריך לאשר את הבקשה באמצעות OAuth 2.0. אם אתם בודקים את השאילתה הזו ב-API Explorer, תצטרכו להחליף את ערך הפרמטר id בבקשה שבהמשך במזהה תגובה תקין או במזהה של שרשור תגובות תקין.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
  id=COMMENT_ID