יצירת מינוי אנושי או מינוי לאפליקציה לשיחות. אי אפשר ליצור מינויים לאפליקציות אחרות. לדוגמה, תוכלו להיעזר במאמר הזמנה או הוספה של משתמשים או אפליקציות ב-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 |
חובה. שם המשאב של המרחב המשותף שעבורו רוצים ליצור את החברות. פורמט: רווחים/{space} |
פרמטרים של שאילתה
פרמטרים | |
---|---|
useAdminAccess |
true , השיטה תפעל עם הרשאות האדמין של המשתמש ב-Google Workspace.המשתמשים לביצוע שיחות צריכים להיות אדמינים ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים המשותפים. נדרש היקף OAuth 2.0 אי אפשר ליצור מינויים לאפליקציות או ליצור מינויים למשתמשים מחוץ לארגון של האדמין ב-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
מידע נוסף זמין במדריך להרשאות.