Method: spaces.messages.create

Google Chat alanında mesaj oluşturur. Örnek için Mesaj gönderme bölümüne bakın.

create() yöntemi için kullanıcı kimlik doğrulaması veya uygulama kimlik doğrulaması gerekir. 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 iletiyi 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.

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 adını görüntüleyerek Chat uygulamasını mesaja bağlar. Mesaj içeriği yalnızca metin (text) içerebilir.

Kullanıcı kimlik doğrulamasıyla gönderilen mesaj

İleti içerikleri de dahil olmak üzere maksimum ileti boyutu 32.000 bayttır.

webhook istekleri için yanıt, iletinin tamamını içermez. Yanıt, istekteki bilgilere ek olarak yalnızca name ve thread.name alanlarını doldurur.

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. En fazla 4.000 karakter desteklenir. Mesaj dizisi başlatmak veya bir mesaj dizisine eklemek için bir mesaj oluşturun ve threadKey veya thread.name belirtin. Örnek kullanım için Mesaj dizisi başlatma veya 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 belirtmek, 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 başlatıp başlatmadığını veya bir mesaj dizisini yanıtlayıp yanıtlamadığını belirtir. Yalnızca adlandırılmış alanlarda desteklenir.

Kullanıcı etkileşimlerine yanıt verirken bu alan yoksayılır. İleti dizisindeki etkileşimler için yanıt, aynı mesaj dizisinde oluşturulur. Aksi takdirde yanıt yeni bir ileti dizisi olarak oluşturulur.
messageId

string

İ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 name alanında temsil edilir) depolamaya gerek kalmadan mesaj almasına, güncellemesine veya silmesine olanak tanır.

Bu alanın değeri aşağıdaki koşulları 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 karakterden oluşmalı ve yalnızca küçük harf, rakam ve kısa çizgi içermelidir.
  • Alan içinde benzersiz olmalıdır. Sohbet uygulamaları, farklı mesajlar için aynı özel kimliği kullanamaz.

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 mesajın 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, dahil edilen tüm thread ID veya threadKey yoksayılır.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD İleti, thread ID veya threadKey ile belirtilen ileti dizisine yanıt olarak oluşturulur. Bu işlem başarısız olursa ileti yerine yeni bir ileti dizisi başlatılır.
REPLY_MESSAGE_OR_FAIL İleti, thread ID veya threadKey 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.