Class CardAction

CardAction

Mục trong trình đơn có thể nhấp được thêm vào trình đơn tiêu đề thẻ.

var action = CardService.newAction();
// Finish building the action...

var cardAction = CardService.newCardAction()
    .setText("Card action")
    .setOnClickAction(action);

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
setAuthorizationAction(action)	CardAction	Thiết lập một thao tác uỷ quyền mở URL cho quy trình uỷ quyền khi đối tượng được nhấp vào.
setComposeAction(action, composedEmailType)	CardAction	Thiết lập một thao tác soạn email nháp khi người dùng nhấp vào đối tượng.
setOnClickAction(action)	CardAction	Thiết lập một thao tác thực thi khi đối tượng được nhấp.
setOnClickOpenLinkAction(action)	CardAction	Đặt một thao tác mở URL trong thẻ khi đối tượng được nhấp vào.
setOpenLink(openLink)	CardAction	Thiết lập URL sẽ mở khi đối tượng được nhấp vào.
setText(text)	CardAction	Đặt văn bản trình đơn cho thao tác này.

Tài liệu chi tiết

setAuthorizationAction(action)

Thiết lập một thao tác uỷ quyền mở URL cho quy trình 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 hoàn tất quy trình uỷ quyền và quay lại ứng dụng, tiện ích bổ sung sẽ tải lại.

Đối tượng giao diện người dùng chỉ có thể đặt một trong các giá trị 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	Nội dung mô tả
action	AuthorizationAction	Đối tượng chỉ định thao tác uỷ quyền cần thực hiện khi người dùng nhấp vào phần tử này.

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.

---

setComposeAction(action, composedEmailType)

Thiết lập một thao tác soạn email nháp khi người dùng nhấp vào đối tượng. Một đối tượng giao diện người dùng chỉ có thể đặt một trong các bộ 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 Compose dùng để mở rộng giao diện người dùng trong Compose. Thay vào đó, phương thức này sẽ kết nối thành phần trên giao diện người dùng này với một Action Soạn thư nháp trong Apps Script được mở trong Gmail khi thao tác này 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	Nội dung mô tả
action	Action	Đối tượng chỉ định thao tác soạn thư cần thực hiện khi nhấp vào phần tử này.
composedEmailType	ComposedEmailType	Giá trị enum chỉ định xem bản nháp đã soạn là độc lập hay bản nháp trả lời.

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.

---

setOnClickAction(action)

Thiết lập một thao tác thực thi khi đối tượng được nhấp. Một đối tượng giao diện người dùng chỉ có thể đặt một trong các giá trị 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	Nội dung mô tả
action	Action	Hành động cần thực hiện khi nhấp vào phần tử này.

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.

---

setOnClickOpenLinkAction(action)

Đặt một thao tác mở URL trong 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 hành động khác để tạo đối tượng OpenLink. Một đối tượng giao diện người dùng chỉ có thể đặt một trong các giá trị 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	Nội dung mô tả
action	Action	Đối tượng chỉ định thao tác cần thực hiện trên đường liên kết mở khi người dùng nhấp vào phần tử này.

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.

---

setOpenLink(openLink)

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

Các tham số

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

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.

---

setText(text)

Đặt văn bản trình đơn cho thao tác này.

Các tham số

Tên	Loại	Nội dung mô tả
text	String	Văn bản mục trong trình đơn.

Cầu thủ trả bóng

CardAction – Đối tượng này để tạo chuỗi.