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 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 delle 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 visualizzandone il nome. I contenuti del messaggio possono contenere solo testo (text).

Messaggio inviato con autenticazione utente

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

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: usa invece thread.thread_key. ID del thread. Supporta fino a 4000 caratteri. Per avviare o aggiungere elementi a un thread, crea un messaggio e specifica un threadKey o il thread.name. Ad esempio, vedi Avviare o rispondere 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 un thread. Funzionalità supportata solo negli spazi denominati.

messageId

string

(Facoltativo) Un ID personalizzato per un messaggio. Consente alle app di Chat di recuperare, aggiornare o eliminare un messaggio senza dover archiviare 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, mentre custom-name non lo è.
  • Contiene fino a 63 caratteri e solo lettere minuscole, numeri e trattini.
  • Sia 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, i valori thread ID o threadKey inclusi vengono ignorati.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea il messaggio come risposta al thread specificato da thread ID o threadKey. Se non riesce, 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.