Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

İletileri biçimlendirme

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

Köprüler içeren veya bir Chat alanındaki bir ya da tüm kullanıcılardan @bahseden zengin metin.
Kart arayüzünde görünen metinler (ör. paragraf metni veya bir düğmenin yanında gösterilen kullanıcı arayüzü metni)

Kısa mesajı biçimlendirme

Chat, kısa mesajlara 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ındakinden farklı şekilde biçimlendirirsiniz.

Chat API kullanılarak gönderilen veya alınan mesajlar için standart Markdown söz dizimini (MARKUP_SYNTAX_MARKDOWN) ya da Chat işaretleme söz dizimini (MARKUP_SYNTAX_CHAT) kullanabilirsiniz. Google Cloud Console'da uygulama düzeyinde varsayılan bir işaretleme söz dizimi yapılandırabilirsiniz (Google Chat API'yi yapılandırma başlıklı makaleyi inceleyin):

Markdown: Ek uzantılarla birlikte CommonMark spesifikasyonunu temel alan standart Markdown söz dizimi (MARKUP_SYNTAX_MARKDOWN). Yeni oluşturulan Chat uygulamaları varsayılan olarak Markdown'ı kullanır.
Chat: Chat işaretleme söz dizimi (MARKUP_SYNTAX_CHAT). Mevcut Chat uygulamaları, geriye dönük uyumluluğu korumak için varsayılan olarak Chat'i kullanır.

Uygulama düzeyindeki varsayılan ayarı geçersiz kılmak için bağımsız Chat API isteklerinde markup_syntax değerini de belirtebilirsiniz. Bir API isteğinde markup_syntax belirtilmediğinde işaretleme, Chat API'yi nasıl çağırdığınıza göre ayarlanır:

Yapılandırılmış Chat uygulamaları: Chat API Yapılandırması sayfasında kaydedilen İşaretleme söz dizimini kullanır.
Yapılandırılmamış Cloud projeleri (yapılandırmasız): Cloud projeniz, kayıtlı bir Chat uygulaması yapılandırması olmadan Chat API'yi çağırırsa istekler varsayılan olarak MARKUP_SYNTAX_MARKDOWN olur.
Gelen webhook'lar: Varsayılan olarak MARKUP_SYNTAX_CHAT değerine ayarlanır. Gelen webhook'ları kullanarak mesaj gönderme başlıklı makaleyi inceleyin.

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

Biçim	MARKUP_SYNTAX_CHAT	MARKUP_SYNTAX_MARKDOWN	Örnek söz dizimi	Google Chat'te gösterilen metin
Kalın	`*`	`**`	`hello` veya: `hello`	hello
İtalik	`_` (alt çizgi)	`*`	`_hello_` veya: `hello`	hello
Üstü çizili	`~`	`~~`	`~hello~` veya: `~~hello~~`	~~hello~~
Sabit boşluklu	` (ters tırnak)	` (ters tırnak)	`hello`	`hello`
Sabit boşluklu blok	` ` ` (üç ters tırnak)	` ` ` (üç ters tırnak)	``` Hello World ```	`Hello World`
Madde işaretli liste	* veya - (tire) ve ardından boşluk	* veya - (tire) ve ardından boşluk	* Bu, listedeki ilk öğedir. * Bu, listedeki ikinci öğedir.	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir.
İç içe yerleştirilmiş liste	* veya - (kısa çizgi) ve ardından bir boşluk, öncesinde iç içe yerleştirme düzeyi başına dört boşluk	* veya - (kısa çizgi) ve ardından bir boşluk, öncesinde iç içe yerleştirme düzeyi başına dört boşluk	* Bu, listede iç içe yerleştirme derinliği bir olan öğedir. * Bu, listede iç içe yerleştirme derinliği iki olan öğedir. * Bu, listede iç içe yerleştirme derinliği üç olan öğedir.	Bu, listedeki iç içe yerleştirme derinliği bir olan öğedir. Bu, listedeki iç içe yerleştirme derinliği iki olan öğedir. Bu, listedeki iç içe yerleştirme derinliği üç olan öğedir.
Numaralı liste	Desteklenmiyor	1. (sayı, ardından nokta ve boşluk)	1. Bu, listedeki ilk öğedir. 2. Bu, listedeki ikinci öğedir.	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir.
Blok alıntı	> (büyüktür işareti)	> (büyüktür işareti)	>merhaba	merhaba
Köprü	`<hyperlink\|display text>`	`[display text](hyperlink)`	`<https://example.com\|Example website>` veya: `[Example website](https://example.com)`	Örnek web sitesi Köprü oluşturma hakkında daha fazla bilgi edinmek için Bağlantıları biçimlendirme başlıklı makaleyi inceleyin.
Kullanıcıdan bahsetme	`<users/{user}>` (`{user}`, kullanıcı kimliğidir).	`<chat-user data-user="users/{user}">` veya: `<chat-user data-email="{email}">`	`<users/123456789012345678901>` veya `<users/all>` veya: `<chat-user data-user="users/123456789012345678901">`, `<chat-user data-user="users/all">` veya `<chat-user data-email="email@example.com">`	@Mahan S Kullanıcılardan bahsetme hakkında daha fazla bilgi edinmek için Kısa mesajda kullanıcılardan bahsetme başlıklı makaleyi inceleyin.
Custom Emoji	`<customEmojis/{uid}>` veya: `<customEmojis/:{name}:>`	`<chat-emoji data-custom-emoji="customEmojis/{uid}">` veya: `<chat-emoji data-emoji-name=":{name}:">`	`<customEmojis/abc-123-def>` veya: `<customEmojis/:smiley-cat:>` veya: `<chat-emoji data-custom-emoji="customEmojis/abc-123-def">` veya: `<chat-emoji data-emoji-name=":smiley-cat:">`	🐱 (Gülümseyen Kedi özel emojisi)
Alıntı	Desteklenmiyor	`<chat-citation data-id="{id}">{text}</chat-citation>` (`{id}`, `elements` mesajında tanımlanan alıntı kimliğidir).	`<chat-citation data-id="cite_1">cited text</chat-citation>`	alıntılanan metin Alıntılar hakkında daha fazla bilgi edinmek için Kısa mesaja alıntı ekleme başlıklı makaleyi inceleyin.

Ö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, bir Chat alanında aşağıdakileri gösterir:

Cymbal Pizza uygulaması, siparişin teslim edildiğini bildiren bir kısa mesaj gönderir.

Mesajda gönderilen metin biçimlendirmesini görüntüleme

Kullanıcı bir mesaj gönderdiğinde, mesajın düz metin gövdesi text alanında yer alır. Markdown söz dizimi kullanılarak kısa mesaja uygulanan bazı biçimlendirmeler text alanında yer alır. Ek biçimlendirme, salt çıkış formattedText alanında bulunur ve aşağıdakileri içerir:

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

Örneğin, bir kullanıcının gönderdiği aşağıdaki metni ele alalım:

Chat'te şu kelimeyi içeren mesaj alındı:

Mesaj, Chat kullanıcı arayüzündeki Biçim 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ülü olduğu, listedeki öğelerin ve bir kelimenin kalın yazıldığı bir kısa mesaj taslağı gösterilmektedir:

Kelimeyi içeren mesaj taslağı

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

Biçim bağlantıları

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 bağlar.

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

Markdown ile yapılandırılmış API mesajları için standart Markdown bağlantı söz dizimini kullanın:

Örnek söz dizimi Google Chat'te gösterilen metin

[Example website](https://example.com)
Example website
Standart düz metin mesajları için dikey çizgi söz dizimini kullanın:

Örnek söz dizimi Google Chat'te gösterilen metin

<https://example.com|Example website>
Example website

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

Örnek söz dizimi	Google Chat'te gösterilen metin
`[Example website](https://example.com)`	Example website

Örnek söz dizimi	Google Chat'te gösterilen metin
`<https://example.com\|Example website>`	Example website

Kısa mesajda özel emoji kullanma

Sohbet uygulamaları, mesajları kişiselleştirmek için özel emoji içeren kısa mesajlar gönderebilir. Özel emojiler yalnızca Google Workspace kuruluşlarında 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ını 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 ifadesini özel emojinin kimliğiyle değiştirin. Bu kimliği, customEmoji kaynağının name veya emoji_name alanında bulabilirsiniz.

Uygulamanız Markdown söz dizimini kullanarak mesaj gönderiyorsa özel emoji kimliğini kullanarak özel emojileri HTML etiketi biçiminde belirtebilirsiniz:

{
  "text": "Hello <chat-emoji data-custom-emoji=\"customEmojis/CUSTOM_EMOJI_ID\">."
}

Alternatif olarak, özel emoji adını belirtebilirsiniz:

{
  "text": "Hello <chat-emoji data-emoji-name=\"CUSTOM_EMOJI_NAME\">."
}

Bu örnekleri kullanmak için CUSTOM_EMOJI_ID yerine özel emoji kimliğini, CUSTOM_EMOJI_NAME yerine ise özel emoji kısa kod adını girin.

Kısa mesajda kullanıcılardan bahsetme

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

Sessiz mesajlar, kullanıcılardan bahsetmeyi desteklemez. Sessiz mesajda bir bahsetme eklemek hata döndürür.

Belirli kullanıcılardan @bahsetme

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 ifadesinin Mahan S. adlı kullanıcı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>."
}

Uygulamanız Markdown söz dizimini kullanarak mesaj gönderiyorsa kullanıcı kimliğini belirtmek için chat-user HTML etiketi biçimini kullanın:

{
  "text": "Assigning ticket #942 to <chat-user data-user=\"users/123456789012345678901\">."
}

E-posta adresine göre de belirtebilirsiniz:

{
  "text": "Assigning ticket #942 to <chat-user data-email=\"mahan@example.com\">."
}

Kısa mesaj aşağıdaki gibi görünür:

Chat uygulaması, kısa mesajda bir kullanıcıdan bahsettiğinde

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 yöntemlerle belirtebilirsiniz:
- Google Chat User kaynağının name alanını (ör. users/123456789012345678901) kullanın.
- 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ı 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 belirlemek için people.get yöntemini de kullanabilirsiniz.

Tüm kullanıcılardan @bahsetme

Bir alandaki herkesten @bahseden 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!"
}

Uygulamanız Markdown söz dizimini kullanarak mesaj gönderiyorsa chat-user HTML etiketi biçimini kullanarak bahsetmeyi belirtin:

{
  "text": "Important message for <chat-user data-user=\"users/all\">: Code freeze starts at midnight tonight!"
}

Kısa mesaja alıntı ekleme

Chat uygulamaları, kullanıcılara ayrıntılı kaynak bilgileri sağlamak için kısa mesajlara alıntılar ekleyebilir. Kaynakları iki şekilde sağlayabilirsiniz:

Satır içi alıntılar: Kullanıcılar işaretçiyi mesaj metninizin belirli bölümlerinin üzerine getirdiğinde görünen etkileşimli kartlar ekleyin.
Altbilgi kaynakları: Mesajın alt kısmında kaynakların listesini altbilgi bağlantıları olarak gösterir.

Alıntılar yalnızca mesajın markupSyntax değeri MARKUP_SYNTAX_MARKDOWN olarak ayarlandığında desteklenir. Bu özellik yalnızca Chat API kullanılarak eşzamansız mesaj oluşturma yoluyla desteklenir.

Bir mesaja satır içi alıntı eklemek için:

elements mesajının citations listesindeki kaynakları sağlayın ve her Citation nesnesine benzersiz bir id atayın.
İleti metninde, alıntı yapmak istediğiniz metni chat-citation HTML etiketi biçimini kullanarak sarmalayın: <chat-citation data-id="{id}">{text}</chat-citation>. {id} değerinin, elements içinde tanımladığınız kimlikle eşleştiğinden emin olun. Referans verilmeyen alıntılar (eşleşen etiketi olmayanlar) yoksayılır.

