İ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:

• Chat alanındaki bir veya tüm kullanıcılardan köprü ya da @bahsetme 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 dizimine göre biçimlendirildiği için kısa mesajlardaki metinleri kart mesajlarındakinden farklı şekilde biçimlendirirsiniz.

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

Biçim	Sembol	Örnek söz dizimi	Google Chat'te görüntülenen metin
Kalın	*	*merhaba*	merhaba
İtalik	_ (alt çizgi)	_merhaba_	merhaba
Üstü çizili	~	~hello~	merhaba
Sabit boşluklu	` (ters tırnak)	`merhaba`	hello
Sabit boşluklu blok	` ` ` (üç ters tırnak)	``` Merhaba Dünya ```	Hello World
Madde işaretli liste	* veya - (tire) ve ardından boşluk	* Bu, listedeki ilk öğedir * Listedeki ikinci öğedir	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir

Ö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ş metin mesajı, Chat alanında şunları 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 bazı biçimlendirmeler text alanındadır. Aşağıdakiler dahil olmak üzere ek biçimlendirme, yalnızca çıkış formattedText alanındadır:

• Metin için ek Markdown söz dizimi
• Kullanıcılardan bahsetme
• Ö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 kelimenin köprülendiği, öğelerin listede yer aldığı ve bir kelimenin kalın olarak gösterildiği bir kısa mesaj taslağı gösterilmektedir:

İleti aşağıdaki 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çimlendirme

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

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

Örnek söz dizimi	Google Chat'te görüntülenen metin
<https://example.com|Example website>	Example website

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 mesajlarda 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 modunda olan bir alandaki veya alana katılmamış kullanıcılardan bahsedemez.

Belirli kullanıcılardan @bahsedin

Belirli bir kullanıcıdan @bahsetmek için kısa mesaja <users/{user}> ekleyin. Burada {user} kullanıcının kimliğidir. Örneğin, 123456789012345678901'nin Mahan S. kullanıcısının kimliğini temsil ettiği aşağıdaki metin mesajını düşünün:

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

Kısa mesaj şu şekilde gösterilir:

users/{user} değerini aşağıdaki yöntemlerle 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 yöntemlerle belirtebilirsiniz:

  • Google Chat User kaynağının name alanını kullanın (ör. users/123456789012345678901).
  • {user} değeri için kullanıcının e-posta adresini takma ad olarak kullanın. Örneğin, e-posta adresi [e-mail] ise kullanıcıyı users/[e-mail] 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ıları @bahsetme

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üzleri tasarlayıp önizlemek üzere Kart Oluşturucu'yu kullanın:

Kart Oluşturucu'yu açın

---

Paragraf metnini biçimlendirme

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

Biçim	Örnek	Oluşturulan sonuç
Kalın	"This is <b>bold</b>."	Bu metin kalın yazılmıştır.
İtalik	"This is <i>italics</i>."	Bu italik.
Altı çizili	"This is <u>underline</u>."	Bu altı çizili.
Üstü çizili	"This is <s>strikethrough</s>."	Bu üstü çizili metindir.
Yazı tipi rengi	"This is <font color=\"#FF0000\">red font</font>."	Bu kırmızı yazı tipidir.
Köprü	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Bu bir köprü.
Saat	"This is a time format: <time>2023-02-16 15:00</time>."	Bu bir saat biçimidir: 2023-02-16 15:00.
Yeni satır	"This is the first line. <br> This is a new line."	Bu ilk satırdır. Bu yeni bir satırdır.

Metne simge ekleme

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:

	UÇAK		YER İŞARETİ
	BUS		ARABA
	SAAT		CONFIRMATION_NUMBER_ICON
	AÇIKLAMA		DOLLAR
	EMAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	DAVET		MAP_PIN
	ÜYELİK		MULTIPLE_PEOPLE
	PERSON		TELEFON
	RESTAURANT_ICON		SHOPPING_CART
	STAR		MAĞAZA
	TICKET		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

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 Materyal 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 özel bir simgeye örnek verilmiştir: