Method: spaces.messages.create

Bir mesaj oluşturur. Örnek için Mesaj oluşturma başlıklı makaleyi inceleyin.

Kimlik doğrulama gerektirir.

Kısa mesaj oluşturma işlemi hem kullanıcı kimlik doğrulamasını hem de uygulama kimlik doğrulamasını destekler. Kullanıcı kimlik doğrulaması, chat.messages veya chat.messages.create yetkilendirme kapsamının kullanılmasını gerektirir.

Kart mesajı oluşturmak için uygulama kimlik doğrulaması gerekir

Chat, webhook kaydedildiğinde oluşturulan URL'nin bir parçası olarak webhook'lar için kimlik doğrulaması sağladığından webhook'lar, hizmet hesabı veya kullanıcı kimlik doğrulaması olmadan 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

string

Zorunlu. Mesajın oluşturulacağı alanın kaynak adı.

Biçim: spaces/{space}

Sorgu parametreleri

Parametreler
threadKey
(deprecated)

string

İsteğe bağlı. Kullanımdan kaldırıldı: Onun yerine thread.thread_key politikasını kullanın. Opak ileti dizisi tanımlayıcısı. Bir ileti dizisi başlatmak veya bir ileti dizisine eklemek üzere bir ileti oluşturun ve bir threadKey veya thread.name belirtin. Örneğin, Mesaj dizisi başlatma veya mesaj dizisini 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ği belirtildiğinde, yeni bir mesaj oluşturmak yerine bu kimlikle oluşturulan mesaj döndürülür.

messageReplyOption

enum (MessageReplyOption)

İsteğe bağlı. Mesajın bir mesaj dizisi başlattığını veya mesaj dizisine yanıt verip vermediğini belirtir. Yalnızca adlandırılmış alanlarda desteklenir.

messageId

string

İsteğe bağlı. Oluşturulduğunda Chat mesajı için özel bir ad. client- ile başlamalı ve en fazla 63 karakter uzunluğunda küçük harfler, sayılar ve kısa çizgiler içermelidir. Belirtilen değerle mesajı almak, güncellemek veya silmek için bu alanı belirtin. Özel bir ad atanması, bir Chat uygulamasının mesajı oluştururken döndürülen yanıt gövdesindeki name mesajı kaydetmeden mesajı hatırlamasını sağlar. Özel bir ad atanması, oluşturulan name alanının yerine geçmez; mesajın kaynak adı. Bunun yerine, özel adı clientAssignedMessageId alanı olarak ayarlar. Bu alana, mesajı güncelleme veya silme gibi sonraki işlemleri gerçekleştirirken başvuruda bulunabilirsiniz. Örneğin, Oluşturulan bir 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ılavuzuna bakın.

MessageAnswerOption

Bir iletiye nasıl yanıt verileceğini belirtir. İleride daha fazla eyalet eklenebilir.

Sıralamalar
MESSAGE_REPLY_OPTION_UNSPECIFIED Varsayılan. Bir mesaj dizisi başlatır.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Mesajı thread ID veya threadKey tarafından belirtilen mesaj dizisine yanıt olarak oluşturur. Başarısız olursa mesaj, bunun yerine yeni bir mesaj dizisi başlatır.
REPLY_MESSAGE_OR_FAIL Mesajı thread ID veya threadKey tarafından belirtilen mesaj dizisine yanıt olarak oluşturur. Başarısız olursa bunun yerine bir NOT_FOUND hatası döndürülür.