זה שינוי אופציונלי. מספר המינויים המקסימלי שצריך להחזיר. השירות עשוי להחזיר פחות מהערך הזה.
אם לא צוין או מוגדר הערך 0, יוחזרו עד 50 מינויים.
הערך המקסימלי הוא 100. אם מציינים ערך של יותר מ-100, המערכת תחזיר רק 100 מינויים.
pageToken
string
זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של מינויים לרשימות. צריך לספק את הפרמטר הזה כדי לאחזר את הדף הבא.
במהלך החלוקה לדפים, ערך המסנן צריך להתאים לקריאה שסיפקה את אסימון הדף. העברת ערך אחר עלולה להוביל לתוצאות בלתי צפויות.
filter
string
חובה. מסנן שאילתות.
אפשר לסנן מינויים לפי סוג האירוע (event_types) ומשאב היעד (target_resource).
צריך לציין סוג אירוע אחד לפחות בשאילתה. כדי לסנן לפי כמה סוגי אירועים, אפשר להשתמש באופרטור OR.
כדי לסנן לפי סוג האירוע וגם לפי משאב היעד, משתמשים באופרטור AND ומציינים את השם המלא של המשאב, כמו //chat.googleapis.com/spaces/{space}.
לדוגמה, השאילתות הבאות תקינות:
event_types:"google.workspace.chat.membership.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created"
event_types:"google.workspace.chat.message.v1.created" AND
target_resource="//chat.googleapis.com/spaces/{space}"
( event_types:"google.workspace.chat.membership.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created" ) AND
target_resource="//chat.googleapis.com/spaces/{space}"
השרת דחה שאילתות לא חוקיות עם השגיאה 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"]],["עדכון אחרון: 2024-08-22 (שעון UTC)."],[[["Lists existing Google Workspace subscriptions, allowing retrieval of details like event types and target resources."],["Enables filtering of subscriptions by event types and target resource using query parameters, requiring at least one event type for filtering."],["Uses pagination to retrieve large lists of subscriptions, providing a `nextPageToken` for accessing subsequent pages."],["Requires specific OAuth scopes for authorization, such as `https://www.googleapis.com/auth/chat.bot` or `https://www.googleapis.com/auth/chat.spaces`, to access and manage subscriptions."],["Returns a response body containing a list of subscriptions and a token for pagination if further pages exist."]]],["This document outlines how to list Google Workspace subscriptions using a `GET` request to `https://workspaceevents.googleapis.com/v1/subscriptions`. Key parameters include `pageSize` (max 100) to limit results, `pageToken` for pagination, and a mandatory `filter` to specify event types and/or target resources using `OR` and `AND` operators. The request body is empty. The response body contains a list of `subscriptions` and an optional `nextPageToken` for subsequent pages. Specific OAuth scopes are required for authorization.\n"]]
