Method: spaces.create

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

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

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

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

• אימות משתמשים

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

החברים במרחב המשותף בזמן היצירה שלו תלויים במקום שבו הוא נוצר ב-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

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