Menghapus pengguna atau aplikasi Google Chat dari ruang

Panduan ini menjelaskan cara menggunakan metode delete pada resource membership di Google Chat API untuk menghapus pengguna atau aplikasi Chat dari ruang yang juga disebut sebagai penghapusan keanggotaan. Pengelola ruang tidak dapat dihapus jika dia adalah satu-satunya pengelola ruang di ruang. Tetapkan pengguna lain sebagai pengelola ruang sebelum menghapus keanggotaan ini.

Resource Membership menunjukkan apakah pengguna manusia atau aplikasi Google Chat diundang ke, sebagian, atau ketidakhadiran dari ruang.

Prasyarat

Python

  • Python 3.6 atau yang lebih baru
  • Alat pengelolaan paket pip

  • Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line Anda:

    pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client

  • Aplikasi Chat yang dipublikasikan. Untuk membuat dan memublikasikan aplikasi Chat, lihat Mem-build aplikasi Google Chat.

  • Otorisasi dikonfigurasi untuk aplikasi Chat. Penghapusan keanggotaan memerlukan Autentikasi pengguna dengan cakupan otorisasi chat.memberships atau chat.memberships.app dari pengguna yang memiliki izin untuk menghapus keanggotaan yang ditentukan.

Menghapus pengguna atau aplikasi Chat dari ruang

Untuk menghapus pengguna atau aplikasi Chat dari ruang:

  • Untuk menghapus pengguna, tentukan cakupan otorisasi chat.memberships. Untuk menghapus aplikasi Chat, tentukan cakupan otorisasi chat.memberships.app (aplikasi hanya dapat menghapus keanggotaannya sendiri, bukan keanggotaan aplikasi lain). Sebagai praktik terbaik, pilih cakupan yang paling terbatas yang masih memungkinkan aplikasi Anda berfungsi.
  • Panggil metode delete di resource membership.
  • Teruskan name langganan untuk dihapus. Jika keanggotaan merupakan satu-satunya pengelola ruang dalam ruang, tetapkan pengguna lain sebagai pengelola ruang sebelum menghapus keanggotaan ini.

Berikut cara menghapus keanggotaan:

Python

  1. Di direktori kerja, buat file bernama chat_membership_delete.py.

  2. Sertakan kode berikut di chat_membership_delete.py:

    import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 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. Dalam kode, ganti kode berikut:

    • SPACE: nama ruang, yang dapat Anda peroleh dari metode spaces.list di Chat API, atau dari URL ruang.

    • MEMBER: nama langganan, yang dapat Anda peroleh dari metode spaces.members.list di Chat API. Untuk menghapus langganan aplikasi, ganti MEMBER dengan app.

  4. Di direktori kerja Anda, build dan jalankan contoh:

    python3 chat_membership_delete.py

Jika berhasil, isi respons akan menampilkan keanggotaan dengan 'state': 'NOT_A_MEMBER', yang menunjukkan bahwa anggota tersebut tidak lagi ada dalam ruang.

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