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

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

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

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

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

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

ตัวอย่างเช่น โปรดพิจารณา JSON ต่อไปนี้

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

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

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

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

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

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

หากจัดรูปแบบข้อความโดยใช้เมนูรูปแบบใน UI ของ Chat โดยช่อง 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 ที่ระบุโดยอัตโนมัติ

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

ข้อความไปป์และลิงก์เป็นตัวเลือกที่ไม่บังคับ ดังนั้น <https://www.example.com/> และ https://www.example.com/ มีค่าเทียบเท่า

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

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

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

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

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

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

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

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

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

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

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

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

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

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

วิธีใช้ไอคอนในตัวที่มีอยู่ใน Chat ระบุข้อใดข้อหนึ่งต่อไปนี้

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

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

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

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

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

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

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

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