تطبيق يعرض صورة واحدة.
var image = CardService.newImage().setAltText("A nice image").setImageUrl("https://image.png");
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
setAltText(altText) | Image | تعمل هذه السياسة على ضبط النص البديل للصورة لتسهيل الاستخدام. |
setAuthorizationAction(action) | Image | يتم ضبط إجراء تفويض يفتح عنوان URL على مسار التفويض عند النقر على العنصر. |
setComposeAction(action, composedEmailType) | Image | ضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. |
setImageUrl(url) | Image | لضبط الصورة التي سيتم استخدامها من خلال تقديم عنوان URL أو سلسلة البيانات الخاصة بها. |
setOnClickAction(action) | Image | ضبط الإجراء الذي يتم تنفيذه عند النقر على العنصر. |
setOnClickOpenLinkAction(action) | Image | ضبط الإجراء الذي يفتح عنوان URL في علامة تبويب عند النقر على العنصر. |
setOpenLink(openLink) | Image | ضبط عنوان URL ليتم فتحه عند النقر على العنصر. |
المستندات التفصيلية
setAltText(altText)
تعمل هذه السياسة على ضبط النص البديل للصورة لتسهيل الاستخدام. مطلوبة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
altText | String | النص البديل الذي سيتم تحديده لهذه الصورة. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setAuthorizationAction(action)
يتم ضبط إجراء تفويض يفتح عنوان URL على مسار التفويض عند النقر على العنصر. سيؤدّي ذلك إلى فتح عنوان URL في نافذة جديدة. عندما ينهي المستخدم تدفق التفويض ويعود إلى التطبيق، تتم إعادة تحميل الإضافة.
يمكن أن يحتوي كائن واجهة مستخدم على مجموعة واحدة فقط من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
// ... var action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
action | AuthorizationAction | تمثّل هذه السمة العنصر الذي يحدد إجراء التفويض الذي يجب اتخاذه عند النقر على هذا العنصر. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setComposeAction(action, composedEmailType)
ضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. لا يمكن أن يحتوي كائن واجهة مستخدم إلا على مجموعة واحدة من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
يجب أن تتضمن المعلمة Action
دالة رد اتصال تعرض كائن ComposeActionResponse
تم ضبطه باستخدام ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... 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(); }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | تمثّل هذه السمة العنصر الذي يحدِّد الإجراء الذي سيتم اتخاذه عند النقر على هذا العنصر. |
composedEmailType | ComposedEmailType | قيمة تعداد تحدد ما إذا كانت المسودة المكوّنة مسودة مستقلة أو ردًا. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setImageUrl(url)
لضبط الصورة التي سيتم استخدامها من خلال تقديم عنوان URL أو سلسلة البيانات الخاصة بها. مطلوبة.
يمكن أن يكون عنوان URL المُقدَّم إما عنوان URL متاحًا للجميع أو سلسلة صورة مرمَّزة base64.
للحصول على الرمز الثاني، يمكنك استخدام الرمز التالي لإنشاء سلسلة صورة مشفّرة من صورة في Google Drive، ثم تخزين هذه السلسلة لاستخدامها لاحقًا مع setImageUrl(url)
. تمنع هذه الطريقة الإضافات من الوصول إلى عنوان URL متاح للجميع للصور:
// The following assumes you have the image to use in Google Drive and have its ID. var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes(); var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes); // You can store encodeImageURL and use it as a parameter to Image.setImageUrl(url).
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL لصورة مستضافة لاستخدامها أو سلسلة صورة مشفّرة. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setOnClickAction(action)
ضبط الإجراء الذي يتم تنفيذه عند النقر على العنصر. يمكن أن يحتوي كائن واجهة مستخدم على مجموعة واحدة فقط من
setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
يجب أن تحدّد المعلمة Action
دالة رد اتصال تعرض كائن ActionResponse
.
// ... 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(); }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء الذي يجب اتخاذه عند النقر على هذا العنصر. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setOnClickOpenLinkAction(action)
ضبط الإجراء الذي يفتح عنوان URL في علامة تبويب عند النقر على العنصر. استخدِم هذه الدالة عند الحاجة إلى إنشاء عنوان URL أو عندما تحتاج إلى اتخاذ إجراءات أخرى بالإضافة إلى إنشاء الكائن OpenLink
. لا يمكن أن يحتوي كائن واجهة مستخدم إلا على مجموعة واحدة من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو
setComposeAction(action, composedEmailType)
.
يجب أن تتضمن المعلمة Action
دالة رد اتصال تعرض كائن ActionResponse
تم ضبطه باستخدام ActionResponseBuilder.setOpenLink(openLink)
.
// ... 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(); }
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | تمثّل هذه السمة العنصر الذي يحدِّد إجراء الرابط المفتوح الذي يجب اتخاذه عند النقر على هذا العنصر. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.
setOpenLink(openLink)
ضبط عنوان URL ليتم فتحه عند النقر على العنصر. استخدِم هذه الوظيفة إذا كان عنوان URL معروفًا
ولا يتطلّب سوى فتحها. لا يمكن أن يحتوي كائن واجهة مستخدم إلا على مجموعة واحدة من setOpenLink(openLink)
أو setOnClickAction(action)
أو setOnClickOpenLinkAction(action)
أو setAuthorizationAction(action)
أو setComposeAction(action, composedEmailType)
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
openLink | OpenLink | عنصر OpenLink يصف عنوان URL لفتحه. |
تذكرة ذهاب وعودة
Image
— هذا العنصر للسلاسل.