Method: spaces.create

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

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

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

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

  • 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 משתמשת בתחביר של gRPC Transcoding.

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

פרמטרים
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

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