Class KeyValue

ChaveValor

Obsoleto. Essa classe foi descontinuada e não deve ser usada em novos scripts.

Esta classe foi descontinuada. Em vez disso, use DecoratedText.

Métodos

MétodoTipo de retornoBreve descrição
setAuthorizationAction(action)KeyValueDefine uma ação de autorização que abre um URL para o fluxo de autorização quando o objeto é clicado.
setComposeAction(action, composedEmailType)KeyValueDefine uma ação que compõe um e-mail de rascunho quando o objeto é clicado.
setOnClickAction(action)KeyValueDefine uma ação que é executada quando o objeto é clicado.
setOnClickOpenLinkAction(action)KeyValueDefine uma ação que abre um URL em uma guia quando o objeto é clicado.
setOpenLink(openLink)KeyValueDefine um URL para ser aberto quando o objeto é clicado.
MétodoTipo de retornoBreve descrição
setBottomLabel(text)KeyValueDefine o texto do rótulo a ser usado como chave.
setButton(button)KeyValueDefine o Button que aparece à direita do contexto.
setContent(text)KeyValueDefine o texto a ser usado como valor.
setIcon(icon)KeyValueDefine o ícone a ser usado como chave.
setIconAltText(altText)KeyValueDefine o texto alternativo do ícone.
setIconUrl(url)KeyValueDefine o URL do ícone a ser usado como chave.
setMultiline(multiline)KeyValueDefine se o texto do valor deve ser mostrado em uma ou várias linhas.
setSwitch(switchToSet)KeyValueDefine o Switch que aparece à direita do conteúdo.
setTopLabel(text)KeyValueDefine o texto do rótulo a ser usado como chave.

Documentação detalhada

setAuthorizationAction(action)

Define uma ação de autorização que abre um URL para o fluxo de autorização quando o objeto é clicado. O URL vai ser aberto em uma nova janela. Quando o usuário termina o fluxo de autorização e retorna ao aplicativo, o complemento é recarregado.

Um objeto de interface só pode ter um dos seguintes valores definidos: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) ou setComposeAction(action, composedEmailType).

// ...

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

Parâmetros

NomeTipoDescrição
actionAuthorizationActionO objeto que especifica a ação de autorização a ser realizada quando este elemento for clicado.

Retornar

KeyValue: este objeto, para encadeamento.


setComposeAction(action, composedEmailType)

Define uma ação que compõe um e-mail de rascunho quando o objeto é clicado. Um objeto de interface só pode ter um dos setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) ou setComposeAction(action, composedEmailType) definidos.

O parâmetro Action precisa especificar uma função de callback que retorne um objeto ComposeActionResponse configurado usando 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();
}

Parâmetros

NomeTipoDescrição
actionActionO objeto que especifica a ação de composição a ser realizada quando este elemento é clicado.
composedEmailTypeComposedEmailTypeUm valor de tipo enumerado que especifica se o rascunho composto é independente ou de resposta.

Retornar

KeyValue: este objeto, para encadeamento.


setOnClickAction(action)

Define uma ação que é executada quando o objeto é clicado. Um objeto de interface só pode ter um dos setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) ou setComposeAction(action, composedEmailType) definidos.

O parâmetro Action precisa especificar uma função de callback que retorne um objeto 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();
}

Parâmetros

NomeTipoDescrição
actionActionA ação a ser realizada quando esse elemento for clicado.

Retornar

KeyValue: este objeto, para encadeamento.


setOnClickOpenLinkAction(action)

Define uma ação que abre um URL em uma guia quando o objeto é clicado. Use essa função quando o URL precisar ser criado ou quando você precisar realizar outras ações além de criar o objeto OpenLink. Um objeto de interface só pode ter um dos seguintes valores definidos: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) ou setComposeAction(action, composedEmailType).

O parâmetro Action precisa especificar uma função de callback que retorne um objeto ActionResponse configurado usando 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();
}

Parâmetros

NomeTipoDescrição
actionActionO objeto que especifica a ação de abrir link a ser realizada quando este elemento for clicado.

Retornar

KeyValue: este objeto, para encadeamento.


Define um URL para ser aberto quando o objeto é clicado. Use essa função quando o URL já é conhecido e só precisa ser aberto. Um objeto de interface só pode ter um dos setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) ou setComposeAction(action, composedEmailType) definidos.

Parâmetros

NomeTipoDescrição
openLinkOpenLinkUm objeto OpenLink que descreve o URL a ser aberto.

Retornar

KeyValue: este objeto, para encadeamento.

Métodos obsoletos

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o texto do rótulo a ser usado como chave. É exibido abaixo do conteúdo de texto.

Parâmetros

NomeTipoDescrição
textStringO texto do rótulo. Observação: ele não oferece suporte à formatação HTML básica.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o Button que aparece à direita do contexto. Um KeyValue só pode ter um botão, um interruptor ou um ícone.

Parâmetros

NomeTipoDescrição
buttonButtonO botão para adicionar.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o texto a ser usado como valor. Aceita formatação HTML básica. Obrigatório.

Parâmetros

NomeTipoDescrição
textStringO conteúdo de texto do widget.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o ícone a ser usado como chave.

Parâmetros

NomeTipoDescrição
iconIconUm dos valores predefinidos de Icon.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o texto alternativo do ícone.

Parâmetros

NomeTipoDescrição
altTextStringO texto alternativo do ícone.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o URL do ícone a ser usado como chave.

Parâmetros

NomeTipoDescrição
urlStringO endereço URL de uma imagem hospedada para usar como ícone.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define se o texto do valor deve ser mostrado em uma ou várias linhas.

Parâmetros

NomeTipoDescrição
multilineBooleanA configuração de várias linhas.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o Switch que aparece à direita do conteúdo. Um KeyValue só pode ter um botão, um interruptor ou um ícone.

Parâmetros

NomeTipoDescrição
switchToSetSwitchO interruptor a ser adicionado.

Retornar

KeyValue: este objeto, para encadeamento.


Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o texto do rótulo a ser usado como chave. É exibido acima do conteúdo de texto.

Parâmetros

NomeTipoDescrição
textStringO texto do rótulo. Observação: ele não oferece suporte à formatação HTML básica.

Retornar

KeyValue: este objeto, para encadeamento.