עיצוב הודעות

ב-Google Chat אתם יכולים לעצב את ההודעות באמצעות עיצובים בדרכים הבאות:

• עיצוב בסיסי של טקסט, כמו מודגש, נטוי או עם קו חוצה הודעות טקסט וגם הודעות בכרטיס.
• טקסט מקושר.
• אזכור של משתמש אחד או כל המשתמשים באמצעות@ במרחב ב-Chat.
• הוספה של הגדרות מובנות וגם סמלים מותאמים אישית בהודעות עם כרטיסים בלבד.

עיצוב הודעת טקסט

ב-Chat אפשר להוסיף עיצוב בסיסי להודעות טקסט, כולל מודגש, נטוי או עם קו חוצה, על ידי שימוש בקבוצת משנה קטנה של תחביר Markdown. שלך לעצב טקסט בהודעות טקסט באופן שונה מאשר בהודעות בכרטיס, מפני התחביר של ההודעות זהה לזה של Chat. שהמשתמשים משתמשים בהם. כדי לעצב טקסט שמופיע בכרטיס, אפשר לעיין במאמרים הבאים: לעצב הודעה בכרטיס.

כדי לעצב הודעות טקסט, צריך להשתמש בתחביר הבא:

פורמט	סמל	תחביר לדוגמה	הטקסט שמוצג ב-Google Chat
מודגש	*	*שלום*	שלום
נטוי	_ (קו תחתון)	_hello_	שלום
קו חוצה	~	~שלום~	שלום
רווח קבוע	` (מירכאות חוזרות)	שלום	hello
בלוק גופן ברוחב אחיד	` ` ` (שלוש מירכאות כפולות)	``` Hello World ```	Hello World
רשימה עם תבליטים	* או - (מקף) ואחריו רווח	* זהו הפריט הראשון ברשימה * זהו הפריט השני ברשימה	זהו הפריט הראשון ברשימה זה הפריט השני ברשימה

לדוגמה, ראו את קובץ ה-JSON הבא:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

בהודעת הטקסט המעוצבת הזו רואים את הדברים הבאים ב-Chat רווח:

הצגת עיצוב הטקסט שנשלח בהודעה

כשמשתמש שולח הודעה, גוף ההודעה בטקסט פשוט נמצא ב שדה text. עיצוב מסוים שחל על הודעת הטקסט באמצעות Markdown נמצא בשדה text. עיצוב נוסף נמצא ב שדה formattedText שמיועד לפלט בלבד, כולל:

• תחביר Markdown נוסף לטקסט
• אזכורים של משתמשים
• היפר-קישורים בהתאמה אישית
• סמלי אמוג'י בהתאמה אישית

נניח, לדוגמה, את הטקסט הבא שנשלח על ידי משתמש:

אם ההודעה מעוצבת באמצעות התפריט עיצוב בממשק המשתמש של Chat, השדה text מכיל את הטקסט בלבד, השדה formattedText מכיל את תגי העיצוב, הטקסט וההיפר-קישור. בדוגמה הבאה מוצגת טיוטה של הודעת טקסט עם מילה עם היפר-קישור, פריטים ברשימה, ומילה אחת מודגשת:

ההודעה מתקבלת בפורמט הבא:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

עיצוב קישורים

אם תכללו כתובת אתר פשוטה של קישור בטקסט ההודעה, כמו http://www.example.com/, הטקסט הזה משמש ב-Google Chat כטקסט של הקישור מבצע היפר-קישור אוטומטי של הטקסט לכתובת ה-URL שצוינה.

כדי להוסיף טקסט חלופי לקישור, צריך להשתמש בתחביר הבא:

תחביר לדוגמה	הטקסט שמוצג ב-Google Chat
<https://example.com|Example website>	Example website

השימוש בקווים אנכיים ובטקסט של קישור הם אופציונליים, לכן השימוש ב-<https://www.example.com/> וב- הערכים https://www.example.com/ מקבילים.

אזכור משתמשים בהודעת טקסט

אפליקציות צ'אט יכולות שליחת הודעות טקסט שמאזכרים משתמש אחד או את כל המשתמשים במרחב ב-Chat. באפליקציות ל-Chat אסור לאזכר משתמשים שטח שנמצא במצב ייבוא או כל משתמש עדיין לא הצטרפו למרחב המשותף.

אזכור של משתמשים ספציפיים באמצעות @

כדי לאזכר משתמש ספציפי באמצעות @, צריך להוסיף את <users/{user}> להודעת הטקסט שבה {user} הוא המזהה של המשתמש. לדוגמה, נבחן את הטקסט הבא הודעה שבה 123456789012345678901 מייצג את המזהה של המשתמש Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

הודעת הטקסט מוצגת כך:

אפשר לציין את הערך של users/{user} בדרכים הבאות:

• אם אפליקציית Google Chat מגיבה להודעה שנשלחה על ידי אתם יכולים להשתמש בשדה message.sender.name של אירוע אינטראקציה אחד (MESSAGE).

