ב-Google Chat אתם יכולים לעצב את ההודעות באמצעות עיצובים בדרכים הבאות:
- עיצוב בסיסי של טקסט, כמו מודגש, נטוי או עם קו חוצה הודעות טקסט וגם הודעות בכרטיס.
- טקסט מקושר.
- אזכור של משתמש אחד או כל המשתמשים באמצעות@ במרחב ב-Chat.
- הוספה של הגדרות מובנות וגם סמלים מותאמים אישית בהודעות עם כרטיסים בלבד.
עיצוב הודעת טקסט
ב-Chat אפשר להוסיף עיצוב בסיסי להודעות טקסט, כולל מודגש, נטוי או עם קו חוצה, על ידי שימוש בקבוצת משנה קטנה של תחביר Markdown. שלך לעצב טקסט בהודעות טקסט באופן שונה מאשר בהודעות בכרטיס, מפני התחביר של ההודעות זהה לזה של Chat. שהמשתמשים משתמשים בהם. כדי לעצב טקסט שמופיע בכרטיס, אפשר לעיין במאמרים הבאים: לעצב הודעה בכרטיס.
כדי לעצב הודעות טקסט, צריך להשתמש בתחביר הבא:
פורמט | סמל | תחביר לדוגמה | הטקסט שמוצג ב-Google Chat |
---|---|---|---|
מודגש | * | *שלום* | שלום |
נטוי | _ (קו תחתון) | _hello_ | שלום |
קו חוצה | ~ | ~שלום~ | |
רווח קבוע | ` (מירכאות חוזרות) | שלום | hello |
בלוק גופן ברוחב אחיד | ` ` ` (שלוש מירכאות כפולות) | ``` Hello World ``` |
Hello |
רשימה עם תבליטים | * או - (מקף) ואחריו רווח | * זהו הפריט הראשון ברשימה * זהו הפריט השני ברשימה |
|
לדוגמה, ראו את קובץ ה-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> |
השימוש בקווים אנכיים ובטקסט של קישור הם אופציונליים, לכן השימוש ב-<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>." |
זהו פורמט שעה: . |
שורה חדשה | "This is the first line. <br> This is a new line. אינץ' |
זו השורה הראשונה. זו שורה חדשה. |
איך מוסיפים סמל מובנה לכרטיס
DecoratedText
וגם
ButtonList
ווידג'טים תומכים ברכיב icon
שמשמש לציון אחד מהסמלים המובנים שזמינים ב-Chat.
בטבלה הבאה מפורטים הסמלים המובנים הזמינים להודעות לגבי כרטיסים:
מטוס | סימנייה | ||
אוטובוס | מכונית | ||
שעון | CONFIRMATION_NUMBER_ICON | ||
תיאור | דולר ארה"ב | ||
אימייל | EVENT_SEAT | ||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
קידום מלונות | HOTEL_ROOM_TYPE | ||
INVITE | MAP_PIN | ||
מועדון החברים | MULTIPLE_PEOPLE | ||
אדם | טלפון | ||
RESTAURANT_ICON | SHOPPING_CART | ||
כוכב | חנות | ||
כרטיס | אימון | ||
VIDEO_CAMERA | VIDEO_PLAY |
דוגמה לכרטיס עם סמל אימייל:
הוספת סמל של Google Material Design לכרטיס
DecoratedText
וגם
ButtonList
ווידג'טים מאפשרים להשתמש בסמלים של חומרי הלימוד של Google
כך שתוכלו לבחור מתוך יותר מ-2,500 אפשרויות סמלים ולהתאים אישית
המשקל, המילוי והציון של הסמלים.
הנה דוגמה לכרטיס עם סמל של חומר לימוד של Google:
הוספת סמל מותאם אישית לכרטיס
DecoratedText
וגם
ButtonList
ווידג'טים מאפשרים לך להשתמש בסמלים המובנים או להגדיר סמלים מותאמים אישית משלך. שפת תרגום
מוסיפים סמל מותאם אישית לכרטיס, מוסיפים את השדה iconUrl
ומציינים את הסמל
בכתובת ה-URL התואמת.
הדוגמה הבאה היא של סמל מותאם אישית: