İletileri biçimlendirme

Bu sayfada, Google Chat uygulamalarının metni nasıl biçimlendirerek aşağıdakilerden herhangi birini içeren mesajlar gönderebileceği açıklanmaktadır:

• Sohbet alanındaki bir veya tüm kullanıcıları @mention eden ya da köprü bağlantıları içeren zengin metin.
• Paragraf metni veya düğme gibi bir simgenin yanında görüntülenen kullanıcı arayüzü metni dahil olmak üzere kart arayüzünde görünen metin.

Kısa mesajı biçimlendirme

Chat, Markdown söz diziminde bulunan küçük bir alt kümeyi kullanarak bir metin mesajına kalın, italik ve üstü çizili gibi temel biçimlendirmeler eklemenize olanak tanır. Kısa mesajlar, Chat kullanıcılarının kullandığı söz dizimiyle biçimlendirildiğinden, kısa mesajlardaki metinleri kart mesajlarından farklı şekilde biçimlendirirsiniz.

Kısa mesajları biçimlendirmek için aşağıdaki söz dizimini kullanın:

Örneğin, aşağıdaki JSON'u ele alalım:

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

Bu biçimlendirilmiş kısa mesaj, Chat alanında şu değeri gösterir:

Bir mesajda gönderilen metin biçimlendirmesini görüntüleme

Kullanıcı bir ileti gönderdiğinde, ileti metninin düz metin hali text alanında yer alır. Markdown söz dizimi kullanılarak kısa mesaja uygulanan biçimlendirmelerin bir kısmı text alanında yer alır. Aşağıdakiler dahil olmak üzere ek biçimlendirme, yalnızca çıkış formattedText alanında yer alır:

• Metin için ek Markdown söz dizimi
• Kullanıcı bahisleri
• Özel köprüler
• Özel emoji

Örneğin, bir kullanıcı tarafından gönderilen şu metni ele alalım:

Mesaj, Chat kullanıcı arayüzündeki Biçim menüsü kullanılarak biçimlendirilmişse text alanında yalnızca metin bulunurken formattedText alanı işaretlemeleri, metni ve köprüyü içerir. Aşağıdaki örnekte bir kısa mesaj taslağında köprü bağlantılı bir kelime, listedeki öğeler ve bir kelimenin kalın yazı tipiyle gösterilmesi gösterilmektedir:

İleti şu biçimde alınır:

    {
      "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*?",
    }

Bağlantıları biçimlendir

Mesaj metninize http://www.example.com/ gibi bir düz bağlantı URL'si eklerseniz Google Chat, bunu bağlantı metni olarak kullanır ve ilgili metin için belirtilen URL'ye otomatik olarak köprü ekler.

Bağlantınız için alternatif bağlantı metni sağlamak üzere aşağıdaki söz dizimini kullanın:

Boru ve bağlantı metni isteğe bağlıdır. Bu nedenle <https://www.example.com/> ve https://www.example.com/ eşdeğerdir.

Kısa mesajda kullanıcılardan bahsetme

Sohbet uygulamaları, Chat alanındaki bir veya tüm kullanıcılardan @bahseden kısa mesajlar gönderebilir. Chat uygulamaları, içe aktarma modundaki bir alandaki kullanıcılardan veya alana katılmamış kullanıcılardan bahsedemez.

Belirli kullanıcılardan @bahsedin

Belirli bir kullanıcıyı @mention etmek için kısa mesaja <users/{user}> ekleyin. Burada {user}, kullanıcının kimliğidir. Örneğin, 123456789012345678901 ürününün, Melda S kullanıcısının kimliğini temsil ettiği aşağıdaki kısa mesajı ele alalım:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Kısa mesaj şu şekilde görüntülenir:

users/{user} değerini aşağıdaki şekillerde belirtebilirsiniz:

• Google Chat uygulamanız kullanıcı tarafından gönderilen bir mesaja yanıt veriyorsa MESSAGE etkileşim etkinliğinin message.sender.name alanını kullanabilirsiniz.

• Google Chat uygulamanız eşzamansız kısa mesaj oluşturuyorsa users/{user} değerini aşağıdaki şekillerde belirtebilirsiniz:

  • Google Chat User kaynağının name alanını kullanın (ör. users/123456789012345678901).
  • Kullanıcının e-posta adresini {user} değeri için takma ad olarak kullanın. Örneğin, e-posta adresi mahan@example.com ise kullanıcıyı users/mahan@example.com olarak belirtebilirsiniz. E-posta takma adını kullanmak için Google Chat uygulamanızın kullanıcı olarak kimlik doğrulaması yapması gerekir.

• People API'yi kullanıyorsanız kullanıcı kimliğini tanımlamak için people.get yöntemini de kullanabilirsiniz.

@tüm kullanıcılardan bahset

Bir alandaki herkesi @bahseten bir kısa mesaj oluşturmak için {user} yerine all yazın. Aşağıdaki JSON örneğinde, bir mesajdaki tüm kullanıcılardan bahsedilmektedir:

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

Kartlarda görünen metni biçimlendirme

Kartların içindeki çoğu metin alanı, HTML etiketlerinin küçük bir alt kümesini kullanarak temel metin biçimlendirmesini destekler. Kart mesajlarındaki metinler, Chat kullanıcılarının kullandığı söz dizimi ile biçimlendirildiği için bu mesajlardaki metinleri kısa mesajlardakinden farklı şekilde biçimlendirirsiniz.

Chat uygulamaları için mesajlaşma ve kullanıcı arayüzlerini tasarlamak ve önizlemek üzere Kart Oluşturucu'yu kullanın:

Paragraf metnini biçimlendirme

Desteklenen etiketler ve amaçları aşağıdaki tabloda gösterilmektedir:

Metne simge ekleyin

Karttaki metnin yanında simge göstermek için DecoratedText ve ButtonList widget'larını kullanabilirsiniz.

Aşağıdaki bölümlerde, süslenmiş metin veya düğmelerde yerleşik simgelerin, Google Material simgelerinin veya özel simgelerin nasıl kullanılacağı açıklanmaktadır.

Chat'teki simgeleri kullanma

Chat'te bulunan yerleşik simgeleri kullanmak için aşağıdakilerden birini belirtin:

Aşağıdaki tabloda kart mesajları için kullanılabilen yerleşik simgeler listelenmiştir:

Aşağıda, e-posta simgesi içeren bir kart örneği verilmiştir:

Google Material simgelerini kullanma

2.500'den fazla simge seçeneği arasından seçim yapmak ve simgelerin kalınlığını, doluluğunu ve sınıfını özelleştirmek için Google Materyal simgelerini kullanabilirsiniz.

Aşağıda, Google Material simgesi içeren bir kart örneği verilmiştir:

Özel simgeler kullanma

Özel simge eklemek için iconUrl alanını ekleyin ve simgenin ilgili URL'sini belirtin.

Aşağıda, bir özel simge örneği verilmiştir: