REST Resource: spaces.messages

{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}

string

Nome della risorsa del messaggio.

Formato: spaces/{space}/messages/{message}

dove {space} è l'ID dello spazio in cui viene pubblicato il messaggio e {message} è un ID assegnato dal sistema al messaggio. Ad esempio: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Se imposti un ID personalizzato durante la creazione di un messaggio, puoi utilizzarlo per specificarlo in una richiesta sostituendo {message} con il valore del campo clientAssignedMessageId. Ad esempio: spaces/AAAAAAAAAAA/messages/client-custom-name. Per maggiori dettagli, vedi Assegnare un nome a un messaggio.

object (User)

Solo output. L'utente che ha creato il messaggio. Se l'app Chat si autentica come utente, l'output compila i campi utente name e type.

string (Timestamp format)

(Facoltativo) Immutabile. Per gli spazi creati in Chat, l'ora in cui è stato creato il messaggio. Questo campo viene solo generato, tranne quando viene utilizzato negli spazi in modalità di importazione.

Per gli spazi in modalità di importazione, imposta questo campo sul timestamp storico in cui è stato creato il messaggio nell'origine per conservare l'ora di creazione originale.

string (Timestamp format)

Solo output. L'ultima modifica del messaggio da parte di un utente. Se il messaggio non è mai stato modificato, questo campo è vuoto.

string (Timestamp format)

Solo output. L'ora in cui il messaggio è stato eliminato in Google Chat. Se il messaggio non viene mai eliminato, questo campo è vuoto.

string

Corpo del messaggio in testo normale. Il primo link a un'immagine, un video o una pagina web genera un chip di anteprima. Puoi anche @menzionare un utente di Google Chat o tutte le persone presenti nello spazio.

Per ulteriori informazioni sulla creazione di messaggi di testo, vedi Inviare un messaggio.

string

Solo output. Contiene il messaggio text con markup aggiunti per comunicare la formattazione. Questo campo potrebbe non acquisire tutta la formattazione visibile nella UI, ma include quanto segue:

• Sintassi di markup per grassetto, corsivo, barrato, monospaziale, blocco monospaziale ed elenco puntato.

• L'utente menziona nel formato <users/{user}>.

• Link ipertestuali personalizzati nel formato <{url}|{rendered_text}>, dove la prima stringa corrisponde all'URL e la seconda al testo visualizzato, ad esempio <http://example.com|custom text>.

• Emoji personalizzate nel formato :{emojiName}:, ad esempio :smile:. Non vale per le emoji Unicode, ad esempio U+1F600 per l'emoji di una faccina che sorride.

Per ulteriori informazioni, vedi Visualizzare la formattazione del testo inviata in un messaggio.

object (Card)

Deprecato: usa invece cardsV2.

Schede complete, formattate e interattive che puoi utilizzare per visualizzare elementi dell'interfaccia utente come testi formattati, pulsanti e immagini cliccabili. In genere le schede vengono visualizzate sotto il corpo in testo normale del messaggio. cards e cardsV2 possono avere una dimensione massima di 32 kB.

object (CardWithId)

Un array di schede.

Solo le app di chat possono creare schede. Se la tua app Chat si autentica come utente, i messaggi non possono contenere schede.

Per scoprire come creare un messaggio che contiene schede, vedi Inviare un messaggio.

Progettare e visualizzare l'anteprima delle schede con il generatore di schede.

object (Annotation)

Solo output. Annotazioni associate all'elemento text in questo messaggio.

object (Thread)

Il thread a cui appartiene il messaggio. Ad esempio, vedi Avviare o rispondere a un thread di messaggi.

object (Space)

Se l'app Chat si autentica come utente, l'output compila lo spazio name.

string

Una descrizione in testo normale delle schede del messaggio, utilizzata quando non è possibile visualizzare le schede effettive, ad esempio per le notifiche su dispositivi mobili.

object (ActionResponse)

Solo input. Parametri che un'app di Chat può utilizzare per configurare la modalità di pubblicazione della risposta.

string

Solo output. Corpo in testo normale del messaggio con tutte le menzioni dell'app Chat eliminate.

object (SlashCommand)

Solo output. Informazioni sul comando slash, se applicabili.

object (Attachment)

Allegato caricato dall'utente.

object (MatchedUrl)

Solo output. Un URL in spaces.messages.text che corrisponde a un pattern di anteprima del link. Per ulteriori informazioni, consulta la sezione Link di anteprima.

boolean

Solo output. Quando true, il messaggio è una risposta in un thread di risposta. Quando false, il messaggio è visibile nella conversazione di primo livello dello spazio come primo messaggio di un thread o come messaggio senza risposte in thread.

Se lo spazio non supporta le risposte nei thread, questo campo è sempre false.

string

(Facoltativo) Un ID personalizzato per il messaggio. Puoi utilizzare il campo per identificare un messaggio o per ricevere, eliminare o aggiornare un messaggio. Per impostare un ID personalizzato, specifica il campo messageId quando crei il messaggio. Per maggiori dettagli, vedi Assegnare un nome a un messaggio.

object (EmojiReactionSummary)

Solo output. L'elenco di riepiloghi di reazioni emoji sul messaggio.

object (User)

Immutabile. Input per la creazione di un messaggio, altrimenti solo output. L'utente che può visualizzare il messaggio. Se impostato, il messaggio è privato e visibile solo all'utente specificato e all'app Chat. Per includere questo campo nella richiesta, devi chiamare l'API Chat utilizzando l'autenticazione delle app e omettere quanto segue:

• Collegamenti
• Widget accessori

Per maggiori dettagli, vedi Inviare un messaggio privato.

object (DeletionMetadata)

Solo output. Informazioni su un messaggio eliminato. Viene eliminato un messaggio dopo aver impostato deleteTime.

object (QuotedMessageMetadata)

Solo output. Informazioni su un messaggio citato da un utente di Google Chat in uno spazio. Gli utenti di Google Chat possono citare un messaggio per rispondere.

object (AttachedGif)

Solo output. GIF allegate al messaggio.

object (AccessoryWidget)

Uno o più widget interattivi che vengono visualizzati nella parte inferiore di un messaggio. Puoi aggiungere widget accessori ai messaggi che contengono testo, schede o testo e schede. Non supportata per i messaggi che contengono finestre di dialogo. Per maggiori dettagli, vedi Aggiungere widget interattivi nella parte inferiore di un messaggio.

La creazione di un messaggio con widget accessori richiede l'autenticazione delle app.