Method: spaces.create

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

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

אם הצטרפתם לתוכנית של התצוגה המקדימה למפתחים, תוכלו ליצור צ'אט קבוצתי במצב ייבוא באמצעות spaceType.GROUP_CHAT.

נדרש אימות משתמש.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
requestId

string

זה שינוי אופציונלי. מזהה ייחודי לבקשה הזו. מומלץ להשתמש במזהה ייחודי אוניברסלי (UUID) אקראי. כשמציינים מזהה בקשה קיים, המערכת מחזירה את המרחב המשותף שנוצר עם המזהה הזה במקום ליצור מרחב חדש. אם מציינים מזהה בקשה קיים מאותה אפליקציית Chat עם משתמש מאומת אחר, תוחזר הודעת שגיאה.

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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