עיצוב הודעות

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

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

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

עיצוב קישורים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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