REST Resource: spaces.messages

Risorsa: Messaggio

Un messaggio in uno spazio di Google Chat.

Rappresentazione JSON 
{
  "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)
    }
  ]
}
Campi
name

string

Identificatore. 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 per il messaggio. Ad esempio: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Se imposti un ID personalizzato quando crei un messaggio, puoi utilizzarlo per specificare il messaggio 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.
sender

object (User)

Solo output. L'utente che ha creato il messaggio. Se la tua app di chat esegue l'autenticazione come utente, l'output compila i campi user name e type.
createTime

string (Timestamp format)

(Facoltativo) Immutabile. Per gli spazi creati in Chat, l'ora in cui è stato creato il messaggio. Questo campo è solo di output, 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.
lastUpdateTime

string (Timestamp format)

Solo output. L'ora in cui il messaggio è stato modificato per l'ultima volta da un utente. Se il messaggio non è mai stato modificato, questo campo è vuoto.
deleteTime

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.
text

string

(Facoltativo) Corpo del messaggio in formato 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 tutti gli utenti dello spazio.

Per informazioni su come creare messaggi di testo, vedi Inviare un messaggio.
formattedText

string

Solo output. Contiene il messaggio text con i markup aggiunti per comunicare la formattazione. Questo campo potrebbe non acquisire tutta la formattazione visibile nell'interfaccia utente, ma include quanto segue:

  • Sintassi di markup per grassetto, corsivo, sbarrato, monospazio, blocco monospazio ed elenco puntato.

  • Menzioni degli utenti utilizzando il formato <users/{user}>.

  • Link ipertestuali personalizzati che utilizzano il formato <{url}|{rendered_text}>, in cui la prima stringa è l'URL e la seconda è il testo visualizzato, ad esempio <http://example.com|custom text>.

  • Emoji personalizzate utilizzando il formato :{emojiName}:, ad esempio :smile:. Questa impostazione non si applica alle emoji Unicode, ad esempio U+1F600 per un'emoji con una faccia sorridente.

Per ulteriori informazioni, vedi Visualizzare la formattazione del testo inviata in un messaggio.
cards[]
(deprecated)

object (Card)

Deprecato: utilizza cardsV2.

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

object (CardWithId)

(Facoltativo) Un array di schede.

Solo le app di Chat possono creare schede. Se l'app Chat esegue l'autenticazione come utente, i messaggi non possono contenere schede.

Per scoprire come creare un messaggio contenente schede, consulta Invia un messaggio.

Progetta e visualizza l'anteprima delle schede con Card Builder.

Apri il generatore di schede
annotations[]

object (Annotation)

Solo output. Annotazioni associate a text in questo messaggio.
thread

object (Thread)

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

object (Space)

Solo output. Se la tua app Chat esegue l'autenticazione come utente, l'output compila solo space name.
fallbackText

string

(Facoltativo) Una descrizione in formato testo semplice delle schede del messaggio, utilizzata quando le schede effettive non possono essere visualizzate, ad esempio nelle notifiche mobile.
actionResponse

object (ActionResponse)

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

string

Solo output. Il corpo del messaggio in formato di testo normale con tutte le menzioni dell'app Chat rimosse.
slashCommand

object (SlashCommand)

Solo output. Informazioni sui comandi slash, se applicabile.
attachment[]

object (Attachment)

(Facoltativo) Allegato caricato dall'utente.
matchedUrl

object (MatchedUrl)

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

boolean

Solo output. Quando true, il messaggio è una risposta in un thread di risposte. 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.
clientAssignedMessageId

string

(Facoltativo) Un ID personalizzato per il messaggio. Puoi utilizzare il campo per identificare un messaggio o per recuperarlo, eliminarlo o aggiornarlo. Per impostare un ID personalizzato, specifica il campo messageId quando crei il messaggio. Per maggiori dettagli, vedi Assegnare un nome a un messaggio.
emojiReactionSummaries[]

object (EmojiReactionSummary)

Solo output. L'elenco dei riepiloghi delle reazioni con emoji al messaggio.
privateMessageViewer

object (User)

