REST Resource: projects.deployments

Tài nguyên: Triển khai

Triển khai tiện ích bổ sung của Google Workspace

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
Trường
name

string

Tên tài nguyên triển khai. Ví dụ: projects/123/deployments/my_deployment
oauthScopes[]

string

Danh sách các phạm vi OAuth của Google cần yêu cầu người dùng cuối đồng ý trước khi thực thi điểm cuối tiện ích bổ sung.
addOns

object (AddOns)

Cấu hình tiện ích bổ sung của Google Workspace.
etag

string

Giá trị này được máy chủ tính toán dựa trên phiên bản triển khai trong bộ nhớ, đồng thời có thể được gửi khi cập nhật và xoá các yêu cầu để đảm bảo ứng dụng có giá trị đã cập nhật trước khi tiếp tục.

AddOns

Cấu hình tiện ích bổ sung của Google Workspace.

Biểu diễn dưới dạng JSON 
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
Trường
common

object (CommonAddOnManifest)

Đây là cấu hình phổ biến trên tất cả tiện ích bổ sung của Google Workspace.
gmail

object (GmailAddOnManifest)

Cấu hình tiện ích bổ sung dành cho Gmail.
drive

object (DriveAddOnManifest)

Cấu hình tiện ích bổ sung Drive.
calendar

object (CalendarAddOnManifest)

Cấu hình tiện ích bổ sung Lịch.
docs

object (DocsAddOnManifest)

Cấu hình tiện ích bổ sung của Tài liệu.
sheets

object (SheetsAddOnManifest)

Cấu hình tiện ích bổ sung của Trang tính.
slides

object (SlidesAddOnManifest)

Cấu hình tiện ích bổ sung của Trang trình bày.
httpOptions

object (HttpOptions)

Các lựa chọn để gửi yêu cầu đến điểm cuối HTTP bổ sung

CommonAddOnManifest

Cấu hình tiện ích bổ sung được dùng chung trên tất cả ứng dụng lưu trữ tiện ích bổ sung.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
Trường
name

string

Bắt buộc. Tên hiển thị của tiện ích bổ sung.
logoUrl

string

Bắt buộc. URL của hình ảnh biểu trưng xuất hiện trong thanh công cụ tiện ích bổ sung.
layoutProperties

object (LayoutProperties)

Thuộc tính bố cục phổ biến cho các thẻ tiện ích bổ sung.
addOnWidgetSet

object (AddOnWidgetSet)

Các tiện ích được dùng trong tiện ích bổ sung. Nếu bạn không chỉ định trường này, thì giá trị mặc định sẽ được sử dụng.
useLocaleFromApp

boolean

Liệu có truyền thông tin ngôn ngữ từ ứng dụng lưu trữ hay không.
homepageTrigger

object (HomepageExtensionPoint)

Xác định điểm cuối sẽ được thực thi trong mọi ngữ cảnh, trên bất kỳ máy chủ lưu trữ nào. Người dùng luôn có thể sử dụng mọi thẻ do hàm này tạo, nhưng nội dung theo bối cảnh có thể bị che khuất khi tiện ích bổ sung này khai báo thêm điều kiện kích hoạt được nhắm mục tiêu.
universalActions[]

object (UniversalActionExtensionPoint)

Xác định danh sách các điểm tiện ích trong trình đơn thao tác chung, đóng vai trò là trình đơn cài đặt cho tiện ích bổ sung. Điểm tiện ích có thể là một URL liên kết để mở hoặc một điểm cuối để thực thi khi gửi biểu mẫu.
openLinkUrlPrefixes

array (ListValue format)

Thao tác OpenLink chỉ có thể sử dụng URL có lược đồ HTTPS, MAILTO hoặc TEL. Đối với đường liên kết HTTPS, URL cũng phải trùng khớp với một trong các tiền tố được chỉ định trong danh sách cho phép. Nếu tiền tố bỏ qua giao thức này, thì HTTPS được giả định. Đường liên kết HTTP được tự động viết lại thành đường liên kết đến HTTPS.

LayoutProperties

