Method: spaces.messages.create

Crea un messaggio in uno spazio di Google Chat. Per un esempio, vedi Inviare un messaggio.

Il metodo create() richiede l'autenticazione dell'utente o l'autenticazione dell'app. Chat attribuisce il mittente del messaggio in modo diverso a seconda del tipo di autenticazione utilizzato nella richiesta.

L'immagine seguente mostra in che modo Chat attribuisce un messaggio quando utilizzi l'autenticazione app. Chat mostra l'app Chat come mittente del messaggio. I contenuti del messaggio possono includere testo (text), schede (cardsV2) e widget accessori (accessoryWidgets).

Messaggio inviato con autenticazione app

L'immagine seguente mostra in che modo Chat attribuisce un messaggio quando utilizzi l'autenticazione utente. Chat mostra l'utente come mittente del messaggio e attribuisce l'app Chat al messaggio mostrando il relativo nome. Il contenuto del messaggio può contenere solo testo (text).

Messaggio inviato con autenticazione utente

La dimensione massima del messaggio, inclusi i contenuti, è di 32.000 byte.

Per le richieste webhook, la risposta non contiene il messaggio completo. La risposta compila solo i campi name e thread.name, oltre alle informazioni contenute nella richiesta.

Richiesta HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa dello spazio in cui creare un messaggio.

Formato: spaces/{space}

Parametri di query

Parametri
threadKey
(deprecated)

string

(Facoltativo) Deprecato: utilizza thread.thread_key. ID del thread. Supporta fino a 4000 caratteri. Per avviare o aggiungere un messaggio a un thread, crea un messaggio e specifica un threadKey o il thread.name. Per esempi di utilizzo, vedi Avvia o rispondi a un thread di messaggi.
requestId

string

(Facoltativo) Un ID richiesta univoco per questo messaggio. Se viene specificato un ID richiesta esistente, viene restituito il messaggio creato con quell'ID anziché crearne uno nuovo.
messageReplyOption

enum (MessageReplyOption)

(Facoltativo) Specifica se un messaggio avvia un thread o risponde a uno. Funzionalità supportata solo negli spazi denominati.

Quando rispondi alle interazioni degli utenti, questo campo viene ignorato. Per le interazioni all'interno di un thread, la risposta viene creata nello stesso thread. In caso contrario, la risposta viene creata come nuovo thread.
messageId

string

(Facoltativo) Un ID personalizzato per un messaggio. Consente alle app di Chat di recuperare, aggiornare o eliminare un messaggio senza dover memorizzare l'ID assegnato dal sistema nel nome della risorsa del messaggio (rappresentato nel campo name del messaggio).

Il valore di questo campo deve soddisfare i seguenti requisiti:

  • Inizia con client-. Ad esempio, client-custom-name è un ID personalizzato valido, ma custom-name non lo è.
  • Deve contenere fino a 63 caratteri e solo lettere minuscole, numeri e trattini.
  • Deve essere univoco all'interno di uno spazio. Un'app di chat non può utilizzare lo stesso ID personalizzato per messaggi diversi.

Per maggiori dettagli, vedi Assegnare un nome a un messaggio.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Message.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Message appena creata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

MessageReplyOption

Specifica come rispondere a un messaggio. In futuro potrebbero essere aggiunti altri stati.

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED Predefinita. Avvia un nuovo thread. Se utilizzi questa opzione, vengono ignorati tutti i valori thread ID o threadKey inclusi.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea il messaggio come risposta al thread specificato da thread ID o threadKey. In caso di errore, il messaggio avvia un nuovo thread.
REPLY_MESSAGE_OR_FAIL Crea il messaggio come risposta al thread specificato da thread ID o threadKey. Se viene utilizzato un nuovo threadKey, viene creato un nuovo thread. Se la creazione del messaggio non riesce, viene restituito un errore NOT_FOUND.