İletileri biçimlendirme

Google Chat, mesajlara aşağıdakiler de dahil olmak üzere biçimlendirme eklemenize olanak tanır:

Kısa mesajı biçimlendirme

Chat, Markdown söz diziminin küçük bir alt kümesini kullanarak kısa mesaja kalın, italik ve üstü çizili temel biçimlendirmeler eklemenize olanak tanır. Kısa mesajlardaki metin, kart mesajlarındakinden farklı şekilde biçimlendirilir, çünkü kısa mesajlar Chat kullanıcılarının kullandığı söz dizimiyle biçimlendirilir. Kartta görünen metni biçimlendirmek için Kart mesajını biçimlendirme bölümüne bakın.

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österilen metin
Kalın * *merhaba* merhaba
İtalik _ (alt çizgi) _merhaba_ merhaba
Üstü Çizili ~ ~merhaba~ merhaba
Sabit boşluklu ` (geri tırnak) "merhaba" hello
Sabit aralıklı blok ` ` ` (üç geri tırnak) ```
Merhaba
Dünya
```		 Hello
World

Örneğin, aşağıdaki JSON öğesini ele alalım:

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

Bu biçimlendirilmiş kısa mesaj Chat alanında aşağıdakileri gösterir:

Cymbal Pizza uygulaması, teslimatın geldiğini belirten bir kısa mesaj gönderir.

İletide gönderilen metin biçimlendirmesini görüntüleme

Bir kullanıcı ileti 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, aşağıdakiler de dahil olmak üzere yalnızca çıkış formattedText alanında yer alır:

  • Metin için işaretleme söz dizimi
  • Kullanıcı bahisleri
  • Ö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çimlendirilmişse text alanı yalnızca metin, formattedText alanı ise işaretlemeleri, metni ve köprüyü içerir. Aşağıdaki örnekte, köprü bağlantılı bir kelime içeren kısa mesaj taslağı ve başka bir kelimenin kalın harflerle yazılmış hali gösterilmektedir:

Şu kelimeyi içeren mesaj gönder:

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

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

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 belirtilen URL'ye otomatik olarak köprü oluşturur.

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

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

Dikey çizgi 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

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

Belirli kullanıcılardan @bahsedin

Belirli bir kullanıcıdan @bahsetmek için kısa mesaja <users/{user}> ifadesini ekleyin. Buradaki {user}, kullanıcının kimliğidir. Örneğin, 123456789012345678901 değerinin Mahan S kullanıcısının kimliğini temsil ettiği aşağıdaki kısa mesajı göz önünde bulundurun:

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

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

Sohbet uygulaması kısa mesajda bir kişiden bahsediyor.

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.
    • {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ı kullanmak için Google Chat uygulamanızın kullanıcı olarak kimlik doğrulaması yapması gerekir.

  • People API'yi kullanıyorsanız User-ID'yi tanımlamak için people.get yöntemini de kullanabilirsiniz.

Tüm kullanıcılardan @bahsedin

Alandaki herkesten @bahseden bir kısa mesaj oluşturmak için {user} ifadesini all ile değiştirin. Aşağıdaki JSON örneğinde bir iletide tüm kullanıcılardan bahsedilmektedir:

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

Kart mesajını biçimlendirme

Kartların içinde, çoğu metin alanı küçük bir HTML etiketleri alt kümesi kullanarak temel metin biçimlendirmesini destekler. Kısa mesajlar Chat kullanıcılarının kullandığı söz dizimiyle biçimlendirildiğinden, kart mesajlarındaki metni kısa mesajlardakinden farklı şekilde biçimlendirirsiniz. Kısa mesajda görünen metni biçimlendirmek için Kısa mesajı biçimlendirme bölümüne göz atın.

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

Biçim Örnek Oluşturulan sonuç
Kalın "This is <b>bold</b>." Kalın yazı tipiyle yazılmıştır.
İtalik "This is <i>italics</i>." Bu dil italik yazılmıştır.
Altı çizili "This is <u>underline</u>." Bu satır altında çizilir.
Üstü Çizili "This is <s>strikethrough</s>." Bu ü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.
Saat "This is a time format: <time>2023-02-16 15:00</time>." Saat biçimi şu şekildedir: .
Yeni satır "This is the first line. <br> This is a new line. inç Bu ilk satır.
Bu yeni bir satır.

Karta yerleşik simge ekleme

DecoratedText ve ButtonList widget'ları, Chat'te kullanılabilen yerleşik simgelerden birini belirtmek için kullanılan icon öğesini destekler.

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

UÇAK BOOKMARK
BUS ARABA
SAAT CONFIRMATION_NUMBER_ICON
AÇIKLAMA LİRA
E-POSTA EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
OTEL HOTEL_ROOM_TYPE
DAVET ET MAP_PIN
ÜYELİK MULTIPLE_PEOPLE
KİŞİ TELEFON
RESTAURANT_ICON SHOPPING_CART
YILDIZ MAĞAZA
BİLET TRAIN
VIDEO_CAMERA VIDEO_PLAY

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

Karta özel simge ekleme

DecoratedText ve ButtonList widget'ları yerleşik simgeleri kullanmanıza veya kendi özel simgelerinizi tanımlamanıza olanak tanır. Özel bir simge belirtmek için iconUrl öğesini aşağıdaki örnekte gösterildiği gibi kullanın: