עיצוב הודעות

ב-Google Chat אפשר לעצב את ההודעות, למשל:

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

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

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

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

* זהו הפריט הראשון ברשימה

* זהו הפריט השני ברשימה
  • זה הפריט הראשון ברשימה
  • זהו הפריט השני ברשימה

לדוגמה, עבור ה-JSON הבא:

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

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

אפליקציית Cymbal Pizza תשלח הודעת טקסט שהמשלוח הגיע.

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

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

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

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

התקבלה הודעה בצ'אט עם המילה

במקרה שההודעה מעוצבת באמצעות התפריט Format בממשק המשתמש של 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*?",
    }

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

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

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

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

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

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

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

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

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

הודעת הטקסט תופיע כך:

אפליקציית Chat מזכירה אדם בהודעת טקסט.

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

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

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

    • משתמשים בשדה name במשאב User של Google Chat, למשל users/123456789012345678901.
    • שימוש בכתובת האימייל של המשתמש ככינוי לערך {user}. לדוגמה, אם כתובת האימייל היא mahan@example.com, אפשר לציין את המשתמש בתור users/mahan@example.com. כדי להשתמש בכתובת אימייל חלופית, אפליקציית Google Chat צריכה לבצע אימות כמשתמש.

  • אם אתם משתמשים ב-People API, תוכלו גם להשתמש ב-method 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>." זהו גופן אדום.
היפר-קישור "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.

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

טיסה BOOKMARK
BUS רכב
שעון CONFIRMATION_NUMBER_ICON
תיאור דולר ארה"ב
אימייל EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
קידום מלון HOTEL_ROOM_TYPE
הזמנה MAP_PIN
מינוי MULTIPLE_PEOPLE
אדם טלפון
RESTAURANT_ICON SHOPPING_CART
כוכב חנות
כרטיס TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

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

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

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

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

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

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