فئة أساسية لجميع الأزرار.
تتوفّر هذه الميزة لإضافات Google Workspace وتطبيقات Google Chat.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
setAuthorizationAction(action) | Button | تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر. |
setComposeAction(action, composedEmailType) | Button | تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. |
setOnClickAction(action) | Button | تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر. |
setOnClickOpenLinkAction(action) | Button | تُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر. |
setOpenLink(openLink) | Button | تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر. |
setOverflowMenu(menu) | Button | إعداد قائمة منبثقة لفتحها عند النقر على العنصر. |
مستندات تفصيلية
setAuthorizationAction(action)
تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر. يؤدي ذلك إلى فتح عنوان URL في نافذة جديدة. عندما ينهي المستخدم تدفق التفويض ويعود إلى التطبيق، تتم إعادة تحميل الإضافة.
يمكن أن يحتوي كائن واجهة المستخدم على مجموعة واحدة فقط من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
action | AuthorizationAction | العنصر الذي يحدّد إجراء التفويض الذي يجب اتّخاذه عند النقر على هذا العنصر |
الإرجاع
Button
— هذا الكائن يمكن استخدامه في التسلسل.
setComposeAction(action, composedEmailType)
تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. يمكن لكائن واجهة المستخدم أن يحتوي فقط على مجموعة واحدة من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
يجب أن تحدد المعلمة Action
دالة استدعاء تعرض كائن ComposeActionResponse
تم إعداده باستخدام ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... 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(); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الكائن الذي يحدد إجراء الإنشاء الذي سيتم اتخاذه عند النقر على هذا العنصر. |
composedEmailType | ComposedEmailType | قيمة مصنّفة تحدد ما إذا كانت المسودة التي تم إنشاؤها هي مسودة مستقلة أو مسودة ردّ. |
الإرجاع
Button
: هذا العنصر، لإنشاء سلسلة.
setOnClickAction(action)
تحدِّد هذه السياسة إجراءً يتم تنفيذه عند النقر على العنصر. يمكن أن يحتوي كائن واجهة المستخدم على مجموعة واحدة فقط من
"setOpenLink(openLink)
" أو "setOnClickAction(action)
" أو "setOnClickOpenLinkAction(action)
" أو "setAuthorizationAction(action)
" أو "setComposeAction(action, composedEmailType)
".
يجب أن تحدّد المَعلمة Action
دالة ردّ اتصال تعرِض عنصر 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(); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء الذي يتم اتخاذه عند النقر على هذا العنصر. |
الإرجاع
Button
: هذا العنصر، لإنشاء سلسلة.
setOnClickOpenLinkAction(action)
تُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر. استخدِم هذه الدالة عندما تحتاج إلى إنشاء عنوان URL أو عندما تحتاج إلى اتّخاذ إجراءات أخرى بالإضافة إلى إنشاء عنصر OpenLink
. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد القيم التالية: setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو
setComposeAction(action, composedEmailType)
.
يجب أن تحدّد المَعلمة Action
دالة ردّ اتصال تعرِض عنصر ActionResponse
تمّ إعداده باستخدام 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(); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | العنصر الذي يحدّد إجراء فتح الرابط الذي يجب اتّخاذه عند النقر على هذا العنصر |
الإرجاع
Button
: هذا العنصر، لإنشاء سلسلة.
setOpenLink(openLink)
تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر. استخدِم هذه الدالة عندما يكون عنوان URL معروفًا
ويحتاج فقط إلى فتحه. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى إحدى القيم التالية: setOpenLink(openLink)
أو
setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو
setComposeAction(action, composedEmailType)
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
openLink | OpenLink | عنصر OpenLink يصف عنوان URL المطلوب فتحه |
الإرجاع
Button
: هذا العنصر، لإنشاء سلسلة.
setOverflowMenu(menu)
لضبط قائمة منبثقة يتم فتحها عند النقر على العنصر. يمكن لكل عنصر في القائمة تحديد إجراء لتشغيله عند النقر فوقه. لا تتوفّر القوائم المُدمَجة، ويجب ألّا تحدّد إجراءات عناصر القائمة قائمة كاملة.
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
المعلمات
الاسم | النوع | الوصف |
---|---|---|
menu | OverflowMenu | العنصر الذي يحدّد القائمة الكاملة التي سيتم عرضها عند النقر على هذا العنصر |
الإرجاع
Button
: هذا العنصر، لإنشاء سلسلة.