Kart başlığı menüsüne eklenen tıklanabilir bir menü öğesi.
var action = CardService.newAction(); // Finish building the action... var cardAction = CardService.newCardAction() .setText("Card action") .setOnClickAction(action);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
setAuthorizationAction(action) | CardAction | Nesne tıklandığında, yetkilendirme akışına yönlendiren bir URL açan yetkilendirme işlemi ayarlar. |
setComposeAction(action, composedEmailType) | CardAction | Nesne tıklandığında taslak e-posta oluşturan bir işlemi ayarlar. |
setOnClickAction(action) | CardAction | Nesne tıklandığında yürütülecek bir işlem ayarlar. |
setOnClickOpenLinkAction(action) | CardAction | Nesne tıklandığında bir URL'yi sekmede açan işlemi ayarlar. |
setOpenLink(openLink) | CardAction | Nesne tıklandığında açılacak bir URL'yi ayarlar. |
setText(text) | CardAction | Bu işlem için menü metnini ayarlar. |
Ayrıntılı belgeler
setAuthorizationAction(action)
Nesne tıklandığında, yetkilendirme akışına yönlendiren bir URL açan yetkilendirme işlemi ayarlar. Bu işlem, URL'yi yeni bir pencerede açar. Kullanıcı yetkilendirme akışını bitirip uygulamaya döndüğünde eklenti yeniden yüklenir.
Bir kullanıcı arayüzü nesnesinde setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
değerlerinden yalnızca biri ayarlanmış olabilir.
// ... var 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
CardAction
: Zincirleme için bu nesne.
setComposeAction(action, composedEmailType)
Nesne tıklandığında taslak e-posta oluşturan bir işlemi ayarlar. Bir kullanıcı arayüzü nesnesinde setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
değerlerinden yalnızca biri ayarlanmış olabilir.
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 tıklandığında gerçekleştirilecek 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
CardAction
: 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 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
değerlerinden yalnızca biri ayarlanmış olabilir.
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
CardAction
: Zincirleme için bu nesne.
setOnClickOpenLinkAction(action)
Nesne tıklandığında bir URL'yi sekmede açan işlemi ayarlar. URL'nin oluşturulması gerektiğinde veya OpenLink
nesnesini oluşturmaya ek olarak başka işlemler gerçekleştirmeniz gerektiğinde bu işlevi kullanın. Bir kullanıcı arayüzü nesnesi yalnızca setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
değerlerinden birine sahip 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.
// ... 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 tıklandığında gerçekleştirilecek açık bağlantı işlemini belirten nesne. |
Return
CardAction
: Zincirleme için bu nesne.
setOpenLink(openLink)
Nesne tıklandığında açılacak bir URL'yi ayarlar. URL zaten biliniyorsa ve yalnızca açılması gerekiyorsa bu işlevi kullanın. Bir kullanıcı arayüzü nesnesi yalnızca setOpenLink(openLink)
,
setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
veya setComposeAction(action, composedEmailType)
grubundan birine sahip olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
openLink | OpenLink | Açılacak URL'yi açıklayan bir OpenLink nesnesi. |
Return
CardAction
: Zincirleme için bu nesne.
setText(text)
Bu işlem için menü metnini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Menü öğesi metni. |
Return
CardAction
: Zincirleme için bu nesne.