Class Image

Obraz

Widżet wyświetlający pojedynczy obraz. Informacje o przycinaniu obrazów znajdziesz w sekcji ImageCropStyle.

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

var image = CardService.newImage().setAltText("A nice image").setImageUrl("https://image.png");

Metody

Metoda	Zwracany typ	Krótki opis
setAltText(altText)	Image	Ustawia tekst alternatywny obrazu na potrzeby ułatwień dostępu.
setAuthorizationAction(action)	Image	Ustawia działanie autoryzacji, które otwiera adres URL w procesie autoryzacji, gdy obiekt kliknięto.
setComposeAction(action, composedEmailType)	Image	Ustawia działanie tworzące wersję roboczą e-maila po kliknięciu obiektu.
setImageUrl(url)	Image	Określa obraz do użycia, podając jego adres URL lub ciąg danych.
setOnClickAction(action)	Image	Ustawia działanie wykonywane po kliknięciu obiektu.
setOnClickOpenLinkAction(action)	Image	Ustawia działanie, które po kliknięciu obiektu otwiera adres URL na karcie.
setOpenLink(openLink)	Image	Ustawia adres URL otwierany po kliknięciu obiektu.

Szczegółowa dokumentacja

setAltText(altText)

Ustawia tekst alternatywny obrazu na potrzeby ułatwień dostępu. Wymagane.

Parametry

Nazwa	Typ	Opis
altText	String	Tekst alternatywny do przypisania do tego obrazu.

Powrót

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

---

setAuthorizationAction(action)

Ustawia działanie autoryzacji, które otwiera adres URL w procesie autoryzacji, gdy obiekt kliknięto. Spowoduje to otwarcie adresu URL w nowym oknie. Gdy użytkownik zakończy proces autoryzacji powróci do aplikacji, dodatek zostanie załadowany ponownie.

Obiekt interfejsu może mieć tylko jedną z wartości: 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

Nazwa	Typ	Opis
action	AuthorizationAction	Obiekt, który określa działanie autoryzacji, które ma zostać wykonane, gdy ten element jest kliknięto.

Powrót

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

---

setComposeAction(action, composedEmailType)

Ustawia działanie tworzące wersję roboczą e-maila po kliknięciu obiektu. Obiekt interfejsu może mieć tylko mają jedną z tych wartości: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), Ustawiono 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 jest służy do rozszerzania interfejsu tworzenia wiadomości. Łączy ona ten element interfejsu z elementem Action, który tworzy wersje robocze wiadomości w Apps Script, które są otwierany w Gmailu po zakończeniu działania.

// ...

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

Nazwa	Typ	Opis
action	Action	Obiekt, który określa działanie tworzenia, które ma być wykonywane, gdy ten element jest kliknięto.
composedEmailType	ComposedEmailType	Wartość wyliczeniowa, która określa, czy tworzona wersja robocza to samodzielnej lub roboczej odpowiedzi.

Powrót

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

---

setImageUrl(url)

Określa obraz do użycia, podając jego adres URL lub ciąg danych. Wymagane.

Podany adres URL może być publicznie dostępnym adresem URL lub ciągiem znaków obrazu zakodowanym w formacie base64. Aby uzyskać ten drugi kod, możesz użyć podanego niżej kodu do utworzenia zakodowanego ciągu obrazu z na Dysku Google, a następnie zapisać ten ciąg znaków do późniejszego użycia w setImageUrl(url). Ta metoda zapobiega sytuacji, w której dodatek musi mieć dostęp do dostępny adres URL obrazu:

// The following assumes you have the image to use in Google Drive and have its ID.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes);

// You can store encodeImageURL and use it as a parameter to Image.setImageUrl(url).

Parametry

Nazwa	Typ	Opis
url	String	Adres URL hostowanego obrazu, który ma zostać użyty, lub zakodowany ciąg znaków obrazu.

Powrót

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

---

setOnClickAction(action)

Ustawia działanie wykonywane po kliknięciu obiektu. Obiekt interfejsu użytkownika może mieć tylko jedną z tych wartości: Ustawiono 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

Nazwa	Typ	Opis
action	Action	Działanie, jakie ma zostać wykonane po kliknięciu tego elementu.

Powrót

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

---

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 wykonać inne działania oprócz utworzenia obiektu OpenLink. Obiekt UI może mieć tylko jedną z tych wartości: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) lub Ustawiono 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

Nazwa	Typ	Opis
action	Action	Obiekt, który określa działanie otwarcia linku, które ma zostać wykonane, gdy ten element jest kliknięto.

Powrót

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

---

setOpenLink(openLink)

Ustawia adres URL otwierany po kliknięciu obiektu. Użyj tej funkcji, gdy adres URL jest już i trzeba go tylko otworzyć. Obiekt UI może mieć tylko jedną z tych wartości: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action), lub setComposeAction(action, composedEmailType).

Parametry

Nazwa	Typ	Opis
openLink	OpenLink	Obiekt OpenLink opisujący adres URL, który ma zostać otwarty.

Powrót

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