Method: spaces.messages.create

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

La chiamata di questo metodo richiede autenticazione e supporta i seguenti tipi di autenticazione:

  • Per i messaggi di testo, sono supportate l'autenticazione utente o l'autenticazione delle app.
  • Per i messaggi con carte, è supportata solo l'autenticazione delle app. Solo le app di chat possono creare messaggi di schede.

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 ricerca

Parametri
threadKey
(deprecated)

string

Campo facoltativo. Deprecato: utilizza 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 un thread.name. Ad esempio, vedi Avviare o rispondere a un thread di messaggi.

requestId

string

Campo facoltativo. Un ID richiesta univoco per questo messaggio. Se specifichi un ID richiesta esistente, viene restituito il messaggio creato con quell'ID anziché crearne uno nuovo.

messageReplyOption

enum (MessageReplyOption)

Campo facoltativo. Specifica se un messaggio avvia un thread o risponde a uno di questi thread. Funzionalità supportata solo negli spazi con nome.

messageId

string

Campo facoltativo. Un ID personalizzato per un messaggio. Consente alle app di Chat di ricevere, 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, al contrario di custom-name.
  • Contiene fino a 63 caratteri e solo lettere minuscole, numeri e trattini.
  • È 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 eventuali thread ID o threadKey inclusi.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea il messaggio come risposta al thread specificato da thread ID o threadKey. Se l'operazione non va a buon fine, 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.