Cấu hình tài nguyên dùng để xác định nội dung và hành vi của Tiện ích Google Workspace trong trình chỉnh sửa. Tệp kê khai tiện ích bổ sung của Google Workspace phải có tất cả thành phần được đánh dấu là Bắt buộc nếu các thành phần đó mở rộng Trình chỉnh sửa.
Trình chỉnh sửa
Cấu hình tệp kê khai Tiện ích bổ sung của Google Workspace cho các tiện ích Trình chỉnh sửa. Hãy xem bài viết Mở rộng trình chỉnh sửa bằng tiện ích bổ sung của Google Workspace để biết thêm thông tin.
| Biểu diễn dưới dạng JSON |
|---|
{
"homepageTrigger": {
object (HomepageTrigger)
},
"onFileScopeGrantedTrigger": {
object (OnFileScopeGrantedTrigger)
},
"linkPreviewTriggers": [
{
object (LinkPreviewTriggers)
}
],
"createActionTriggers": [
{
object (CreateActionTriggers)
}
} |
| Trường | |
|---|---|
homepageTrigger |
Hàm kích hoạt này tạo trang chủ bổ sung trong ứng dụng lưu trữ. Thao tác này sẽ ghi đè
|
onFileScopeGrantedTrigger |
Bắt buộc nếu tiện ích bổ sung của bạn bao gồm hành vi dành riêng cho tài liệu Editor hiện tại, được kích hoạt khi người dùng cho phép phạm vi |
linkPreviewTriggers[] |
Bắt buộc đối với bản xem trước đường liên kết. Danh sách điều kiện kích hoạt để xem trước đường liên kết trong tệp Google Tài liệu, Trang tính hoặc Trang trình bày. Để biết thông tin chi tiết, hãy xem bài viết Xem trước đường liên kết bằng khối thông minh. |
createActionTriggers[] |
Bắt buộc để tạo tài nguyên bên thứ ba. Danh sách điều kiện kích hoạt để tạo tài nguyên trong dịch vụ của bên thứ ba từ trình đơn @. Để biết thông tin chi tiết, hãy xem bài viết Tạo tài nguyên bên thứ ba bằng khối thông minh. |
OnFileScopeGrantedTrigger
Cấu hình cho trình kích hoạt theo ngữ cảnh sẽ kích hoạt khi hộp thoại yêu cầu phạm vi tệp sử dụng CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build(); và người dùng cấp quyền truy cập phạm vi drive.file.
| Biểu diễn dưới dạng JSON |
|---|
{
"runFunction": string
} |
| Trường | |
|---|---|
runFunction |
drive.file được cấp. Nếu được chỉ định, bạn phải triển khai hàm này để tạo và trả về một mảng các đối tượng
Card để hiển thị trong giao diện người dùng của tiện ích bổ sung.
|
LinkPreviewTriggers
Cấu hình cho một điều kiện kích hoạt sẽ kích hoạt khi người dùng nhập hoặc dán một đường liên kết từ một dịch vụ bên thứ ba hoặc không phải của Google vào tệp Tài liệu, Trang tính hoặc Trang trình bày.
Để thiết lập điều kiện kích hoạt này cho một Tiện ích bổ sung của Google Workspace, hãy xem bài viết Xem trước đường liên kết bằng khối thông minh.
| Biểu diễn dưới dạng JSON |
|---|
{
"labelText": string,
"localizedLabelText": {
string: string,
...
},
"runFunction": string,
"logoUrl": string,
"patterns": [
{
object(patterns)
}
]
} |
| Trường | |
|---|---|
labelText |
Example: Support case. Văn bản này là văn bản tĩnh và hiển thị trước khi người dùng thực thi tiện ích bổ sung.
|
localizedLabelText |
labelText để bản địa hoá sang các ngôn ngữ khác. Định dạng ngôn ngữ theo ISO 639 và quốc gia/khu vực theo ISO 3166, phân tách bằng dấu gạch nối -. Ví dụ: en-US
Nếu ngôn ngữ của người dùng có trong các khoá của bản đồ, thì người dùng sẽ thấy phiên bản đã bản địa hoá của |
patterns[] |
|
runFunction |
https://www.googleapis.com/auth/workspace.linkpreview.
Nếu được chỉ định, bạn phải triển khai hàm này để chấp nhận đối tượng sự kiện chứa EDITOR_NAME.matchedUrl.url làm đối số và trả về một đối tượng
Card hiển thị bản xem trước đường liên kết trong giao diện người dùng của tiện ích bổ sung.
|
logoUrl |
logoUrl.
|
UriPattern
Cấu hình cho từng mẫu URL kích hoạt bản xem trước đường liên kết.
| Biểu diễn dưới dạng JSON |
|---|
{
"hostPattern": string,
"pathPrefix" : string
} |
| Trường | |
|---|---|
hostPattern |
subdomain.example.com, hãy thêm miền con đó.
Để xem trước đường liên kết cho toàn bộ miền, hãy chỉ định một ký tự đại diện có dấu hoa thị (*) làm miền con.
Ví dụ: |
pathPrefix |
hostPattern.
Ví dụ: nếu mẫu máy chủ lưu trữ URL là Để so khớp tất cả URL trong miền mẫu máy chủ, hãy để trống |
CreateActionTriggers
Cấu hình cho một điều kiện kích hoạt sẽ kích hoạt khi người dùng chọn một mục trình đơn tích hợp của bên thứ ba trong trình đơn @ Google Docs.
Để thiết lập điều kiện kích hoạt này cho một Tiện ích bổ sung của Google Workspace, hãy xem phần Tạo tài nguyên của bên thứ ba bằng khối thông minh.
| Biểu diễn dưới dạng JSON |
|---|
{
"id": string,
"labelText": string,
"localizedLabelText": {
string: string,
...
},
"runFunction": string,
"logoUrl": string,
} |
| Trường | |
|---|---|
id |
[a-zA-Z0-9-]+..
|
labelText |
Create support case.
|
localizedLabelText |
labelText để bản địa hoá sang các ngôn ngữ khác. Định dạng ngôn ngữ theo ISO 639 và quốc gia/khu vực theo ISO 3166, phân tách bằng dấu gạch nối -. Ví dụ: en-US
Nếu ngôn ngữ của người dùng có trong các khoá của bản đồ, thì người dùng sẽ thấy phiên bản đã bản địa hoá của |
runFunction |
|
logoUrl |
logoUrl.
|