Xem thông tin chi tiết về gói thành viên của người dùng hoặc ứng dụng Google Chat

Hướng dẫn này giải thích cách sử dụng phương thức get trên tài nguyên membership của API Google Chat để biết thông tin chi tiết về gói thành viên của người dùng hoặc ứng dụng Chat trong một không gian.

Tài nguyên Membership cho biết người dùng thực hoặc ứng dụng Google Chat được mời tham gia, tham gia hay không tham gia không gian.

Việc xác thực bằng xác thực ứng dụng cho phép một ứng dụng Chat nhận gói thành viên từ các không gian mà ứng dụng đó có quyền truy cập trong Google Chat (ví dụ: các không gian mà ứng dụng là thành viên), nhưng không bao gồm gói thành viên của ứng dụng Chat, bao gồm cả thành viên của ứng dụng đó. Việc xác thực bằng xác thực người dùng sẽ trả về tư cách thành viên từ các không gian mà người dùng đã xác thực có quyền truy cập.

Điều kiện tiên quyết

Python

  • Python 3.6 trở lên
  • Công cụ quản lý gói pip

  • Các thư viện ứng dụng mới nhất của Google dành cho Python. Để cài đặt hoặc cập nhật các công cụ này, hãy chạy lệnh sau trong giao diện dòng lệnh của bạn:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Một dự án trên Google Cloud đã bật và thiết lập API Google Chat. Để biết các bước, hãy xem bài viết Tạo ứng dụng Google Chat.

  • Đã định cấu hình hoạt động uỷ quyền cho ứng dụng Chat. Khi có gói thành viên, bạn hỗ trợ cả hai phương thức xác thực sau:

Xem thông tin chi tiết về gói thành viên của người dùng hoặc gói thành viên của ứng dụng Chat

Để biết thông tin chi tiết về một gói thành viên trong Google Chat, hãy chuyển những thông tin sau vào yêu cầu của bạn:

  • Với tính năng xác thực ứng dụng, hãy chỉ định phạm vi uỷ quyền chat.bot. Với quy trình xác thực người dùng, hãy chỉ định phạm vi uỷ quyền chat.memberships.readonly hoặc chat.memberships. Cách tốt nhất là chọn phạm vi hạn chế nhất mà vẫn cho phép ứng dụng của bạn hoạt động.
  • Gọi phương thức get trên tài nguyên membership.
  • Chuyển gói thành viên name để có được. Lấy tên thành viên từ tài nguyên thành viên của Google Chat.

Sau đây là cách đăng ký gói thành viên bằng phương thức xác thực người dùng:

Python

  1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_membership_get.py.

  2. Đưa mã sau vào chat_membership_get.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.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets details about a 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().get(

        # The membership to get.
        #
        # 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.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

  3. Trong mã, hãy thay thế các đoạn mã sau:

  4. Trong thư mục đang làm việc, hãy tạo và chạy mẫu:

    python3 chat_membership_get.py

API Chat trả về một thực thể của membership nêu chi tiết thành viên đã chỉ định.