Bu sayfa, Cloud Translation API ile çevrilmiştir.

İ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 metin mesajları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 dizimi ile 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:

Cymbal Pizza uygulaması, teslimatın elinize ulaştığını belirten bir kısa mesaj gönderir.

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 bahsetmeler
Özel köprüler
Özel emoji

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

Chat'te "

İleti, Chat kullanıcı arayüzündeki Biçimlendir menüsü kullanılarak biçimlendirildiyse text alanı yalnızca metni, formattedText alanı ise 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 yazıldığı 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 otomatik olarak belirtilen URL'ye 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.

Metin mesajında özel emoji kullanma

Sohbet uygulamaları, mesajları kişiselleştirmek için özel emojilerle kısa mesaj gönderebilir. Özel emojiler yalnızca Google Workspace kuruluşları tarafından kullanılabilir ve yöneticinin kuruluş için özel emojileri etkinleştirmesi gerekir. Daha fazla bilgi için Google Chat'teki özel emojiler hakkında ve Özel emoji izinlerini yönetme başlıklı makaleleri inceleyin.

Özel emoji içeren mesajlar oluşturmak için uygulamanızın kullanıcı kimlik doğrulaması kullanması gerekir. Özel emojiler, webhook olarak oluşturulan mesajlarda veya uygulama kimlik doğrulamasıyla oluşturulan mesajlarda desteklenmez.

Bir mesajın metnine özel emoji eklemek için customEmoji kaynağının name veya emoji_name değerini belirtin:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

Bu örneği kullanmak için CUSTOM_EMOJI_ID değerini özel emojinin kimliğiyle değiştirin. Bu kimliği, customEmoji kaynağının name veya emoji_name alanında bulabilirsiniz.

Kısa mesajlarda kullanıcılardan bahsetme

Chat uygulamaları, bir Chat alanındaki bir veya tüm kullanıcıları @mention ederek kısa mesaj gönderebilir. Alana katılmamış kullanıcılardan veya aktarma modunda olan bir alandan bahsetmek için Chat uygulamalarının mesajı kullanıcı kimlik doğrulamasıyla göndermesi gerekir.

Belirli kullanıcıları @bahsetme

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

Chat uygulamasında bir metin mesajında bir kişiden bahsedilir.

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

Kart Oluşturucu'yu açma

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üdür.
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

Kartta 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 Materyal 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ında kullanılabilen yerleşik simgeler listelenmiştir:

	AIRPLANE		YER İŞARETİ
	BUS		CAR
	SAAT		CONFIRMATION_NUMBER_ICON
	AÇIKLAMA		DOLLAR
	EMAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	INVITE		MAP_PIN
	ÜYELİK		MULTIPLE_PEOPLE
	PERSON		PHONE
	RESTAURANT_ICON		SHOPPING_CART
	YILDIZ		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 simge örneği verilmiştir:

İletileri biçimlendirme Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.