Class KeyValue

KeyValue

تمّت إزالة هذا العمود. تم إيقاف هذه الفئة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تم إيقاف هذه الفئة نهائيًا. استخدِم DecoratedText بدلاً من ذلك.

الطُرق

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

الطرق المتوقّفة

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
setBottomLabel(text)	KeyValue	تضبط هذه السمة نص التصنيف الذي سيتم استخدامه كمفتاح.
setButton(button)	KeyValue	تضبط هذه السمة Button التي يتم عرضها على يسار السياق.
setContent(text)	KeyValue	تضبط هذه السمة النص الذي سيتم استخدامه كقيمة.
setIcon(icon)	KeyValue	تضبط هذه السمة الرمز الذي سيتم استخدامه كمفتاح.
setIconAltText(altText)	KeyValue	يضبط هذا الإجراء النص البديل للرمز.
setIconUrl(url)	KeyValue	تضبط هذه السمة عنوان URL للرمز الذي سيتم استخدامه كمفتاح.
setMultiline(multiline)	KeyValue	تضبط هذه السمة ما إذا كان يجب عرض نص القيمة في سطر واحد أو عدة أسطر.
setSwitch(switchToSet)	KeyValue	تضبط هذه السمة Switch الذي يظهر على يسار المحتوى.
setTopLabel(text)	KeyValue	تضبط هذه السمة نص التصنيف الذي سيتم استخدامه كمفتاح.

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

addEventAction(eventAction)

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

المَعلمات

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

الإرجاع

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

---

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

المَعلمات

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

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setComposeAction(action, composedEmailType)

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

يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرض عنصر ComposeActionResponse تمّ إعداده باستخدام ComposeActionResponseBuilder.setGmailDraft(draft).

ملاحظة: لا تضبط هذه الطريقة إجراء إنشاء يُستخدم لتوسيع واجهة مستخدم الإنشاء. بدلاً من ذلك، تربط هذه الطريقة عنصر واجهة المستخدم هذا بـ Action الذي ينشئ مسودات رسائل في "برمجة تطبيقات Google"، ويتم فتحها في Gmail عند اكتمال الإجراء.

// ...

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	العنصر الذي يحدّد إجراء الإنشاء الذي سيتم اتخاذه عند النقر على هذا العنصر.
composedEmailType	ComposedEmailType	قيمة تعداد تحدّد ما إذا كانت المسودّة التي تم إنشاؤها مستقلة أو مسودّة ردّ.

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setId(id)

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

المَعلمات

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

الإرجاع

Widget: هذا العنصر، للتسلسل

---

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

المَعلمات

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

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

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

المَعلمات

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

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setOpenLink(openLink)

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

المَعلمات

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

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setVisibility(visibility)

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

المَعلمات

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

الإرجاع

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

الطرق المتوقّفة

setBottomLabel(text)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

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

المَعلمات

الاسم	النوع	الوصف
text	String	نص التصنيف ملاحظة: لا يتيح هذا الخيار تنسيق HTML الأساسي.

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setButton(button)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تضبط هذه السمة Button التي يتم عرضها على يسار السياق. يمكن أن يتضمّن KeyValue زرًا واحدًا أو مفتاحًا واحدًا أو رمزًا واحدًا فقط.

المَعلمات

الاسم	النوع	الوصف
button	Button	الزر المطلوب إضافته

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setContent(text)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

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

المَعلمات

الاسم	النوع	الوصف
text	String	المحتوى النصي لهذه الأداة

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setIcon(icon)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تضبط هذه السمة الرمز الذي سيتم استخدامه كمفتاح.

المَعلمات

الاسم	النوع	الوصف
icon	Icon	إحدى قيم Icon المحدّدة مسبقًا

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setIconAltText(altText)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يضبط هذا الإجراء النص البديل للرمز.

المَعلمات

الاسم	النوع	الوصف
altText	String	النص البديل للرمز

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setIconUrl(url)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تضبط هذه السمة عنوان URL للرمز الذي سيتم استخدامه كمفتاح.

المَعلمات

الاسم	النوع	الوصف
url	String	تمثّل هذه السمة عنوان URL لصورة مستضافة سيتم استخدامها كرمز.

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setMultiline(multiline)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

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

المَعلمات

الاسم	النوع	الوصف
multiline	Boolean	إعداد الأسطر المتعددة

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setSwitch(switchToSet)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تضبط هذه السمة Switch الذي يظهر على يسار المحتوى. يمكن أن يتضمّن KeyValue زرًا واحدًا أو مفتاحًا واحدًا أو رمزًا واحدًا فقط.

المَعلمات

الاسم	النوع	الوصف
switchToSet	Switch	مفتاح التبديل المطلوب إضافته

الإرجاع

KeyValue: هذا العنصر، للتسلسل

---

setTopLabel(text)

تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

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

المَعلمات

الاسم	النوع	الوصف
text	String	نص التصنيف ملاحظة: لا يتيح هذا الخيار تنسيق HTML الأساسي.

الإرجاع

KeyValue: هذا العنصر، للتسلسل