Thuộc tính bố cục thẻ dùng chung trên tất cả ứng dụng lưu trữ tiện ích bổ sung.

Biểu diễn dưới dạng JSON 
{
  "primaryColor": string,
  "secondaryColor": string,
  "useNewMaterialDesign": boolean
}
Trường
primaryColor

string

Màu chính của tiện ích bổ sung. Công cụ này đặt màu của thanh công cụ. Nếu bạn không đặt màu chính, thì giá trị mặc định do khung cung cấp sẽ được sử dụng.
secondaryColor

string

Màu phụ của tiện ích bổ sung. Thuộc tính này thiết lập màu của các nút. Nếu bạn đặt màu chính nhưng không đặt màu cấp hai, thì màu cấp hai sẽ giống với màu chính. Nếu bạn không đặt màu chính và màu phụ, thì giá trị mặc định do khung cung cấp sẽ được sử dụng.
useNewMaterialDesign

boolean

Cho phép sử dụng Material Design cho thẻ.

AddOnWidgetSet

Tập hợp con tiện ích mà tiện ích bổ sung sử dụng.

Biểu diễn dưới dạng JSON 
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
Trường
usedWidgets[]

enum (WidgetType)

Danh sách tiện ích được dùng trong tiện ích bổ sung.

WidgetType

Loại tiện ích. WIDGET_TYPE_UNSPECIFIED là bộ tiện ích cơ bản.

Enum
WIDGET_TYPE_UNSPECIFIED Đã đặt tiện ích mặc định.
DATE_PICKER Bộ chọn ngày.
STYLED_BUTTONS Các nút được tạo kiểu bao gồm nút được tô màu nền và nút đã tắt.
PERSISTENT_FORMS Biểu mẫu cố định cho phép duy trì các giá trị biểu mẫu trong quá trình thao tác.
UPDATE_SUBJECT_AND_RECIPIENTS Cập nhật tiêu đề và người nhận bản nháp.
GRID_WIDGET Tiện ích lưới.
ADDON_COMPOSE_UI_ACTION Một thao tác tiện ích bổ sung của Gmail áp dụng cho giao diện người dùng của tiện ích bổ sung trong Compose.

HomepageExtensionPoint

Định dạng phổ biến để khai báo chế độ xem trang chủ của tiện ích bổ sung.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string,
  "enabled": boolean
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng này được kích hoạt.
enabled

boolean

Không bắt buộc. Nếu bạn đặt thành false, thì hệ thống sẽ tắt chế độ xem trang chủ trong trường hợp này.

Giá trị mặc định là true nếu bạn không đặt.

Nếu chế độ xem trang chủ tuỳ chỉnh của một tiện ích bổ sung bị tắt, thì thẻ tổng quan chung sẽ được cung cấp cho người dùng.

UniversalActionExtensionPoint

Định dạng để khai báo điểm mở rộng của mục trong trình đơn thao tác chung.

