Cấu hình tài nguyên dùng để xác định Tiện ích bổ sung của Google Workspace nội dung và hành vi của người 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 chúng 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 Tiện ích trình chỉnh sửa. Xem 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 tiện ích bổ sung
homepage trong
ứng dụng lưu trữ nội dung. Thao tác ghi đè này
|
onFileScopeGrantedTrigger |
Bắt buộc nếu tiện ích bổ sung của bạn có hành vi cụ thể cho
Tài liệu trình chỉnh sửa, đượ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 trình kích hoạt cho xem trước cá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 khi 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ụ bên thứ ba trên trình đơn @. Để biết thông tin chi tiết, hãy xem phần Tạo tài nguyên bên thứ ba bằng khối thông minh. |
OnFileScopeGrantedTrigger
Cấu hình cho điều kiện 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 bằng CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build(); và người dùng cấp drive.file
uỷ quyền phạm vi.
| Biểu diễn dưới dạng JSON |
|---|
{
"runFunction": string
} |
| Trường | |
|---|---|
runFunction |
drive.file là
đã đượ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 tiện ích bổ sung.
|
LinkPreviewTriggers
Cấu hình của 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 đường liên kết từ dịch vụ của bên thứ ba hoặc dịch vụ không phải của Google vào Tài liệu, Trang tính hoặc Trang trình bày.
Cách thiết lập điều kiện kích hoạt này cho tiện ích bổ sung của Google Workspace: xem 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 ở dạng 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ữ
trong ISO 639 và quốc gia/khu vực ở
ISO 3166,
được 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 đồ, người dùng sẽ thấy
phiên bản được 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 một đối tượng sự kiện chứa EDITOR_NAME.matchedUrl.url làm đối số và trả về một
Card cho thấy bản xem trước đường liên kết trong giao diện người dùng tiện ích bổ sung.
|
logoUrl |
logoUrl.
|
UriPattern
Cấu hình cho mỗi 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 của 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à Để khớp tất cả URL trong miền mẫu máy chủ lưu trữ, 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 bên thứ ba mục trình đơn tích hợp từ trình đơn @ của Google Tài liệu.
Cách thiết lập điều kiện kích hoạt này cho tiện ích bổ sung của Google Workspace: xem Tạo tài nguyên 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ữ
trong ISO 639 và quốc gia/khu vực ở
ISO 3166,
được 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 đồ, người dùng sẽ thấy
phiên bản được bản địa hoá của |
runFunction |
|
logoUrl |
logoUrl.
|