- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- MessageReplyOption
- Prova!
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
).
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
).
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 |
Obbligatorio. Il nome della risorsa dello spazio in cui creare un messaggio. Formato: |
Parametri di query
Parametri | |
---|---|
threadKey |
(Facoltativo) Deprecato: usa invece |
requestId |
(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 |
(Facoltativo) Specifica se un messaggio avvia un thread o risponde a un thread. Funzionalità supportata solo negli spazi denominati. |
messageId |
(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 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, i valori thread ID o inclusi vengono ignorati. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Crea il messaggio come risposta al thread specificato da thread ID o . 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 . Se viene utilizzato un nuovo threadKey , viene creato un nuovo thread. Se la creazione del messaggio non riesce, viene restituito un errore NOT_FOUND . |