עיצוב הודעות

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

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

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

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

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

פורמט סמל תחביר לדוגמה הטקסט שמוצג ב-Google Chat
מודגש * *שלום* שלום
נטוי _ (קו תחתון) _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 לטקסט
  • אזכורים של משתמשים
  • היפר-קישורים בהתאמה אישית
  • סמלי אמוג'י בהתאמה אישית

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

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

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

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

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

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

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

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

מטוס סימנייה
אוטובוס מכונית
שעון CONFIRMATION_NUMBER_ICON
תיאור DOLLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
INVITE MAP_PIN
מינוי MULTIPLE_PEOPLE
אדם PHONE
RESTAURANT_ICON SHOPPING_CART
STAR STORE
כרטיס TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

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

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

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

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

כדי להוסיף סמל מותאם אישית, ציינו את השדה iconUrl וציינו את כתובת ה-URL התואמת של הסמל.

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