Izgara öğeleri koleksiyonunu gösteren düzenlenmiş bir ızgara.
Google Workspace eklentilerinde ve Google Chat uygulamalarında kullanılabilir.
var 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 şu anda yetkilendirme akışı için bir URL açan yetkilendirme işlemi ayarlar: tıklandı. |
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örüntülenecek sütun sayısı. |
setOnClickAction(action) | Grid | Nesne tıklandığında yürütülecek bir işlemi ayarlar. |
setOnClickOpenLinkAction(action) | Grid | Nesne tıklandığında URL'yi bir sekmede açan işlemi ayarlar. |
setOpenLink(openLink) | Grid | Nesne tıklandığında açılacak bir URL'yi ayarlar. |
setTitle(title) | Grid | Izgaranın başlık metnini ayarlar. |
Ayrıntılı belgeler
addItem(gridItem)
setAuthorizationAction(action)
Nesne şu anda yetkilendirme akışı için bir URL açan yetkilendirme işlemi ayarlar: tıklandı. 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)
ayarlanmış olabilir.
// ... var action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | AuthorizationAction | Bu öğe olduğunda yapılacak yetkilendirme işlemini belirten nesne tıklandı. |
Return
Grid
: Zincirleme için bu nesne.
setBorderStyle(borderStyle)
Her bir ızgara öğesine uygulanan kenarlık stilini ayarlar. Varsayılan değer: NO_BORDER.
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 e-posta taslağı oluşturan bir işlem ayarlar. Kullanıcı arayüzü nesnesi yalnızca
biri setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
,
setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
set.
Action
parametresi, ComposeActionResponseBuilder.setGmailDraft(draft)
kullanılarak yapılandırılmış bir ComposeActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Bu öğe olduğunda yapılacak oluşturma işlemini belirten nesne tıklandı. |
composedEmailType | ComposedEmailType | Oluşturulan taslağın veya yanıt taslağı oluşturabilirsiniz. |
Return
Grid
: Zincirleme için bu nesne.
setNumColumns(numColumns)
Izgarada görüntülenecek sütun sayısı. Sağ taraftaki panelde gösteriliyorsa 1-2 sütun içerir ve varsayılan değer 1'dir. Bir iletişim kutusunda gösterilirse 2-3 sütun görüntüleyebilir 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şlemi ayarlar. Kullanıcı arayüzü nesnesi
setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
set.
Action
parametresi, ActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
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 URL'yi bir sekmede açan işlemi ayarlar. Bu işlevi
URL'nin oluşturulması veya OpenLink
nesnesini oluşturmak için ek olarak başka işlemler yapmanız gerektiğinde gereklidir. Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya
setComposeAction(action, composedEmailType)
set.
Action
parametresi, ActionResponseBuilder.setOpenLink(openLink)
kullanılarak yapılandırılmış bir ActionResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
// ... 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(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Bu öğe olduğunda yapılacak açık bağlantı işlemini belirten nesne tıklandı. |
Return
Grid
: Zincirleme için bu nesne.
setOpenLink(openLink)
Nesne tıklandığında açılacak bir URL'yi ayarlar. URL zaten hazır olduğunda bu işlevi kullanın
açılması gerekir. Bir kullanıcı arayüzü nesnesinde yalnızca setOpenLink(openLink)
,
setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
,
veya setComposeAction(action, composedEmailType)
set.
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.