עיצוב הודעות

בדף הזה מוסבר איך אפליקציות של 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 לטקסט
• אזכורים של משתמשים
• היפר-קישורים בהתאמה אישית
• סמלי אמוג'י בהתאמה אישית

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

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

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

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

איך משתמשים באמוג'י בהתאמה אישית בהודעת טקסט

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

כדי ליצור הודעות עם אמוג'י בהתאמה אישית, האפליקציה צריכה להשתמש באימות משתמשים. אי אפשר להשתמש באימוג'י מותאם אישית בהודעות שנוצרו כ-webhook או בהודעות שנוצרו באמצעות אימות אפליקציה.

כדי להוסיף אמוג'י מותאם אישית לטקסט של הודעה, מציינים את name או emoji_name של משאב customEmoji:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

כדי להשתמש בדוגמה הזו, צריך להחליף את CUSTOM_EMOJI_ID במזהה של האמוג'י המותאם אישית. המזהה הזה מופיע בשדה name או emoji_name של משאב customEmoji.

איך מתייגים משתמשים בהודעות טקסט

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

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

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

בנוסף, אפשר להשתמש בתחביר Markdown ובתגים הבאים:

This is a code block.

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

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

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

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

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

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

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

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

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

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

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

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

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

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