Class Grid

الشبكة

شبكة منظَّمة لعرض مجموعة من عناصر الشبكة

متاحة لإضافات Google Workspace وتطبيقات Google Chat 

const grid = CardService.newGrid().setTitle('My Grid').setNumColumns(2).addItem(
    CardService.newGridItem().setTitle('My item'));

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
addItem(gridItem)Gridتضيف هذه السمة عنصر شبكة جديدًا إلى الشبكة.
setAuthorizationAction(action)Gridيضبط هذا الإعداد إجراء تفويض يفتح عنوان URL لمسار التفويض عند النقر على العنصر.
setBorderStyle(borderStyle)Gridتضبط هذه السمة نمط الحدود الذي يتم تطبيقه على كل عنصر من عناصر الشبكة.
setComposeAction(action, composedEmailType)Gridتضبط هذه السمة إجراءً ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setNumColumns(numColumns)Gridعدد الأعمدة المطلوب عرضها في الشبكة
setOnClickAction(action)Gridتضبط هذه السمة إجراءً يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Gridتضبط هذه السمة إجراءً يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Gridتضبط هذه السمة عنوان URL ليتم فتحه عند النقر على العنصر.
setTitle(title)Gridتضبط هذه السمة نص عنوان الشبكة.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

مستندات تفصيلية

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المعلمات

الاسمالنوعالوصف
eventActionEventActionتمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل.

addItem(gridItem)

تضيف هذه السمة عنصر شبكة جديدًا إلى الشبكة.

المعلمات

الاسمالنوعالوصف
gridItemGridItemعنصر الشبكة المطلوب إضافته

الإرجاع

Grid: هذا الكائن، للتسلسل

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);

المعلمات

الاسمالنوعالوصف
actionAuthorizationActionالعنصر الذي يحدّد إجراء التفويض الذي سيتم اتخاذه عند النقر على هذا العنصر.

الإرجاع

Grid: هذا الكائن، للتسلسل

setBorderStyle(borderStyle)

تضبط هذه السمة نمط الحدود الذي يتم تطبيقه على كل عنصر من عناصر الشبكة. القيمة التلقائية هي NO_BORDER.

المعلمات

الاسمالنوعالوصف
borderStyleBorderStyleنمط الحد المطلوب تطبيقه.

الإرجاع

Grid: هذا الكائن، للتسلسل

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(e) {
  const thread = GmailApp.getThreadById(e.threadId);
  const draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

المعلمات

الاسمالنوعالوصف
actionActionالعنصر الذي يحدّد إجراء الإنشاء الذي سيتم اتخاذه عند النقر على هذا العنصر.
composedEmailTypeComposedEmailTypeقيمة تعداد تحدّد ما إذا كانت المسودة التي تم إنشاؤها مستقلة أو مسودة رد.

الإرجاع

Grid: هذا الكائن، للتسلسل

setId(id)

تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.

المعلمات

الاسمالنوعالوصف
idStringمعرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا الكائن، للتسلسل

setNumColumns(numColumns)

عدد الأعمدة المطلوب عرضها في الشبكة إذا تم عرضها في اللوحة الجانبية اليمنى، يمكنك عرض عمود واحد أو عمودَين، والقيمة التلقائية هي 1. إذا تم عرضها في مربّع حوار، يمكنك عرض عمودَين أو ثلاثة، والقيمة التلقائية هي 2.

المعلمات

الاسمالنوعالوصف
numColumnsIntegerتمثّل هذه السمة عدد الأعمدة.

الإرجاع

Grid: هذا الكائن، للتسلسل

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();
}

المعلمات

الاسمالنوعالوصف
actionActionالإجراء المطلوب اتّخاذه عند النقر على هذا العنصر.

الإرجاع

Grid: هذا الكائن، للتسلسل

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();
}

المعلمات

الاسمالنوعالوصف
actionActionالعنصر الذي يحدّد إجراء فتح الرابط الذي سيتم اتخاذه عند النقر على هذا العنصر.

الإرجاع

Grid: هذا الكائن، للتسلسل

تضبط هذه السمة عنوان URL ليتم فتحه عند النقر على العنصر. استخدِم هذه الدالة عندما يكون عنوان URL معروفًا ويجب فتحه فقط. يمكن أن يتضمّن عنصر واجهة المستخدم قيمة واحدة فقط من setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

المعلمات

الاسمالنوعالوصف
openLinkOpenLinkتمثّل هذه السمة عنصر OpenLink يصف عنوان URL المطلوب فتحه.

الإرجاع

Grid: هذا الكائن، للتسلسل

setTitle(title)

تضبط هذه السمة نص عنوان الشبكة. يجب أن يكون النص سلسلة عادية بدون تنسيق.

المعلمات

الاسمالنوعالوصف
titleStringنص العنوان

الإرجاع

Grid: هذا الكائن، للتسلسل

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.

المعلمات

الاسمالنوعالوصف
visibilityVisibilityVisibility الأداة

الإرجاع

Widget — العنصر، للتسلسل.