(Facoltativo) 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 di chat. Per includere questo campo nella richiesta, devi chiamare l'API Chat utilizzando l'autenticazione dell'app e omettere quanto segue:

Per maggiori dettagli, vedi Inviare un messaggio privato.
deletionMetadata

object (DeletionMetadata)

Solo output. Informazioni su un messaggio eliminato. Un messaggio viene eliminato quando viene impostato deleteTime.
quotedMessageMetadata

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.
attachedGifs[]

object (AttachedGif)

Solo output. Immagini GIF allegate al messaggio.
accessoryWidgets[]

object (AccessoryWidget)

(Facoltativo) Uno o più widget interattivi visualizzati nella parte inferiore di un messaggio. Puoi aggiungere widget di accessori ai messaggi che contengono testo, schede o entrambi. Non supportato per i messaggi che contengono dialoghi. Per maggiori dettagli, vedi Aggiungere widget interattivi in fondo a un messaggio.

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

CardWithId

Una scheda in un messaggio di Google Chat.

Solo le app di Chat possono creare schede. Se la tua app Chat esegue l'autenticazione come utente, il messaggio non può contenere schede.

Progetta e visualizza l'anteprima delle schede con Card Builder.

Apri il generatore di schede

Rappresentazione JSON 
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Campi
cardId

string

Obbligatorio se il messaggio contiene più schede. Un identificatore univoco per una scheda in un messaggio.
card

object (Card)

Una scheda. La dimensione massima è 32 kB.

Annotazione

Solo output. Annotazioni associate al corpo del messaggio in formato testo normale. Per aggiungere la formattazione di base a un messaggio, consulta Formattare i messaggi.

Esempio di corpo del messaggio di testo normale:

Hello @FooBot how are you!"

I metadati delle annotazioni corrispondenti:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
Rappresentazione JSON 
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campi
type

enum (AnnotationType)

Il tipo di annotazione.
length

integer

Lunghezza della sottostringa nel corpo del messaggio di testo normale a cui corrisponde questa annotazione.
startIndex

integer

Indice iniziale (inclusivo, basato su 0) nel corpo del messaggio di testo normale a cui corrisponde questa annotazione.
Campo unione metadata. Metadati aggiuntivi sull'annotazione. metadata può essere solo uno dei seguenti:
userMention

object (UserMentionMetadata)

I metadati della menzione dell'utente.
slashCommand

object (SlashCommandMetadata)

I metadati di un comando slash.
customEmojiMetadata

object (CustomEmojiMetadata)

I metadati di un'emoji personalizzata.

AnnotationType

Tipo di annotazione.

Enum
ANNOTATION_TYPE_UNSPECIFIED Valore predefinito per l'enum. Non utilizzare.
USER_MENTION Un utente viene menzionato.
SLASH_COMMAND Viene richiamato un comando slash.
CUSTOM_EMOJI Un'annotazione di emoji personalizzata.

UserMentionMetadata

Metadati delle annotazioni per le menzioni degli utenti (@).

Rappresentazione JSON 
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Campi
user

object (User)

L'utente menzionato.
type

enum (Type)

Il tipo di menzione dell'utente.

Tipo

Enum
TYPE_UNSPECIFIED Valore predefinito per l'enum. Non utilizzare.
ADD Aggiungi l'utente allo spazio.
MENTION Menziona l'utente nello spazio.

SlashCommandMetadata

Metadati delle annotazioni per i comandi slash (/).

Rappresentazione JSON 
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Campi
bot

object (User)

L'app di chat il cui comando è stato richiamato.
type

enum (Type)

Il tipo di comando slash.
commandName

string

Il nome del comando slash richiamato.
commandId

string (int64 format)

L'ID comando del comando slash richiamato.
triggersDialog

boolean

Indica se il comando slash è per una finestra di dialogo.

Tipo

Enum
TYPE_UNSPECIFIED Valore predefinito per l'enum. Non utilizzare.
ADD Aggiungi l'app Chat allo spazio.
INVOKE Richiamare il comando slash nello spazio.

RichLinkMetadata

Un link avanzato a una risorsa.

Rappresentazione JSON 
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  }
  // End of list of possible types for union field data.
}
Campi
uri

