Class Button

Button

Một lớp cơ sở cho mọi nút.

Phương pháp

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
setAuthorizationAction(action)	Button	Đặt một thao tác uỷ quyền sẽ mở URL thành luồng uỷ quyền khi đối tượng được nhấp vào.
setComposeAction(action, composedEmailType)	Button	Đặt một thao tác soạn email nháp khi đối tượng được nhấp vào.
setOnClickAction(action)	Button	Đặt một thao tác thực thi khi nhấp vào đối tượng.
setOnClickOpenLinkAction(action)	Button	Đặt thao tác mở URL trong một thẻ khi đối tượng được nhấp vào.
setOpenLink(openLink)	Button	Đặt URL để mở khi người dùng nhấp vào đối tượng.

Tài liệu chi tiết

setAuthorizationAction(action)

Đặt một thao tác uỷ quyền sẽ mở URL thành luồng uỷ quyền khi đối tượng được nhấp vào. Thao tác này sẽ mở URL trong một cửa sổ mới. Khi người dùng kết thúc quy trình ủy quyền và quay lại ứng dụng, tiện ích bổ sung sẽ tải lại.

Bạn chỉ có thể đặt một trong các đối tượng giao diện người dùng setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) hoặc setComposeAction(action, composedEmailType).

// ...

var action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

Các tham số

Tên	Loại	Mô tả
action	AuthorizationAction	Đối tượng chỉ định thao tác ủy quyền cần thực hiện khi nhấp vào phần tử này.

Hai chiều

Button — Đối tượng này, để tạo chuỗi.

---

setComposeAction(action, composedEmailType)

Đặt một thao tác soạn email nháp khi đối tượng được nhấp vào. Đối tượng giao diện người dùng chỉ được đặt một trong các giá trị cho setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) hoặc setComposeAction(action, composedEmailType).

Tham số Action phải chỉ định một hàm callback trả về đối tượng ComposeActionResponse được định cấu hình bằng ComposeActionResponseBuilder.setGmailDraft(draft).

Lưu ý: Phương thức này không đặt thao tác soạn thư được dùng để mở rộng giao diện người dùng soạn. Thay vào đó, phương thức này kết nối phần tử giao diện người dùng này với một Action kết hợp các thư nháp trong Apps Script được mở trong Gmail khi thao tác hoàn tất.

// ...

var action = CardService.newAction().setFunctionName('composeEmailCallback');
CardService.newTextButton()
    .setText('Compose Email')
    .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT);

// ...

function composeEmailCallback() {
  var thread = GmailApp.getThreadById(e.threadId);
  var draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

Các tham số

Tên	Loại	Mô tả
action	Action	Đối tượng chỉ định hành động soạn thư cần thực hiện khi nhấp vào phần tử này.
composedEmailType	ComposedEmailType	Giá trị enum cho biết bản nháp là bản nháp hay là thư trả lời.

Hai chiều

Button — Đối tượng này, để tạo chuỗi.

---

setOnClickAction(action)

Đặt một thao tác thực thi khi nhấp vào đối tượng. Bạn chỉ có thể đặt một trong các đối tượng giao diện người dùng setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) hoặc setComposeAction(action, composedEmailType).

Tham số Action phải chỉ định một hàm callback trả về đối tượng ActionResponse.

// ...

var action = CardService.newAction().setFunctionName('notificationCallback');
CardService.newTextButton().setText('Create notification').setOnClickAction(action);

// ...

function notificationCallback() {
  return CardService.newActionResponseBuilder()
      .setNotification(CardService.newNotification()
          .setText("Some info to display to user"))
      .build();
}

Các tham số

Tên	Loại	Mô tả
action	Action	Hành động cần thực hiện khi nhấp vào phần tử này.

Hai chiều

Button — Đối tượng này, để tạo chuỗi.

---

setOnClickOpenLinkAction(action)

Đặt thao tác mở URL trong một thẻ khi đối tượng được nhấp vào. Hãy sử dụng hàm này khi cần tạo URL hoặc khi bạn cần thực hiện các thao tác khác trong tiện ích bổ sung để tạo đối tượng OpenLink. Bạn chỉ có thể đặt một trong các đối tượng giao diện người dùng setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) hoặc setComposeAction(action, composedEmailType).

Tham số Action phải chỉ định một hàm callback trả về đối tượng ActionResponse được định cấu hình bằng ActionResponseBuilder.setOpenLink(openLink).

// ...

var action = CardService.newAction().setFunctionName('openLinkCallback');
CardService.newTextButton().setText('Open Link').setOnClickOpenLinkAction(action);

// ...

function openLinkCallback() {
  return CardService.newActionResponseBuilder()
      .setOpenLink(CardService.newOpenLink()
          .setUrl('https://www.google.com'))
      .build();
}

Các tham số

Tên	Loại	Mô tả
action	Action	Đối tượng chỉ định hành động liên kết đang mở khi thực hiện phần tử này.

Hai chiều

Button — Đối tượng này, để tạo chuỗi.

---

setOpenLink(openLink)

Đặt URL để mở khi người dùng nhấp vào đối tượng. Hãy sử dụng hàm này khi URL đã biết và chỉ cần mở. Đối tượng giao diện người dùng chỉ có thể có một trong các setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action), hoặc setComposeAction(action, composedEmailType).

Các tham số

Tên	Loại	Mô tả
openLink	OpenLink	Đối tượng OpenLink mô tả URL cần mở.

Hai chiều

Button — Đối tượng này, để tạo chuỗi.