Method: spaces.messages.create

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

create() yöntemi, kullanıcı 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. İletinin içeriğinde metin (text), kartlar (cardsV2) ve aksesuar widget'ları (accessoryWidgets) yer alabilir.

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.

İleti, kullanıcı kimlik doğrulamasıyla gönderildi

İleti içerikleri de dahil olmak üzere 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 oluşturulacak 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. 4.000 karaktere kadar destekler. Bir ileti dizisi başlatmak veya ileti dizisine eklemek için bir ileti oluşturun ve threadKey ya da thread.name belirtin. Kullanım örnekleri için İleti dizisi başlatma veya yanıtlama başlıklı makaleye bakın.
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 mesajın özel kimliği. Chat uygulamalarının, mesajın kaynak adında (mesaj name alanında gösterilir) sistem tarafından atanmış kimliği depolamasına gerek kalmadan mesaj almasını, güncellemesini veya silmesini sağlar.

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. Chat uygulamaları, farklı mesajlar için aynı özel kimliği kullanamaz.

Ayrıntılar için Mesajı adlandırma 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 gövdesi, 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ılavuzunu inceleyin.

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 İletiyi, thread ID veya threadKey tarafından belirtilen ileti dizisine yanıt olarak oluşturur. Yeni bir threadKey kullanılırsa yeni bir ileti dizisi oluşturulur. İleti oluşturulamazsa bunun yerine bir NOT_FOUND hatası döndürülür.