Method: spaces.messages.create

Google Chat alanında mesaj oluşturur. Örnek için Mesaj gönderme bölümüne bakın.

create() yöntemi, kullanıcı kimlik doğrulaması veya uygulama kimlik doğrulaması gerektirir. Chat, isteğinizde kullandığınız kimlik doğrulama türüne bağlı olarak mesajı göndereni farklı şekilde ilişkilendirir.

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

Uygulama kimlik doğrulamasıyla gönderilen mesaj

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 Chat uygulamasını, adını göstererek mesajla ilişkilendirir. İletinin içeriği yalnızca metin (text) içerebilir.

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

İleti içeriği dahil maksimum ileti boyutu 32.000 bayttır.

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 eklemek için bir ileti oluşturun ve threadKey ya da thread.name belirtin. Örnek kullanım 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ğinin belirtilmesi, 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, mesaj dizisi mi başlatacağını yoksa bir mesaj dizisine yanıt mı vereceğini belirtir. Yalnızca adlandırılmış alanlarda desteklenir.
messageId

string

İsteğe bağlı. Bir ileti için özel kimlik. Chat uygulamalarının, sistem tarafından atanan kimliği mesajın kaynak adında (mesajın name alanında temsil edilir) depolamaya gerek kalmadan mesajı almasına, güncellemesine veya silmesine olanak tanır.

Bu alanın değeri aşağıdaki şartları 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 ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir.
  • Bir alan içinde benzersiz olmalıdır. Sohbet uygulamaları, farklı mesajlar için aynı özel kimliği kullanamaz.

Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

İstek içeriği

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

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş 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ılavuzuna bakın.

MessageReplyOption

Bir iletinin nasıl yanıtlanacağını belirtir. Gelecekte daha fazla eyalet eklenebilir.

Sıralamalar
MESSAGE_REPLY_OPTION_UNSPECIFIED Varsayılan. Yeni bir ileti dizisi başlatır. Bu seçeneğin kullanılması, dahil edilen tüm thread ID veya threadKey öğelerini yoksayar.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD İletiyi, thread ID veya threadKey tarafından belirtilen ileti dizisine yanıt olarak oluşturur. Başarısız olursa ileti, bunun yerine yeni bir ileti dizisi başlatır.
REPLY_MESSAGE_OR_FAIL İleti, thread ID veya threadKey ile belirtilen ileti dizisine yanıt olarak oluşturulur. Yeni bir threadKey kullanılırsa yeni bir ileti dizisi oluşturulur. Mesaj oluşturma işlemi başarısız olursa bunun yerine bir NOT_FOUND hatası döndürülür.