Method: spaces.create

• בקשת HTTP
• פרמטרים של שאילתות
• גוף הבקשה
• גוף התשובה
• היקפי הרשאות
• רוצים לנסות?

יצירת מרחב משותף. אפשר להשתמש בה כדי ליצור מרחב משותף בעל שם או צ'אט קבוצתי ב-Import mode. לדוגמה, ראו יצירת מרחב משותף.

יש תמיכה בסוגי אימות הבאים:

• אימות אפליקציה עם אישור אדמין ב-גרסת Developer Preview ואחד מהיקפי ההרשאה הבאים:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces

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

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.import (רווחים במצב ייבוא בלבד)

כשמבצעים אימות כאפליקציה, צריך להגדיר את השדה space.customer בבקשה.

כשמבצעים אימות כאפליקציה, אפליקציית Chat מתווספת כחברה במרחב המשותף. עם זאת, בניגוד לאימות אנושי, אפליקציית Chat לא מתווספת כמנהלת של המרחב המשותף. כברירת מחדל, כל המשתתפים במרחב המשותף יכולים להסיר ממנו את אפליקציית Chat. כדי לאפשר רק למנהלי המרחב המשותף להסיר את האפליקציה ממנו, מגדירים את space.permission_settings.manage_apps כ-managersAllowed.

החברים במרחב המשותף בזמן היצירה שלו תלויים במקום שבו הוא נוצר ב-Import mode:

• מצב ייבוא: לא נוצרים חברים.
• כל שאר המצבים: המשתמש שיזום את השיחה יתווסף כחבר. זהו:
  • האפליקציה עצמה כשמשתמשים באימות באפליקציה.
  • המשתמש האנושי כשמשתמשים באימות משתמש.

אם מופיעה הודעת השגיאה ALREADY_EXISTS כשיוצרים מרחבים משותפים, מנסים displayName אחר. יכול להיות ששם התצוגה הזה כבר משמש מרחב משותף קיים בארגון ב-Google Workspace.

בקשת HTTP

POST https://chat.googleapis.com/v1/spaces

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

פרמטרים של שאילתה

פרמטרים
requestId	string אופציונלי. מזהה ייחודי של הבקשה הזו. מומלץ להשתמש ב-UUID אקראי. ציון מזהה בקשה קיים מחזיר את המרחב המשותף שנוצר באמצעות המזהה הזה במקום ליצור מרחב משותף חדש. אם מציינים מזהה בקשה קיים מאותה אפליקציית Chat עם משתמש מאומת אחר, מתקבלת הודעת שגיאה.

גוף הבקשה

גוף הבקשה מכיל מופע של Space.

גוף התשובה

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

היקפי הרשאה

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

• https://www.googleapis.com/auth/chat.app.spaces.create
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.spaces
• https://www.googleapis.com/auth/chat.spaces.create

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