Google Chat API

Google Chat API מאפשר לכם ליצור אפליקציות ל-Chat כדי לשלב את השירותים שלכם עם Google Chat ולנהל משאבים ב-Chat כמו מרחבים משותפים, חברים והודעות.

שירות: chat.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, השתמשו במידע הבא כשתשלחו את בקשות ה-API.

מסמך הגילוי

מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולשימוש בממשקי API ל-REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין בסביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:

נקודת קצה בשירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoints) של שירות. לשירות הזה יש את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI הבאים הם יחסיים לנקודת הקצה של השירות:

  • https://chat.googleapis.com

משאב REST: v1.media

שיטות
download GET /v1/media/{resourceName=**}
הורדת מדיה.
upload POST /v1/{parent=spaces/*}/attachments:upload
POST /upload/v1/{parent=spaces/*}/attachments:upload
מתבצעת העלאה של קובץ מצורף.

משאב REST: v1.spaces

שיטות
completeImport POST /v1/{name=spaces/*}:completeImport
משלים את תהליך הייבוא של המרחב המשותף שצוין והופך אותו לגלוי למשתמשים.
create POST /v1/spaces
ייווצר מרחב משותף עם שם.
delete DELETE /v1/{name=spaces/*}
מחיקת מרחב משותף עם שם.
findDirectMessage GET /v1/spaces:findDirectMessage
מחזירה את הצ'אט האישי הקיים עם המשתמש שצוין.
get GET /v1/{name=spaces/*}
מחזירה פרטים על מרחב משותף.
list GET /v1/spaces
רשימת המרחבים המשותפים שבהם מבצע הקריאה החוזרת חבר.
patch PATCH /v1/{space.name=spaces/*}
הפונקציה מעדכנת את המרחב המשותף.
setup POST /v1/spaces:setup
יצירת מרחב משותף והוספה של משתמשים ספציפיים אליו.

משאב REST: v1.spaces.members

שיטות
create POST /v1/{parent=spaces/*}/members
יצירת מינוי אנושי או מינוי לאפליקציה לשיחות.
delete DELETE /v1/{name=spaces/*/members/*}
המינוי יימחק.
get GET /v1/{name=spaces/*/members/*}
מחזיר פרטים על המינוי.
list GET /v1/{parent=spaces/*}/members
רשימת המשתתפים במרחבים משותפים.
patch PATCH /v1/{membership.name=spaces/*/members/*}
עדכון המינוי.

משאב REST: v1.spaces.messages

שיטות
create POST /v1/{parent=spaces/*}/messages
יצירת הודעה במרחב משותף ב-Google Chat.
delete DELETE /v1/{name=spaces/*/messages/*}
ההודעה תימחק.
get GET /v1/{name=spaces/*/messages/*}
מחזיר פרטים על הודעה.
list GET /v1/{parent=spaces/*}/messages
כאן רשומים ההודעות במרחב המשותף שבו המתקשר חבר, כולל הודעות מהמשתתפים ומהמרחבים המשותפים שחסמתם.
patch PATCH /v1/{message.name=spaces/*/messages/*}
הודעה מעדכנת.
update PUT /v1/{message.name=spaces/*/messages/*}
הודעה מעדכנת.

משאב REST: v1.spaces.messages.attachments

שיטות
get GET /v1/{name=spaces/*/messages/*/attachments/*}
הפונקציה הזו מקבלת את המטא-נתונים של קובץ מצורף להודעה.

משאב REST: v1.spaces.messages.reactions

שיטות
create POST /v1/{parent=spaces/*/messages/*}/reactions
המערכת יוצרת תגובה ומוסיפה אותה להודעה.
delete DELETE /v1/{name=spaces/*/messages/*/reactions/*}
התגובה להודעה תימחק.
list GET /v1/{parent=spaces/*/messages/*}/reactions
רשימת התגובות להודעות.

משאב REST: v1.spaces.spaceEvents

שיטות
get GET /v1/{name=spaces/*/spaceEvents/*}
מחזירה אירוע ממרחב משותף ב-Google Chat.
list GET /v1/{parent=spaces/*}/spaceEvents
רשימת אירועים ממרחב משותף ב-Google Chat.

משאב REST: v1.users.spaces

שיטות
getSpaceReadState GET /v1/{name=users/*/spaces/*/spaceReadState}
מחזירה פרטים על מצב הקריאה של המשתמש במרחבים משותפים, שמשמשים לזיהוי הודעות שנקראו ולא נקראו.
updateSpaceReadState PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}
עדכון מצב הקריאה של המשתמש במרחב המשותף, שמשמש לזיהוי הודעות שנקראו ולא נקראו.

משאב REST: v1.users.spaces.threads

שיטות
getThreadReadState GET /v1/{name=users/*/spaces/*/threads/*/threadReadState}
הצגת פרטים על מצב הקריאה של המשתמש בשרשור, שמשמשים לזיהוי הודעות שנקראו ולא נקראו.