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 mà cần yêu cầu người dùng cuối đồng ý trước khi thực thi điểm cuối của 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ớ và có thể được gửi khi có yêu cầu cập nhật và xoá để đả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)

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 Gmail.
drive

object (DriveAddOnManifest)

Cấu hình tiện ích bổ sung của 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 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 các điểm cuối HTTP của tiện ích bổ sung

CommonAddOnManifest

Cấu hình tiện ích bổ sung được dùng chung trên tất cả cá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 hiển thị trên thanh công cụ của tiện ích bổ sung.
layoutProperties

object (LayoutProperties)

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

object (AddOnWidgetSet)

Các tiện ích được sử dụng trong tiện ích bổ sung. Nếu trường này không được chỉ định, 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 máy chủ bất kỳ. Người dùng luôn có thể sử dụng bất kỳ thẻ nào do hàm này tạo, nhưng có thể bị nội dung theo ngữ cảnh che khuất khi tiện ích bổ sung này khai báo trình kích hoạt được nhắm mục tiêu nhiều hơn.
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 mở rộng có thể là một URL liên kết để mở hoặc một điểm cuối để thực thi dưới dạng lượt 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 các đường liên kết HTTPS, URL cũng phải 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 lược đồ, thì HTTPS sẽ được giả định. Đường liên kết HTTP được tự động viết lại thành đường liên kết 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. Thao tác này sẽ đặt màu cho 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. Chế độ này đặt màu cho các nút. Nếu màu chính được đặt nhưng chưa đặt màu phụ, 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

Bật thiết kế 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 các tiện ích được dùng trong một 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ó kiểu cách bao gồm nút được tô màu nền và nút đã tắt.
PERSISTENT_FORMS Biểu mẫu cố định giúp các giá trị biểu mẫu được duy trì trong suốt hành động.
UPDATE_SUBJECT_AND_RECIPIENTS Cập nhật tiêu đề và người nhận của thư nháp.
GRID_WIDGET Tiện ích lưới.
ADDON_COMPOSE_UI_ACTION Một thao tác của tiện ích bổ sung Gmail áp dụng cho giao diện người dùng soạn thư của tiện ích bổ sung.

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 chính sách này thành false, hãy tắt chế độ xem trang chủ trong trường hợp này.

Giá trị mặc định là true nếu 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 một điểm mở rộng 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 mà người dùng nhìn thấy, 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 một người liên hệ mới").
Trường hợp action_type. Bắt buộc. Loại thao tác được hỗ trợ trên một 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:
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à quá trình thực thi tiện ích bổ sung 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 điểm cuối sẽ được thực thi trong những 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 bất kỳ thẻ nào do hàm này tạo ra, nhưng có thể bị nội dung theo ngữ cảnh che khuất khi tiện ích bổ sung này khai báo trình kích hoạt được nhắm mục tiêu nhiều hơn.

Nếu có, tuỳ chọn 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 từ 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 về thời gian soạn thư đều phải có phạm vi gmail.addons.current.action.compose, mặc dù nó 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ả các lượt 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 thăm 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 trình kích hoạt sẽ kích hoạt khi email đang mở đáp ứng một tiêu chí cụ thể. Khi được kích hoạt, trình 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 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:
unconditional

object (UnconditionalTrigger)

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

UnconditionalTrigger

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

Một điều kiện kích hoạt sẽ kích hoạt khi người dùng mở email bất kỳ.

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ông báo.

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 mà người dùng thấy để mô tả hành động, ví dụ: "Thêm một người liên hệ mới".
Trường hợp action_type. Loại hành động sẽ xác định hành vi của Gmail khi người dùng gọi hành động đó. action_type chỉ có thể là một trong những trạng thái sau:
runFunction

string

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

ComposeTrigger

Một yếu tố kích hoạt sẽ được 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 tiện ích bổ sung thời gian soạn tin. Đây là những thao tác mà người dùng có thể kích hoạt trong tiện ích bổ sung về thời gian soạn tin.
draftAccess