string

L'URI di questo link.
Campo unione data. Dati della risorsa collegata. data può essere solo uno dei seguenti:

RichLinkType

Il tipo di link avanzato. In futuro potrebbero essere aggiunti altri tipi.

Enum
DRIVE_FILE Un tipo di link avanzato di Google Drive.
CHAT_SPACE Un tipo di link avanzato dello spazio di Chat. Ad esempio, uno smart chip per spazi.

DriveLinkData

Dati per i link di Google Drive.

Rappresentazione JSON 
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Campi
driveDataRef

object (DriveDataRef)

Un DriveDataRef che fa riferimento a un file di Google Drive.
mimeType

string

Il tipo MIME della risorsa di Google Drive collegata.

ChatSpaceLinkData

Dati per i link degli spazi di Chat.

Rappresentazione JSON 
{
  "space": string,
  "thread": string,
  "message": string
}
Campi
space

string

Lo spazio della risorsa dello spazio di Chat collegato.

Formato: spaces/{space}
thread

string

Il thread della risorsa dello spazio di Chat collegato.

Formato: spaces/{space}/threads/{thread}
message

string

Il messaggio della risorsa dello spazio di Chat collegato.

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

CustomEmojiMetadata

Metadati delle annotazioni per le emoji personalizzate.

Rappresentazione JSON 
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
Campi
customEmoji

object (CustomEmoji)

L'emoji personalizzata.

Thread

Un thread in uno spazio di Google Chat. Per un esempio di utilizzo, vedi Avviare o rispondere a un thread di messaggi.

Se specifichi un thread quando crei un messaggio, puoi impostare il campo messageReplyOption per determinare cosa succede se non viene trovato alcun thread corrispondente.

Rappresentazione JSON 
{
  "name": string,
  "threadKey": string
}
Campi
name

string

Identificatore. Nome della risorsa del thread.

Esempio: spaces/{space}/threads/{thread}
threadKey

string

(Facoltativo) Input per la creazione o l'aggiornamento di un thread. In caso contrario, solo output. ID del thread. Supporta fino a 4000 caratteri.

Questo ID è univoco per l'app di chat che lo imposta. Ad esempio, se più app di chat creano un messaggio utilizzando la stessa chiave del thread, i messaggi vengono pubblicati in thread diversi. Per rispondere a un thread creato da una persona o da un'altra app di chat, specifica invece il campo name del thread.

ActionResponse

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

Rappresentazione JSON 
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Campi
type

enum (ResponseType)

Solo input. Il tipo di risposta dell'app Chat.
url

string

Solo input. URL per l'autenticazione o la configurazione degli utenti. (Solo per i tipi di risposta REQUEST_CONFIG.)
dialogAction

object (DialogAction)

Solo input. Una risposta a un evento di interazione correlato a una finestra di dialogo. Deve essere accompagnato da ResponseType.Dialog.
updatedWidget

object (UpdatedWidget)

Solo input. La risposta del widget aggiornato.

ResponseType

Il tipo di risposta dell'app Chat.

Enum
TYPE_UNSPECIFIED Tipo predefinito gestito come NEW_MESSAGE.
NEW_MESSAGE Pubblica come nuovo messaggio nell'argomento.
UPDATE_MESSAGE Aggiorna il messaggio dell'app Chat. Ciò è consentito solo in un evento CARD_CLICKED in cui il tipo di mittente del messaggio è BOT.
UPDATE_USER_MESSAGE_CARDS Aggiorna le schede nel messaggio di un utente. Questo è consentito solo come risposta a un evento MESSAGE con un URL corrispondente o a un evento CARD_CLICKED in cui il tipo di mittente del messaggio è HUMAN. Il testo viene ignorato.
REQUEST_CONFIG Chiedi privatamente all'utente un'ulteriore autenticazione o configurazione.
DIALOG Viene visualizzata una finestra di dialogo.
UPDATE_WIDGET Query per le opzioni di completamento automatico del testo del widget.

DialogAction

Contiene una finestra di dialogo e il codice di stato della richiesta.

Rappresentazione JSON 
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Campi
actionStatus

