İ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 diziminin küçük bir alt kümesini kullanarak kısa mesajlara kalın, italik ve üstü çizili gibi temel biçimlendirme özellikleri 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ından 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) _hello_ merhaba
Üstü çizili ~ ~hello~ merhaba
Sabit boşluklu ` (ters tırnak) "merhaba" hello
Sabit boşluklu blok ` ` ` (üç geri tırnak) ```
Hello
World
```
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ş kısa mesaj, Chat alanında şu değeri gösterir:

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

Bir iletide 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 biçimlendirmelerin bir kısmı text alanında yer alı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ının gönderdiği aşağıdaki metni ele alalım:

Chat'te alındı ve kelimeyi içeren mesaj

İ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 olarak gösterildiği bir kısa mesaj taslağı gösterilmektedir:

Şu kelimeyi içeren mesaj taslağı

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

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 ilgili metin için belirtilen URL'ye otomatik olarak köprü ekler.

Bağlantınız için alternatif bağlantı metni sağlamak üzere 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 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 modundaki bir alandaki kullanıcılardan veya alana katılmamış kullanıcılardan bahsedemez.

Belirli kullanıcılardan @bahsedin

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örüntülenir:

Chat uygulaması bir 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ı 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ümesi kullanılarak 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ç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 karakter kalın yazılmıştır.
İtalik "This is <i>italics</i>." Bu değer italik yazılmıştır.
Altı çizili "This is <u>underline</u>." Bu altı çizilidir.
Ü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>." Şu saat biçimi kullanılır: .
Yeni satır "This is the first line. <br> This is a new line." Bu ilk satır.
Bu yeni bir satırdır.

Metne simge ekleyin

Bir kartta metnin yanında simgeleri görüntülemek için DecoratedText ve ButtonList widget'larını kullanabilirsiniz.

Aşağıdaki bölümlerde, yerleşik simgelerin, Google Materyal simgelerinin veya özel simgelerin süslenmiş metinlerde ya da düğmelerde 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:

UÇAK YER İŞARETİ
BUS CAR
SAAT CONFIRMATION_NUMBER_ICON
AÇIKLAMA DOLLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
DAVET ET 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

Google Materyal simgelerini kullanarak 2500'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 Materyal simgesi içeren bir kart örneği verilmiştir:

Özel simgeler kullanma

Özel bir simge eklemek için iconUrl alanını dahil edin ve simgenin karşılık gelen URL'sini belirtin.

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