Method: spaces.members.delete

מחיקה של מינוי. לדוגמה, הסרת משתמש או אפליקציית 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

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

  • הסרת קבוצת Google ממרחבים משותפים.
  • הסרת אפליקציית Chat ממרחב משותף.

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

בקשת HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}

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

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

פרמטרים
name

string

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

כדי למחוק מינוי של משתמש, צריך את ההיקף chat.memberships עם אימות משתמש או את ההיקף chat.memberships.app עם אימות אפליקציה בפורמט spaces/{space}/members/{member}. אפשר להשתמש בכתובת האימייל ככתובת חלופית ל-{member}. לדוגמה, spaces/{space}/members/[email protected], כאשר [email protected] היא כתובת האימייל של המשתמש ב-Google Chat.

כדי למחוק חברות באפליקציה, צריך את ההיקף chat.memberships.app והפורמט spaces/{space}/members/app.

פורמט: spaces/{space}/members/{member} או spaces/{space}/members/app.

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

פרמטרים
useAdminAccess

boolean

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

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

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

לא ניתן למחוק את החברויות באפליקציות במרחב משותף באמצעות הרשאת אדמין.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של 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

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