จัดรูปแบบข้อความ

หน้านี้จะอธิบายวิธีที่แอป Google Chat จัดรูปแบบข้อความเพื่อส่งข้อความที่มีเนื้อหาต่อไปนี้

• Rich Text ที่มีไฮเปอร์ลิงก์หรือ @พูดถึงผู้ใช้ทั้งหมดในพื้นที่ใน Chat
• ข้อความที่ปรากฏในอินเทอร์เฟซของการ์ด รวมถึงข้อความย่อหน้าหรือข้อความ UI ที่แสดงคู่กับไอคอน เช่น ปุ่ม

จัดรูปแบบข้อความ

Chat ช่วยให้คุณเพิ่มการจัดรูปแบบพื้นฐานให้กับข้อความได้ ซึ่งรวมถึงตัวหนา ตัวเอียง และขีดทับ โดยใช้ชุดย่อยของไวยากรณ์มาร์กดาวน์บางส่วน คุณจัดรูปแบบข้อความใน SMS ต่างจากข้อความในการ์ดเนื่องจากข้อความได้รับการจัดรูปแบบด้วยไวยากรณ์เดียวกันกับที่ผู้ใช้ Chat ใช้

หากต้องการจัดรูปแบบข้อความ ให้ใช้ไวยากรณ์ต่อไปนี้

ตัวอย่างเช่น ลองดู JSON ต่อไปนี้

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

ข้อความที่มีการจัดรูปแบบนี้จะแสดงข้อมูลต่อไปนี้ในพื้นที่ใน Chat

ดูการจัดรูปแบบข้อความที่ส่งในข้อความ

เมื่อผู้ใช้ส่งข้อความ เนื้อหาข้อความธรรมดาจะอยู่ในช่อง text การจัดรูปแบบบางอย่างที่ใช้กับ SMS โดยใช้ไวยากรณ์มาร์กดาวน์จะอยู่ในช่อง text การจัดรูปแบบเพิ่มเติมจะอยู่ในช่อง formattedText เฉพาะเอาต์พุตเท่านั้น ซึ่งรวมถึงรายการต่อไปนี้

• ไวยากรณ์เพิ่มเติมของมาร์กดาวน์สำหรับข้อความ
• การพูดถึงของผู้ใช้
• ไฮเปอร์ลิงก์ที่กำหนดเอง
• อีโมจิที่กำหนดเอง

ตัวอย่างเช่น ลองพิจารณาข้อความต่อไปนี้ที่ผู้ใช้ส่ง

หากจัดรูปแบบข้อความโดยใช้เมนูรูปแบบใน Chat UI ช่อง text จะมีเฉพาะข้อความเท่านั้น ส่วนช่อง formattedText จะมีมาร์กอัป ข้อความ และไฮเปอร์ลิงก์ ตัวอย่างต่อไปนี้แสดงข้อความร่างของข้อความที่มีคำเป็นไฮเปอร์ลิงก์ รายการในรายการ และมีตัวหนา 1 คำ

ข้อความที่ได้รับอยู่ในรูปแบบต่อไปนี้

    {
      "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 ดังกล่าวเป็นข้อความลิงก์และไฮเปอร์ลิงก์ข้อความนั้นไปยัง URL ที่ระบุโดยอัตโนมัติ

หากต้องการระบุข้อความลิงก์สำรองสำหรับลิงก์ของคุณ ให้ใช้ไวยากรณ์ต่อไปนี้

คุณจะใช้เครื่องหมายทับและข้อความลิงก์หรือไม่ก็ได้เพื่อให้ <https://www.example.com/> และ https://www.example.com/ มีค่าเท่ากัน

พูดถึงผู้ใช้ใน SMS

แอปแชทสามารถส่งข้อความที่ @พูดถึงผู้ใช้ 1 คนหรือทั้งหมดในพื้นที่ใน 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-ID ได้ด้วย

@พูดถึงผู้ใช้ทั้งหมด

หากต้องการสร้างข้อความที่ @พูดถึงทุกคนในพื้นที่ทำงาน ให้แทนที่ {user} ด้วย all ตัวอย่าง JSON ต่อไปนี้พูดถึงผู้ใช้ทั้งหมดในข้อความ

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

จัดรูปแบบข้อความที่ปรากฏในการ์ด

ภายในการ์ด ช่องข้อความส่วนใหญ่รองรับการจัดรูปแบบข้อความพื้นฐานโดยใช้ชุดย่อยของแท็ก HTML ขนาดเล็ก คุณจัดรูปแบบข้อความในข้อความการ์ดแตกต่างจากในข้อความตัวอักษร เนื่องจากข้อความตัวอักษรได้รับการจัดรูปแบบด้วยไวยากรณ์เดียวกับที่ผู้ใช้ Chat ใช้

ใช้เครื่องมือสร้างการ์ดเพื่อออกแบบและแสดงตัวอย่างการรับส่งข้อความและอินเทอร์เฟซผู้ใช้สำหรับแอป Chat โดยทำดังนี้

จัดรูปแบบข้อความในย่อหน้า

แท็กที่รองรับและวัตถุประสงค์ของแท็กจะแสดงในตารางต่อไปนี้

เพิ่มไอคอนในข้อความ

คุณสามารถใช้วิดเจ็ต DecoratedText และ ButtonList เพื่อแสดงไอคอนควบคู่ไปกับข้อความในการ์ด

ส่วนต่อไปนี้จะอธิบายวิธีใช้ไอคอนในตัว ไอคอน Material ของ Google หรือไอคอนที่กำหนดเองในข้อความหรือปุ่มที่มีการตกแต่ง

ใช้ไอคอนจาก Chat

หากต้องการใช้ไอคอนในตัวที่มีให้ใช้งานใน Chat ให้ระบุสิ่งใดสิ่งหนึ่งต่อไปนี้

ตารางต่อไปนี้แสดงรายการไอคอนในตัวที่ใช้ได้กับข้อความการ์ด

ต่อไปนี้เป็นตัวอย่างการ์ดที่มีไอคอนอีเมล

ใช้ไอคอน Material ของ Google

คุณสามารถใช้ไอคอน Google Material เพื่อเลือกจากตัวเลือกไอคอนกว่า 2,500 รายการ และปรับแต่งน้ำหนัก พื้นผิว และระดับของไอคอน

ต่อไปนี้คือตัวอย่างการ์ดที่มีไอคอน Google Material

ใช้ไอคอนที่กำหนดเอง

หากต้องการเพิ่มไอคอนที่กำหนดเอง ให้ใส่ช่อง iconUrl และระบุ URL ที่เกี่ยวข้องของไอคอน

ต่อไปนี้เป็นตัวอย่างของไอคอนที่กำหนดเอง: