Class CardAction

CardAction

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

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

const cardAction =
    CardService.newCardAction().setText('Card action').setOnClickAction(action);

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
setAuthorizationAction(action)CardActionĐặt một thao tác uỷ quyền mở một URL cho quy trình uỷ quyền khi nhấp vào đối tượng.
setComposeAction(action, composedEmailType)CardActionĐặt một thao tác soạn email nháp khi nhấp vào đối tượng.
setOnClickAction(action)CardActionĐặt một thao tác thực thi khi nhấp vào đối tượng.
setOnClickOpenLinkAction(action)CardActionĐặt một thao tác mở một URL trong một thẻ khi nhấp vào đối tượng.
setOpenLink(openLink)CardActionĐặt một URL sẽ được mở khi nhấp vào đối tượng.
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)

Đặt một thao tác uỷ quyền mở một URL cho quy trình uỷ quyền khi nhấp vào đối tượng. 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.

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). 

// ...

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

Tham số

TênLoạiMô tả
actionAuthorizationActionĐối tượng chỉ định thao tác uỷ quyền 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.

setComposeAction(action, composedEmailType)

Đặt một thao tác soạn email nháp khi 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 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 ComposeActionResponse được định cấu hình bằng ComposeActionResponseBuilder.setGmailDraft(draft). 

// ...

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

// ...

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

Tham số

TênLoạiMô tả
actionActionĐối tượng chỉ định thao tác soạn cần thực hiện khi nhấp vào phần tử này.
composedEmailTypeComposedEmailTypeMột giá trị enum chỉ định xem bản nháp đã soạn là bản nháp độ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)

Đặt một thao tác thực thi khi 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 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. 

// ...

const 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();
}

Tham số

TênLoạiMô tả
actionActionThao tác 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ở một URL trong một thẻ khi nhấp vào đối tượng. 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 ngoài việ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). 

// ...

const 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();
}

Tham số

TênLoạiMô tả
actionActionĐối tượng chỉ định thao tác mở đường liên kết 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.

Đặt một URL sẽ được mở khi nhấp vào đối tượng. Hãy sử dụng hàm này khi URL đã được biết 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).

Tham số

TênLoạiMô tả
openLinkOpenLinkMột đố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.

Tham số

TênLoạiMô tả
textStringVă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.