הצגת אירועים ממרחבים משותפים ב-Google Chat. מטען הייעודי של כל אירוע מכיל את הגרסה האחרונה של משאב Chat. לדוגמה, אם תציגו אירועים על חברים חדשים במרחב המשותף, השרת יחזיר משאבי Membership שמכילים את פרטי החברות העדכניים ביותר. אם חברים חדשים הוסרו במהלך התקופה המבוקשת, המטען הייעודי (payload) של האירוע מכיל משאב Membership ריק.
נדרש אימות משתמש. כדי להציג את האירועים, המשתמש המאומת צריך להיות חבר במרחב המשותף.
זה שינוי אופציונלי. המספר המקסימלי של אירועי מרחבים משותפים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.
ערכים שליליים מחזירים שגיאה מסוג INVALID_ARGUMENT.
pageToken
string
זה שינוי אופציונלי. אסימון דף, שהתקבל מבקשת אירועים קודמת של מרחב משותף. צריך לספק אותו כדי לאחזר את הדף הבא.
כשמחלקים את הרשימה לדפים, כל הפרמטרים האחרים שסיפקתם כדי לקבל את האירועים של מרחב העבודה חייבים להתאים לקריאה שסיפק את אסימון הדף. העברת ערכים שונים לפרמטרים האחרים עלולה להוביל לתוצאות לא צפויות.
filter
string
חובה. מסנן שאילתות.
צריך לציין לפחות סוג אירוע אחד (eventType) באמצעות האופרטור has :. כדי לסנן לפי כמה סוגי אירועים, משתמשים באופרטור OR. להשמיט מסננים של סוגי אירועים של קבוצות. הבקשה מחזירה באופן אוטומטי את כל אירועי האצווה הקשורים. לדוגמה, אם מסננים לפי תגובות חדשות (google.workspace.chat.reaction.v1.created), השרת מחזיר גם אירועים של קבוצת תגובות חדשות (google.workspace.chat.reaction.v1.batchCreated). רשימה של סוגי האירועים הנתמכים מופיעה במסמכי העזרה של SpaceEvents.
אפשר גם לסנן לפי שעת ההתחלה (startTime) ושעת הסיום (endTime):
startTime: חותמת זמן בלעדית שממנה מתחילים לרשום אירועים במרחב המשותף. אפשר לרשום אירועים שהתרחשו עד לפני 28 יום. אם לא צוין תאריך, יוצגו אירועים במרחב המשותף מ-28 הימים האחרונים.
endTime: חותמת זמן מקיפה עד שתוצג רשימה של אירועים במרחב המשותף. אם לא צוין תאריך, המערכת תציג אירועים עד לזמן שליחת הבקשה.
כדי לציין זמן התחלה או זמן סיום, משתמשים באופרטור השוויון = ובפורמט RFC-3339. כדי לסנן לפי startTime וגם לפי endTime, משתמשים באופרטור AND.
לדוגמה, השאילתות הבאות תקינות:
startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"
startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")
השאילתות הבאות לא תקינות:
startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"
eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"
שאילתות לא חוקיות נדחות על ידי השרת עם שגיאה INVALID_ARGUMENT.
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת תגובה להצגת אירועים במרחב המשותף.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-02-27 (שעון UTC)."],[[["Lists events from a specified Google Chat space, including new members, messages, and reactions, with the payload containing the most recent version of the resource."],["Requires user authentication and membership in the space to list events, returning data chronologically with optional pagination."],["Allows filtering by event types, start time, and end time to refine the results of the listed events."],["The response includes an array of space events and a token for retrieving subsequent pages if available."],["Needs specific authorization scopes for accessing and retrieving the chat space data."]]],["This documentation outlines how to list events from a Google Chat space using the `GET` method. Key actions include: specifying the space via the `parent` path parameter, filtering events by type and time using the `filter` query parameter, and setting the number of events returned with `pageSize`. `pageToken` is used for pagination. Authentication requires user membership in the space and specific OAuth scopes. The response body includes a list of `spaceEvents` and a `nextPageToken` for further results.\n"]]