• אם אפליקציית Google Chat יוצרת הודעת טקסט אסינכרונית, אפשר לציין את הערך של users/{user} בדרכים הבאות:

  • שימוש בשדה name ב-Google Chat משאב User, כמו users/123456789012345678901
  • שימוש בכתובת האימייל של המשתמש ככינוי של הערך של {user}. עבור לדוגמה, אם כתובת האימייל היא [email protected], תוכלו לציין המשתמש בתור users/[email protected]. כדי להשתמש בכתובת אימייל חלופית, חובה להשתמש באפליקציית Google Chat אימות כמשתמשים

• אם אתם משתמשים ב-People API, תוכלו גם שיטת people.get כדי לזהות את מזהה המשתמש.

אזכור של כל המשתמשים באמצעות @

כדי ליצור הודעת טקסט עם אזכור של כל מי שבמרחב המשותף באמצעות @, צריך להחליף את {user} עם all. בדוגמה הבאה ל-JSON מציינים את כל המשתמשים בהודעה:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

איך מעצבים הודעת כרטיס

בתוך הכרטיסים, רוב שדות הטקסט תומכים בעיצוב טקסט בסיסי באמצעות קבוצת משנה של תגי HTML. העיצוב של הטקסט בהודעות בכרטיס שונה מהעיצוב שלהן בטקסט בגלל שהודעות הטקסט מעוצבות עם אותו תחביר משתמשי הצ'אט. כדי לעצב טקסט שיופיע בהודעת טקסט: לראות עיצוב של הודעת טקסט.

---

אתם יכולים להשתמש בכלי ליצירת כרטיסים כדי לעצב הודעות של כרטיסי JSON ולהציג אותן בתצוגה מקדימה בשביל אפליקציות ל-Chat:

לפתיחת הכלי ליצירת כרטיסים

---

התגים הנתמכים והמטרה שלהם מוצגים בקטעים הבאים טבלה:

פורמט	דוגמה	תוצאה לאחר עיבוד
מודגש	"This is <b>bold</b>."	הטקסט הזה מודגש.
נטוי	"This is <i>italics</i>."	הטקסט הזה נטוי.
קו תחתון	"This is <u>underline</u>."	זהו קו תחתון.
קו חוצה	"This is <s>strikethrough</s>."	זהו קו חוצה.
צבע גופן	"This is <font color=\"#FF0000\">red font</font>."	זהו גופן אדום.
Hyperlink	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	זהו היפר-קישור.
שעה	"This is a time format: <time>2023-02-16 15:00</time>."	זהו פורמט שעה: 2023-02-16 15:00.
שורה חדשה	"This is the first line. <br> This is a new line. אינץ'	זו השורה הראשונה. זו שורה חדשה.

איך מוסיפים סמל מובנה לכרטיס

DecoratedText וגם ButtonList ווידג'טים תומכים ברכיב icon שמשמש לציון אחד מהסמלים המובנים שזמינים ב-Chat.

בטבלה הבאה מפורטים הסמלים המובנים הזמינים להודעות לגבי כרטיסים:

flight	מטוס	bookmark	סימנייה
directions_bus	אוטובוס	directions_car	מכונית
schedule	שעון	confirmation_number	CONFIRMATION_NUMBER_ICON
subject	תיאור	attach_money	דולר ארה"ב
mail	אימייל	event_seat	EVENT_SEAT
flight_land	FLIGHT_ARRIVAL	flight_takeoff	FLIGHT_DEPARTURE
hotel	קידום מלונות	grade	HOTEL_ROOM_TYPE
insert_invitation	INVITE	location_on	MAP_PIN
card_membership	מועדון החברים	people	MULTIPLE_PEOPLE
person	אדם	local_phone	טלפון
restaurant	RESTAURANT_ICON	shopping_cart	SHOPPING_CART
grade	כוכב	store	חנות
local_play	כרטיס	train	אימון
videocam	VIDEO_CAMERA	play_circle_filled	VIDEO_PLAY

דוגמה לכרטיס עם סמל אימייל:

הוספת סמל של Google Material Design לכרטיס

DecoratedText וגם ButtonList ווידג'טים מאפשרים להשתמש בסמלים של חומרי הלימוד של Google כך שתוכלו לבחור מתוך יותר מ-2,500 אפשרויות סמלים ולהתאים אישית המשקל, המילוי והציון של הסמלים.

הנה דוגמה לכרטיס עם סמל של חומר לימוד של Google:

הוספת סמל מותאם אישית לכרטיס

DecoratedText וגם ButtonList ווידג'טים מאפשרים לך להשתמש בסמלים המובנים או להגדיר סמלים מותאמים אישית משלך. שפת תרגום מוסיפים סמל מותאם אישית לכרטיס, מוסיפים את השדה iconUrl ומציינים את הסמל בכתובת ה-URL התואמת.

הדוגמה הבאה היא של סמל מותאם אישית: