Tài nguyên: Gói thuê bao
Gói thuê bao để nhận các sự kiện về tài nguyên trên Google Workspace. Để tìm hiểu thêm về gói thuê bao, hãy xem bài viết Tổng quan về API Sự kiện của Google Workspace.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "uid": string, "targetResource": string, "eventTypes": [ string ], "payloadOptions": { object ( |
Trường | |
---|---|
name |
Không bắt buộc. Không thể thay đổi. Giá trị nhận dạng. Tên tài nguyên của gói thuê bao. Định dạng |
uid |
Chỉ có đầu ra. Giá trị nhận dạng duy nhất do hệ thống chỉ định cho gói thuê bao. |
targetResource |
Bắt buộc. Không thể thay đổi. Tài nguyên Google Workspace được theo dõi cho các sự kiện, có định dạng là tên tài nguyên đầy đủ. Để tìm hiểu về tài nguyên mục tiêu và các sự kiện được hỗ trợ, hãy xem bài viết Các sự kiện Google Workspace được hỗ trợ. Người dùng chỉ có thể cho phép ứng dụng của bạn tạo một gói thuê bao cho một tài nguyên đích nhất định. Nếu ứng dụng của bạn cố gắng tạo một gói thuê bao khác có cùng thông tin đăng nhập của người dùng, thì yêu cầu sẽ trả về lỗi |
eventTypes[] |
Bắt buộc. Không thể thay đổi. Danh sách không theo thứ tự. Dữ liệu đầu vào để tạo gói thuê bao. Nếu không, bạn sẽ chỉ nhận được kết quả đầu ra. Một hoặc nhiều loại sự kiện cần nhận về tài nguyên đích. Được định dạng theo thông số kỹ thuật của CloudEvents. Các loại sự kiện được hỗ trợ sẽ phụ thuộc vào tài nguyên mục tiêu của gói thuê bao. Để biết thông tin chi tiết, hãy xem bài viết Các sự kiện Google Workspace được hỗ trợ. Theo mặc định, bạn cũng nhận được các sự kiện về vòng đời của gói thuê bao. Bạn không cần chỉ định các sự kiện trong vòng đời cho trường này. Nếu bạn chỉ định một loại sự kiện không tồn tại cho tài nguyên đích, thì yêu cầu sẽ trả về mã trạng thái HTTP |
payloadOptions |
Không bắt buộc. Các lựa chọn về dữ liệu cần đưa vào tải trọng sự kiện. Chỉ hỗ trợ cho các sự kiện trong Google Chat. |
notificationEndpoint |
Bắt buộc. Không thể thay đổi. Điểm cuối nơi gói thuê bao phân phối sự kiện, chẳng hạn như một chủ đề Pub/Sub. |
state |
Chỉ có đầu ra. Trạng thái của gói thuê bao. Xác định xem gói thuê bao có thể nhận sự kiện và gửi sự kiện đến điểm cuối thông báo hay không. |
suspensionReason |
Chỉ có đầu ra. Lỗi khiến gói thuê bao bị tạm ngưng. Để kích hoạt lại gói thuê bao, hãy khắc phục lỗi rồi gọi phương thức |
authority |
Chỉ có đầu ra. Người dùng đã cho phép tạo gói thuê bao. Định dạng Đối với người dùng Google Workspace, giá trị |
createTime |
Chỉ có đầu ra. Thời điểm tạo gói thuê bao. |
updateTime |
Chỉ có đầu ra. Lần gần đây nhất mà gói thuê bao được cập nhật. |
reconciling |
Chỉ có đầu ra. Nếu giá trị là |
etag |
Không bắt buộc. Giá trị tổng kiểm này được máy chủ tính toán dựa trên giá trị của các trường khác và có thể được gửi đi khi có yêu cầu cập nhật để đảm bảo máy khách có giá trị mới nhất trước khi tiếp tục. |
Trường hợp Thời gian hết hạn tối đa phụ thuộc vào việc gói thuê bao của bạn có chứa dữ liệu tài nguyên trong các tải trọng sự kiện hay không (được chỉ định trong trường
Sau khi gói thuê bao hết hạn, gói thuê bao đó sẽ tự động bị xoá. Bạn sẽ nhận được các sự kiện trong vòng đời đến Để gói thuê bao không hết hạn, bạn có thể sử dụng phương thức |
|
expireTime |
Giá trị mặc định không để trống. Dấu thời gian theo giờ UTC khi gói thuê bao hết hạn. Luôn hiển thị trên đầu ra, bất kể nội dung nào được sử dụng trên đầu vào. |
ttl |
Chỉ nhập. Thời gian tồn tại (TTL) hay thời hạn của gói thuê bao. Nếu không chỉ định hoặc đặt thành |
PayloadOptions
Các lựa chọn về dữ liệu cần đưa vào tải trọng sự kiện. Chỉ hỗ trợ cho các sự kiện trong Google Chat.
Biểu diễn dưới dạng JSON |
---|
{ "includeResource": boolean, "fieldMask": string } |
Trường | |
---|---|
includeResource |
Không bắt buộc. Liệu tải trọng sự kiện có bao gồm dữ liệu về tài nguyên đã thay đổi hay không. Ví dụ: đối với một sự kiện được tạo tin nhắn Google Chat, liệu phần tải dữ liệu có chứa dữ liệu về tài nguyên |
fieldMask |
Không bắt buộc. Nếu bạn đặt Nếu bạn chỉ định một trường không tồn tại cho tài nguyên, hệ thống sẽ bỏ qua trường này. |
NotificationEndpoint
Điểm cuối nơi gói thuê bao phân phối sự kiện.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp
|
|
pubsubTopic |
Không thể thay đổi. Chủ đề Cloud Pub/Sub nhận sự kiện cho gói thuê bao. Định dạng Bạn phải tạo chủ đề trong chính dự án Google Cloud mà bạn tạo gói thuê bao này. Khi chủ đề nhận được sự kiện, các sự kiện sẽ được mã hoá dưới dạng thông báo Cloud Pub/Sub. Để biết thông tin chi tiết, hãy xem bài viết Liên kết giao thức Google Cloud Pub/Sub cho CloudEvents. |
Tiểu bang
Các trạng thái có thể có của gói thuê bao.
Enum | |
---|---|
STATE_UNSPECIFIED |
Giá trị mặc định. Giá trị này không được sử dụng. |
ACTIVE |
Gói thuê bao đang hoạt động và có thể nhận cũng như gửi sự kiện đến điểm cuối thông báo của gói thuê bao đó. |
SUSPENDED |
Gói thuê bao này không thể nhận sự kiện do có lỗi. Để xác định lỗi, hãy xem trường . |
DELETED |
Gói thuê bao này đã bị xoá. |
ErrorType
Các lỗi có thể xảy ra với gói thuê bao.
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Giá trị mặc định. Giá trị này không được sử dụng. |
USER_SCOPE_REVOKED |
Người dùng uỷ quyền đã thu hồi quyền được cấp một hoặc nhiều phạm vi OAuth. Để tìm hiểu thêm về việc uỷ quyền cho Google Workspace, hãy xem bài viết Định cấu hình màn hình xin phép bằng OAuth. |
RESOURCE_DELETED |
Tài nguyên đích cho gói thuê bao không còn tồn tại. |
USER_AUTHORIZATION_FAILURE |
Người dùng đã cho phép tạo gói thuê bao sẽ không còn quyền truy cập vào tài nguyên đích của gói thuê bao đó. |
ENDPOINT_PERMISSION_DENIED |
Ứng dụng Google Workspace không có quyền truy cập để gửi sự kiện đến điểm cuối thông báo của gói thuê bao của bạn. |
ENDPOINT_NOT_FOUND |
Không tồn tại điểm cuối thông báo của gói thuê bao hoặc không tìm thấy điểm cuối trong dự án Google Cloud nơi bạn tạo gói thuê bao. |
ENDPOINT_RESOURCE_EXHAUSTED |
Điểm cuối thông báo của gói thuê bao không nhận được sự kiện do không đủ hạn mức hoặc đã đạt đến giới hạn số lượng yêu cầu. |
OTHER |
Đã xảy ra lỗi không xác định. |
Phương thức |
|
---|---|
|
Tạo gói thuê bao Google Workspace. |
|
Xoá một gói thuê bao của Google Workspace. |
|
Xem thông tin chi tiết về một gói thuê bao của Google Workspace. |
|
Liệt kê các gói thuê bao của Google Workspace. |
|
Cập nhật hoặc gia hạn gói thuê bao của Google Workspace. |
|
Kích hoạt lại gói thuê bao bị tạm ngưng của Google Workspace. |