- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- MessageReplyOption
- Deneyin.
Google Chat alanında mesaj oluşturur. Metinler ve kartlar dahil olmak üzere maksimum ileti boyutu 32.000 bayttır. Örneğin, Mesaj gönderme başlıklı makaleyi inceleyin.
Bu yöntemi çağırmak için kimlik doğrulama gerekir ve aşağıdaki kimlik doğrulama türlerini destekler:
- Kısa mesajlarda kullanıcı kimlik doğrulama veya uygulama kimlik doğrulaması desteklenir.
- Kart mesajları için yalnızca uygulama kimlik doğrulaması desteklenir. (Yalnızca Chat uygulamaları kart mesajı oluşturabilir.)
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ın oluşturulacağı alanın kaynak adı. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
threadKey |
İsteğe bağlı. Kullanımdan kaldırıldı: Bunun yerine |
requestId |
İsteğe bağlı. Bu mesaj için benzersiz bir istek kimliği. Mevcut bir istek kimliği belirtildiğinde, yeni bir mesaj oluşturmak yerine bu kimlikle oluşturulan mesaj döndürülür. |
messageReplyOption |
İsteğe bağlı. Bir iletinin, ileti dizisi mi başlatacağını yoksa bir ileti dizisine yanıt verip vermeyeceğini belirtir. Yalnızca adlandırılmış alanlarda desteklenir. |
messageId |
İsteğe bağlı. Bir ileti için özel kimlik. Mesajın kaynak adında (mesaj Bu alana ilişkin değer, aşağıdaki gereksinimleri 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şturulan 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 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çenek kullanıldığında, eklenen tüm thread ID veya yoksayılır. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Mesajı, thread ID veya tarafından belirtilen mesaj dizisine yanıt olarak oluşturur. Bu işlem başarısız olursa ileti bunun yerine yeni bir ileti dizisi başlatır. |
REPLY_MESSAGE_OR_FAIL |
Mesajı, thread ID veya tarafından belirtilen mesaj dizisine yanıt olarak oluşturur. Yeni bir threadKey kullanılırsa yeni bir ileti dizisi oluşturulur. İleti oluşturulamazsa NOT_FOUND hatası döndürülür. |