object (ActionStatus)

Solo input. Stato di una richiesta di richiamo o invio di una finestra di dialogo. Mostra uno stato e un messaggio agli utenti, se necessario. Ad esempio, in caso di errore o esito positivo.
Campo unione action. Azione da eseguire. action può essere solo uno dei seguenti:
dialog

object (Dialog)

Solo input. Finestra di dialogo per la richiesta.

Dialog

Contenitore attorno al corpo della scheda della finestra di dialogo.

Rappresentazione JSON 
{
  "body": {
    object (Card)
  }
}
Campi
body

object (Card)

Solo input. Corpo della finestra di dialogo, visualizzato in una finestra modale. Le app Google Chat non supportano le seguenti entità delle schede: DateTimePicker, OnChangeAction.

ActionStatus

Rappresenta lo stato di una richiesta di richiamo o invio di una finestra di dialogo.

Rappresentazione JSON 
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Campi
statusCode

enum (Code)

Il codice di stato.
userFacingMessage

string

Il messaggio da inviare agli utenti in merito allo stato della loro richiesta. Se non è impostato, viene inviato un messaggio generico basato su statusCode.

Codice

I codici di errore canonici per le API gRPC.

A volte possono essere applicati più codici di errore. I servizi devono restituire il codice di errore più specifico applicabile. Ad esempio, preferisci OUT_OF_RANGE a FAILED_PRECONDITION se entrambi i codici sono applicabili. Allo stesso modo, preferisci NOT_FOUND o ALREADY_EXISTS a FAILED_PRECONDITION.

Enum
OK

Non è un errore; viene restituito in caso di esito positivo.

Mapping HTTP: 200 OK
CANCELLED

L'operazione è stata annullata, in genere dal chiamante.

Mappatura HTTP: 499 Client Closed Request
UNKNOWN

Errore sconosciuto. Ad esempio, questo errore può essere restituito quando un valore Status ricevuto da un altro spazio degli indirizzi appartiene a uno spazio di errore sconosciuto in questo spazio degli indirizzi. Anche gli errori generati dalle API che non restituiscono informazioni sufficienti sugli errori possono essere convertiti in questo errore.

Mapping HTTP: 500 Internal Server Error (Errore interno del server)
INVALID_ARGUMENT

Il client ha specificato un argomento non valido. Tieni presente che questa operazione è diversa da FAILED_PRECONDITION. INVALID_ARGUMENT indica argomenti problematici indipendentemente dallo stato del sistema (ad es. un nome file non valido).

Mapping HTTP: 400 Bad Request
DEADLINE_EXCEEDED

La scadenza è terminata prima che l'operazione potesse essere completata. Per le operazioni che modificano lo stato del sistema, questo errore può essere restituito anche se l'operazione è stata completata correttamente. Ad esempio, una risposta corretta da un server potrebbe essere stata ritardata abbastanza a lungo da far scadere la scadenza.

Mappatura HTTP: timeout del gateway (504)
NOT_FOUND

Impossibile trovare alcune entità richieste (ad es. file o directory).

Nota per gli sviluppatori di server: se una richiesta viene negata per un'intera classe di utenti, ad esempio per il lancio graduale di funzionalità o per una lista consentita non documentata, è possibile utilizzare NOT_FOUND. Se una richiesta viene negata per alcuni utenti all'interno di una classe di utenti, ad esempio il controllo dell'accesso basato sull'utente, è necessario utilizzare PERMISSION_DENIED.

Mappatura HTTP: 404 Not Found
ALREADY_EXISTS

L'entità che un client ha tentato di creare (ad es. file o directory) esiste già.

Mappatura HTTP: 409 Conflict
PERMISSION_DENIED

Il chiamante non dispone dell'autorizzazione per eseguire l'operazione specificata. PERMISSION_DENIED non deve essere utilizzato per i rifiuti causati dall'esaurimento di alcune risorse (utilizza invece RESOURCE_EXHAUSTED per questi errori). PERMISSION_DENIED non deve essere utilizzato se il chiamante non può essere identificato (utilizza UNAUTHENTICATED per questi errori). Questo codice di errore non implica che la richiesta sia valida o che l'entità richiesta esista o soddisfi altre precondizioni.

