Tìm hiểu thông tin chi tiết về gói thuê bao của Google Workspace

Trang này giải thích cách xem thông tin chi tiết về một gói thuê bao của Google Workspace bằng phương thức subscriptions.get().

Khi bạn gọi phương thức này qua phương thức xác thực người dùng, phương thức này sẽ trả về thông tin chi tiết về gói thuê bao được người dùng cho phép. Khi bạn sử dụng phương thức xác thực ứng dụng, phương thức này có thể trả về thông tin chi tiết về mọi gói thuê bao cho ứng dụng.

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

Apps Script

  • Một dự án Apps Script:
    • Sử dụng dự án của bạn trên Google Cloud thay vì dự án mặc định do Apps Script tạo tự động.
    • Đối với mọi phạm vi mà bạn đã thêm để định cấu hình màn hình xin phép bằng OAuth, bạn cũng phải thêm các phạm vi đó vào tệp appsscript.json trong dự án Apps Script. Ví dụ: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages.readonly"
]
    • Bật dịch vụ nâng cao của Google Workspace Events.

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

  • Gói thuê bao của Google Workspace. Để tạo gói thuê bao, hãy xem phần Tạo gói thuê bao.

  • Yêu cầu xác thực:

    • Để xác thực người dùng, bạn cần có một phạm vi hỗ trợ ít nhất một trong các loại sự kiện cho gói thuê bao. Để xác định phạm vi, hãy xem bài viết Phạm vi theo loại sự kiện.
    • Để xác thực ứng dụng, bạn phải có phạm vi chat.bot (chỉ dành cho các ứng dụng Google Chat).

Mua gói thuê bao được người dùng cho phép

Mã mẫu sau đây cung cấp thông tin chi tiết về một tài nguyên Subscription bằng cách sử dụng phương thức xác thực người dùng. Khi được xác thực là người dùng, phương thức này sẽ trả về một gói thuê bao mà người dùng đã cho phép ứng dụng tạo.

Cách nhận gói thuê bao được người dùng uỷ quyền:

Apps Script

  1. Trong dự án Apps Script, hãy tạo một tệp tập lệnh mới có tên là getSubscription rồi thêm mã sau:

    function getSubscription() {
  // The name of the subscription to get.
  const name = 'subscriptions/SUBSCRIPTION_ID';

  // Call the Workspace Events API using the advanced service.
  const subscription = WorkspaceEvents.Subscriptions.get(name);
  console.log(subscription);
}

    Thay thế các đoạn mã sau:

    • SUBSCRIPTION_ID: Mã của gói thuê bao. Để lấy mã nhận dạng, bạn có thể dùng bất kỳ cách nào sau đây:
      • Giá trị của trường uid.
      • Mã nhận dạng tên tài nguyên được thể hiện trong trường name. Ví dụ: nếu tên tài nguyên là subscriptions/subscription-123, hãy sử dụng subscription-123.

  2. Để nhận gói thuê bao, hãy chạy hàm getSubscription trong dự án Apps Script.

Python

  1. Trong thư mục đang làm việc, hãy tạo một tệp có tên get_subscription.py rồi thêm mã sau:

    """Get subscription."""

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = ['SCOPE']

# Authenticate with Google Workspace and get user authentication.
flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
CREDENTIALS = flow.run_local_server()

# Call the Workspace Events API using the service endpoint.
service = build(
    'workspaceevents',
    'v1',
    credentials=CREDENTIALS,
)

NAME = 'subscriptions/SUBSCRIPTION_ID'
subscription = service.subscriptions().get(name=NAME).execute()
print(subscription)

    Thay thế các đoạn mã sau:

    • SCOPE: Phạm vi OAuth hỗ trợ ít nhất một loại sự kiện trong gói thuê bao. Ví dụ: nếu gói thuê bao của bạn nhận được các sự kiện trong một phòng Chat đã cập nhật, https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: Mã của gói thuê bao. Để lấy mã nhận dạng, bạn có thể dùng bất kỳ cách nào sau đây:
      • Giá trị của trường uid.
      • Mã nhận dạng tên tài nguyên được thể hiện trong trường name. Ví dụ: nếu tên tài nguyên là subscriptions/subscription-123, hãy sử dụng subscription-123.

  2. Trong thư mục đang làm việc, hãy đảm bảo rằng bạn đã lưu trữ thông tin đăng nhập của mã ứng dụng khách OAuth và đặt tên cho tệp là client_secrets.json. Mã mẫu sẽ sử dụng tệp JSON này để xác thực với Google Workspace và lấy thông tin đăng nhập của người dùng. Để biết hướng dẫn, hãy xem bài viết Tạo thông tin đăng nhập mã ứng dụng khách OAuth.

  3. Để nhận gói thuê bao, hãy chạy lệnh sau trong thiết bị đầu cuối của bạn:

    python3 get_subscription.py