Chip
مع رمز ونص يمكنك إيقاف الشريحة عند الحاجة.
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const chip = CardService.newChip() .setLabel('Open Link') .setOpenLink(CardService.newOpenLink().setUrl( 'https://www.google.com'));
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
set | Chip | لضبط النص البديل للشريحة من أجل تسهيل الاستخدام |
set | Chip | تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر. |
set | Chip | تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. |
set | Chip | لضبط ما إذا كانت الشريحة غير مفعَّلة. |
set | Chip | لضبط الرمز الذي سيتم استخدامه كشريحة. |
set | Chip | تُستخدَم لضبط عنوان الشريحة. |
set | Chip | تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر. |
set | Chip | تُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر. |
set | Chip | تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر. |
مستندات تفصيلية
set Alt Text(altText)
لضبط النص البديل للشريحة من أجل تسهيل الاستخدام في حال عدم ضبط القيمة، يتم ضبطها تلقائيًا على النص الذي يظهر على الشريحة.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
alt | String | النص البديل الذي سيتمّ تعيينه لهذه الشريحة. |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set Authorization Action(action)
تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر. يؤدي ذلك إلى فتح عنوان URL في نافذة جديدة. عندما ينتهي المستخدم من مسار التفويض ويعود إلى التطبيق، تتم إعادة تحميل الإضافة.
لا يمكن ضبط عنصر واجهة المستخدم إلا على أحد القيم التالية: set
أو set
أو set
أو set
أو set
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
action | Authorization | العنصر الذي يحدّد إجراء التفويض الذي يجب اتّخاذه عند النقر على هذا العنصر |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set Compose Action(action, composedEmailType)
تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. يمكن أن يحتوي عنصر واجهة المستخدم على أحد العناصر التالية فقط: set
أو set
أو set
أو
set
أو set
.
يجب أن تحدّد المَعلمة Action
دالة ردّ اتصال تعرِض عنصر Compose
تمّ إعداده باستخدام Compose
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback(e) { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | العنصر الذي يحدّد إجراء الإنشاء الذي يجب اتّخاذه عند النقر على هذا العنصر |
composed | Composed | قيمة مصنّفة تحدد ما إذا كانت المسودة التي تم إنشاؤها هي مسودة مستقلة أو مسودة ردّ. |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set Disabled(disabled)
لضبط ما إذا كانت الشريحة غير مفعَّلة. تكون الشريحة غير مفعّلة باللون الرمادي ولا يمكن النقر عليها.
const chip = CardService.newChip().setLabel('bug Report').setDisabled(true);
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
disabled | Boolean | الحالة "غير مفعّلة" |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set Icon(icon)
set Label(label)
تُستخدَم لضبط عنوان الشريحة. مطلوب.
const chip = CardService.newChip().setLabel('bug Report');
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
label | String | النص المراد عرضه |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set On Click Action(action)
تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد الإعدادات التالية:
set
أو set
أو set
أو set
أو set
.
يجب أن تحدّد المَعلمة Action
دالة ردّ اتصال تعرِض عنصر Action
.
// ... 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 | الإجراء الذي يتم اتّخاذه عند النقر على هذا العنصر. |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set On Click Open Link Action(action)
تُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر. استخدِم هذه الدالة عندما تحتاج إلى إنشاء عنوان URL أو عندما تحتاج إلى اتّخاذ إجراءات أخرى بالإضافة إلى إنشاء عنصر Open
. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد القيم التالية: set
أو set
أو set
أو set
أو
set
.
يجب أن تحدّد المَعلمة Action
دالة ردّ اتصال تعرِض عنصر Action
تمّ إعداده باستخدام Action
.
// ... 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 | العنصر الذي يحدّد إجراء فتح الرابط الذي يجب اتّخاذه عند النقر على هذا العنصر |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.
set Open Link(openLink)
تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر. استخدِم هذه الدالة عندما يكون عنوان URL معروفًا
ويحتاج فقط إلى فتحه. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى إحدى القيم التالية: set
أو
set
أو set
أو set
أو
set
.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
open | Open | عنصر Open يصف عنوان URL المطلوب فتحه |
الإرجاع
Chip
: هذا العنصر، لإنشاء سلسلة.