Method: spaces.members.create

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

כדי לציין חבר להוספה, מגדירים את membership.member.name בCreateMembershipRequest:

  • כדי להוסיף את אפליקציית השיחות למרחב משותף או לצ'אט אישי בין שני משתמשים, צריך להשתמש בפונקציה users/app. אי אפשר לצרף למרחב המשותף אפליקציות אחרות.

  • כדי להוסיף משתמש אנושי, צריך להשתמש ב-users/{user}. הכתובת {user} יכולה לשמש ככתובת האימייל של המשתמש. עבור משתמשים באותו ארגון Workspace, {user} יכול להיות גם id עבור המשתמש מ-People API, או id של המשתמש ב-Directory API. לדוגמה, אם מזהה פרופיל האנשים של user@example.com ב-People API הוא 123456789, אפשר להוסיף את המשתמש למרחב המשותף על ידי הגדרת הערך של membership.member.name בתור users/user@example.com או users/123456789.

בקשת HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

פרמטרים של נתיב

פרמטרים
parent

string

חובה. שם המשאב של המרחב המשותף שבו רוצים ליצור את החברות.

פורמט: רווחים/{space}

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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