Method: spaces.members.create

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

כדי לבחור מי יכול להוסיף, צריך להגדיר את הערך membership.member.name בשביל המשתמש או האפליקציה, או להגדיר את membership.group_member.name בשביל חבר הקבוצה.

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

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

  • כדי להוסיף או להזמין קבוצת Google למרחב משותף עם שם, צריך להשתמש ב-groups/{group}. הערך {group} הוא id של הקבוצה מה-Cloud Identity Groups API. לדוגמה, אפשר להשתמש ב-Cloud Identity Groups lookup API כדי לאחזר את המזהה 123456789 של כתובת האימייל של הקבוצה group@example.com. אחר כך אפשר להוסיף או להזמין את הקבוצה למרחב משותף עם שם על ידי הגדרת הערך groups/123456789 ב-membership.group_member.name. אי אפשר להשתמש בכתובת אימייל קבוצתית, ואפשר להוסיף קבוצות ב-Google רק כחברים במרחבים משותפים עם שם.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

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

פרמטרים
useAdminAccess

boolean

כשהערך הוא true, השיטה תפעל עם הרשאות האדמין של המשתמש ב-Google Workspace.

המשתמשים לביצוע שיחות צריכים להיות אדמינים ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים המשותפים.

נדרש היקף OAuth 2.0 chat.admin.memberships.

אי אפשר ליצור מינויים לאפליקציות או ליצור מינויים למשתמשים מחוץ לארגון של האדמין ב-Google Workspace באמצעות הרשאת אדמין.

גוף הבקשה

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

גוף התשובה

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

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

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

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

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