עיצוב הודעות

בדף הזה נסביר איך אפליקציות Google Chat יכולות לעצב טקסט כדי לשלוח הודעות שמכילות את הפריטים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

התקבלה הודעה ב-Chat עם המילה

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

טיוטת הודעה עם המילה

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

    {
      "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 יכולות לשלוח הודעות טקסט עם @mention של משתמש אחד או של כל המשתמשים במרחב המשותף ב-Chat. כדי להזכיר משתמשים שלא הצטרפו למרחב המשותף או מרחב משותף שנמצא במצב ייבוא, אפליקציות 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, תוכלו גם להשתמש בשיטה people.get כדי לזהות את מזהה המשתמש.

תיוג כל המשתמשים ב-@

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

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

עיצוב טקסט שמופיע בכרטיסים

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

אתם יכולים להשתמש בכלי ליצירת כרטיסים כדי לעצב ולראות תצוגה מקדימה של הודעות וממשקי משתמש לאפליקציות 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.

בקטעים הבאים מוסבר איך להשתמש בסמלים מובנים, בסמלי Google Material או בסמלים מותאמים אישית בטקסט או בלחצנים מעוטרים.

שימוש בסמלים מ-Chat

כדי להשתמש בסמלים מובנים שזמינים ב-Chat, מציינים אחד מהסמלים הבאים:

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

AIRPLANE סימניה
BUS CAR
שעון CONFIRMATION_NUMBER_ICON
תיאור DOLLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
INVITE MAP_PIN
מינוי MULTIPLE_PEOPLE
PERSON PHONE
RESTAURANT_ICON SHOPPING_CART
STAR STORE
TICKET TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

שימוש בסמלי Google Material

אתם יכולים להשתמש בסמלי Google Material כדי לבחור מתוך יותר מ-2, 500 אפשרויות של סמלים ולהתאים אישית את העובי, המילוי והרמה של הסמלים.

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

שימוש בסמלים מותאמים אישית

כדי להוסיף סמל בהתאמה אישית, צריך לכלול את השדה iconUrl ולציין את כתובת ה-URL המתאימה של הסמל.

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