עיצוב הודעות

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

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

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

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

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

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

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

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

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

כשמשתמש שולח הודעה, גוף ההודעה בטקסט ללא עיצוב נמצא בשדה 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 שצוינה.

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

השימוש בקווים אנכיים ובטקסט הקישור הם אופציונליים, כך שהערכים <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>."
}

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

אפשר לציין את הערך של 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 ולראות תצוגה מקדימה שלהן:

עיצוב טקסט של פסקה

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

הוספת סמלים לטקסט

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

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

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

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

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

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

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

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

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

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

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

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