Mappatura HTTP: 403 accesso negato
UNAUTHENTICATED

La richiesta non ha credenziali di autenticazione valide per l'operazione.

Mappatura HTTP: 401 Non autorizzato
RESOURCE_EXHAUSTED

Alcune risorse sono esaurite, ad esempio una quota per utente o l'intero file system è esaurito.

Mapping HTTP: 429 Too Many Requests
FAILED_PRECONDITION

L'operazione è stata rifiutata perché il sistema non si trova nello stato richiesto per l'esecuzione dell'operazione. Ad esempio, la directory da eliminare non è vuota, un'operazione rmdir viene applicata a un elemento che non è una directory e così via.

Gli implementatori di servizi possono utilizzare le seguenti linee guida per decidere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE: (a) Utilizza UNAVAILABLE se il client può riprovare solo la chiamata non riuscita. (b) Utilizza ABORTED se il client deve riprovare a un livello superiore. Ad esempio, quando un test-and-set specificato dal client non riesce, indicando che il client deve riavviare una sequenza di lettura-modifica-scrittura. (c) Utilizza FAILED_PRECONDITION se il client non deve riprovare finché lo stato del sistema non è stato corretto in modo esplicito. Ad esempio, se un comando "rmdir" non va a buon fine perché la directory non è vuota, FAILED_PRECONDITION deve essere restituito perché il client non deve riprovare a meno che i file non vengano eliminati dalla directory.

Mapping HTTP: 400 Bad Request
ABORTED

L'operazione è stata interrotta, in genere a causa di un problema di concorrenza, ad esempio un errore di controllo del sequencer o un'interruzione della transazione.

Consulta le linee guida riportate sopra per decidere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mappatura HTTP: 409 Conflict
OUT_OF_RANGE

L'operazione è stata tentata oltre l'intervallo valido. Ad esempio, cercare o leggere oltre la fine del file.

A differenza di INVALID_ARGUMENT, questo errore indica un problema che può essere risolto se lo stato del sistema cambia. Ad esempio, un file system a 32 bit genererà INVALID_ARGUMENT se viene chiesto di leggere a un offset non compreso nell'intervallo [0,2^32-1], ma genererà OUT_OF_RANGE se viene chiesto di leggere da un offset successivo alla dimensione corrente del file.