{
  "text": "This is a <chat-citation data-id=\"cite_1\">cited</chat-citation> text.",
  "markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
  "elements": {
    "citations": [
      {
        "id": "cite_1",
        "citedSources": [
          {
            "title": "Example Source",
            "uri": "https://example.com"
          }
        ]
      }
    ]
  }
}

Bir mesaja altbilgi kaynakları eklemek için kaynakları mesajın elements citedSources listesinde belirtin. Burada sağlanan tüm kaynaklar, mesajın altında otomatik olarak altbilgi bağlantıları şeklinde görünür ve mesaj metninde satır içi etiketler gerektirmez.

{
  "text": "This is a message with a footer source.",
  "markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
  "elements": {
    "citedSources": [
      {
        "title": "Example Source",
        "uri": "https://example.com"
      }
    ]
  }
}

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çimlendirmeyi destekler. Kısa mesajlar, Chat kullanıcılarının kullandığı söz dizimiyle biçimlendirildiğinden kart mesajlarındaki metinleri kısa mesajlardan farklı şekilde biçimlendirirsiniz.

Chat uygulamaları için mesajlaşma ve kullanıcı arayüzleri tasarlamak ve önizlemek üzere Card Builder'ı kullanın:

Kart Oluşturucu'yu açma

Paragraf metnini biçimlendirme

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

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 metin italik yazılmıştır.
Altı çizili	`"This is <u>underline</u>."`	Bu, altı çizili metindir.
Üstü çizili	`"This is <s>strikethrough</s>."`	Bu metnin ~~üstü çizilidir~~.
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.
Time	`"This is a time format: <time>2023-02-16 15:00</time>."`	Bu bir zaman 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.

Listeleri ve kod bloklarını tanımlamak için aşağıdaki etiketleri kullanın:

Biçim	Örnek	Oluşturulan sonuç
Yeni satır	`"Line 1<br>Line 2"`	Satır 1 Satır 2
Sabit boşluklu	`"This is an <code>inline code</code>."`	Bu bir `inline code`.
Sabit boşluklu blok	`"<pre><code>This a code block.</code></pre>"`	`This is a code block.`
Madde işaretli liste	`"<ul><li>List item 1</li><li>List item 2</li></ul>"`	List item 1 List item 2
Sıralı liste	`"<ol><li>List item 1</li><li>List item 2</li></ol>"`	List item 1 List item 2

Markdown

Markdown söz dizimi etkinleştirildiğinde aşağıdaki söz dizimini kullanabilirsiniz:

Biçim	Örnek	Oluşturulan sonuç
Kalın	merhaba veya __merhaba__	hello
İtalik	merhaba veya _merhaba_	hello
Üstü çizili	~merhaba~	~~hello~~
Sabit boşluklu	`hello`	`hello`
Sabit boşluklu blok	``` Hello World ```	`Hello World`
Madde işaretli liste	- Bu, listedeki ilk öğedir. - Bu, listedeki ikinci öğedir.	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir.
Madde işaretli liste	* Bu, listedeki ilk öğedir * Bu, listedeki ikinci öğedir.	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir.
Sıralı liste	1. Bu, listedeki ilk öğedir. 2. Bu, listedeki ikinci öğedir.	Bu, listedeki ilk öğedir. Bu, listedeki ikinci öğedir.
Köprü	[Örnek web sitesi](https://example.com)	Örnek web sitesi

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üslü metinlerde veya düğmelerde yerleşik simgelerin, Google Materyal simgelerinin ya da ö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:

	AIRPLANE		BOOKMARK
	BUS		CAR
	SAAT		CONFIRMATION_NUMBER_ICON
	AÇIKLAMA		DOLLAR
	E-POSTA		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	DAVET ET		MAP_PIN
	ÜYELİK		MULTIPLE_PEOPLE
	KİŞİ		PHONE
	RESTAURANT_ICON		SHOPPING_CART
	STAR		STORE
	BİLET		EĞİT
	VIDEO_CAMERA		VIDEO_PLAY

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

Google Materyal simgelerini kullanma

2.500'den fazla simge seçeneği arasından seçim yapmak ve simgelerin kalınlığını, dolgusunu ve derecesini ö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 simgeye dair bir örnek verilmiştir: