Method: spaces.members.create

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

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

  • אימות אפליקציות עם אישור אדמין והיקף ההרשאה:

    • 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 משתמשת בתחביר של gRPC Transcoding.

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

פרמטרים
parent

string

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

פורמט: spaces/{space}

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

פרמטרים
useAdminAccess

boolean

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

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

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

אי אפשר להשתמש בגישת אדמין כדי ליצור חברות באפליקציה או ליצור חברות למשתמשים מחוץ לארגון 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

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