enum (DraftAccess)

Xác định cấp truy cập dữ liệu khi một tiện ích bổ sung về thời gian soạn tin đượ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 Compose yêu cầu.

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

DriveAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và quá trình thực thi 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ó, tuỳ chọn 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 liên quan trên Drive, chẳng hạn như Danh sách tài liệu trên Drive của tôi.

DriveExtensionPoint

Định dạng phổ biến để khai báo điều kiện kích hoạt của tiện ích bổ sung 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à quá trình thực thi của tiện ích bổ sung Lịch.

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

object (HomepageExtensionPoint)

Xác định đ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 bất kỳ thẻ nào do hàm này tạo ra, nhưng có thể bị nội dung theo ngữ cảnh che khuất khi tiện ích bổ sung này khai báo trình kích hoạt được nhắm mục tiêu nhiều hơn.

Nếu có, tuỳ chọn 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 đế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ở một sự kiện để xem hoặc chỉnh sửa.
eventUpdateTrigger

object (CalendarExtensionPoint)

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

enum (EventAccess)

Xác định cấp truy cập dữ liệu khi 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ị truyền hình.

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 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 cho các giải pháp hội nghị truyền hình trong một tiện ích bổ sung, nếu không thì 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ị truyền hình.

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 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 giá trị enum xác định cấp độ yêu cầu của điều kiện kích hoạt sự kiện truy cập dữ liệ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 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 Cấp quyền truy cập cho điều kiện kích hoạt sự kiện vào tất cả các trường sự kiện đã 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 trình kích hoạt sự kiện quyền truy cập vào siêu dữ liệu của các sự kiện và khả năng thực hiện tất cả các hành động, bao gồm cả thêm người tham dự và thiết lập dữ liệu hội nghị.
READ_WRITE Cấp cho trình kích hoạt sự kiện quyền truy cập vào tất cả cá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ả các hành động.

DocsAddOnManifest

Các thuộc tính tuỳ chỉnh giao diện và thao tác 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ó, tuỳ chọn 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 truy cập 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 để xem trước đường liên kết trong một tài liệu trên 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 của 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 từ trình đơn @.

DocsExtensionPoint

Định dạng phổ biến để khai báo điều kiện 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 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ừ mộ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à sẽ xuất hiện 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 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 xuất hiện 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.

Đố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 cá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ị 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 tính năng 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 để xem trước. Miền của mẫu URL. Đường liên kết xem trước của tiện ích bổ sung có chứa miền này trong URL. Để xem trước các đường liên kết cho 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 các đường liên kết cho toàn bộ miền, hãy chỉ định 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 thêm miền của hostpattern.

Ví dụ: nếu mẫu máy chủ lưu trữ URL là support.example.com, thì để so 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 một ứ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 từ 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 mở rộng 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 một biểu tượng cho điểm truy cập tài nguyên, chẳng hạn như Create support case. Văn bản này ở dạng tĩnh và sẽ xuất hiện 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 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 xuất hiện 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.

Đố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 mối liên kết.
logoUrl

string

Không bắt buộc. Biểu tượng hiển thị đ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à quá trình 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ó, tuỳ chọn 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 truy cập 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 để xem trước đường liên kết trong một tài liệu trên 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 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à quá trình thực thi 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ó, tuỳ chọn 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 truy cập 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 để 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 điều kiện kích hoạt của tiện ích bổ sung 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 tuỳ chọn gửi yêu cầu đến các đ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

Tiêu đề uỷ quyền được gửi trong các yêu cầu tiện ích bổ sung HTTP.

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 Không gửi tiêu đề 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 đã đặt.

get

 Lấy hoạt động triển khai với tên được chỉ định.

getInstallStatus

 Xem trạng thái cài đặt của quá trình triển khai thử nghiệm.

install

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

list

 Liệt kê tất cả đợt 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 bản triển khai thử nghiệm khỏi tài khoản của người dùng.