Izgara öğeleri koleksiyonunu gösteren düzenlenmiş bir ızgara.
Google Workspace eklentileri ve Google Chat uygulamaları için kullanılabilir.
const grid = CardService.newGrid().setTitle('My Grid').setNumColumns(2).addItem( CardService.newGridItem().setTitle('My item'));
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addItem(gridItem) | Grid | Izgaraya yeni bir ızgara öğesi ekler. |
setAuthorizationAction(action) | Grid | Nesne tıklandığında yetkilendirme akışına giden bir URL açan yetkilendirme işlemi ayarlar. |
setBorderStyle(borderStyle) | Grid | Her bir ızgara öğesine uygulanan kenarlık stilini ayarlar. |
setComposeAction(action, composedEmailType) | Grid | Nesne tıklandığında e-posta taslağı oluşturan bir işlem ayarlar. |
setNumColumns(numColumns) | Grid | Izgarada gösterilecek sütun sayısı. |
setOnClickAction(action) | Grid | Nesne tıklandığında yürütülecek bir işlem ayarlar. |
setOnClickOpenLinkAction(action) | Grid | Nesne tıklandığında bir URL'yi sekmede açan bir işlem ayarlar. |
setOpenLink(openLink) | Grid | Nesne tıklandığında açılacak bir URL ayarlar. |
setTitle(title) | Grid | Izgaranın başlık metnini ayarlar. |
Ayrıntılı dokümanlar
addItem(gridItem)
setAuthorizationAction(action)
Nesne tıklandığında yetkilendirme akışına giden bir URL açan yetkilendirme işlemi ayarlar. Bu işlem, URL'yi yeni bir pencerede açar. Kullanıcı yetkilendirme akışını tamamlayıp uygulamaya döndüğünde eklenti yeniden yüklenir.
Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
ayarlarından biri olabilir.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | AuthorizationAction | Bu öğe tıklandığında gerçekleştirilecek yetkilendirme işlemini belirten nesne. |
Return
Grid
: Zincirleme için bu nesne.
setBorderStyle(borderStyle)
Her ızgara öğesine uygulanan kenarlık stilini ayarlar. Varsayılan değer NO_BORDER'dır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
borderStyle | BorderStyle | Uygulanacak kenarlık stili. |
Return
Grid
: Zincirleme için bu nesne.
setComposeAction(action, composedEmailType)
Nesne tıklandığında bir e-posta taslağı oluşturan bir işlem ayarlar. Bir kullanıcı arayüzü nesnesinde setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
özelliklerinden yalnızca biri ayarlanabilir.
Action
parametresi, ComposeActionResponseBuilder.setGmailDraft(draft)
kullanılarak yapılandırılmış bir ComposeActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Bu öğe tıklandığında yapılacak oluşturma işlemini belirten nesne. |
composedEmailType | ComposedEmailType | Oluşturulan taslağın bağımsız mı yoksa yanıt taslağı mı olduğunu belirten bir enum değeri. |
Return
Grid
: Zincirleme için bu nesne.
setNumColumns(numColumns)
Izgarada gösterilecek sütun sayısı. Sağ taraftaki panelde gösteriliyorsa 1-2 sütun görüntüleyebilirsiniz ve varsayılan değer 1'dir. Bir iletişim kutusunda 2-3 sütun görüntüleyebilirsiniz ve varsayılan değer 2'dir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numColumns | Integer | Sütun sayısı. |
Return
Grid
: Zincirleme için bu nesne.
setOnClickAction(action)
Nesne tıklandığında yürütülecek bir işlem ayarlar. Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
ayarlarından biri olabilir.
Action
parametresi, ActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Bu öğe tıklandığında yapılacak işlem. |
Return
Grid
: Zincirleme için bu nesne.
setOnClickOpenLinkAction(action)
Nesne tıklandığında bir URL'yi sekmede açan bir işlem ayarlar. URL'nin oluşturulması gerektiğinde veya OpenLink
nesnesini oluşturmanın yanı sıra başka işlemler yapmanız gerektiğinde bu işlevi kullanın. Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
ayarlanmış olabilir.
Action
parametresi, ActionResponseBuilder.setOpenLink(openLink)
kullanılarak yapılandırılmış bir ActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Bu öğe tıklandığında yapılacak bağlantı açma işlemini belirten nesne. |
Return
Grid
: Zincirleme için bu nesne.
setOpenLink(openLink)
Nesne tıklandığında açılacak bir URL ayarlar. URL zaten bilindiğinde ve yalnızca açılması gerektiğinde bu işlevi kullanın. Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
,
setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
kümesi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
openLink | OpenLink | Açılacak URL'yi açıklayan bir OpenLink nesnesi. |
Return
Grid
: Zincirleme için bu nesne.
setTitle(title)
Izgaranın başlık metnini ayarlar. Metin, biçimlendirme içermeyen düz bir dize olmalıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Başlık metni. |
Return
Grid
: Zincirleme için bu nesne.