یک کاربر یا یک برنامه چت Google را از یک فضا حذف کنید

این راهنما نحوه استفاده از روش delete در منبع membership Google Chat API برای حذف کاربر یا برنامه چت از فضایی که به عنوان حذف عضویت نیز شناخته می‌شود، توضیح می‌دهد. اگر مدیران فضا تنها مدیر فضا در یک فضا باشند، نمی‌توان آنها را حذف کرد. قبل از حذف این عضویت ها، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

منبع Membership نشان می‌دهد که آیا کاربر انسانی یا برنامه چت Google به یک فضا دعوت شده، بخشی از آن یا غایب است.

پیش نیازها

پایتون

  • پایتون 3.6 یا بالاتر
  • ابزار مدیریت بسته پیپ

  • جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.

  • مجوز برای برنامه چت پیکربندی شد. حذف عضویت نیازمند تأیید اعتبار کاربر با محدوده مجوز chat.memberships یا chat.memberships.app از سوی کاربری است که اجازه حذف عضویت مشخص شده را دارد.

یک کاربر یا یک برنامه چت را از یک فضا حذف کنید

برای حذف یک کاربر یا یک برنامه چت از یک فضا:

  • برای حذف یک کاربر، محدوده مجوز chat.memberships را مشخص کنید. برای حذف یک برنامه چت، محدوده مجوز chat.memberships.app را مشخص کنید (برنامه ها فقط می توانند عضویت خود را حذف کنند، نه عضویت سایر برنامه ها). به عنوان بهترین روش، محدودترین محدوده را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می دهد.
  • روش delete را در منبع membership فراخوانی کنید.
  • name عضویت را برای حذف ارسال کنید. اگر عضویت به تنها مدیر فضای یک فضا تعلق دارد، قبل از حذف این عضویت، کاربر دیگری را به عنوان مدیر فضا تعیین کنید.

در اینجا نحوه حذف عضویت آمده است:

پایتون

  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 : نام فضایی است که می توانید از روش 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"
}