Class Navigation

التنقّل

كائن مساعد يتحكّم في التنقّل بين البطاقات. اطّلِع على دليل التنقّل بين البطاقات لمزيد من التفاصيل.

مثال على الاستخدام: 

function myFunction() {
  return AddOnsResponseService.newChatDataActionBuilder();
}

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
popCard()Navigation
popToNamedCard(cardName)Navigation
popToRoot()Navigation
printJson()Stringتعرض هذه الطريقة تمثيل JSON لهذا العنصر.
pushCard(card)Navigationيدفع البطاقة المحدّدة إلى الحزمة.
setEndNavigation(endNavigation)Navigationتضبط هذه السمة إجراء التنقّل النهائي.
updateCard(card)Navigationيستبدل البطاقة الحالية في مكانها.

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

popCard()

متاحة لإضافات Google Workspace التي توسّع نطاق Google Chat.

تعرض هذه الطريقة بطاقة من حزمة التنقّل. يمكن ربطها بإجراءات أخرى للتنقّل بين البطاقات.

الإرجاع

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

popToNamedCard(cardName)

متاحة لإضافات Google Workspace التي توسّع نطاق Google Chat.

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

المعلمات

الاسمالنوعالوصف
cardNameStringتمثّل هذه السمة اسم البطاقة المطلوب الانتقال إليها.

الإرجاع

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

popToRoot()

متاحة لإضافات Google Workspace التي توسّع نطاق Google Chat.

يؤدي إلى إغلاق حزمة البطاقات والرجوع إلى البطاقة الجذر. يمكن ربطها بإجراءات أخرى للتنقّل بين البطاقات.

الإرجاع

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

printJson()

تعرض هذه الطريقة تمثيل JSON لهذا العنصر. يُستخدم هذا الإعداد لتصحيح الأخطاء فقط.

الإرجاع

String

pushCard(card)

يدفع البطاقة المحدّدة إلى الحزمة. يمكن ربطها بإجراءات أخرى للتنقّل بين البطاقات. 

const card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle('Card title'))
    .addSection(cardSection)
    .build();

const navigation = AddOnsResponseService.newNavigation()
    .pushCard(card);

المعلمات

الاسمالنوعالوصف
cardCardبطاقة لإضافتها إلى الحزمة

الإرجاع

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

setEndNavigation(endNavigation)

تضبط هذه السمة إجراء التنقّل النهائي. 

const navigation = AddOnsResponseService.newNavigation()
    .setEndNavigation(AddOnsResponseService.EndNavigation.CLOSE_DIALOG);

المعلمات

الاسمالنوعالوصف
endNavigationEndNavigationتمثّل هذه السمة EndNavigation المطلوب استخدامه.

الإرجاع

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

updateCard(card)

يستبدل البطاقة الحالية في مكانها. يمكن ربطها بإجراءات أخرى متعلقة بالتنقّل بين البطاقات. 

const card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle('Card title'))
    .addSection(cardSection)
    .build();

const navigation = AddOnsResponseService.newNavigation()
    .updateCard(card);

المعلمات

الاسمالنوعالوصف
cardCardبطاقة لاستبدال البطاقة الحالية

الإرجاع

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