Biểu diễn dưới dạng JSON 
{
  "label": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
Trường
label

string

Bắt buộc. Văn bản hiển thị cho người dùng mô tả hành động được thực hiện bằng cách kích hoạt điểm mở rộng này, ví dụ: "Thêm người liên hệ mới".
Trường kết hợp action_type. Bắt buộc. Loại thao tác được hỗ trợ trên mục trong trình đơn thao tác chung. Đó có thể là một đường liên kết để mở hoặc một điểm cuối để thực thi. action_type chỉ có thể là một trong những trạng thái sau đây:
runFunction

string

Điểm cuối sẽ do UniversalAction chạy.

GmailAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của một tiện ích bổ sung dành cho Gmail.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Xác định một điểm cuối sẽ được thực thi trong ngữ cảnh không khớp với điều kiện kích hoạt theo ngữ cảnh đã khai báo. Người dùng luôn có thể sử dụng mọi thẻ do hàm này tạo, nhưng nội dung theo bối cảnh có thể bị che khuất khi tiện ích bổ sung này khai báo thêm điều kiện kích hoạt được nhắm mục tiêu.

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
contextualTriggers[]

object (ContextualTrigger)

Xác định tập hợp các điều kiện kích hoạt tiện ích bổ sung.
universalActions[]

object (UniversalAction)

Xác định một tập hợp thao tác chung cho tiện ích bổ sung. Người dùng kích hoạt các thao tác chung qua trình đơn thanh công cụ của tiện ích bổ sung.
composeTrigger

object (ComposeTrigger)

Xác định điều kiện kích hoạt thời gian soạn cho tiện ích bổ sung thời gian soạn. Đây là điều kiện kích hoạt khiến tiện ích bổ sung thực hiện hành động khi người dùng đang soạn email. Tất cả tiện ích bổ sung trong thời gian soạn thư phải có phạm vi gmail.addons.current.action.compose mặc dù tiện ích này có thể không chỉnh sửa bản nháp.
authorizationCheckFunction

string

Tên của một điểm cuối xác minh rằng tiện ích bổ sung có tất cả sự uỷ quyền bắt buộc của bên thứ ba, bằng cách thăm dò các API của bên thứ ba. Nếu đầu dò không thành công, hàm sẽ gửi một ngoại lệ để bắt đầu quy trình uỷ quyền. Hàm này được gọi trước mỗi lần gọi tiện ích bổ sung để đảm bảo trải nghiệm người dùng mượt mà.

ContextualTrigger

Xác định một điều kiện kích hoạt sẽ kích hoạt khi email đang mở đáp ứng một tiêu chí cụ thể. Khi kích hoạt, điều kiện kích hoạt sẽ thực thi một điểm cuối cụ thể, thường là để tạo thẻ mới và cập nhật giao diện người dùng.

Biểu diễn dưới dạng JSON 
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
Trường
onTriggerFunction

string

Bắt buộc. Tên của điểm cuối cần gọi khi một thông báo khớp với điều kiện kích hoạt.
Trường kết hợp trigger. Loại trình kích hoạt xác định các điều kiện mà Gmail sử dụng để hiển thị tiện ích bổ sung. trigger chỉ có thể là một trong những trạng thái sau đây:
unconditional

object (UnconditionalTrigger)

Lệnh kích hoạt vô điều kiện sẽ được thực thi khi có bất kỳ thư nào được mở.

UnconditionalTrigger

Loại này không có trường nào.

Một trình kích hoạt sẽ kích hoạt khi người dùng mở bất kỳ email nào.

UniversalAction

Một thao tác luôn có sẵn trong trình đơn thanh công cụ của tiện ích bổ sung, bất kể ngữ cảnh của thư.

Biểu diễn dưới dạng JSON 
{
  "text": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
Trường
text

string

Bắt buộc. Văn bản hiển thị cho người dùng, mô tả hành động, ví dụ: "Thêm địa chỉ liên hệ mới".
Trường kết hợp action_type. Loại thao tác xác định hành vi của Gmail khi người dùng yêu cầu thao tác. action_type chỉ có thể là một trong những trạng thái sau đây:
runFunction

string

Một điểm cuối được gọi khi người dùng kích hoạt hành động. Vui lòng xem hướng dẫn thao tác chung để biết thông tin chi tiết.

ComposeTrigger

Một điều kiện kích hoạt sẽ kích hoạt khi người dùng đang soạn email.

Biểu diễn dưới dạng JSON 
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
Trường
actions[]

object (MenuItemExtensionPoint)

Xác định tập hợp các hành động cho một tiện ích bổ sung thời gian soạn. Đây là những thao tác mà người dùng có thể kích hoạt trên tiện ích bổ sung thời gian soạn.
draftAccess

enum (DraftAccess)

Xác định cấp truy cập dữ liệu khi một tiện ích bổ sung trong thời gian Compose được kích hoạt.

DraftAccess

Một giá trị enum xác định cấp độ truy cập dữ liệu mà điều kiện kích hoạt trong Compose yêu cầu.

Enum
UNSPECIFIED Giá trị mặc định khi không đặt giá trị nào cho quyền nháp.
NONE Điều kiện kích hoạt Compose không thể truy cập vào bất kỳ dữ liệu nào của thư nháp khi một tiện ích bổ sung Compose được kích hoạt.
METADATA Cấp cho điều kiện kích hoạt Compose quyền truy cập vào siêu dữ liệu của thư nháp khi một tiện ích bổ sung Compose được kích hoạt. Danh sách này bao gồm danh sách đối tượng, chẳng hạn như danh sách Đến và Cc của thư nháp.

DriveAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của một tiện ích bổ sung trên Drive.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
onItemsSelectedTrigger

object (DriveExtensionPoint)

Tương ứng với hành vi thực thi khi các mục được chọn trong chế độ xem Drive có liên quan, chẳng hạn như Danh sách tài liệu Drive của tôi.

DriveExtensionPoint

Định dạng phổ biến để khai báo điều kiện kích hoạt tiện ích bổ sung trên Drive.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng được kích hoạt.

CalendarAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của một tiện ích bổ sung cho Lịch Google.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventAttachmentTrigger": {
    object (MenuItemExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Xác định một điểm cuối được thực thi trong ngữ cảnh không khớp với điều kiện kích hoạt theo ngữ cảnh đã khai báo. Người dùng luôn có thể sử dụng mọi thẻ do hàm này tạo, nhưng nội dung theo bối cảnh có thể bị che khuất khi tiện ích bổ sung này khai báo thêm điều kiện kích hoạt được nhắm mục tiêu.

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
conferenceSolution[]

object (ConferenceSolution)

Xác định các giải pháp hội nghị do tiện ích bổ sung này cung cấp.
createSettingsUrlFunction

string

Một điểm cuối cần thực thi sẽ tạo URL dẫn đến trang cài đặt của tiện ích bổ sung.
eventOpenTrigger

object (CalendarExtensionPoint)

Một điểm cuối kích hoạt khi người dùng mở hoặc chỉnh sửa một sự kiện.
eventUpdateTrigger

object (CalendarExtensionPoint)

Một điểm cuối kích hoạt khi sự kiện mở được cập nhật.
eventAttachmentTrigger

object (MenuItemExtensionPoint)

Cấu hình cho điều kiện kích hoạt theo ngữ cảnh sẽ kích hoạt khi người dùng nhấp vào trình cung cấp tệp đính kèm chứa tiện ích bổ sung trong trình đơn thả xuống của Lịch.
currentEventAccess

enum (EventAccess)

Xác định cấp truy cập dữ liệu khi một tiện ích bổ sung sự kiện được kích hoạt.

ConferenceSolution

Xác định các giá trị liên quan đến hội nghị.

Biểu diễn dưới dạng JSON 
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
Trường
onCreateFunction

string

Bắt buộc. Điểm cuối cần gọi khi cần tạo dữ liệu hội nghị truyền hình.
id

string

Bắt buộc. Bạn phải chỉ định mã nhận dạng riêng biệt cho các giải pháp hội nghị trong một tiện ích bổ sung, nếu không, giải pháp hội nghị truyền hình không chính xác có thể được sử dụng khi tiện ích bổ sung được kích hoạt. Mặc dù có thể thay đổi tên hiển thị của tiện ích bổ sung, nhưng bạn không nên thay đổi mã nhận dạng.
name

string

Bắt buộc. Tên hiển thị của giải pháp hội nghị truyền hình.
logoUrl

string

Bắt buộc. URL cho hình ảnh biểu trưng của giải pháp hội nghị.

CalendarExtensionPoint

Định dạng phổ biến để khai báo điều kiện kích hoạt của tiện ích bổ sung trong lịch.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng này được kích hoạt.

EventAccess

Một enum xác định cấp độ của điều kiện kích hoạt sự kiện truy cập dữ liệu yêu cầu.

Enum
UNSPECIFIED Giá trị mặc định khi không đặt giá trị nào cho eventAccess.
METADATA Cấp cho sự kiện sẽ kích hoạt quyền truy cập vào siêu dữ liệu của sự kiện, chẳng hạn như mã sự kiện và mã lịch.
READ Cho phép sự kiện kích hoạt quyền truy cập vào tất cả trường sự kiện được cung cấp, bao gồm cả siêu dữ liệu, người tham dự và dữ liệu hội nghị.
WRITE Cấp cho các sự kiện kích hoạt quyền truy cập vào siêu dữ liệu của sự kiện và khả năng thực hiện tất cả thao tác, bao gồm cả việc thêm người tham dự và thiết lập dữ liệu hội nghị.
READ_WRITE Cho phép sự kiện kích hoạt quyền truy cập vào tất cả trường sự kiện được cung cấp, bao gồm cả siêu dữ liệu, người tham dự và dữ liệu hội nghị, cũng như khả năng thực hiện tất cả thao tác.

DocsAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của tiện ích bổ sung Google Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ],
  "createActionTriggers": [
    {
      object (CreateActionExtensionPoint)
    }
  ]
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
onFileScopeGrantedTrigger

object (DocsExtensionPoint)

Điểm cuối sẽ thực thi khi cấp quyền trong phạm vi tệp cho cặp tài liệu/người dùng này.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Danh sách các điểm tiện ích dùng để xem trước đường liên kết trong một tài liệu Google Tài liệu. Để 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[]

object (CreateActionExtensionPoint)

Danh sách các điểm mở rộng để tạo tài nguyên bên thứ ba trong các ứng dụng của Google Workspace. Để biết thêm thông tin, hãy xem phần Tạo tài nguyên bên thứ ba qua trình đơn @.

DocsExtensionPoint

Định dạng phổ biến để khai báo trình kích hoạt của tiện ích bổ sung Tài liệu.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng này được kích hoạt.

LinkPreviewExtensionPoint

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 đường liên kết từ dịch vụ của bên thứ ba hoặc không phải của Google vào tệp Google Tài liệu, Trang tính hoặc Trang trình bày.

Biểu diễn dưới dạng JSON 
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "patterns": [
    {
      object (UriPattern)
    }
  ],
  "runFunction": string,
  "logoUrl": string
}
Trường
labelText

string

Bắt buộc. Văn bản của một khối thông minh mẫu nhắc người dùng xem trước đường liên kết, chẳng hạn như 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

map (key: string, value: string)

Không bắt buộc. Bản đồ labeltext để bản địa hoá sang các ngôn ngữ khác. Định dạng ngôn ngữ theo tiêu chuẩn ISO 639 và quốc gia/khu vực theo 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 đồ, thì người dùng sẽ thấy phiên bản đã bản địa hoá của labeltext.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
patterns[]

object (UriPattern)

Bắt buộc. Một loạt các mẫu URL kích hoạt tiện ích bổ sung để xem trước đường liên kết.
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi bản xem trước đường liên kết được kích hoạt.
logoUrl

string

Không bắt buộc. Biểu tượng xuất hiện trong khối thông minh và thẻ xem trước. Nếu bạn bỏ qua, tiện ích bổ sung sẽ sử dụng biểu tượng thanh công cụ 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

string

Bắt buộc đối với mỗi mẫu URL cần xem trước. Miền của mẫu URL. Đường liên kết xem trước tiện ích bổ sung có chứa miền này trong URL. Để xem trước đường liên kết của một miền con cụ thể (chẳng hạn như 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ụ: *.example.com khớp với subdomain.example.com và another.subdomain.example.com.
pathPrefix

string

Không bắt buộc. Đường dẫn nối miền của hostpattern.

Ví dụ: nếu mẫu máy chủ lưu trữ URL là support.example.com, thì để khớp URL cho các trường hợp được lưu trữ tại support.example.com/cases/, hãy nhập cases.

Để khớp tất cả URL trong miền mẫu máy chủ lưu trữ, hãy để trống pathprefix.

CreateActionExtensionPoint

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 gọi quy trình tạo tài nguyên trong ứng dụng của Google Workspace. Để biết thêm thông tin, hãy xem phần Tạo tài nguyên bên thứ ba qua trình đơn @.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string
}
Trường
id

string

Bắt buộc. Mã nhận dạng duy nhất để phân biệt điểm tiện ích này. Mã nhận dạng có thể dài tối đa 64 ký tự và phải ở định dạng [a-zA-Z0-9-]+.
labelText

string

Bắt buộc. Văn bản xuất hiện cùng với biểu tượng cho điểm truy cập tạo tài nguyên, chẳng hạn như Create 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

map (key: string, value: string)

Không bắt buộc. Bản đồ labeltext để bản địa hoá sang các ngôn ngữ khác. Định dạng ngôn ngữ theo tiêu chuẩn ISO 639 và quốc gia/khu vực theo 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 đồ, thì người dùng sẽ thấy phiên bản đã bản địa hoá của labeltext.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi quy trình tạo tài nguyên được kích hoạt để tạo đường liên kết.
logoUrl

string

Không bắt buộc. Biểu tượng xuất hiện cho điểm truy cập tạo tài nguyên. Nếu bạn bỏ qua, trình đơn này sẽ sử dụng biểu tượng thanh công cụ của tiện ích bổ sung, logourl.

SheetsAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của tiện ích bổ sung Google Trang tính.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SheetsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

Điểm cuối sẽ thực thi khi cấp quyền trong phạm vi tệp cho cặp tài liệu/người dùng này.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Danh sách các điểm tiện ích giúp xem trước đường liên kết trong một tài liệu Google Trang tính. Để 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.

SheetsExtensionPoint

Định dạng phổ biến để khai báo điều kiện kích hoạt của tiện ích bổ sung trong Trang tính.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng này được kích hoạt.

SlidesAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và cách thực thi của tiện ích bổ sung Google Trang trình bày.

Biểu diễn dưới dạng JSON 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SlidesExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
Trường
homepageTrigger

object (HomepageExtensionPoint)

Nếu có, cấu hình này sẽ ghi đè cấu hình trong addons.common.homepageTrigger.
onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

Điểm cuối sẽ thực thi khi cấp quyền trong phạm vi tệp cho cặp tài liệu/người dùng này.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Danh sách các điểm tiện ích dùng để xem trước đường liên kết trong một tài liệu trên Google 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.

SlidesExtensionPoint

Định dạng phổ biến để khai báo trình kích hoạt của tiện ích bổ sung trong Trang trình bày.

Biểu diễn dưới dạng JSON 
{
  "runFunction": string
}
Trường
runFunction

string

Bắt buộc. Điểm cuối cần thực thi khi điểm mở rộng này được kích hoạt.

HttpOptions

Các lựa chọn gửi yêu cầu đến điểm cuối của tiện ích bổ sung HTTP.

Biểu diễn dưới dạng JSON 
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
Trường
authorizationHeader

enum (HttpAuthorizationHeader)

Cấu hình của mã thông báo được gửi trong tiêu đề Uỷ quyền HTTP.

HttpAuthorizationHeader

Đã gửi tiêu đề uỷ quyền trong các yêu cầu HTTP của tiện ích bổ sung.

Enum
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED Giá trị mặc định, tương đương với SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN Gửi mã thông báo mã nhận dạng cho tài khoản dịch vụ hệ thống của Tiện ích bổ sung Google Workspace dành riêng cho dự án (mặc định).
USER_ID_TOKEN Gửi mã thông báo nhận dạng cho người dùng cuối.
NONE Đừng gửi tiêu đề Authentication (Xác thực).

Phương thức

create

 Tạo một quá trình triển khai có tên và cấu hình đã chỉ định.

delete

 Xoá hoạt động triển khai có tên đã cho.

get

 Lấy thông tin triển khai có tên đã chỉ định.

getInstallStatus

 Xem trạng thái cài đặt của một đợt triển khai kiểm thử.

install

 Cài đặt một phiên triển khai cho tài khoản của bạn để thử nghiệm.

list

 Liệt kê tất cả phiên triển khai trong một dự án cụ thể.

replaceDeployment

 Tạo hoặc thay thế quá trình triển khai bằng tên đã chỉ định.

uninstall

 Gỡ cài đặt một bản triển khai thử nghiệm khỏi tài khoản của người dùng.