- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- MessageReplyOption
- Prova!
Crea un messaggio in uno spazio di Google Chat. La dimensione massima dei messaggi, inclusi testo e schede, è di 32.000 byte. Per un esempio, vedi Inviare 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 |
Obbligatoria. Il nome della risorsa dello spazio in cui creare un messaggio. Formato: |
Parametri di ricerca
Parametri | |
---|---|
threadKey |
Campo facoltativo. Deprecato: utilizza |
requestId |
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 |
Campo facoltativo. Specifica se un messaggio avvia un thread o risponde a uno di questi thread. Funzionalità supportata solo negli spazi con nome. |
messageId |
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 Il valore di questo campo deve soddisfare i seguenti requisiti:
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 inclusi. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Crea il messaggio come risposta al thread specificato da thread ID o . 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 . Se viene utilizzato un nuovo threadKey , viene creato un nuovo thread. Se la creazione del messaggio non riesce, viene restituito un errore NOT_FOUND . |