Esiste una sovrapposizione piuttosto ampia tra FAILED_PRECONDITION e OUT_OF_RANGE. Ti consigliamo di utilizzare OUT_OF_RANGE (l'errore più specifico) quando si applica, in modo che i chiamanti che scorrono uno spazio possano cercare facilmente un errore OUT_OF_RANGE per rilevare quando hanno terminato.

Mapping HTTP: 400 Bad Request
UNIMPLEMENTED

L'operazione non è implementata o non è supportata/abilitata in questo servizio.

Mappatura HTTP: 501 Not Implemented
INTERNAL

Errori interni. Ciò significa che alcuni invarianti previsti dal sistema sottostante sono stati violati. Questo codice di errore è riservato agli errori gravi.

Mapping HTTP: 500 Internal Server Error (Errore interno del server)
UNAVAILABLE

Il servizio non è al momento disponibile. Si tratta molto probabilmente di una condizione temporanea, che può essere corretta riprovando con un backoff. Tieni presente che non è sempre sicuro riprovare le operazioni non idempotenti.

Consulta le linee guida riportate sopra per decidere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mappatura HTTP: 503 Servizio non disponibile
DATA_LOSS

Perdita o danneggiamento dei dati non recuperabili.

Mapping HTTP: 500 Internal Server Error (Errore interno del server)

UpdatedWidget

Per i widget selectionInput, restituisce i suggerimenti di completamento automatico per un menu a selezione multipla.

Rappresentazione JSON 
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
Campi
widget

string

L'ID del widget aggiornato. L'ID deve corrispondere a quello del widget che ha attivato la richiesta di aggiornamento.
Campo unione updated_widget. Il widget è stato aggiornato in risposta a un'azione utente. updated_widget può essere solo uno dei seguenti:
suggestions

object (SelectionItems)

Elenco dei risultati del completamento automatico del widget

SelectionItems

Elenco dei risultati del completamento automatico del widget.

Rappresentazione JSON 
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Campi
items[]

object (SelectionItem)

Un array di oggetti SelectionItem.

SlashCommand

Metadati relativi a un comando con barra in Google Chat.

Rappresentazione JSON 
{
  "commandId": string
}
Campi
commandId

string (int64 format)

L'ID del comando slash.

MatchedUrl

Un URL corrispondente in un messaggio di Chat. Le app di chat possono visualizzare l'anteprima degli URL corrispondenti. Per ulteriori informazioni, vedi Anteprima dei link.

Rappresentazione JSON 
{
  "url": string
}
Campi
url

string

Solo output. L'URL che è stato abbinato.

EmojiReactionSummary

Il numero di persone che hanno reagito a un messaggio con un'emoji specifica.

Rappresentazione JSON 
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Campi
emoji

object (Emoji)

Solo output. Emoji associata alle reazioni.
reactionCount

integer

Solo output. Il numero totale di reazioni che utilizzano l'emoji associata.

DeletionMetadata

Informazioni su un messaggio eliminato. Un messaggio viene eliminato quando viene impostato deleteTime.

Rappresentazione JSON 
{
  "deletionType": enum (DeletionType)
}
Campi
deletionType

enum (DeletionType)

Indica chi ha eliminato il messaggio.

DeletionType

Chi ha eliminato il messaggio e come è stato eliminato. In futuro potrebbero essere aggiunti altri valori. Per informazioni dettagliate su quando è possibile eliminare i messaggi, consulta Modificare o eliminare un messaggio in Google Chat.

Enum
DELETION_TYPE_UNSPECIFIED Questo valore non viene utilizzato.
CREATOR L'utente ha eliminato il proprio messaggio.
SPACE_OWNER Un gestore dello spazio ha eliminato il messaggio.
ADMIN Un amministratore di Google Workspace ha eliminato il messaggio. Gli amministratori possono eliminare qualsiasi messaggio nello spazio, inclusi quelli inviati da qualsiasi membro dello spazio o dall'app Chat.
APP_MESSAGE_EXPIRY Un'app Chat ha eliminato il proprio messaggio alla scadenza.
CREATOR_VIA_APP Un'app di chat ha eliminato il messaggio per conto dell'autore (utilizzando l'autenticazione utente).
SPACE_OWNER_VIA_APP Un'app di chat ha eliminato il messaggio per conto di un gestore dello spazio (utilizzando l'autenticazione utente).
SPACE_MEMBER Un membro dello spazio ha eliminato il messaggio. Gli utenti possono eliminare i messaggi inviati dalle app.

QuotedMessageMetadata

Informazioni su un messaggio citato.

Rappresentazione JSON 
{
  "name": string,
  "lastUpdateTime": string
}
Campi
name

string

Solo output. Nome della risorsa del messaggio citato.

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

string (Timestamp format)

Solo output. Il timestamp di creazione o dell'ultimo aggiornamento del messaggio citato.

AttachedGif

Un'immagine GIF specificata da un URL.

Rappresentazione JSON 
{
  "uri": string
}
Campi
uri

string

Solo output. L'URL che ospita l'immagine GIF.

AccessoryWidget

Uno o più widget interattivi visualizzati nella parte inferiore di un messaggio. Per maggiori dettagli, vedi Aggiungere widget interattivi in fondo a un messaggio.

Rappresentazione JSON 
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Campi
Campo unione action. Il tipo di azione. action può essere solo uno dei seguenti:
buttonList

object (ButtonList)

Un elenco di pulsanti.

Metodi

create

 Crea un messaggio in uno spazio di Google Chat.

delete

 Elimina un messaggio.

get

 Restituisce i dettagli di un messaggio.

list

 Elenca i messaggi in uno spazio di cui il chiamante è membro, inclusi i messaggi provenienti da membri e spazi bloccati.

patch

 Aggiorna un messaggio.

update

 Aggiorna un messaggio.