Class Grid

Siatka

Uporządkowana siatka wyświetlająca kolekcję elementów siatki.

Dostępne w przypadku dodatków do Google Workspace i aplikacji Google Chat.

var grid = CardService.newGrid()
    .setTitle("My Grid")
    .setNumColumns(2)
    .addItem(CardService.newGridItem()
        .setTitle("My item"));

Metody

MetodaTyp zwracanej wartościKrótki opis
addItem(gridItem)GridDodaje nowy element siatki do siatki.
setAuthorizationAction(action)GridUstawia działanie autoryzacji, które po kliknięciu obiektu otwiera adres URL w procesie autoryzacji.
setBorderStyle(borderStyle)GridUstawia styl obramowania stosowany do każdego elementu siatki.
setComposeAction(action, composedEmailType)GridUstawia działanie tworzące wersję roboczą e-maila po kliknięciu obiektu.
setNumColumns(numColumns)GridLiczba kolumn wyświetlanych w siatce.
setOnClickAction(action)GridUstawia działanie wykonywane po kliknięciu obiektu.
setOnClickOpenLinkAction(action)GridUstawia działanie, które otwiera adres URL na karcie po kliknięciu obiektu.
setOpenLink(openLink)GridUstawia adres URL, który otwiera się po kliknięciu obiektu.
setTitle(title)GridUstawia tytuł siatki.

Szczegółowa dokumentacja

addItem(gridItem)

Dodaje nowy element siatki do siatki.

Parametry

NazwaTypOpis
gridItemGridItemElement siatki do dodania.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setAuthorizationAction(action)

Ustawia działanie autoryzacji, które po kliknięciu obiektu otwiera adres URL w procesie autoryzacji. Adres URL zostanie otwarty w nowym oknie. Gdy użytkownik zakończy proces autoryzacji i wróci do aplikacji, dodatek załaduje się ponownie.

Obiekt UI może mieć ustawiony tylko jeden z tych elementów setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

// ...

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

Parametry

NazwaTypOpis
actionAuthorizationActionObiekt określający działanie autoryzacji, które ma być wykonywane po kliknięciu tego elementu.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setBorderStyle(borderStyle)

Ustawia styl obramowania stosowany do każdego elementu siatki. Wartość domyślna to NO_BORDER.

Parametry

NazwaTypOpis
borderStyleBorderStyleStyl obramowania, który chcesz zastosować.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setComposeAction(action, composedEmailType)

Ustawia działanie tworzące wersję roboczą e-maila po kliknięciu obiektu. Obiekt UI może mieć ustawiony tylko jeden z tych elementów: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

Parametr Action musi określać funkcję wywołania zwrotnego, która zwraca obiekt ComposeActionResponse skonfigurowany za pomocą ComposeActionResponseBuilder.setGmailDraft(draft).

// ...

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

Parametry

NazwaTypOpis
actionActionObiekt określający czynność tworzenia, która ma być wykonywana po kliknięciu tego elementu.
composedEmailTypeComposedEmailTypeWartość wyliczenia, która określa, czy stworzona wersja robocza jest samodzielną wersją roboczą, czy wersją odpowiedzi.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setNumColumns(numColumns)

Liczba kolumn wyświetlanych w siatce. Jeśli jest widoczny w prawym panelu bocznym, możesz wyświetlić 1–2 kolumny, których wartość domyślna to 1. W oknie możesz zobaczyć od 2 do 3 kolumn, których wartość domyślna to 2.

Parametry

NazwaTypOpis
numColumnsIntegerLiczba kolumn.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setOnClickAction(action)

Ustawia działanie wykonywane po kliknięciu obiektu. Obiekt UI może mieć ustawiony tylko jeden z tych parametrów: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

Parametr Action musi określać funkcję wywołania zwrotnego, która zwraca obiekt 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();
}

Parametry

NazwaTypOpis
actionActionDziałanie, jakie ma być wykonywane po kliknięciu tego elementu.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setOnClickOpenLinkAction(action)

Ustawia działanie, które otwiera adres URL na karcie po kliknięciu obiektu. Użyj tej funkcji, gdy trzeba skompilować adres URL lub gdy trzeba wykonać inne działania oprócz utworzenia obiektu OpenLink. Obiekt UI może mieć ustawiony tylko jeden z tych elementów: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

Parametr Action musi określać funkcję wywołania zwrotnego, która zwraca obiekt ActionResponse skonfigurowany za pomocą 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();
}

Parametry

NazwaTypOpis
actionActionObiekt określający działanie otwierania linku, które ma być wykonywane po kliknięciu tego elementu.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


Ustawia adres URL, który otwiera się po kliknięciu obiektu. Tej funkcji należy używać, gdy adres URL jest już znany i tylko trzeba go otworzyć. Obiekt UI może mieć ustawiony tylko jeden z tych elementów: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

Parametry

NazwaTypOpis
openLinkOpenLinkObiekt OpenLink opisujący adres URL do otwarcia.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.


setTitle(title)

Ustawia tytuł siatki. Tekst musi być zwykłym ciągiem znaków bez formatowania.

Parametry

NazwaTypOpis
titleStringTytuł.

Powroty

Grid – ten obiekt do tworzenia łańcuchów.