Method: spaces.messages.create

Google Chat alanında mesaj oluşturur. Ö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

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ı: Bunun yerine thread.thread_key kullanın. İleti dizisinin kimliği. 4.000 karaktere kadar desteklenir. Bir mesaj dizisi başlatmak veya mesaj dizisine ekleme yapmak için bir mesaj oluşturup threadKey veya thread.name belirtin. Örneğin kullanımı, Bir 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 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ı. 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

string

İsteğe bağlı. Bir ileti için özel kimlik. Mesajın kaynak adında (mesaj name alanında gösterilir) sistem tarafından atanan kimliği depolamaya gerek kalmadan Chat uygulamalarının mesaj almasına, güncellemesine veya silmesine olanak tanır.

Bu alana ilişkin değer, aşağıdaki gereksinimleri karşılamalıdır:

  • Şununla başlar: client-. Örneğin, client-custom-name geçerli bir özel kimlik olsa da custom-name geçerli bir özel kimlik değildir.
  • En fazla 63 karakter ve yalnızca küçük harf, rakam ve kısa çizgi içerebilir.
  • Bir alan içinde benzersizdir. Chat uygulamaları farklı mesajlar için aynı özel kimliği kullanamaz.

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 threadKey yoksayılır.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Mesajı, thread ID veya threadKey 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 threadKey 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.