Method: spaces.messages.create

Google Chat alanında mesaj oluşturur. Örnek için Mesaj gönderme başlıklı makaleye bakın.

Aşağıdaki kimlik doğrulama türlerini destekler:

  • Yetkilendirme kapsamıyla uygulama kimlik doğrulaması:
    • https://www.googleapis.com/auth/chat.bot
  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:
    • https://www.googleapis.com/auth/chat.messages.create
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)

Chat, isteğinizde kullandığınız kimlik doğrulama türüne bağlı olarak ileti gönderen kişiyi farklı şekilde ilişkilendirir.

Aşağıdaki resimde, uygulama kimlik doğrulaması kullandığınızda Chat'in bir mesajı nasıl ilişkilendirdiği gösterilmektedir. Chat, mesaj göndereni Chat uygulaması olarak gösterir. Mesajın içeriğinde metin (text), kart (cardsV2) ve aksesuar widget'ları (accessoryWidgets) bulunabilir.

Uygulama kimlik doğrulamasıyla gönderilen ileti

Aşağıdaki resimde, kullanıcı kimlik doğrulamasını kullandığınızda Chat'in bir mesajı nasıl ilişkilendirdiği gösterilmektedir. Chat, kullanıcıyı mesaj gönderen olarak gösterir ve adını göstererek Chat uygulamasını mesajla ilişkilendirir. İleti içeriği yalnızca metin (text) içerebilir.

Kullanıcı kimlik doğrulamasıyla gönderilen ileti

İleti içeriği de dahil olmak üzere maksimum ileti boyutu 32.000 bayttır.

Webhook isteklerinde yanıt, mesajın tamamını içermiyor. Yanıtta, istekte yer alan bilgilere ek olarak yalnızca name ve thread.name alanları dolduruluyor.

HTTP isteği

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Mesajın oluşturulacağı alanın kaynak adı.

Biçim: spaces/{space}

Sorgu parametreleri

Parametreler
threadKey
(deprecated)

string

İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine thread.thread_key kullanın. İleti dizisinin kimliği. En fazla 4.000 karakter desteklenir. Bir ileti dizisi başlatmak veya ileti dizisine ekleme yapmak için bir mesaj oluşturun ve threadKey veya thread.name simgesini belirtin. Kullanım örneği için Mesaj dizisi başlatma veya yanıtlama başlıklı makaleyi inceleyin.
requestId

string

İsteğe bağlı. Bu mesaj için benzersiz bir istek kimliği. Mevcut bir istek kimliğini belirtmek, yeni bir mesaj oluşturmak yerine bu kimlikle oluşturulan mesajı döndürür.
messageReplyOption

enum (MessageReplyOption)

İsteğe bağlı. Bir mesajın ileti dizisi başlatıp başlatmayacağını veya bir ileti dizisini yanıtlayıp yanıtlamayacağını belirtir. Yalnızca adlandırılmış alanlarda desteklenir.

Kullanıcı etkileşimlerine yanıt verirken bu alan yoksayılır. Bir ileti dizisindeki etkileşimlerde yanıt aynı ileti dizisinde oluşturulur. Aksi takdirde yanıt yeni bir ileti dizisi olarak oluşturulur.
messageId

string

İsteğe bağlı. İleti için özel kimlik. Sohbet uygulamalarının, sisteme atanan kimliği mesajın kaynak adında (mesaj name alanında gösterilir) depolamasına gerek kalmadan mesaj almasına, güncellemesine veya silmesine olanak tanır.

Bu alanın değeri aşağıdaki koşulları karşılamalıdır:

  • client- ile başlar. Örneğin, client-custom-name geçerli bir özel kimliktir ancak custom-name geçerli değildir.
  • En fazla 63 karakter içerir ve yalnızca küçük harf, rakam ve kısa çizgi içerebilir.
  • Bir alan içinde benzersiz olmalıdır. Bir sohbet uygulaması, farklı mesajlar için aynı özel kimliği kullanamaz.

Ayrıntılar için İletileri adlandırma başlıklı makaleyi inceleyin.
createMessageNotificationOptions

object (CreateMessageNotificationOptions)

İsteğe bağlı. İleti yayınlandığında bildirim davranışını kontrol eder. Daha fazla bilgi için Bildirimleri zorunlu kılma veya sessiz mesaj gönderme başlıklı makaleyi inceleyin.

İstek metni

İstek metni, Message öğesinin bir örneğini içerir.

Yanıt metni

Başarılı olursa yanıt metni, yeni oluşturulan bir Message örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

MessageReplyOption

Bir iletiye nasıl yanıt verileceğini belirtir. Gelecekte daha fazla eyalet eklenebilir.

Sıralamalar
MESSAGE_REPLY_OPTION_UNSPECIFIED Varsayılan. Yeni bir ileti dizisi başlatır. Bu seçeneği kullandığınızda eklenen tüm thread ID veya threadKey yoksayılır.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD thread ID veya threadKey ile belirtilen ileti dizisine yanıt olarak mesaj oluşturur. İşlem başarısız olursa mesaj yeni bir ileti dizisi başlatır.
REPLY_MESSAGE_OR_FAIL thread ID veya threadKey ile belirtilen ileti dizisine yanıt olarak mesaj oluşturur. Yeni bir threadKey kullanılıyorsa yeni bir ileti dizisi oluşturulur. İleti oluşturma işlemi başarısız olursa bunun yerine NOT_FOUND hatası döndürülür.

CreateMessageNotificationOptions

Mesaj yayınlandığında bildirim davranışıyla ilgili seçenekler.

JSON gösterimi 
{
  "notificationType": enum (NotificationType)
}
Alanlar
notificationType

enum (NotificationType)

Mesajın bildirim türü.

NotificationType

İleti için bildirim türü seçenekleri.

Sıralamalar
NOTIFICATION_TYPE_NONE Varsayılan davranış. Bildirim davranışı, kullanıcının mesajı Chat kullanıcı arayüzünü kullanarak göndermesiyle aynıdır: Gönderene bildirim gönderilmez.
NOTIFICATION_TYPE_FORCE_NOTIFY

Alıcılara zorla bildirim gönderin. Bu işlem, kullanıcıların alan bildirim ayarlarını ve Chat'teki Rahatsız Etmeyin ayarlarını atlar. Bu seçenek, cihaz düzeyindeki Rahatsız Etmeyin ayarlarını atlamaz.

Uygulama kimlik doğrulaması gerektirir.
NOTIFICATION_TYPE_SILENT

Alıcılar Chat'te Rahatsız Etmeyin'i etkinleştirmiş veya alanı sessize almış gibi bildirimi sessize alın.

Uygulama kimlik doğrulaması gerektirir.