- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- MessageReplyOption
- Deneyin.
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.
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 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 |
Zorunlu. Mesaj oluşturulacak alanın kaynak adı. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
threadKey |
İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine |
requestId |
İ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 |
İ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 |
İsteğe bağlı. Bir mesajın özel kimliği. Chat uygulamalarının, mesajın kaynak adında (mesaj Bu alanın değeri aşağıdaki şartları karşılamalıdır:
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 öğelerini yoksayar. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
İletiyi, thread ID veya 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 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. |