Method: spaces.spaceEvents.get

הפונקציה מחזירה אירוע ממרחבים משותפים ב-Google Chat. המטען הייעודי (Payload) של האירוע מכיל את הגרסה האחרונה של המשאב שהשתנה. לדוגמה, אם מבקשים אירוע לגבי הודעה חדשה אבל ההודעה עודכנה מאוחר יותר, השרת מחזיר את המשאב המעודכן Message בתוכן של האירוע.

הערה: השדה permissionSettings לא מוחזר באובייקט המרחב המשותף של נתוני האירועים במרחב המשותף לבקשה הזו.

נדרשת אימות משתמש עם היקף הרשאה שמתאים לקריאת הנתונים המבוקשים:

  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

כדי לקבל אירוע, המשתמש המאומת צריך להיות חבר במרחב המשותף.

דוגמה לכך מופיעה במאמר איך רואים פרטים על אירוע במרחב משותף ב-Google Chat.

בקשת HTTP

GET https://chat.googleapis.com/v1/{name=spaces/*/spaceEvents/*}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של אירוע המרחב המשותף.

פורמט: spaces/{space}/spaceEvents/{spaceEvent}

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של SpaceEvent.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

מידע נוסף זמין במדריך ההרשאות.