Kısa mesaj gönder

Bu sayfada, kullanıcı tarafından yazılmış gibi satır içinde gösterilecek mesajların nasıl oluşturulacağı açıklanmaktadır. Kullanıcılara basit bilgiler sunmak için kısa mesajları kullanın. Sohbette kart oluşturan daha karmaşık mesajlar oluşturma hakkında bilgi edinmek için Kart mesajı gönderme başlıklı makaleye göz atın.

Ön koşullar

Bu kılavuzdaki örnekleri çalıştırmak için aşağıdaki ön koşulları sağlamanız gerekir:

Python

• Python 3.6 veya sonraki sürümler
• pip paket yönetim aracı

• Python için Google istemci kitaplıkları. İstemci kitaplıklarını yükleyin:

  pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client
  

• Chat alanında üyeliği olan yayınlanmış bir Chat uygulaması:

  • Chat uygulaması oluşturmak ve yayınlamak için Cloud Functions ile Google Chat uygulaması oluşturma başlıklı makaleyi inceleyin.
  • Chat alanına Chat uygulaması eklemek için Google Chat'te alanlara veya görüşmelere uygulama ekleme başlıklı makaleyi inceleyin.

• Chat uygulaması için yapılandırılmış yetkilendirme:

  • Hizmet hesabı kimlik doğrulaması tam olarak desteklenir. Hizmet hesabı oluşturmak için Kimlik doğrulaması yapma ve hizmet hesabı olarak yetkilendirme başlıklı makaleyi inceleyin.
  • Geliştirici Önizlemesi: Kullanıcı kimlik doğrulaması, belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı'nın bir parçası olarak desteklenir. Kullanıcı kimlik doğrulamasını ayarlamak için Kullanıcıların kimliğini doğrulama ve yetkilendirme (Geliştirici Önizlemesi) başlıklı makaleye bakın.

Kısa mesajın anatomisi

Google Chat'teki tüm mesajlar JSON nesnesi olarak temsil edilir. Aşağıdaki örnek, basit bir düz metin gövdesi belirten temel bir mesajdır:

{
  "text": "Your pizza delivery is here!"
}

Google Chat'te yayınlandıysa bu örnek aşağıdaki gibi görünür:

Eşzamansız kısa mesaj gönderin

Metin mesajını nasıl oluşturacağınız aşağıda açıklanmıştır:

Python

1. Çalışma dizininizde chat_create_text_message.py adlı bir dosya oluşturun.

2. chat_create_text_message.py uygulamasına aşağıdaki kodu ekleyin:

   from httplib2 import Http
   from oauth2client.service_account import ServiceAccountCredentials
   from apiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['https://www.googleapis.com/auth/chat.bot']
   
   # Specify service account details.
   CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name(
       'service_account.json', SCOPES)
   
   # Build the URI and authenticate with the service account.
   chat = build('chat', 'v1', http=CREDENTIALS.authorize(Http()))
   
   # Create a Chat message.
   result = chat.spaces().messages().create(
   
       # The space to create the message in.
       #
       # Replace SPACE with a space name.
       # Obtain the space name from the spaces resource of Chat API,
       # or from a space's URL.
       parent='spaces/SPACE',
   
       # The message to create.
       body={'text': 'Hello, world!'}
   
   ).execute()
   
   print(result)
   

3. Koddaki SPACE yerine Chat API'sindeki spaces.list() yöntemini veya bir alanın URL'sini kullanarak bir alan adı girin.

4. Çalışma dizininizde örneği oluşturun ve çalıştırın:

   python3 chat_create_text_message.py
   

Mesajlardaki metinleri biçimlendirme

Google Chat; mesaj metnine kalın, italik ve üstü çizili olmak üzere temel biçimlendirme özellikleri eklemenize olanak tanır. Metni biçimlendirmek için aşağıdaki sembollerle sarmalayın:

Biçim	Sembol	Örnek	Sonuç
Kalın	*	*selam*	Merhaba
İtalik	_ (alt çizgi)	_selam_	Merhaba
Üstü Çizili	~	~merhaba~	Merhaba
Sabit boşluklu	` (tırnak işareti)	"merhaba"	hello
Sabit aralıklı blok	``` (üç çift tırnak)	``` Merhaba Dünya ```	Hello World

Örneğin, aşağıdaki JSON'u göz önünde bulundurun:

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

Bu işlem, Chat alanına şöyle bir mesaj yerleştirir:

Bu metin işaretleme söz dizimi, kullanıcılar tarafından yazılan mesajlar için geçerli olan söz dizimiyle aynıdır. Bu nedenle bu değer, kartların içindeki metne uygulanan HTML tabanlı biçimlendirmeden farklıdır.

Mesaj metnindeki bağlantıları dahil et

Mesaj metninize http://example.com/ gibi bir düz bağlantı URL'si eklerseniz Google Chat bunu bağlantı metni olarak kullanır ve bu metni belirtilen URL'ye otomatik olarak köprü olarak ekler.

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

Söz dizimi	Oluşturma
<https://example.com/|LINK_TEXT>	LINK_TEXT

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

Belirli kullanıcılardan @bahsedilen mesajlar

Chat uygulamaları, aşağıdaki söz diziminde USER_ID değerlerini belirterek mesajlarda kullanıcılardan @bahsedebilir. Bir kullanıcıya ait USER_ID'i belirlemek için kullanıcıdan gelen mesajın sender alanını inceleyin.

<users/USER_ID>

Bu dize, belirtilen kullanıcıdan @bahsedilir. Örneğin, aşağıdaki JSON'u dikkate alın:

{
    "text": "Hey <users/123456789012345678901>! Thank you for using _Pizza bot!_"
}

Bu durum aşağıdaki gibi bir sonuç verir:

Tüm kullanıcılardan @bahsedilen mesajlar

Bir alandaki tüm kullanıcı kullanıcılardan @bahsetmek için all kullanıcı kimliğini kullanabilirsiniz. Örneğin:

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