במדריך הזה מוסבר איך משתמשים בשיטה delete
במשאב membership
ב-Google Chat API כדי להסיר משתמשים או אפליקציות של Chat ממרחבים משותפים, שנקראים גם מחיקת מינויים. אי אפשר להסיר את המנהלים של המרחב המשותף אם הם היחידים שמנהלים אותו. לפני שמסירים את המרחב המשותף, צריך להקצות משתמש אחר כמנהל שלו.
המשאב Membership
מייצג אם משתמש אנושי או אפליקציית Google Chat הוזמנו למרחב משותף, אם הוא חלק ממנו או נעדר ממנו.
דרישות מוקדמות
Python
- Python 3.6 ואילך
- הכלי pip לניהול חבילות
ספריות הלקוח העדכניות של Google ל-Python. כדי להתקין או לעדכן אותן, מריצים את הפקודה הבאה בממשק שורת הפקודה:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- פרויקט ב-Google Cloud עם ממשק Google Chat API פעיל ומוגדר. במאמר איך יוצרים אפליקציה ל-Google Chat מוסבר איך עושים זאת.
הוגדרה הרשאה לאפליקציית Chat. כדי למחוק מינוי צריך אימות משתמש בהיקף ההרשאות של
chat.memberships
אוchat.memberships.app
, ממשתמש שיש לו הרשאה למחוק את המינוי שצוין.
איך מסירים משתמשים או אפליקציות ל-Chat ממרחבים משותפים
כדי להסיר משתמשים או אפליקציות מ-Chat ממרחב משותף:
- כדי להסיר משתמש, מציינים את היקף ההרשאות
chat.memberships
. כדי להסיר אפליקציות של Chat, צריך לציין את היקף ההרשאהchat.memberships.app
(לאפליקציות יש הרשאה למחוק רק את המינוי שלהן, ולא את המינוי של אפליקציות אחרות). מומלץ לבחור את ההיקף המגביל ביותר שעדיין מאפשר לאפליקציה לפעול. - קוראים ל-method
delete
במשאבmembership
. - כדי למחוק, מעבירים את
name
של המינוי. אם המינוי שייך למנהל היחיד של המרחב המשותף, צריך להקצות משתמש אחר כמנהל שלו לפני שתמחקו את החברות הזו.
כדי למחוק מינוי:
Python
- בספריית העבודה, יוצרים קובץ בשם
chat_membership_delete.py
. יש לכלול את הקוד הבא ב-
chat_membership_delete.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the specified membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().delete( # The membership to delete. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. print(result) if __name__ == '__main__': main()
בקוד, מחליפים את מה שכתוב בשדות הבאים:
SPACE
: שם למרחב המשותף, שאותו אפשר לקבל מה-methodspaces.list
ב-Chat API או מכתובת ה-URL של המרחב המשותף.MEMBER
: שם המינוי, שאותו אפשר לקבל דרך ה-methodspaces.members.list
ב-Chat API. כדי למחוק מינוי של אפליקציה, צריך להחליף אתMEMBER
ב-app
.
בספריית העבודה, יוצרים ומריצים את הדוגמה:
python3 chat_membership_delete.py
אם הפעולה בוצעה בהצלחה, גוף התשובה יחזיר את החברות עם 'state': 'NOT_A_MEMBER'
, ויצוין בו שהחבר לא נמצא יותר במרחב המשותף.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
נושאים קשורים
- איך מקבלים פרטים על מינויים של משתמש או של אפליקציית Chat.
- איך רואים את רשימת המשתתפים במרחבים משותפים
- איך מעדכנים את המינוי של משתמש במרחבים משותפים ב-Google Chat.
- איך מזמינים או מוסיפים משתמשים או אפליקציות ל-Chat למרחבים משותפים