İletileri biçimlendirme

Google Chat, mesajlara aşağıdakiler gibi biçimlendirme özellikleri 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, Chat kullanıcılarının kullandığı söz dizimiyle biçimlendirildiğinden, kısa mesajlardaki metinleri kart mesajlarındakinden farklı şekilde biçimlendirirsiniz. 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 ` (ters tırnak) "merhaba" hello
Sabit aralıklı blok ` ` ` (üç tırnak işareti) ```
Merhaba
Dünya
```		 Hello
World
Madde işaretli liste * veya - (kısa çizgi) ve ardından bir boşluk

* Bu, listedeki ilk öğedir

* Bu, 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ş kısa mesaj bir Chat alanında şu metni gösterir:

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

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

Bir kullanıcı ileti gönderdiğinde, iletinin düz metin gövdesi text alanındadır. Markdown söz dizimi kullanılarak kısa mesaja uygulanan bazı biçimlendirmeler text alanındadır. Ek biçimlendirme, aşağıdakiler de dahil olmak üzere yalnızca çıkış özellikli 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ı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ında yalnızca metin, formattedText alanında ise işaretlemeler, metin ve köprü bulunur. Aşağıdaki örnekte, bir kelimenin köprü bağlantılı olduğu, bir listedeki öğelerin ve bir kelimenin kalın olarak yazıldığı bir kısa mesaj taslağı gösterilmektedir:

Şu kelimeyi içeren ileti taslağı

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

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 söz konusu metnin belirtilen URL'ye otomatik olarak bağlanmasını sağlar.

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ı olduğundan <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 kullanıcılardan 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ı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ı 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:

Chat 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 yollarla belirtebilirsiniz:

    • users/123456789012345678901 gibi Google Chat User kaynağının name alanını 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 kimliğini doğrulaması 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 @bahsedin

Bir 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 iletideki tüm kullanıcılar 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 metinleri 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.

Chat uygulamaları için JSON kartı mesajlarını tasarlamak ve önizlemek üzere Kart Oluşturucu'yu kullanın:

Card Builder'ı açı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>." Bu kalın yazılmıştır.
İtalik "This is <i>italics</i>." Bu italik yazıdır.
Altı çizili "This is <u>underline</u>." Altı çizili.
Üstü çizili "This is <s>strikethrough</s>." Bu, üstü çizilidir.
Yazı tipi rengi "This is <font color=\"#FF0000\">red font</font>." Kırmızı yazı tipi kullanılır.
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, saat biçimi: .
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 Google Materyal Tasarım simgesi ekleme

DecoratedText ve ButtonList widget'ları Google Material simgelerini kullanmanıza olanak tanır. Böylece 2.500'den fazla simge seçeneği arasından seçim yapabilir ve simgelerin ağırlığını, dolgusunu ve derecesini özelleştirebilirsiniz.

Aşağıda, Google Material 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. Bir karta özel simge eklemek için iconUrl alanını dahil edin ve simgenin ilgili URL'sini belirtin.

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