- 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 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.
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ç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 |
Zorunlu. Mesajın oluşturulacağı alanın kaynak adı. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
threadKey |
İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine |
request |
İ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. |
message |
İ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. |
message |
İ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 Bu alanın değeri aşağıdaki şartları karşılamalıdır:
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 öğ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 |
İleti, thread ID veya 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. |