איך מסירים אנשים ממרחבים משותפים

במדריך הזה מוסבר איך להשתמש ב-method delete במשאב membership של Google Chat API כדי להסיר חבר ממרחב משותף, שנקרא גם מחיקת מועדון החברים. אי אפשר להסיר מנהלי המרחב המשותף רק אם הם המנהלים שלו במרחב משותף. לפני שמסירים את המרחב המשותף צריך לבחור משתמש אחר כמנהל של המרחב המשותף חברויות במועדונים של ערוצים.

משאב אחד (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 ממשתמש שיש לו הרשאה למחוק את המינוי שצוין.

איך מסירים אנשים ממרחבים משותפים

כדי להסיר משתמש, קבוצה ב-Google או אפליקציית Chat רווח:

  • כדי להסיר משתמש או קבוצה ב-Google, צריך לציין את ההרשאה 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: שם המינוי, שאפשר לקבל מהשיטה 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"
}