Method: spaces.members.create

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

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

  • אימות אפליקציה עם אישור אדמין ב-גרסת Developer Preview והיקף ההרשאה:

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

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

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (כדי להוסיף את אפליקציית השיחות למרחב המשותף)
    • https://www.googleapis.com/auth/chat.import (רווחים במצב ייבוא בלבד)
    • אימות משתמש מעניק הרשאות אדמין כשחשבון אדמין מבצע אימות, הערך של useAdminAccess הוא true ומשתמשים בהיקף ההרשאה הבא:
      • https://www.googleapis.com/auth/chat.admin.memberships

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

  • הזמנת משתמשים מחוץ לארגון ב-Workspace שאליו שייך המרחב המשותף.
  • צירוף קבוצה מ'קבוצות Google' למרחב משותף.
  • הוספת אפליקציה של Chat למרחב משותף.

דוגמאות לשימוש:

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
parent

string

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

פורמט: spaces/{space}

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

פרמטרים
useAdminAccess

boolean

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

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

נדרשת הרשאת OAuth 2.0 chat.admin.memberships.

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

  • https://www.googleapis.com/auth/chat.app.memberships
  • 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

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