הפונקציה מחזירה רשימה של מרחבים משותפים בארגון ב-Google Workspace לפי החיפוש של האדמין.
נדרשת אימות משתמש עם הרשאות אדמין. בבקשה, מגדירים את useAdminAccess
כ-true
.
בקשת HTTP
GET https://chat.googleapis.com/v1/spaces:search
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
useAdminAccess |
כשהערך הוא המשתמשים לביצוע שיחות צריכים להיות אדמינים ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים המשותפים. נדרש היקף OAuth 2.0, השיטה הזו תומכת כרגע רק בהרשאת אדמין, ולכן אפשר להשתמש רק ב- |
pageSize |
המספר המקסימלי של מרחבים משותפים להחזרה. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא צויין ערך, יוחזרו 100 רווחים לכל היותר. הערך המקסימלי הוא 1,000. אם משתמשים בערך גבוה מ-1,000, הוא ישתנה באופן אוטומטי ל-1,000. |
pageToken |
טוקן, שהתקבל מהקריאה הקודמת למרחבים משותפים לחיפוש. מציינים את הפרמטר הזה כדי לאחזר את הדף הבא. כשמחלקים את הדפים, כל הפרמטרים האחרים שצוינו צריכים להתאים לקריאה שסיפקה את אסימון הדף. העברה של ערכים שונים לפרמטרים האחרים עלולה להוביל לתוצאות בלתי צפויות. |
query |
חובה. שאילתת חיפוש. אפשר לבצע חיפוש באמצעות הפרמטרים הבאים:
השדות השדה אפשר להשתמש ב-
השדה בשדות שונים, יש תמיכה רק באופרטור באותו שדה, השאילתות לדוגמה הבאות תקינות:
|
orderBy |
זה שינוי אופציונלי. סדר הרשימה של המרחבים המשותפים. המאפיינים שנתמכים לפי הסדר הם:
הערכים החוקיים של פעולת ההזמנה הם:
התחביר הנתמך הוא:
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה עם רשימה של מרחבים משותפים שתואמים לבקשה לחיפוש מרחבים משותפים.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{
"spaces": [
{
object ( |
שדות | |
---|---|
spaces[] |
דף עם המרחבים המשותפים המבוקשים. |
nextPageToken |
אסימון שאפשר להשתמש בו כדי לאחזר את הדף הבא. אם השדה הזה ריק, אין דפים נוספים. |
totalSize |
המספר הכולל של הרווחים שתואמים לשאילתה, בכל הדפים. אם התוצאה היא יותר מ-10,000 מקומות חנייה, הערך הזה הוא אומדן. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/chat.admin.spaces
https://www.googleapis.com/auth/chat.admin.spaces.readonly
מידע נוסף זמין במדריך ההרשאות.