איך מסירים משתמשים או אפליקציות של Google Chat ממרחבים משותפים

במדריך הזה מוסבר איך משתמשים בשיטה 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

  1. בספריית העבודה, יוצרים קובץ בשם chat_membership_delete.py.

  2. יש לכלול את הקוד הבא ב-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()

  3. בקוד, מחליפים את מה שכתוב בשדות הבאים:

    • SPACE: שם למרחב המשותף, שאותו אפשר לקבל מה-method spaces.list ב-Chat API או מכתובת ה-URL של המרחב המשותף.

    • MEMBER: שם המינוי, שאותו אפשר לקבל דרך ה-method spaces.members.list ב-Chat API. כדי למחוק מינוי של אפליקציה, צריך להחליף את MEMBER ב-app.

  4. בספריית העבודה, יוצרים ומריצים את הדוגמה:

    python3 chat_membership_delete.py

אם הפעולה בוצעה בהצלחה, גוף התשובה יחזיר את החברות עם 'state': 'NOT_A_MEMBER', ויצוין בו שהחבר לא נמצא יותר במרחב המשותף.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}