Class Grid

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الشبكة

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

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
addItem(gridItem)Gridلإضافة عنصر جديد إلى الشبكة إلى الشبكة.
setAuthorizationAction(action)Gridيتم ضبط إجراء تفويض يفتح عنوان URL على مسار التفويض عند النقر على العنصر.
setBorderStyle(borderStyle)Gridلضبط نمط الحدود الذي يتم تطبيقه على كل عنصر من عناصر الشبكة.
setComposeAction(action, composedEmailType)Gridضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setNumColumns(numColumns)Gridعدد الأعمدة المطلوب عرضها في الشبكة.
setOnClickAction(action)Gridضبط الإجراء الذي يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Gridضبط الإجراء الذي يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Gridضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setTitle(title)Gridتعمل على ضبط نص عنوان الشبكة.

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

addItem(gridItem)

لإضافة عنصر جديد إلى الشبكة إلى الشبكة.

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


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

المعلّمات

الاسمالنوعالوصف
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).

// ...

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

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


setNumColumns(numColumns)

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

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


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

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


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

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


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

المعلّمات

الاسمالنوعالوصف
openLinkOpenLinkعنصر OpenLink يصف عنوان URL لفتحه.

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.


setTitle(title)

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

المعلّمات

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

تذكرة ذهاب وعودة

Grid — هذا العنصر للسلاسل.