Ta strona została przetłumaczona przez Cloud Translation API.

Class Grid

uporządkowana siatka do wyświetlania kolekcji elementów siatki;

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

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

Metody

Metoda	Zwracany typ	Krótki opis
`addItem(gridItem)`	`Grid`	Dodaje nowy element siatki do siatki.
`setAuthorizationAction(action)`	`Grid`	Ustawia działanie autoryzacji, które otwiera URL do procesu autoryzacji po kliknięciu obiektu.
`setBorderStyle(borderStyle)`	`Grid`	Ustawia styl obramowania stosowany do każdego elementu siatki.
`setComposeAction(action, composedEmailType)`	`Grid`	Po kliknięciu obiektu ustawia działanie, które tworzy wersję roboczą e-maila.
`setNumColumns(numColumns)`	`Grid`	Liczba kolumn wyświetlanych w siatce.
`setOnClickAction(action)`	`Grid`	Ustawia działanie wykonywane po kliknięciu obiektu.
`setOnClickOpenLinkAction(action)`	`Grid`	Ustawia działanie, które otwiera URL w karcie po kliknięciu obiektu.
`setOpenLink(openLink)`	`Grid`	Ustawia adres URL otwierany po kliknięciu obiektu.
`setTitle(title)`	`Grid`	Ustawia tekst tytułu siatki.

Szczegółowa dokumentacja

`addItem(gridItem)`

Dodaje nowy element siatki do siatki.

Parametry

Nazwa	Typ	Opis
`gridItem`	`GridItem`	Element siatki do dodania.

Powrót

Grid – ten obiekt do łańcucha.

`setAuthorizationAction(action)`

Ustawia działanie autoryzacji, które otwiera URL do procesu autoryzacji po kliknięciu obiektu. Spowoduje to otwarcie adresu URL w nowym oknie. Gdy użytkownik zakończy proces autoryzacji i powróci do aplikacji, wtyczka zostanie ponownie załadowana.

Obiekt interfejsu może mieć tylko jedną z wartości: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

// ...

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

Parametry

Nazwa	Typ	Opis
`action`	`AuthorizationAction`	Obiekt określający działanie autoryzacyjne, które ma zostać wykonane po kliknięciu tego elementu.

Powrót

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

`setBorderStyle(borderStyle)`

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

Parametry

Nazwa	Typ	Opis
`borderStyle`	`BorderStyle`	Styl obramowania do zastosowania.

Powrót

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

`setComposeAction(action, composedEmailType)`

Po kliknięciu obiektu ustawia działanie, które tworzy wersję roboczą e-maila. Obiekt interfejsu może mieć tylko jedną z tych przeglądarek: 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).

Uwaga: ta metoda nie ustawia działania tworzenia, które służy do rozszerzania interfejsu tworzenia. Zamiast tego łączy ten element interfejsu użytkownika z funkcją Action, która tworzy kopie robocze wiadomości w Google Apps Script, które są otwierane w Gmailu po zakończeniu działania.

// ...

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

// ...

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

Parametry

Nazwa	Typ	Opis
`action`	`Action`	Obiekt określający działanie, które ma zostać wykonane po kliknięciu tego elementu.
`composedEmailType`	`ComposedEmailType`	Wartość wyliczeniowa określająca, czy utworzona wersja robocza jest samodzielną wersją roboczą czy odpowiedzią.

Powrót

Grid – ten obiekt do łańcucha.

`setNumColumns(numColumns)`

Liczba kolumn wyświetlanych w siatce. Jeśli panel boczny jest widoczny po prawej stronie, możesz wyświetlić 1–2 kolumny. Wartość domyślna to 1. Jeśli jest wyświetlany w oknie, możesz wyświetlić od 2 do 3 kolumn, a wartość domyślna to 2.

Parametry

Nazwa	Typ	Opis
`numColumns`	`Integer`	Liczba kolumn.

Powrót

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

`setOnClickAction(action)`

Określa działanie, które jest wykonywane po kliknięciu obiektu. Obiekt interfejsu może mieć 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.

// ...

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

Parametry

Nazwa	Typ	Opis
`action`	`Action`	Działanie, które ma być wykonywane po kliknięciu tego elementu.

Powrót

Grid – ten obiekt do łańcucha.

`setOnClickOpenLinkAction(action)`

Ustawia działanie, które po kliknięciu obiektu otwiera adres URL na karcie. Użyj tej funkcji, gdy musisz utworzyć adres URL lub gdy oprócz utworzenia obiektu OpenLink musisz wykonać inne czynności. Obiekt interfejsu może mieć tylko jedną z tych wartości: 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).

// ...

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

Parametry

Nazwa	Typ	Opis
`action`	`Action`	Obiekt określający działanie polegające na otwarciu linku, które ma zostać wykonane po kliknięciu tego elementu.

Powrót

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

`setOpenLink(openLink)`

Ustawia adres URL, który zostanie otwarty po kliknięciu obiektu. Używaj tej funkcji, gdy adres URL jest już znany i trzeba go tylko otworzyć. Obiekt interfejsu może mieć tylko jeden z tych parametrów: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub setComposeAction(action, composedEmailType).

Parametry

Nazwa	Typ	Opis
`openLink`	`OpenLink`	Obiekt `OpenLink` opisujący adres URL do otwarcia.

Powrót

Grid – ten obiekt do łańcucha.

`setTitle(title)`

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

Parametry

Nazwa	Typ	Opis
`title`	`String`	Tekst tytułu.

Powrót

Grid – ten obiekt do łańcucha.