Package google.chat.v1

Indice

ChatService

Consente agli sviluppatori di creare app e integrazioni di Chat sulla piattaforma Google Chat.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

Completa la procedura di importazione per lo spazio specificato e lo rende visibile agli utenti.

Richiede l'autenticazione dell'app e la delega a livello di dominio. Per saperne di più, vedi Autorizzare le app Google Chat a importare i dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.import

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji)

Crea un'emoji personalizzata.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.customemojis

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

Crea un'appartenenza per l'app Chat che effettua la chiamata, un utente o un gruppo Google. La creazione di abbonamenti per altre app di chat non è supportata. Quando crei un abbonamento, se per il membro specificato è disattivata la norma di accettazione automatica, l'utente riceve l'invito e deve accettarlo prima di partecipare allo spazio. In caso contrario, la creazione di un abbonamento aggiunge il membro direttamente allo spazio specificato.

Supporta i seguenti tipi di autenticazione:

Per esempi di utilizzo, consulta:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

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 l'autenticazione dell'app. Chat attribuisce il mittente del messaggio in modo diverso a seconda del tipo di autenticazione utilizzato nella richiesta.

L'immagine seguente mostra come Chat attribuisce un messaggio quando utilizzi l'autenticazione dell'app. Chat mostra l'app Chat come mittente del messaggio. I contenuti del messaggio possono includere testo (text), schede (cardsV2) e widget accessori (accessoryWidgets).

Messaggio inviato con autenticazione app

L'immagine seguente mostra come Chat attribuisce un messaggio quando utilizzi l'autenticazione utente. Chat mostra l'utente come mittente del messaggio e attribuisce l'app Chat al messaggio mostrando il relativo nome. Il contenuto del messaggio può contenere solo testo (text).

Messaggio inviato con autenticazione utente

Le dimensioni massime del messaggio, inclusi i contenuti, sono 32.000 byte.

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.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

Crea una reazione e la aggiunge a un messaggio. Sono supportati solo gli emoji Unicode. Per un esempio, consulta Aggiungere una reazione a un messaggio.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.create

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

Crea uno spazio. Può essere utilizzato per creare uno spazio denominato o una chat di gruppo in Import mode. Per un esempio, vedi Creare uno spazio.

Supporta i seguenti tipi di autenticazione:

Quando esegui l'autenticazione come app, il campo space.customer deve essere impostato nella richiesta.

L'appartenenza allo spazio al momento della creazione dipende dal fatto che lo spazio sia stato creato in Import mode:

  • Modalità di importazione: non vengono creati membri.
  • Tutte le altre modalità: l'utente che effettua la chiamata viene aggiunto come membro. ovvero:
    • L'app stessa quando utilizzi l'autenticazione delle app.
    • L'utente quando si utilizza l'autenticazione utente.

Se ricevi il messaggio di errore ALREADY_EXISTS durante la creazione di uno spazio, prova con un altro displayName. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty)

Consente di eliminare un'emoji personalizzata.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.customemojis

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

Consente di eliminare un abbonamento. Per un esempio, consulta Rimuovere un utente o un'app Google Chat da uno spazio.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

Elimina un messaggio. Per un esempio, vedi Eliminare un messaggio.

Supporta i seguenti tipi di autenticazione:

Quando utilizzi l'autenticazione dell'app, le richieste possono eliminare solo i messaggi creati dall'app Chat che effettua la chiamata.

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

Consente di eliminare una reazione a un messaggio. Sono supportati solo gli emoji Unicode. Per un esempio, vedi Eliminare una reazione.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

Consente di eliminare uno spazio denominato. Esegue sempre un'eliminazione a cascata, il che significa che vengono eliminate anche le risorse secondarie dello spazio, come i messaggi pubblicati nello spazio e le iscrizioni allo spazio. Per un esempio, consulta Eliminare uno spazio.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

Restituisce il messaggio diretto esistente con l'utente specificato. Se non viene trovato uno spazio per i messaggi diretti, viene restituito un errore 404 NOT_FOUND. Per un esempio, consulta Trovare un messaggio diretto.

Con l'autenticazione dell'app, restituisce lo spazio dei messaggi diretti tra l'utente specificato e l'app Chat chiamante.

Con l'autenticazione utente, restituisce lo spazio dei messaggi diretti tra l'utente specificato e l'utente autenticato.

// Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

Recupera i metadati di un allegato del messaggio. I dati degli allegati vengono recuperati utilizzando l'API media. Per un esempio, vedi Ottenere i metadati di un allegato di un messaggio. Richiede l'autenticazione dell'app.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.bot

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji)

Restituisce i dettagli di un'emoji personalizzata.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Restituisce i dettagli di un abbonamento. Per un esempio, vedi Ottenere i dettagli sull'abbonamento di un utente o dell'app Google Chat.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

Restituisce i dettagli di un messaggio. Per un esempio, vedi Ottenere i dettagli di un messaggio.

Supporta i seguenti tipi di autenticazione:

Nota: potrebbe essere restituito un messaggio da uno spazio o un membro bloccato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

Restituisce i dettagli di uno spazio. Per un esempio, vedi Visualizzare i dettagli di uno spazio.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.app.spaces

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

Restituisce un evento da uno spazio di Google Chat. Il payload dell'evento contiene la versione più recente della risorsa modificata. Ad esempio, se richiedi un evento relativo a un nuovo messaggio, ma il messaggio è stato successivamente aggiornato, il server restituisce la risorsa Message aggiornata nel payload dell'evento.

Nota: il campo permissionSettings non viene restituito nell'oggetto Space dei dati sugli eventi Space per questa richiesta.

Richiede l'autenticazione utente. Per ricevere un evento, l'utente autenticato deve essere un membro dello spazio.

Per un esempio, vedi Ottenere i dettagli di un evento da uno spazio di Google Chat.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetSpaceNotificationSetting

rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

Recupera le impostazioni dello stato delle notifiche dello spazio.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.users.spacesettings

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

Restituisce i dettagli sullo stato di lettura di un utente all'interno di uno spazio, utilizzati per identificare i messaggi letti e da leggere. Per un esempio, vedi Ottenere i dettagli sullo stato di lettura dello spazio di un utente.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

Restituisce i dettagli sullo stato di lettura di un utente all'interno di un thread, utilizzati per identificare i messaggi letti e non letti. Per un esempio, vedi Ottenere i dettagli sullo stato di lettura del thread di un utente.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse)

Elenca le emoji personalizzate visibili all'utente autenticato.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Elenca le iscrizioni a uno spazio. Per un esempio, vedi Elenca gli utenti e le app Google Chat in uno spazio. L'elenco dei membri con autenticazione app elenca i membri degli spazi a cui ha accesso l'app Chat, ma esclude i membri dell'app Chat, inclusi i suoi. L'elenco delle iscrizioni con Autenticazione utente elenca le iscrizioni negli spazi a cui l'utente autenticato ha accesso.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

Elenca i messaggi di uno spazio di cui l'utente che ha effettuato la chiamata è membro, inclusi i messaggi di spazi e membri bloccati. Se elenchi i messaggi di uno spazio senza messaggi, la risposta è un oggetto vuoto. Quando utilizzi un'interfaccia REST/HTTP, la risposta contiene un oggetto JSON vuoto, {}. Per un esempio, vedi Elenca messaggi.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse)

Elenca le reazioni a un messaggio. Per un esempio, vedi Elenca le reazioni per un messaggio.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse)

Elenca gli eventi di uno spazio di Google Chat. Per ogni evento, il payload contiene la versione più recente della risorsa Chat. Ad esempio, se elenchi eventi relativi ai nuovi membri dello spazio, il server restituisce risorse Membership che contengono i dettagli più recenti dell'abbonamento. Se i nuovi membri sono stati rimossi durante il periodo richiesto, il payload dell'evento contiene una risorsa Membership vuota.

Richiede l'autenticazione utente. Per elencare gli eventi, l'utente autenticato deve essere un membro dello spazio.

Per un esempio, consulta Elenco di eventi da uno spazio di Google Chat.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse)

Elenca gli spazi di cui l'utente che chiama è membro. Le chat di gruppo e i messaggi diretti non vengono elencati finché non viene inviato il primo messaggio. Per un esempio, consulta Elenca gli spazi.

Supporta i seguenti tipi di autenticazione:

Per elencare tutti gli spazi denominati per organizzazione Google Workspace, utilizza il metodo spaces.search() utilizzando i privilegi di amministratore di Workspace.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse)

Restituisce un elenco di spazi in un'organizzazione Google Workspace in base alla ricerca di un amministratore.

È richiesta l'autenticazione utente con privilegi di amministratore. Nella richiesta, imposta use_admin_access su true.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space)

Crea uno spazio e aggiunge gli utenti specificati. L'utente che effettua la chiamata viene aggiunto automaticamente allo spazio e non deve essere specificato come appartenenza nella richiesta. Per un esempio, consulta Configurare uno spazio con i membri iniziali.

Per specificare i membri umani da aggiungere, aggiungi le adesioni con l'membership.member.name appropriato. Per aggiungere un utente, utilizza users/{user}, dove {user} può essere l'indirizzo email dell'utente. Per gli utenti della stessa organizzazione Workspace, {user} può anche essere il id della persona dell'API People o il id dell'utente nell'API Directory. Ad esempio, se l'ID profilo della persona dell'API People per user@example.com è 123456789, puoi aggiungere l'utente allo spazio impostando membership.member.name su users/user@example.com o users/123456789.

Per specificare i gruppi Google da aggiungere, aggiungi le iscrizioni con l'membership.group_member.name appropriato. Per aggiungere o invitare un gruppo Google, utilizza groups/{group}, dove {group} è il id del gruppo dall'API Cloud Identity Groups. Ad esempio, puoi utilizzare l'API di ricerca dei gruppi Cloud Identity per recuperare l'ID 123456789 per l'indirizzo email del gruppo group@example.com, quindi aggiungere il gruppo allo spazio impostando membership.group_member.name su groups/123456789. L'email di gruppo non è supportata e i gruppi Google possono essere aggiunti come membri solo negli spazi con nome.

Per uno spazio denominato o una chat di gruppo, se chi chiama blocca o viene bloccato da alcuni membri oppure non dispone dell'autorizzazione per aggiungerne alcuni, questi membri non vengono aggiunti allo spazio creato.

Per creare un messaggio diretto (DM) tra l'utente che chiama e un altro utente, specifica esattamente un'appartenenza per rappresentare l'utente. Se un utente blocca l'altro, la richiesta non va a buon fine e il messaggio diretto non viene creato.

Per creare un messaggio diretto tra l'utente che effettua la chiamata e l'app di chiamata, imposta Space.singleUserBotDm su true e non specificare alcun gruppo di appartenenza. Puoi utilizzare questo metodo solo per configurare un messaggio diretto con l'app di chiamata. Per aggiungere l'app di chiamata come membro di uno spazio o di un messaggio diretto esistente tra due utenti umani, consulta Invitare o aggiungere un utente o un'app a uno spazio.

Se tra due utenti esiste già un messaggio diretto, anche se un utente blocca l'altro al momento della richiesta, viene restituito il messaggio diretto esistente.

Gli spazi con risposte in thread non sono supportati. Se ricevi il messaggio di errore ALREADY_EXISTS durante la configurazione di uno spazio, prova un altro displayName. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership)

Aggiorna un abbonamento. Per un esempio, vedi Aggiornare l'appartenenza di un utente a uno spazio.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message)

Aggiorna un messaggio. Esiste una differenza tra i metodi patch e update. Il metodo patch utilizza una richiesta patch, mentre il metodo update utilizza una richiesta put. Ti consigliamo di utilizzare il metodo patch. Per un esempio, vedi Aggiornare un messaggio.

Supporta i seguenti tipi di autenticazione:

Quando utilizzi l'autenticazione dell'app, le richieste possono aggiornare solo i messaggi creati dall'app Chat chiamante.

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space)

Aggiorna uno spazio. Per un esempio, vedi Aggiornare uno spazio.

Se stai aggiornando il campo displayName e ricevi il messaggio di errore ALREADY_EXISTS, prova un nome visualizzato diverso. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Supporta i seguenti tipi di autenticazione:

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

UpdateSpaceNotificationSetting

rpc UpdateSpaceNotificationSetting(UpdateSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

Aggiorna le impostazioni dello stato delle notifiche dello spazio.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.users.spacesettings

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState)

Aggiorna lo stato di lettura di un utente all'interno di uno spazio, utilizzato per identificare i messaggi letti e da leggere. Per un esempio, vedi Aggiornare lo stato di lettura dello spazio di un utente.

Richiede l'autenticazione utente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/chat.users.readstate

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

AccessoryWidget

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

Campi
Campo unione action. Il tipo di azione. action può essere solo uno dei seguenti:
button_list

ButtonList

Un elenco di pulsanti.

ActionResponse

Parametri che un'app di chat può utilizzare per configurare il modo in cui viene pubblicata la sua risposta.

Campi
type

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

dialog_action

DialogAction

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

updated_widget

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 un nuovo messaggio nell'argomento.
UPDATE_MESSAGE Aggiorna il messaggio dell'app Chat. Questo è consentito solo in un evento CARD_CLICKED in cui il tipo di mittente del messaggio è BOT.
UPDATE_USER_MESSAGE_CARDS Aggiorna le schede del 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 all'utente di effettuare un'autenticazione o una configurazione aggiuntiva in privato.
DIALOG Mostra una finestra di dialogo.
UPDATE_WIDGET Query sulle opzioni di completamento automatico del testo del widget.

SelectionItems

Elenco dei risultati del completamento automatico del widget.

Campi
items[]

SelectionItem

Un array di oggetti SelectionItem.

UpdatedWidget

La risposta del widget aggiornato. Utilizzato per fornire opzioni di completamento automatico per un 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 dell'utente. updated_widget può essere solo uno dei seguenti:
suggestions

SelectionItems

Elenco dei risultati di completamento automatico del widget

ActionStatus

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

Campi
status_code

Code

Il codice di stato.

user_facing_message

string

Il messaggio da inviare agli utenti sullo stato della loro richiesta. Se non è impostato, viene inviato un messaggio generico basato su status_code.

Annotazione

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

Esempio di corpo del messaggio in 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"
   }
}]
Campi
type

AnnotationType

Il tipo di annotazione.

length

int32

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

start_index

int32

Indice iniziale (da 0, incluso) nel corpo del messaggio in testo normale a cui corrisponde questa annotazione.

Campo unione metadata. Metadati aggiuntivi sull'annotazione. metadata può essere solo uno dei seguenti:
user_mention

UserMentionMetadata

I metadati della menzione dell'utente.

slash_command

SlashCommandMetadata

I metadati di un comando slash.

AnnotationType

Tipo di annotazione.

Enum
ANNOTATION_TYPE_UNSPECIFIED Valore predefinito per l'enum. Non utilizzare.
USER_MENTION Viene menzionato un utente.
SLASH_COMMAND Viene richiamato un comando slash.

AttachedGif

Un'immagine GIF specificata da un URL.

Campi
uri

string

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

Allegato

Un allegato in Google Chat.

Campi
name

string

Facoltativo. Nome della risorsa dell'allegato, nel formato spaces/{space}/messages/{message}/attachments/{attachment}.

content_name

string

Solo output. Il nome file originale dei contenuti, non il percorso completo.

content_type

string

Solo output. Il tipo di contenuto (tipo MIME) del file.

thumbnail_uri

string

Solo output. L'URL della miniatura da utilizzare per visualizzare l'anteprima dell'allegato a un utente. Le app di chat non devono utilizzare questo URL per scaricare i contenuti degli allegati.

download_uri

string

Solo output. L'URL di download da utilizzare per consentire a un utente di scaricare l'allegato. Le app di chat non devono utilizzare questo URL per scaricare i contenuti degli allegati.

source

Source

Solo output. L'origine dell'allegato.

Campo unione data_ref. Il riferimento ai dati dell'allegato. data_ref può essere solo uno dei seguenti:
attachment_data_ref

AttachmentDataRef

Facoltativo. Un riferimento ai dati dell'allegato. Questo campo viene utilizzato per creare o aggiornare i messaggi con gli allegati o con l'API Media per scaricare i dati degli allegati.

drive_data_ref

DriveDataRef

Solo output. Un riferimento all'allegato di Google Drive. Questo campo viene utilizzato con l'API Google Drive.

Origine

L'origine dell'allegato.

Enum
SOURCE_UNSPECIFIED Riservato.
DRIVE_FILE Il file è un file di Google Drive.
UPLOADED_CONTENT Il file viene caricato in Chat.

AttachmentDataRef

Un riferimento ai dati dell'allegato.

Campi
resource_name

string

Facoltativo. Il nome della risorsa dei dati dell'allegato. Questo campo viene utilizzato con l'API Media per scaricare i dati degli allegati.

attachment_upload_token

string

Facoltativo. Token opaco contenente un riferimento a un allegato caricato. Trattato dai client come una stringa opaca e utilizzato per creare o aggiornare i messaggi di Chat con allegati.

CardWithId

Una scheda in un messaggio di Google Chat.

Solo le app di Chat possono creare schede. Se l'app Chat si autentica come utente, il messaggio non può contenere schede.

Progetta e visualizza l'anteprima delle schede con lo strumento per la creazione di schede.

Apri lo strumento per la creazione di schede

Campi
card_id

string

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

card

Card

Una scheda. La dimensione massima è 32 KB.

ChatSpaceLinkData

Dati per i link agli spazi di Chat.

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

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

message

string

Il messaggio della risorsa dello spazio di Chat collegato.

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

CompleteImportSpaceRequest

Messaggio di richiesta per completare la procedura di importazione di uno spazio.

Campi
name

string

Obbligatorio. Nome della risorsa dello spazio in modalità di importazione.

Formato: spaces/{space}

CompleteImportSpaceResponse

Messaggio di risposta per il completamento del processo di importazione di uno spazio.

Campi
space

Space

Lo spazio in modalità di importazione.

ContextualAddOnMarkup

Questo tipo non contiene campi.

Il markup per consentire agli sviluppatori di specificare i contenuti di un componente aggiuntivo contestuale.

Scheda

Una scheda è un elemento dell'interfaccia utente che può contenere widget dell'interfaccia utente come testo e immagini.

Campi
header

CardHeader

L'intestazione della scheda. Un'intestazione di solito contiene un titolo e un'immagine.

sections[]

Section

Le sezioni sono separate da un divisore di riga.

card_actions[]

CardAction

Le azioni di questa scheda.

name

string

Nome della scheda.

CardAction

Un'azione della scheda è l'azione associata alla scheda. Per una scheda di fattura, un'azione tipica potrebbe essere: elimina fattura, invia fattura via email o apri la fattura nel browser.

Non supportato dalle app Google Chat.

Campi
action_label

string

In precedenza, l'etichetta veniva visualizzata nell'elemento del menu Azione.

on_click

OnClick

L'azione onclick per questo elemento dell'azione.

CardHeader

Campi
title

string

Il titolo deve essere specificato. L'intestazione ha un'altezza fissa: se sono specificati sia un titolo che un sottotitolo, ciascuno occupa una riga. Se viene specificato solo il titolo, questo occupa entrambe le righe.

subtitle

string

Il sottotitolo dell'intestazione della scheda.

image_style

ImageStyle

Il tipo di immagine (ad esempio, bordo quadrato o bordo circolare).

image_url

string

L'URL dell'immagine nell'intestazione della scheda.

ImageStyle

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Bordo quadrato.
AVATAR Bordo circolare.

Sezione

Una sezione contiene una raccolta di widget che vengono visualizzati (verticalmente) nell'ordine in cui sono specificati. Su tutte le piattaforme, le schede hanno una larghezza fissa ristretta, pertanto al momento non sono necessarie proprietà di layout (ad esempio float).

Campi
header

string

L'intestazione della sezione. Il testo formattato è supportato. Per saperne di più sulla formattazione del testo, vedi Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace.

widgets[]

WidgetMarkup

Una sezione deve contenere almeno un widget.

CreateCustomEmojiRequest

Una richiesta di creazione di un'emoji personalizzata.

Campi
custom_emoji

CustomEmoji

Obbligatorio. L'emoji personalizzata da creare.

CreateMembershipRequest

Messaggio di richiesta per la creazione di un abbonamento.

Campi
parent

string

Obbligatorio. Il nome della risorsa dello spazio per cui creare l'appartenenza.

Formato: spaces/{space}

membership

Membership

Obbligatorio. La relazione di appartenenza da creare.

Il campo memberType deve contenere un utente con i campi user.name e user.type compilati. Il server assegnerà un nome alla risorsa e sovrascriverà tutto ciò che è stato specificato.

Quando un'app di chat crea una relazione di appartenenza per un utente umano, deve utilizzare determinati ambiti di autorizzazione e impostare valori specifici per determinati campi:

  • Quando esegui l'autenticazione come utente, è necessario l'ambito di autorizzazione chat.memberships.

  • Quando esegui l'autenticazione come app, è necessario l'ambito di autorizzazione chat.app.memberships. L'autenticazione come app è disponibile in

  • Imposta user.type su HUMAN e user.name con il formato users/{user}, dove {user} può essere l'indirizzo email dell'utente. Per gli utenti della stessa organizzazione Workspace, {user} può anche essere il id della persona dell'API People o il id dell'utente nell'API Directory. Ad esempio, se l'ID profilo della persona dell'API People per user@example.com è 123456789, puoi aggiungere l'utente allo spazio impostando membership.member.name su users/user@example.com o users/123456789.

L'invito di utenti esterni all'organizzazione Workspace proprietaria dello spazio richiede l'autenticazione utente.

Quando un'app di chat crea una relazione di appartenenza per se stessa, deve autenticarsi come utente e utilizzare l'ambito chat.memberships.app, impostare user.type su BOT e user.name su users/app.

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'chat.admin.memberships ambito OAuth 2.0.

La creazione di abbonamenti alle app o di abbonamenti per utenti esterni all'organizzazione Google Workspace dell'amministratore non è supportata con l'accesso amministrativo.

CreateMessageRequest

Crea un messaggio.

Campi
parent

string

Obbligatorio. Il nome della risorsa dello spazio in cui creare un messaggio.

Formato: spaces/{space}

message

Message

Obbligatorio. Corpo del messaggio.

thread_key
(deprecated)

string

Facoltativo. Deprecato: utilizza thread.thread_key. ID del thread. Supporta fino a 4000 caratteri. Per avviare o aggiungere un messaggio a un thread, crea un messaggio e specifica un threadKey o il thread.name. Per esempi di utilizzo, vedi Avvia o rispondi a un thread di messaggi.

request_id

string

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.

message_reply_option

MessageReplyOption

Facoltativo. Specifica se un messaggio avvia un thread o risponde a uno. Supportato solo negli spazi con un nome.

Quando rispondi alle interazioni degli utenti, questo campo viene ignorato. Per le interazioni all'interno di un thread, la risposta viene creata nello stesso thread. In caso contrario, la risposta viene creata come nuovo thread.

message_id

string

Facoltativo. Un ID personalizzato per un messaggio. Consente alle app di Chat di recuperare, aggiornare o eliminare un messaggio senza dover memorizzare 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, ma custom-name non lo è.
  • Deve contenere 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.

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 tutti i valori thread ID o thread_key inclusi.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea il messaggio come risposta al thread specificato da thread ID o thread_key. In caso di errore, il messaggio avvia un nuovo thread.
REPLY_MESSAGE_OR_FAIL Crea il messaggio come risposta al thread specificato da thread ID o thread_key. Se viene utilizzato un nuovo thread_key, viene creato un nuovo thread. Se la creazione del messaggio non va a buon fine, viene restituito un errore NOT_FOUND.

CreateReactionRequest

Crea una reazione a un messaggio.

Campi
parent

string

Obbligatorio. Il messaggio in cui viene creata la reazione.

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

reaction

Reaction

Obbligatorio. La reazione da creare.

CreateSpaceRequest

Una richiesta di creazione di uno spazio denominato senza membri.

Campi
space

Space

Obbligatorio. I campi displayName e spaceType devono essere compilati. Sono supportati solo SpaceType.SPACE e SpaceType.GROUP_CHAT. SpaceType.GROUP_CHAT può essere utilizzato solo se importMode è impostato su true.

Se ricevi il messaggio di errore ALREADY_EXISTS, prova con un altro displayName. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Lo spazio name è assegnato sul server, pertanto qualsiasi elemento specificato in questo campo verrà ignorato.

request_id

string

Facoltativo. Un identificatore univoco per questa richiesta. È consigliabile utilizzare un UUID casuale. Se specifichi un ID richiesta esistente, viene restituito lo spazio creato con quell'ID anziché crearne uno nuovo. Se specifichi un ID richiesta esistente della stessa app Chat con un utente autenticato diverso, viene restituito un errore.

CustomEmoji

Rappresenta un'emoji personalizzata.

Campi
name

string

Identificatore. Il nome della risorsa dell'emoji personalizzata, assegnato dal server.

Formato: customEmojis/{customEmoji}

uid

string

Solo output. Chiave univoca per la risorsa emoji personalizzata.

emoji_name

string

Facoltativo. Immutabile. Nome fornito dall'utente per l'emoji personalizzata, che deve essere univoco all'interno dell'organizzazione.

Obbligatorio quando viene creata l'emoji personalizzata, altrimenti solo output.

I nomi delle emoji devono iniziare e terminare con due punti, devono essere in lettere minuscole e possono contenere solo caratteri alfanumerici, trattini e trattini bassi. I trattini e i trattini bassi dovrebbero essere utilizzati per separare le parole e non possono essere digitati uno di seguito all'altro.

Esempio: :valid-emoji-name:

temporary_image_uri

string

Solo output. L'URL dell'immagine per l'emoji personalizzata, valido per almeno 10 minuti. Tieni presente che questo campo non viene compilato nella risposta quando viene creata l'emoji personalizzata.

payload

CustomEmojiPayload

Facoltativo. Solo input. Dati del payload. Obbligatorio quando viene creata l'emoji personalizzata.

CustomEmojiPayload

Dati del payload per l'emoji personalizzata.

Campi
file_content

bytes

Obbligatorio. Solo input. L'immagine utilizzata per l'emoji personalizzata.

Il payload deve essere inferiore a 256 KB e le dimensioni dell'immagine devono essere comprese tra 64 e 500 pixel. Le limitazioni sono soggette a modifica.

filename

string

Obbligatorio. Solo input. Il nome del file immagine.

Estensioni file supportate: .png, .jpg, .gif.

DeleteCustomEmojiRequest

Richiesta di eliminazione di un'emoji personalizzata.

Campi
name

string

Obbligatorio. Nome della risorsa dell'emoji personalizzata da eliminare.

Formato: customEmojis/{customEmoji}

Puoi utilizzare il nome dell'emoji come alias per {customEmoji}. Ad esempio, customEmojis/:example-emoji:, dove :example-emoji: è il nome dell'emoji personalizzata.

DeleteMembershipRequest

Richiedere l'eliminazione di un abbonamento a uno spazio.

Campi
name

string

Obbligatorio. Nome della risorsa dell'abbonamento da eliminare. Le app di chat possono eliminare i propri abbonamenti o quelli degli utenti umani. Le app di chat non possono eliminare gli abbonamenti di altre app.

Quando elimini un abbonamento di una persona, sono richiesti l'ambito chat.memberships e il formato spaces/{space}/members/{member}. Puoi utilizzare l'email come alias per {member}. Ad esempio, spaces/{space}/members/example@gmail.com, dove example@gmail.com è l'indirizzo email dell'utente di Google Chat.

Quando elimini un abbonamento a un'app, sono richiesti l'ambito chat.memberships.app e il formato spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app.

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'chat.admin.memberships ambito OAuth 2.0.

L'eliminazione delle iscrizioni alle app in uno spazio non è supportata con l'accesso amministrativo.

DeleteMessageRequest

Richiedi di eliminare un messaggio.

Campi
name

string

Obbligatorio. Nome della risorsa del messaggio.

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

Se hai impostato un ID personalizzato per il messaggio, puoi utilizzare il valore del campo clientAssignedMessageId per {message}. Per maggiori dettagli, vedi Assegnare un nome a un messaggio.

force

bool

Facoltativo. Quando è true, l'eliminazione di un messaggio comporta anche l'eliminazione delle relative risposte in thread. Quando false, se un messaggio ha risposte in thread, l'eliminazione non va a buon fine.

Si applica solo quando l'autenticazione avviene come utente. Non ha alcun effetto quando si esegue l'autenticazione come app di chat.

DeleteReactionRequest

Consente di eliminare una reazione a un messaggio.

Campi
name

string

Obbligatorio. Nome della reazione da eliminare.

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

DeleteSpaceRequest

Richiesta di eliminazione di uno spazio.

Campi
name

string

Obbligatorio. Nome della risorsa dello spazio da eliminare.

Formato: spaces/{space}

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'chat.admin.delete ambito OAuth 2.0.

DeletionMetadata

Informazioni su un messaggio eliminato. Un messaggio viene eliminato quando è impostato delete_time.

Campi
deletion_type

DeletionType

Indica chi ha eliminato il messaggio.

DeletionType

Chi ha eliminato il messaggio e come è stato eliminato. In futuro potrebbero essere aggiunti altri valori.

Enum
DELETION_TYPE_UNSPECIFIED Questo valore non è utilizzato.
CREATOR L'utente ha eliminato il proprio messaggio.
SPACE_OWNER Il proprietario dello spazio ha eliminato il messaggio.
ADMIN Un amministratore di Google Workspace ha eliminato il messaggio.
APP_MESSAGE_EXPIRY Un'app di chat ha eliminato il proprio messaggio alla scadenza.
CREATOR_VIA_APP Un'app Chat ha eliminato il messaggio per conto dell'utente.
SPACE_OWNER_VIA_APP Un'app Chat ha eliminato il messaggio per conto del proprietario dello spazio.

Dialog

Contenitore del corpo della scheda della finestra di dialogo.

Campi
body

Card

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

DialogAction

Contiene un dialogo e il codice di stato della richiesta.

Campi
action_status

ActionStatus

Solo input. Stato di una richiesta di chiamata 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

Dialog

Solo input. Dialogo per la richiesta.

DriveDataRef

Un riferimento ai dati di un allegato di Drive.

Campi
drive_file_id

string

L'ID del file di Drive. Da utilizzare con l'API Drive.

DriveLinkData

Dati per i link di Google Drive.

Campi
drive_data_ref

DriveDataRef

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

mime_type

string

Il tipo MIME della risorsa di Google Drive collegata.

Emoji

Un'emoji usata come reazione a un messaggio.

Campi
Campo unione content. Obbligatorio. Il contenuto dell'emoji. content può essere solo uno dei seguenti:
unicode

string

Facoltativo. Un'emoji di base rappresentata da una stringa Unicode.

custom_emoji

CustomEmoji

Solo output. Un'emoji personalizzata.

EmojiReactionSummary

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

Campi
emoji

Emoji

Solo output. Emoji associate alle reazioni.

reaction_count

int32

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

FindDirectMessageRequest

Una richiesta per ottenere spazio per i messaggi diretti in base alla risorsa utente.

Campi
name

string

Obbligatorio. Nome della risorsa dell'utente con cui trovare il messaggio diretto.

Formato: users/{user}, dove {user} è il valore id per la persona dell'API People o il valore id per l'utente nell'API Directory. Ad esempio, se l'ID profilo dell'API People è 123456789, puoi trovare un messaggio diretto con la persona utilizzando users/123456789 come name. Quando esegui l'autenticazione come utente, puoi utilizzare l'email come alias per {user}. Ad esempio, users/example@gmail.com, dove example@gmail.com è l'indirizzo email dell'utente di Google Chat.

GetAttachmentRequest

Richiedi di ricevere un allegato.

Campi
name

string

Obbligatorio. Nome della risorsa dell'allegato, nel formato spaces/{space}/messages/{message}/attachments/{attachment}.

GetCustomEmojiRequest

Una richiesta di restituzione di una singola emoji personalizzata.

Campi
name

string

Obbligatorio. Nome della risorsa dell'emoji personalizzata.

Formato: customEmojis/{customEmoji}

Puoi utilizzare il nome dell'emoji come alias per {customEmoji}. Ad esempio, customEmojis/:example-emoji:, dove :example-emoji: è il nome dell'emoji personalizzata.

GetMembershipRequest

Richiedere l'abbonamento a uno spazio.

Campi
name

string

Obbligatorio. Nome della risorsa dell'abbonamento da recuperare.

Per ottenere l'abbonamento dell'app utilizzando l'autenticazione utente, puoi eventualmente utilizzare spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app

Puoi utilizzare l'indirizzo email dell'utente come alias per {member}. Ad esempio, spaces/{space}/members/example@gmail.com, dove example@gmail.com è l'indirizzo email dell'utente di Google Chat.

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede gli ambiti OAuth 2.0 chat.admin.memberships o chat.admin.memberships.readonly.

L'ottenimento degli abbonamenti alle app in uno spazio non è supportato quando si utilizza l'accesso amministrativo.

GetMessageRequest

Richiedi di ricevere un messaggio.

Campi
name

string

Obbligatorio. Nome della risorsa del messaggio.

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

Se hai impostato un ID personalizzato per il messaggio, puoi utilizzare il valore del campo clientAssignedMessageId per {message}. Per maggiori dettagli, vedi Assegnare un nome a un messaggio.

GetSpaceEventRequest

Messaggio di richiesta per ricevere un evento dello spazio.

Campi
name

string

Obbligatorio. Il nome della risorsa dell'evento dello spazio.

Formato: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

Richiedi un messaggio per ricevere l'impostazione di notifica dello spazio. Supporta solo l'impostazione di notifica per l'utente che chiama.

Campi
name

string

Obbligatorio. Formato: users/{user}/spaces/{space}/spaceNotificationSetting

  • users/me/spaces/{space}/spaceNotificationSetting OPPURE
  • users/user@example.com/spaces/{space}/spaceNotificationSetting OPPURE
  • users/123456789/spaces/{space}/spaceNotificationSetting. Nota: nel percorso è consentito solo l'ID utente o l'email dell'utente che chiama.

GetSpaceReadStateRequest

Messaggio di richiesta per l'API GetSpaceReadState.

Campi
name

string

Obbligatorio. Nome della risorsa dello stato di lettura dello spazio da recuperare.

Supporta solo l'ottenimento dello stato di lettura per l'utente che chiama.

Per fare riferimento all'utente che chiama, imposta una delle seguenti opzioni:

  • L'alias me. Ad esempio, users/me/spaces/{space}/spaceReadState.

  • Il relativo indirizzo email Workspace. Ad esempio, users/user@example.com/spaces/{space}/spaceReadState.

  • Il proprio ID utente. Ad esempio, users/123456789/spaces/{space}/spaceReadState.

Formato: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

Una richiesta di restituzione di un singolo spazio.

Campi
name

string

Obbligatorio. Nome della risorsa dello spazio, nel formato spaces/{space}.

Formato: spaces/{space}

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede gli ambiti OAuth 2.0 chat.admin.spaces o chat.admin.spaces.readonly.

GetThreadReadStateRequest

Messaggio di richiesta per l'API GetThreadReadStateRequest.

Campi
name

string

Obbligatorio. Nome della risorsa dello stato di lettura del thread da recuperare.

Supporta solo l'ottenimento dello stato di lettura per l'utente che chiama.

Per fare riferimento all'utente che chiama, imposta una delle seguenti opzioni:

  • L'alias me. Ad esempio, users/me/spaces/{space}/threads/{thread}/threadReadState.

  • Il relativo indirizzo email Workspace. Ad esempio, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.

  • Il proprio ID utente. Ad esempio, users/123456789/spaces/{space}/threads/{thread}/threadReadState.

Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Gruppo

Un gruppo Google in Google Chat.

Campi
name

string

Nome della risorsa per un gruppo Google.

Rappresenta un gruppo nell'API Cloud Identity Groups.

Formato: groups/{group}

HistoryState

Lo stato della cronologia per messaggi e spazi. Specifica per quanto tempo conservare i messaggi e i thread di conversazione dopo la creazione.

Enum
HISTORY_STATE_UNSPECIFIED Valore predefinito. Non utilizzare.
HISTORY_OFF Cronologia disattivata. Messaggi e thread vengono conservati per 24 ore.
HISTORY_ON Cronologia attivata. Le regole di conservazione di Vault dell'organizzazione specificano per quanto tempo vengono conservati i messaggi e i thread.

ListCustomEmojisRequest

Una richiesta di restituzione di un elenco di emoji personalizzate.

Campi
page_size

int32

Facoltativo. Il numero massimo di emoji personalizzate restituite. Il servizio può restituire meno emoji personalizzate di questo valore. Se non specificato, il valore predefinito è 25. Il valore massimo è 200; i valori superiori a 200 vengono modificati in 200.

page_token

string

Facoltativo. (Se riprendi da una query precedente).

Un token di pagina ricevuto da una precedente chiamata dell'emoji personalizzata dell'elenco. Fornisci questo valore per recuperare la pagina successiva.

Quando viene visualizzata la paginazione, il valore del filtro deve corrispondere alla chiamata che ha fornito il token pagina. Se passi un valore diverso, potresti ottenere risultati imprevisti.

filter

string

Facoltativo. Un filtro per query.

Supporta i filtri per creator.

Per filtrare in base al creator, devi specificare un valore valido. Al momento, solo creator("users/me") e NOT creator("users/me") sono accettati per filtrare le emoji personalizzate in base al fatto che siano state create o meno dall'utente che chiama.

Ad esempio, la seguente query restituisce l'emoji personalizzata creata dall'utente che ha effettuato la chiamata:

creator("users/me")

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

ListCustomEmojisResponse

Una risposta a un elenco di emoji personalizzate.

Campi
custom_emojis[]

CustomEmoji

Elenco non ordinato. Elenco di emoji personalizzate nella pagina richiesta (o prima).

next_page_token

string

Un token che puoi inviare come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

ListMembershipsRequest

Richiedi un messaggio per l'inserimento degli abbonamenti.

Campi
parent

string

Obbligatorio. Il nome della risorsa dello spazio per cui recuperare un elenco di membri.

Formato: spaces/{space}

page_size

int32

Facoltativo. Il numero massimo di abbonamenti da restituire. Il servizio potrebbe restituire meno di questo valore.

Se non specificato, vengono restituiti al massimo 100 abbonamenti.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, questo viene modificato automaticamente in 1000.

I valori negativi restituiscono un errore INVALID_ARGUMENT.

page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata precedente per elencare le iscrizioni. Specifica questo parametro per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token pagina. Se passi valori diversi agli altri parametri, potresti ottenere risultati imprevisti.

filter

string

Facoltativo. Un filtro per query.

Puoi filtrare le iscrizioni in base al ruolo (role) e al tipo (member.type) di un membro.

Per filtrare per ruolo, imposta role su ROLE_MEMBER o ROLE_MANAGER.

Per filtrare per tipo, imposta member.type su HUMAN o BOT. Puoi anche filtrare per member.type utilizzando l'operatore !=.

Per filtrare in base a ruolo e tipo, utilizza l'operatore AND. Per filtrare in base al ruolo o al tipo, utilizza l'operatore OR.

member.type = "HUMAN" o member.type != "BOT" è obbligatorio quando use_admin_access è impostato su true. Gli altri filtri per tipo di membro verranno rifiutati.

Ad esempio, le seguenti query sono valide:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Le seguenti query non sono valide:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

show_groups

bool

Facoltativo. Se true, restituisce anche gli abbonamenti associati a un Google Group, oltre ad altri tipi di abbonamenti. Se è impostato un filter, gli abbonamenti Google Group che non corrispondono ai criteri di filtro non vengono restituiti.

show_invited

bool

Facoltativo. Quando true, restituisce anche gli abbonamenti associati ai membri invited, oltre ad altri tipi di abbonamenti. Se è impostato un filtro, gli abbonamenti a invited che non corrispondono ai criteri del filtro non vengono restituiti.

Al momento è richiesta l'autenticazione dell'utente.

use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'ambito OAuth 2.0 chat.admin.memberships.readonly o chat.admin.memberships.

L'elenco delle iscrizioni alle app in uno spazio non è supportato quando si utilizza l'accesso amministrativo.

ListMembershipsResponse

Risposta per elencare le iscrizioni allo spazio.

Campi
memberships[]

Membership

Elenco non ordinato. Elenco degli abbonamenti nella pagina richiesta (o prima).

next_page_token

string

Un token che puoi inviare come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

ListMessagesRequest

Elenca i messaggi nello spazio specificato di cui l'utente è membro.

Campi
parent

string

Obbligatorio. Il nome della risorsa dello spazio da cui elencare i messaggi.

Formato: spaces/{space}

page_size

int32

Facoltativo. Il numero massimo di messaggi restituiti. Il servizio potrebbe restituire meno messaggi di questo valore.

Se non specificato, vengono restituiti al massimo 25 elementi.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, questo viene modificato automaticamente in 1000.

I valori negativi restituiscono un errore INVALID_ARGUMENT.

page_token

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata dell'elenco dei messaggi. Specifica questo parametro per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token pagina. Se passi valori diversi agli altri parametri, potresti ottenere risultati imprevisti.

filter

string

Facoltativo. Un filtro per query.

Puoi filtrare i messaggi per data (create_time) e thread (thread.name).

Per filtrare i messaggi in base alla data di creazione, specifica create_time con un timestamp nel formato RFC-3339 e virgolette doppie. Ad esempio: "2023-04-21T11:30:00-04:00". Puoi utilizzare l'operatore maggiore di > per elencare i messaggi creati dopo un timestamp o l'operatore minore di < per elencare i messaggi creati prima di un timestamp. Per filtrare i messaggi in un intervallo di tempo, utilizza l'operatore AND tra due timestamp.

Per filtrare per thread, specifica thread.name, formattato come spaces/{space}/threads/{thread}. Puoi specificare un solo thread.name per query.

Per filtrare in base sia al thread che alla data, utilizza l'operatore AND nella query.

Ad esempio, le seguenti query sono valide:

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

order_by

string

Facoltativo. L'ordinamento dell'elenco dei messaggi. Specifica un valore da ordinare in base a un'operazione di ordinamento. I valori validi per l'operazione di ordinamento sono:

  • ASC per ordine crescente.

  • DESC per decrescente.

L'ordinamento predefinito è create_time ASC.

show_deleted

bool

Facoltativo. Se includere i messaggi eliminati. I messaggi eliminati includono l'ora di eliminazione e i metadati relativi all'eliminazione, ma i contenuti dei messaggi non sono disponibili.

ListMessagesResponse

Messaggio di risposta per i messaggi della scheda.

Campi
messages[]

Message

Elenco di messaggi.

next_page_token

string

Puoi inviare un token come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

ListReactionsRequest

Elenca le reazioni a un messaggio.

Campi
parent

string

Obbligatorio. Il messaggio a cui gli utenti hanno aggiunto una reazione.

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

page_size

int32

Facoltativo. Il numero massimo di reazioni restituite. Il servizio può restituire meno reazioni rispetto a questo valore. Se non specificato, il valore predefinito è 25. Il valore massimo è 200; i valori superiori a 200 vengono modificati in 200.

page_token

string

Facoltativo. (Se riprendi da una query precedente).

Un token di pagina ricevuto da una precedente chiamata di elenco delle reazioni. Fornisci questo valore per recuperare la pagina successiva.

Quando viene visualizzata la paginazione, il valore del filtro deve corrispondere alla chiamata che ha fornito il token pagina. Se passi un valore diverso, potresti ottenere risultati imprevisti.

filter

string

Facoltativo. Un filtro per query.

Puoi filtrare le reazioni per emoji (emoji.unicode o emoji.custom_emoji.uid) e utente (user.name).

Per filtrare le reazioni per più emoji o utenti, unisci campi simili con l'operatore OR, ad esempio emoji.unicode = "🙂" OR emoji.unicode = "👍" e user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Per filtrare le reazioni per emoji e utente, utilizza l'operatore AND, ad esempio emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Se la query utilizza sia AND sia OR, raggruppale tra parentesi.

Ad esempio, le seguenti query sono valide:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Le seguenti query non sono valide:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

ListReactionsResponse

Risposta a una richiesta di elenco di reazioni.

Campi
reactions[]

Reaction

Elenco delle reazioni nella pagina richiesta (o prima).

next_page_token

string

Token di continuazione per recuperare la pagina successiva dei risultati. È vuoto per l'ultima pagina dei risultati.

ListSpaceEventsRequest

Richiedi un messaggio per elencare gli eventi dello spazio.

Campi
parent

string

Obbligatorio. Nome della risorsa dello spazio di Google Chat in cui si sono verificati gli eventi.

Formato: spaces/{space}.

page_size

int32

Facoltativo. Il numero massimo di eventi spazio restituiti. Il servizio potrebbe restituire meno di questo valore.

I valori negativi restituiscono un errore INVALID_ARGUMENT.

page_token

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata di eventi dello spazio elenco. Fornisci questo valore per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti per elencare gli eventi dello spazio devono corrispondere alla chiamata che ha fornito il token pagina. Se passi valori diversi agli altri parametri, potresti ottenere risultati imprevisti.

filter

string

Obbligatorio. Un filtro per query.

Devi specificare almeno un tipo di evento (event_type) utilizzando l'operatore ha :. Per filtrare in base a più tipi di eventi, utilizza l'operatore OR. Ometti i tipi di eventi batch nel filtro. La richiesta restituisce automaticamente tutti gli eventi batch correlati. Ad esempio, se filtri per le nuove reazioni (google.workspace.chat.reaction.v1.created), il server restituisce anche gli eventi batch delle nuove reazioni (google.workspace.chat.reaction.v1.batchCreated). Per un elenco dei tipi di eventi supportati, consulta la documentazione di riferimento di SpaceEvents.

Se vuoi, puoi anche filtrare per ora di inizio (start_time) e ora di fine (end_time):

  • start_time: timestamp esclusivo da cui iniziare a elencare gli eventi nello spazio. Puoi elencare gli eventi che si sono verificati fino a 28 giorni fa. Se non specificato, vengono elencati gli eventi dello spazio degli ultimi 28 giorni.
  • end_time: timestamp incluso fino al quale sono elencati gli eventi dello spazio. Se non specificato, vengono elencati gli eventi fino al momento della richiesta.

Per specificare un'ora di inizio o di fine, utilizza l'operatore è uguale a = e il formato RFC-3339. Per filtrare in base a start_time e end_time, utilizza l'operatore AND.

Ad esempio, le seguenti query sono valide:

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"
start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

Le seguenti query non sono valide:

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"
event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

ListSpaceEventsResponse

Messaggio di risposta per la visualizzazione degli eventi dello spazio.

Campi
space_events[]

SpaceEvent

I risultati vengono restituiti in ordine cronologico (primo evento meno recente). Nota: il campo permissionSettings non viene restituito nell'oggetto Space per le richieste di elenco.

next_page_token

string

Token di continuazione utilizzato per recuperare altri eventi. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ListSpacesRequest

Una richiesta di elenco degli spazi di cui l'utente che chiama è membro.

Campi
page_size

int32

Facoltativo. Il numero massimo di spazi da restituire. Il servizio potrebbe restituire meno di questo valore.

Se non specificato, vengono restituiti al massimo 100 spazi.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, questo viene modificato automaticamente in 1000.

I valori negativi restituiscono un errore INVALID_ARGUMENT.

page_token

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata di elenco di spazi. Specifica questo parametro per recuperare la pagina successiva.

Quando viene visualizzata la paginazione, il valore del filtro deve corrispondere alla chiamata che ha fornito il token pagina. Se passi un valore diverso, potresti ottenere risultati imprevisti.

filter

string

Facoltativo. Un filtro per query.

Puoi filtrare gli spazi in base al tipo di spazio (space_type).

Per filtrare in base al tipo di spazio, devi specificare un valore enumerato valido, ad esempio SPACE o GROUP_CHAT (space_type non può essere SPACE_TYPE_UNSPECIFIED). Per eseguire query su più tipi di spazi, utilizza l'operatore OR.

Ad esempio, le seguenti query sono valide:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Le query non valide vengono rifiutate dal server con un errore INVALID_ARGUMENT.

ListSpacesResponse

La risposta a una richiesta di elenco di spazi.

Campi
spaces[]

Space

Elenco di spazi nella pagina richiesta (o prima). Nota: il campo permissionSettings non viene restituito nell'oggetto Space per le richieste di elenco.

next_page_token

string

Puoi inviare un token come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

MatchedUrl

Un URL corrispondente in un messaggio di Chat. Le app di chat possono visualizzare l'anteprima degli URL corrispondenti. Per saperne di più, consulta Visualizzare l'anteprima dei link.

Campi
url

string

Solo output. L'URL a cui è stata trovata una corrispondenza.

Abbonamento

Rappresenta una relazione di appartenenza in Google Chat, ad esempio se un utente o un'app di Chat è invitato a uno spazio, ne fa parte o è assente.

Campi
name

string

Identificatore. Nome della risorsa dell'abbonamento, assegnato dal server.

Formato: spaces/{space}/members/{member}

state

MembershipState

Solo output. Stato dell'abbonamento.

role

MembershipRole

Facoltativo. Il ruolo dell'utente all'interno di uno spazio di Chat, che determina le azioni consentite nello spazio.

Questo campo può essere utilizzato come input solo in UpdateMembership.

create_time

Timestamp

Facoltativo. Immutabile. La data e l'ora di creazione dell'abbonamento, ad esempio quando un membro si è unito o è stato invitato a partecipare a uno spazio. Questo campo è solo di output, tranne quando viene utilizzato per importare gli abbonamenti storici negli spazi in modalità di importazione.

delete_time

Timestamp

Facoltativo. Immutabile. La data e l'ora dell'eliminazione dell'abbonamento, ad esempio quando un membro è uscito o è stato rimosso da uno spazio. Questo campo è solo di output, tranne quando viene utilizzato per importare gli abbonamenti storici negli spazi in modalità di importazione.

Campo unione memberType. Membro associato a questo abbonamento. In futuro potrebbero essere supportati altri tipi di abbonati. memberType può essere solo uno dei seguenti:
member

User

Facoltativo. L'utente o l'app Google Chat a cui corrisponde l'appartenenza. Se la tua app di chat si autentica come utente, l'output compila name e type dell'utente.

group_member

Group

Facoltativo. Il gruppo Google a cui corrisponde l'appartenenza.

La lettura o la modifica delle iscrizioni per Google Gruppi richiede l'autenticazione dell'utente.

MembershipRole

Rappresenta le azioni consentite a un utente in uno spazio di Chat. In futuro potrebbero essere aggiunti altri valori enum.

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Valore predefinito. Per users: non è membro dello spazio, ma può essere invitato. Per Google Groups: a questo ruolo viene sempre assegnato questo ruolo (in futuro potrebbero essere utilizzati altri valori di enum).
ROLE_MEMBER Un membro dello spazio. L'utente dispone di autorizzazioni di base, come l'invio di messaggi allo spazio. Nelle conversazioni 1:1 e di gruppo senza nome, tutti hanno questo ruolo.
ROLE_MANAGER Un gestore dello spazio. L'utente dispone di tutte le autorizzazioni di base, oltre a quelle amministrative che gli consentono di gestire lo spazio, ad esempio aggiungere o rimuovere membri. Supportato solo in SpaceType.SPACE.

MembershipState

Specifica la relazione del membro con uno spazio. In futuro potrebbero essere supportati altri stati dell'abbonamento.

Enum
MEMBERSHIP_STATE_UNSPECIFIED Valore predefinito. Non utilizzare.
JOINED L'utente viene aggiunto allo spazio e può partecipare.
INVITED L'utente è stato invitato a partecipare allo spazio, ma non lo ha ancora fatto.
NOT_A_MEMBER L'utente non appartiene allo spazio e non ha un invito in attesa per partecipare.

MembershipBatchCreatedEventData

Payload dell'evento per più nuovi abbonamenti.

Tipo di evento: google.workspace.chat.membership.v1.batchCreated

Campi
memberships[]

MembershipCreatedEventData

Un elenco di nuovi abbonamenti.

MembershipBatchDeletedEventData

Payload dell'evento per più abbonamenti eliminati.

Tipo di evento: google.workspace.chat.membership.v1.batchDeleted

Campi
memberships[]

MembershipDeletedEventData

Un elenco di abbonamenti eliminati.

MembershipBatchUpdatedEventData

Payload dell'evento per più abbonamenti aggiornati.

Tipo di evento: google.workspace.chat.membership.v1.batchUpdated

Campi
memberships[]

MembershipUpdatedEventData

Un elenco di abbonamenti aggiornati.

MembershipCreatedEventData

Payload evento per un nuovo abbonamento.

Tipo di evento: google.workspace.chat.membership.v1.created.

Campi
membership

Membership

Il nuovo abbonamento.

MembershipDeletedEventData

Payload evento per un abbonamento eliminato.

Tipo di evento: google.workspace.chat.membership.v1.deleted

Campi
membership

Membership

L'abbonamento eliminato. Vengono compilati solo i campi name e state.

MembershipUpdatedEventData

Payload evento per un abbonamento aggiornato.

Tipo di evento: google.workspace.chat.membership.v1.updated

Campi
membership

Membership

L'abbonamento aggiornato.

Messaggio

Un messaggio in uno spazio di Google Chat.

Campi
name

string

Identificatore. Nome della risorsa del messaggio.

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

Dove {space} è l'ID dello spazio in cui è pubblicato il messaggio e {message} è un ID assegnato dal sistema al 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

User

Solo output. L'utente che ha creato il messaggio. Se la tua app di chat si autentica come utente, l'output compila name e type dell'utente.

create_time

Timestamp

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 il messaggio è stato creato nell'origine per conservare l'ora di creazione originale.

last_update_time

Timestamp

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.

delete_time

Timestamp

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 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 sulla creazione di messaggi, vedi Inviare un messaggio.

formatted_text

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 del markup per grassetto, corsivo, barrato, carattere monospazio, blocco di carattere monospazio ed elenco puntato.

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

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

  • Emoji personalizzate che utilizzano il formato :{emoji_name}:, ad esempio :smile:. Questo 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)

Card

Deprecato: utilizza cards_v2.

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 testo normale. cards e cards_v2 possono avere una dimensione massima di 32 KB.

cards_v2[]

CardWithId

Facoltativo. Un array di schede.

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

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

Progetta e visualizza l'anteprima delle schede con lo strumento per la creazione di schede.

Apri lo strumento per la creazione di schede

annotations[]

Annotation

Solo output. Annotazioni associate a text in questo messaggio.

thread

Thread

Il thread a cui appartiene il messaggio. Per esempi di utilizzo, vedi Avvia o rispondi a un thread di messaggi.

space

Space

Solo output. Se la tua app di Chat si autentica come utente, l'output compila solo lo spazio name.

fallback_text

string

Facoltativo. Una descrizione in testo normale delle schede del messaggio, utilizzata quando non è possibile visualizzare le schede effettive, ad esempio le notifiche mobile.

action_response

ActionResponse

Solo input. Parametri che un'app di chat può utilizzare per configurare il modo in cui viene pubblicata la sua risposta.

argument_text

string

Solo output. Testo normale del messaggio con tutte le menzioni dell'app Chat rimosse.

slash_command

SlashCommand

Solo output. Informazioni sul comando slash, se applicabile.

attachment[]

Attachment

Facoltativo. Allegato caricato dall'utente.

matched_url

MatchedUrl

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

thread_reply

bool

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

client_assigned_message_id

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.

emoji_reaction_summaries[]

EmojiReactionSummary

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

private_message_viewer

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 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 in privato.

deletion_metadata

DeletionMetadata

Solo output. Informazioni su un messaggio eliminato. Un messaggio viene eliminato quando è impostato delete_time.

quoted_message_metadata

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.

attached_gifs[]

AttachedGif

Solo output. Immagini GIF allegate al messaggio.

accessory_widgets[]

AccessoryWidget

Facoltativo. Uno o più widget interattivi visualizzati nella parte inferiore di un messaggio. Puoi aggiungere widget accessori ai messaggi che contengono testo, schede o testo e schede. Non supportato 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 dell'app.

MessageBatchCreatedEventData

Payload dell'evento per più nuovi messaggi.

Tipo di evento: google.workspace.chat.message.v1.batchCreated

Campi
messages[]

MessageCreatedEventData

Un elenco di nuovi messaggi.

MessageBatchDeletedEventData

Payload dell'evento per più messaggi eliminati.

Tipo di evento: google.workspace.chat.message.v1.batchDeleted

Campi
messages[]

MessageDeletedEventData

Un elenco di messaggi eliminati.

MessageBatchUpdatedEventData

Payload dell'evento per più messaggi aggiornati.

Tipo di evento: google.workspace.chat.message.v1.batchUpdated

Campi
messages[]

MessageUpdatedEventData

Un elenco di messaggi aggiornati.

MessageCreatedEventData

Payload evento per un nuovo messaggio.

Tipo di evento: google.workspace.chat.message.v1.created

Campi
message

Message

Il nuovo messaggio.

MessageDeletedEventData

Payload dell'evento per un messaggio eliminato.

Tipo di evento: google.workspace.chat.message.v1.deleted

Campi
message

Message

Il messaggio eliminato. Vengono compilati solo i campi name, createTime, deleteTime e deletionMetadata.

MessageUpdatedEventData

Payload evento per un messaggio aggiornato.

Tipo di evento: google.workspace.chat.message.v1.updated

Campi
message

Message

Il messaggio aggiornato.

QuotedMessageMetadata

Informazioni su un messaggio tra virgolette.

Campi
name

string

Solo output. Nome della risorsa del messaggio tra virgolette.

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

last_update_time

Timestamp

Solo output. Il timestamp della creazione o dell'ultimo aggiornamento del messaggio tra virgolette.

Reazioni

Una reazione a un messaggio.

Campi
name

string

Identificatore. Il nome della risorsa della reazione.

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

user

User

Solo output. L'utente che ha creato la reazione.

emoji

Emoji

Obbligatorio. L'emoji utilizzata nella reazione.

ReactionBatchCreatedEventData

Payload dell'evento per più nuove reazioni.

Tipo di evento: google.workspace.chat.reaction.v1.batchCreated

Campi
reactions[]

ReactionCreatedEventData

Un elenco di nuove reazioni.

ReactionBatchDeletedEventData

Payload dell'evento per più reazioni eliminate.

Tipo di evento: google.workspace.chat.reaction.v1.batchDeleted

Campi
reactions[]

ReactionDeletedEventData

Un elenco delle reazioni eliminate.

ReactionCreatedEventData

Payload dell'evento per una nuova reazione.

Tipo di evento: google.workspace.chat.reaction.v1.created

Campi
reaction

Reaction

La nuova reazione.

ReactionDeletedEventData

Payload evento per una reazione eliminata.

Tipo: google.workspace.chat.reaction.v1.deleted

Campi
reaction

Reaction

La reazione eliminata.

RichLinkMetadata

Un link avanzato a una risorsa.

Campi
uri

string

L'URI di questo link.

Campo unione data. Dati per la 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 per gli spazi di Chat. Ad esempio, uno smart chip per lo spazio.

SearchSpacesRequest

Richiesta di ricerca di un elenco di spazi in base a una query.

Campi
use_admin_access

bool

Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'ambito OAuth 2.0 chat.admin.spaces.readonly o chat.admin.spaces.

Al momento, questo metodo supporta solo l'accesso amministrativo, pertanto per questo campo è accettato solo true.

page_size

int32

Il numero massimo di spazi da restituire. Il servizio potrebbe restituire meno di questo valore.

Se non specificato, vengono restituiti al massimo 100 spazi.

Il valore massimo è 1000. Se utilizzi un valore superiore a 1000, questo viene modificato automaticamente in 1000.

page_token

string

Un token ricevuto dalla chiamata dello spazio di ricerca precedente. Specifica questo parametro per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token pagina. Se passi valori diversi agli altri parametri, potresti ottenere risultati imprevisti.

query

string

Obbligatorio. Una query di ricerca.

Puoi eseguire ricerche utilizzando i seguenti parametri:

  • create_time
  • customer
  • display_name
  • external_user_allowed
  • last_active_time
  • space_history_state
  • space_type

create_time e last_active_time accettano un timestamp in formato RFC-3339 e gli operatori di confronto supportati sono: =, <, >, <=, >=.

customer è obbligatorio e viene utilizzato per indicare da quale cliente recuperare gli spazi. customers/my_customer è l'unico valore supportato.

display_name accetta solo l'operatore HAS (:). Il testo da associare viene prima tokenizzato in token e ciascun token viene associato al prefisso indipendentemente dalle maiuscole e minuscole e come sottostringa in qualsiasi punto di display_name dello spazio. Ad esempio, Fun Eve corrisponde a Fun event o The evening was fun, ma non a notFun event o even.

external_user_allowed accetta true o false.

space_history_state accetta solo i valori del campo historyState di una risorsa space.

space_type è obbligatorio e l'unico valore valido è SPACE.

In diversi campi, sono supportati solo gli operatori AND. Un esempio valido è space_type = "SPACE" AND display_name:"Hello" e un esempio non valido è space_type = "SPACE" OR display_name:"Hello".

Nello stesso campo, space_type non supporta gli operatori AND o OR. display_name, "space_history_state" ed "external_user_allowed" supportano solo gli operatori OR. last_active_time e create_time supportano entrambi gli operatori AND e OR. AND può essere utilizzato solo per rappresentare un intervallo, ad esempio last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00".

Le seguenti query di esempio sono valide:

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by

string

Facoltativo. L'ordinamento dell'elenco di spazi.

Gli attributi supportati per l'ordinamento sono:

  • membership_count.joined_direct_human_user_count: indica il numero di utenti che si sono uniti direttamente a uno spazio.
  • last_active_time: indica l'ora in cui è stato aggiunto l'ultimo elemento idoneo a qualsiasi argomento di questo spazio.
  • create_time: indica l'ora di creazione dello spazio.

I valori validi per l'operazione di ordinamento sono:

  • ASC per ordine crescente. Valore predefinito.

  • DESC per decrescente.

Le sintassi supportate sono:

  • membership_count.joined_direct_human_user_count DESC
  • membership_count.joined_direct_human_user_count ASC
  • last_active_time DESC
  • last_active_time ASC
  • create_time DESC
  • create_time ASC

SearchSpacesResponse

Rispondi con un elenco di spazi corrispondenti alla richiesta di spazi di ricerca.

Campi
spaces[]

Space

Una pagina degli spazi richiesti.

next_page_token

string

Un token che può essere utilizzato per recuperare la pagina successiva. Se questo campo è vuoto, non ci sono pagine successive.

total_size

int32

Il numero totale di spazi che corrispondono alla query in tutte le pagine. Se il risultato è superiore a 10.000 spazi, questo valore è una stima.

SetUpSpaceRequest

Richiedi di creare uno spazio e aggiungi utenti specifici.

Campi
space

Space

Obbligatorio. Il campo Space.spaceType è obbligatorio.

Per creare uno spazio, imposta Space.spaceType su SPACE e imposta Space.displayName. Se ricevi il messaggio di errore ALREADY_EXISTS durante la configurazione di uno spazio, prova un altro displayName. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Per creare una chat di gruppo, imposta Space.spaceType su GROUP_CHAT. Non impostare Space.displayName.

Per creare una conversazione 1:1 tra persone, imposta Space.spaceType su DIRECT_MESSAGE e Space.singleUserBotDm su false. Non impostare Space.displayName o Space.spaceDetails.

Per creare una conversazione 1:1 tra una persona e l'app di Chat che effettua la chiamata, imposta Space.spaceType su DIRECT_MESSAGE e Space.singleUserBotDm su true. Non impostare Space.displayName o Space.spaceDetails.

Se esiste già uno spazio DIRECT_MESSAGE, viene restituito anziché crearne uno nuovo.

request_id

string

Facoltativo. Un identificatore univoco per questa richiesta. È consigliabile utilizzare un UUID casuale. Se specifichi un ID richiesta esistente, viene restituito lo spazio creato con quell'ID anziché crearne uno nuovo. Se specifichi un ID richiesta esistente della stessa app Chat con un utente autenticato diverso, viene restituito un errore.

memberships[]

Membership

Facoltativo. Gli utenti o i gruppi di Google Chat da invitare a partecipare allo spazio. Ometti l'utente che chiama, poiché viene aggiunto automaticamente.

Attualmente, il set consente fino a 20 abbonamenti (oltre a quello del chiamante).

Per l'appartenenza umana, il campo Membership.member deve contenere un user con name compilato (formato: users/{user}) e type impostato su User.Type.HUMAN. Puoi aggiungere utenti umani solo durante la configurazione di uno spazio (l'aggiunta di app di Chat è supportata solo per la configurazione dei messaggi diretti con l'app di chiamata). Puoi anche aggiungere membri utilizzando l'indirizzo email dell'utente come alias per {user}. Ad esempio, user.name può essere users/example@gmail.com. Per invitare utenti di Gmail o di domini Google Workspace esterni, è necessario utilizzare l'indirizzo email dell'utente per {user}.

Per l'appartenenza al gruppo Google, il campo Membership.group_member deve contenere un group con name compilato (formato groups/{group}). Puoi aggiungere gruppi Google solo impostando Space.spaceType su SPACE.

Facoltativo quando imposti Space.spaceType su SPACE.

Obbligatorio quando Space.spaceType è impostato su GROUP_CHAT, insieme ad almeno due adesioni.

Obbligatorio quando imposti Space.spaceType su DIRECT_MESSAGE con un utente umano, insieme a un solo abbonamento.

Deve essere vuoto quando viene creata una conversazione 1:1 tra una persona e l'app Chat che effettua la chiamata (quando Space.spaceType è impostato su DIRECT_MESSAGE e Space.singleUserBotDm su true).

SlashCommand

Un comando con barra in Google Chat.

Campi
command_id

int64

L'ID del comando slash invocato.

SlashCommandMetadata

Metadati di annotazione per i comandi slash (/).

Campi
bot

User

L'app Chat di cui è stato invocato il comando.

type

Type

Il tipo di comando slash.

command_name

string

Il nome del comando slash invocato.

command_id

int64

L'ID del comando slash invocato.

triggers_dialog

bool

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 Richiama il comando slash nello spazio.

Spazio

Uno spazio in Google Chat. Gli spazi sono conversazioni tra due o più utenti o messaggi 1:1 tra un utente e un'app di chat.

Campi
name

string

Identificatore. Nome della risorsa dello spazio.

Formato: spaces/{space}

Dove {space} rappresenta l'ID assegnato dal sistema allo spazio. Puoi ottenere l'ID spazio chiamando il metodo spaces.list() o dall'URL dello spazio. Ad esempio, se l'URL dello spazio è https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, l'ID spazio è AAAAAAAAA.

type
(deprecated)

Type

Solo output. Deprecato: utilizza space_type. Il tipo di uno spazio.

space_type

SpaceType

Facoltativo. Il tipo di spazio. Obbligatorio per la creazione o l'aggiornamento del tipo di uno spazio. Output solo per altri utilizzi.

single_user_bot_dm

bool

Facoltativo. Indica se lo spazio è un messaggio diretto tra un'app Chat e una singola persona.

threaded
(deprecated)

bool

Solo output. Deprecato: utilizza spaceThreadingState. Indica se i messaggi sono organizzati in thread in questo spazio.

display_name

string

Facoltativo. Il nome visualizzato dello spazio. Obbligatorio quando crei uno spazio con un spaceType pari a SPACE. Se ricevi il messaggio di errore ALREADY_EXISTS durante la creazione di uno spazio o l'aggiornamento del displayName, prova un displayName diverso. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Per i messaggi diretti, questo campo potrebbe essere vuoto.

Supporta fino a 128 caratteri.

external_user_allowed

bool

Facoltativo. Immutabile. Indica se questo spazio consente a qualsiasi utente di Google Chat di essere membro. Input da inserire durante la creazione di uno spazio in un'organizzazione Google Workspace. Ometti questo campo quando crei spazi nelle seguenti condizioni:

  • L'utente autenticato utilizza un account consumer (account utente non gestito). Per impostazione predefinita, uno spazio creato da un account consumer consente l'accesso a qualsiasi utente di Google Chat.

Per gli spazi esistenti, questo campo è solo di output.

space_threading_state

SpaceThreadingState

Solo output. Lo stato della conversazione in thread nello spazio di Chat.

space_details

SpaceDetails

Facoltativo. Dettagli sullo spazio, tra cui descrizione e regole.

space_history_state

HistoryState

Facoltativo. Lo stato della cronologia dei messaggi per i messaggi e i thread in questo spazio.

import_mode

bool

Facoltativo. Indica se questo spazio è stato creato in Import Mode nell'ambito di una migrazione dei dati in Google Workspace. Durante l'importazione, gli spazi non sono visibili agli utenti finché l'operazione non è completata.

La creazione di uno spazio in Import Moderichiede l'autenticazione dell'utente.

create_time

Timestamp

Facoltativo. Immutabile. Per gli spazi creati in Chat, l'ora in cui è stato creato lo spazio. 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 lo spazio è stato creato nell'origine per preservare l'ora di creazione originale.

Viene compilato nell'output solo quando spaceType è GROUP_CHAT o SPACE.

last_active_time

Timestamp

Solo output. Timestamp dell'ultimo messaggio nello spazio.

admin_installed

bool

Solo output. Per gli spazi con messaggi diretti (DM) con un'app di Chat, indica se lo spazio è stato creato da un amministratore di Google Workspace. Gli amministratori possono installare e configurare un messaggio diretto con un'app di chat per conto degli utenti della loro organizzazione.

Per supportare l'installazione da amministratore, l'app Chat deve includere la messaggistica diretta.

membership_count

MembershipCount

Solo output. Il numero di abbonamenti uniti raggruppati per tipo di abbonamento. Viene compilato quando space_type è SPACE, DIRECT_MESSAGE o GROUP_CHAT.

access_settings

AccessSettings

Facoltativo. Specifica l'impostazione di accesso dello spazio. Viene compilato solo quando space_type è SPACE.

space_uri

string

Solo output. L'URI per consentire a un utente di accedere allo spazio.

import_mode_expire_time

Timestamp

Solo output. La data e l'ora in cui lo spazio verrà eliminato automaticamente dal sistema se rimane in modalità di importazione.

Ogni spazio creato in modalità di importazione deve uscire da questa modalità prima della scadenza utilizzando spaces.completeImport.

Questo campo viene compilato solo per gli spazi creati con la modalità di importazione.

customer

string

Facoltativo. Immutabile. L'ID cliente del dominio dello spazio. Obbligatorio solo quando si crea uno spazio con autenticazione app e SpaceType è SPACE, altrimenti non deve essere impostato.

Nel formato customers/{customer}, dove customer è id della [risorsa cliente dell'SDK Admin]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Le app private possono anche utilizzare l'alias customers/my_customer per creare lo spazio nella stessa organizzazione Google Workspace dell'app.

Per i messaggi diretti, questo campo non viene compilato.

Campo unione space_permission_settings. Rappresenta le impostazioni di autorizzazione di uno spazio. Viene compilato solo quando space_type è SPACE.

Richiede l'autenticazione utente. space_permission_settings può essere solo uno dei seguenti:

predefined_permission_settings

PredefinedPermissionSettings

Facoltativo. Solo input. Impostazioni predefinite per le autorizzazioni dello spazio, da inserire solo al momento della creazione di uno spazio. Se il campo non è impostato, viene creato uno spazio di collaborazione. Dopo aver creato lo spazio, le impostazioni vengono inserite nel campo PermissionSettings.

permission_settings

PermissionSettings

Facoltativo. Impostazioni delle autorizzazioni per gli spazi esistenti. Input per aggiornare le impostazioni di autorizzazione dello spazio esatta, in cui le impostazioni di autorizzazione esistenti vengono sostituite. L'output elenca le impostazioni di autorizzazione correnti.

AccessSettings

Rappresenta l'impostazione di accesso dello spazio.

Campi
access_state

AccessState

Solo output. Indica lo stato di accesso dello spazio.

audience

string

Facoltativo. Il nome della risorsa del pubblico di destinazione che può trovare lo spazio, partecipare e visualizzare l'anteprima dei messaggi. Se non è impostato, solo gli utenti o i gruppi Google che sono stati invitati o aggiunti singolarmente allo spazio possono accedervi. Per maggiori dettagli, vedi Rendere uno spazio rilevabile da un pubblico di destinazione.

Formato: audiences/{audience}

Per utilizzare il pubblico di destinazione predefinito per l'organizzazione Google Workspace, imposta il valore audiences/default.

La lettura del pubblico di destinazione supporta:

Questo campo non viene compilato quando si utilizza l'ambito chat.bot con l'autenticazione app.

L'impostazione del pubblico di destinazione richiede l'autenticazione utente.

AccessState

Rappresenta lo stato di accesso dello spazio.

Enum
ACCESS_STATE_UNSPECIFIED Lo stato di accesso è sconosciuto o non supportato in questa API.
PRIVATE Solo gli utenti o i gruppi Google aggiunti o invitati singolarmente da altri utenti o amministratori di Google Workspace possono scoprire e accedere allo spazio.
DISCOVERABLE

Un gestore dello spazio ha concesso l'accesso allo spazio a un pubblico di destinazione. Anche gli utenti o i gruppi Google aggiunti o invitati singolarmente allo spazio possono trovarlo e accedervi. Per scoprire di più, vedi Rendere uno spazio rilevabile per utenti specifici.

La creazione di spazi rilevabili richiede l'autenticazione dell'utente.

MembershipCount

Rappresenta il numero di adesioni a uno spazio, raggruppate in categorie.

Campi
joined_direct_human_user_count

int32

Solo output. Numero di utenti che si sono uniti direttamente allo spazio, esclusi gli utenti che si sono uniti tramite l'iscrizione a un gruppo unito.

joined_group_count

int32

Solo output. Conteggio di tutti i gruppi che hanno aderito direttamente allo spazio.

PermissionSetting

Rappresenta un'impostazione di autorizzazione per lo spazio.

Campi
managers_allowed

bool

Facoltativo. Indica se i gestori degli spazi dispongono di questa autorizzazione.

members_allowed

bool

Facoltativo. Indica se i membri non gestori dispongono di questa autorizzazione.

PermissionSettings

Impostazioni di autorizzazione che puoi specificare quando aggiorni uno spazio denominato esistente.

Per impostare le impostazioni di autorizzazione durante la creazione di uno spazio, specifica il campo PredefinedPermissionSettings nella richiesta.

Campi
manage_members_and_groups

PermissionSetting

Facoltativo. Impostazione per la gestione di membri e gruppi in uno spazio.

modify_space_details

PermissionSetting

Facoltativo. Impostazione per aggiornare il nome, l'avatar, la descrizione e le linee guida dello spazio.

toggle_history

PermissionSetting

Facoltativo. Impostazione per attivare e disattivare la cronologia dello spazio.

use_at_mention_all

PermissionSetting

Facoltativo. Impostazione per l'utilizzo di @tutti in uno spazio.

manage_apps

PermissionSetting

Facoltativo. Impostazione per la gestione delle app in uno spazio.

manage_webhooks

PermissionSetting

Facoltativo. Impostazione per la gestione degli webhook in uno spazio.

post_messages

PermissionSetting

Solo output. Impostazione per la pubblicazione di messaggi in uno spazio.

reply_messages

PermissionSetting

Facoltativo. Impostazione per rispondere ai messaggi in uno spazio.

PredefinedPermissionSettings

Impostazioni di autorizzazione predefinite che puoi specificare solo quando crei uno spazio denominato. In futuro potrebbero essere aggiunte altre impostazioni. Per informazioni dettagliate sulle impostazioni delle autorizzazioni per gli spazi con nome, vedi Informazioni sugli spazi.

Enum
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED Non specificato. Non utilizzare.
COLLABORATION_SPACE Impostazione per rendere lo spazio uno spazio di collaborazione in cui tutti i membri possono pubblicare messaggi.
ANNOUNCEMENT_SPACE Impostazione per rendere lo spazio uno spazio per gli annunci in cui solo i gestori dello spazio possono pubblicare messaggi.

SpaceDetails

Dettagli sullo spazio, tra cui descrizione e regole.

Campi
description

string

Facoltativo. Una descrizione dello spazio. Ad esempio, descrivi l'argomento della discussione, lo scopo funzionale o i partecipanti dello spazio.

Supporta fino a 150 caratteri.

guidelines

string

Facoltativo. Le regole, le aspettative e il galateo dello spazio.

Supporta fino a 5000 caratteri.

SpaceThreadingState

Specifica il tipo di stato di threading nello spazio di Chat.

Enum
SPACE_THREADING_STATE_UNSPECIFIED Riservato.
THREADED_MESSAGES Spazi con nome che supportano i thread di messaggi. Quando gli utenti rispondono a un messaggio, possono farlo all'interno del thread, in modo che la risposta rimanga nel contesto del messaggio originale.
GROUPED_MESSAGES Spazi con nome in cui la conversazione è organizzata per argomento. Gli argomenti e le relative risposte vengono raggruppati.
UNTHREADED_MESSAGES Messaggi diretti tra due persone e conversazioni di gruppo tra 3 o più persone.

SpaceType

Il tipo di spazio. Obbligatorio quando si crea o aggiorna uno spazio. Output solo per altri utilizzi.

Enum
SPACE_TYPE_UNSPECIFIED Riservato.
SPACE Un luogo in cui le persone inviano messaggi, condividono file e collaborano. Un SPACE può includere app di Chat.
GROUP_CHAT Conversazioni di gruppo tra 3 o più persone. Un GROUP_CHAT può includere app di Chat.
DIRECT_MESSAGE Messaggi 1:1 tra due persone o tra una persona e un'app di chat.

Tipo

Deprecato: utilizza SpaceType.

Enum
TYPE_UNSPECIFIED Riservato.
ROOM Conversazioni tra due o più persone.
DM Messaggio diretto 1:1 tra una persona e un'app di chat, in cui tutti i messaggi sono invariati. Tieni presente che non sono inclusi i messaggi diretti tra due persone.

SpaceBatchUpdatedEventData

Payload evento per più aggiornamenti di uno spazio.

Tipo di evento: google.workspace.chat.space.v1.batchUpdated

Campi
spaces[]

SpaceUpdatedEventData

Un elenco di spazi aggiornati.

SpaceEvent

Un evento che rappresenta una modifica o un'attività in uno spazio di Google Chat. Per scoprire di più, consulta Lavorare con gli eventi di Google Chat.

Campi
name

string

Nome della risorsa dell'evento dello spazio.

Formato: spaces/{space}/spaceEvents/{spaceEvent}

event_time

Timestamp

Ora in cui si è verificato l'evento.

event_type

string

Tipo di evento nello spazio. Ogni tipo di evento ha una versione batch, che rappresenta più istanze del tipo di evento che si verificano in un breve periodo di tempo. Per le richieste spaceEvents.list(), ometti i tipi di eventi batch nel filtro della query. Per impostazione predefinita, il server restituisce sia il tipo di evento sia la relativa versione batch.

Tipi di eventi supportati per i messaggi:

  • Nuovo messaggio: google.workspace.chat.message.v1.created
  • Messaggio aggiornato: google.workspace.chat.message.v1.updated
  • Messaggio eliminato: google.workspace.chat.message.v1.deleted
  • Più nuovi messaggi: google.workspace.chat.message.v1.batchCreated
  • Più messaggi aggiornati: google.workspace.chat.message.v1.batchUpdated
  • Più messaggi eliminati: google.workspace.chat.message.v1.batchDeleted

Tipi di eventi supportati per gli abbonamenti:

  • Nuovo abbonamento: google.workspace.chat.membership.v1.created
  • Abbonamento aggiornato: google.workspace.chat.membership.v1.updated
  • Abbonamento eliminato: google.workspace.chat.membership.v1.deleted
  • Più nuovi abbonamenti: google.workspace.chat.membership.v1.batchCreated
  • Più abbonamenti aggiornati: google.workspace.chat.membership.v1.batchUpdated
  • Più abbonamenti eliminati: google.workspace.chat.membership.v1.batchDeleted

Tipi di eventi supportati per le reazioni:

  • Nuova reazione: google.workspace.chat.reaction.v1.created
  • Reazione eliminata: google.workspace.chat.reaction.v1.deleted
  • Più nuove reazioni: google.workspace.chat.reaction.v1.batchCreated
  • Più reazioni eliminate: google.workspace.chat.reaction.v1.batchDeleted

Tipi di eventi supportati relativi allo spazio:

  • Spazio aggiornato: google.workspace.chat.space.v1.updated
  • Più aggiornamenti dello spazio: google.workspace.chat.space.v1.batchUpdated

Campo unione payload.

payload può essere solo uno dei seguenti:

message_created_event_data

MessageCreatedEventData

Payload evento per un nuovo messaggio.

Tipo di evento: google.workspace.chat.message.v1.created

message_updated_event_data

MessageUpdatedEventData

Payload evento per un messaggio aggiornato.

Tipo di evento: google.workspace.chat.message.v1.updated

message_deleted_event_data

MessageDeletedEventData

Payload dell'evento per un messaggio eliminato.

Tipo di evento: google.workspace.chat.message.v1.deleted

message_batch_created_event_data

MessageBatchCreatedEventData

Payload dell'evento per più nuovi messaggi.

Tipo di evento: google.workspace.chat.message.v1.batchCreated

message_batch_updated_event_data

MessageBatchUpdatedEventData

Payload dell'evento per più messaggi aggiornati.

Tipo di evento: google.workspace.chat.message.v1.batchUpdated

message_batch_deleted_event_data

MessageBatchDeletedEventData

Payload dell'evento per più messaggi eliminati.

Tipo di evento: google.workspace.chat.message.v1.batchDeleted

space_updated_event_data

SpaceUpdatedEventData

Payload evento per un aggiornamento dello spazio.

Tipo di evento: google.workspace.chat.space.v1.updated

space_batch_updated_event_data

SpaceBatchUpdatedEventData

Payload evento per più aggiornamenti di uno spazio.

Tipo di evento: google.workspace.chat.space.v1.batchUpdated

membership_created_event_data

MembershipCreatedEventData

Payload evento per un nuovo abbonamento.

Tipo di evento: google.workspace.chat.membership.v1.created

membership_updated_event_data

MembershipUpdatedEventData

Payload evento per un abbonamento aggiornato.

Tipo di evento: google.workspace.chat.membership.v1.updated

membership_deleted_event_data

MembershipDeletedEventData

Payload evento per un abbonamento eliminato.

Tipo di evento: google.workspace.chat.membership.v1.deleted

membership_batch_created_event_data

MembershipBatchCreatedEventData

Payload dell'evento per più nuovi abbonamenti.

Tipo di evento: google.workspace.chat.membership.v1.batchCreated

membership_batch_updated_event_data

MembershipBatchUpdatedEventData

Payload dell'evento per più abbonamenti aggiornati.

Tipo di evento: google.workspace.chat.membership.v1.batchUpdated

membership_batch_deleted_event_data

MembershipBatchDeletedEventData

Payload dell'evento per più abbonamenti eliminati.

Tipo di evento: google.workspace.chat.membership.v1.batchDeleted

reaction_created_event_data

ReactionCreatedEventData

Payload dell'evento per una nuova reazione.

Tipo di evento: google.workspace.chat.reaction.v1.created

reaction_deleted_event_data

ReactionDeletedEventData

Payload evento per una reazione eliminata.

Tipo di evento: google.workspace.chat.reaction.v1.deleted

reaction_batch_created_event_data

ReactionBatchCreatedEventData

Payload dell'evento per più nuove reazioni.

Tipo di evento: google.workspace.chat.reaction.v1.batchCreated

reaction_batch_deleted_event_data

ReactionBatchDeletedEventData

Payload dell'evento per più reazioni eliminate.

Tipo di evento: google.workspace.chat.reaction.v1.batchDeleted

SpaceNotificationSetting

Le impostazioni di notifica di un utente in uno spazio.

Campi
name

string

Identificatore. Il nome della risorsa dell'impostazione di notifica dello spazio. Formato: users/{user}/spaces/{space}/spaceNotificationSetting.

notification_setting

NotificationSetting

L'impostazione di notifica.

mute_setting

MuteSetting

L'impostazione di disattivazione audio delle notifiche dello spazio.

MuteSetting

I tipi di impostazioni di disattivazione delle notifiche dello spazio.

Enum
MUTE_SETTING_UNSPECIFIED Riservato.
UNMUTED L'utente riceverà notifiche per lo spazio in base all'impostazione delle notifiche.
MUTED L'utente non riceverà alcuna notifica per lo spazio, indipendentemente dall'impostazione della notifica.

NotificationSetting

I tipi di impostazioni di notifica.

Enum
NOTIFICATION_SETTING_UNSPECIFIED Riservato.
ALL Le notifiche vengono attivate da @menzioni, thread seguiti, primo messaggio di nuovi thread. Tutti i nuovi thread vengono seguiti automaticamente, a meno che l'utente non li rimuovi manualmente.
MAIN_CONVERSATIONS La notifica viene attivata dalle @menzioni, dai thread seguiti e dal primo messaggio dei nuovi thread. Non disponibile per i messaggi diretti 1:1.
FOR_YOU La notifica viene attivata dalle @menzioni e dai thread seguiti. Non disponibile per i messaggi diretti 1:1.
OFF La notifica è disattivata.

SpaceReadState

Lo stato di lettura di un utente all'interno di uno spazio, utilizzato per identificare i messaggi letti e da leggere.

Campi
name

string

Nome della risorsa dello stato di lettura dello spazio.

Formato: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

Facoltativo. L'ora in cui è stato aggiornato lo stato di lettura dello spazio dell'utente. Di solito corrisponde al timestamp dell'ultimo messaggio letto o a un timestamp specificato dall'utente per contrassegnare l'ultima posizione di lettura in uno spazio.

SpaceUpdatedEventData

Payload evento per uno spazio aggiornato.

Tipo di evento: google.workspace.chat.space.v1.updated

Campi
space

Space

Lo spazio aggiornato.

Thread

Un thread in uno spazio di Google Chat. Per esempi di utilizzo, vedi Avvia o rispondi a un thread di messaggi.

Se specifichi un thread durante la creazione di un messaggio, puoi impostare il campo messageReplyOption per determinare cosa succede se non viene trovato alcun thread corrispondente.

Campi
name

string

Identificatore. Nome della risorsa del thread.

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

thread_key

string

Facoltativo. Input per la creazione o l'aggiornamento di un thread. In caso contrario, viene visualizzato solo l'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 in un thread creato da una persona o da un'altra app di chat, specifica il campo name del thread.

ThreadReadState

Lo stato di lettura di un utente all'interno di un thread, utilizzato per identificare i messaggi letti e da leggere.

Campi
name

string

Nome della risorsa dello stato di lettura del thread.

Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

L'ora in cui è stato aggiornato lo stato di lettura del thread dell'utente. In genere corrisponde al timestamp dell'ultimo messaggio letto in un thread.

UpdateMembershipRequest

Messaggio di richiesta per l'aggiornamento di un abbonamento.

Campi
membership

Membership

Obbligatorio. L'abbonamento da aggiornare. Vengono aggiornati solo i campi specificati da update_mask.

update_mask

FieldMask

Obbligatorio. I percorsi dei campi da aggiornare. Separa più valori con virgole o utilizza * per aggiornare tutti i percorsi dei campi.

Percorsi dei campi attualmente supportati:

  • role
use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'chat.admin.memberships ambito OAuth 2.0.

UpdateMessageRequest

Richiedere l'aggiornamento di un messaggio.

Campi
message

Message

Obbligatorio. Messaggio con i campi aggiornati.

update_mask

FieldMask

Obbligatorio. I percorsi dei campi da aggiornare. Separa più valori con virgole o utilizza * per aggiornare tutti i percorsi dei campi.

Percorsi dei campi attualmente supportati:

allow_missing

bool

Facoltativo. Se true e il messaggio non vengono trovati, viene creato un nuovo messaggio e updateMask viene ignorato. L'ID messaggio specificato deve essere assegnato dal client, altrimenti la richiesta non avrà esito positivo.

UpdateSpaceNotificationSettingRequest

Richiedi l'aggiornamento delle impostazioni di notifica dello spazio. Supporta solo l'aggiornamento dell'impostazione di notifica per l'utente che chiama.

Campi
space_notification_setting

SpaceNotificationSetting

Obbligatorio. Il nome della risorsa per le impostazioni di notifica dello spazio deve essere inserito nel formato users/{user}/spaces/{space}/spaceNotificationSetting. Vengono aggiornati solo i campi specificati da update_mask.

update_mask

FieldMask

Obbligatorio. Percorsi dei campi supportati: - notification_setting - mute_setting

UpdateSpaceReadStateRequest

Messaggio di richiesta per l'API UpdateSpaceReadState.

Campi
space_read_state

SpaceReadState

Obbligatorio. Lo stato di lettura dello spazio e i campi da aggiornare.

Supporta solo l'aggiornamento dello stato di lettura per l'utente che chiama.

Per fare riferimento all'utente che chiama, imposta una delle seguenti opzioni:

  • L'alias me. Ad esempio, users/me/spaces/{space}/spaceReadState.

  • Il relativo indirizzo email Workspace. Ad esempio, users/user@example.com/spaces/{space}/spaceReadState.

  • Il proprio ID utente. Ad esempio, users/123456789/spaces/{space}/spaceReadState.

Formato: users/{user}/spaces/{space}/spaceReadState

update_mask

FieldMask

Obbligatorio. I percorsi dei campi da aggiornare. Percorsi dei campi attualmente supportati:

  • last_read_time

Quando last_read_time è precedente alla data e all'ora di creazione dell'ultimo messaggio, lo spazio viene visualizzato come non letto nell'interfaccia utente.

Per contrassegnare lo spazio come letto, imposta last_read_time su un valore successivo (maggiore) all'ora di creazione dell'ultimo messaggio. Il valore last_read_time viene forzato in modo che corrisponda all'ora di creazione dell'ultimo messaggio. Tieni presente che lo stato di lettura dello spazio influisce solo sullo stato di lettura dei messaggi visibili nella conversazione di primo livello dello spazio. Le risposte nei thread non sono interessate da questo timestamp e si basano invece sullo stato di lettura del thread.

UpdateSpaceRequest

Una richiesta di aggiornamento di un singolo spazio.

Campi
space

Space

Obbligatorio. Spazio con i campi da aggiornare. Space.name deve essere compilato nel formato spaces/{space}. Vengono aggiornati solo i campi specificati da update_mask.

update_mask

FieldMask

Obbligatorio. I percorsi dei campi aggiornati, separati da virgole se sono presenti più campi.

Puoi aggiornare i seguenti campi per uno spazio:

space_details: aggiorna la descrizione dello spazio. Supporta fino a 150 caratteri.

display_name: supporta l'aggiornamento del nome visualizzato solo per gli spazi in cui il campo spaceType è SPACE. Se ricevi il messaggio di errore ALREADY_EXISTS, prova un valore diverso. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

space_type: supporta solo la modifica di un tipo di spazio GROUP_CHAT in SPACE. Includi display_name insieme a space_type nella maschera di aggiornamento e assicurati che lo spazio specificato abbia un nome visualizzato non vuoto e il tipo di spazio SPACE. L'inclusione della maschera space_type e del tipo SPACE nello spazio specificato durante l'aggiornamento del nome visualizzato è facoltativa se lo spazio esistente ha già il tipo SPACE. Il tentativo di aggiornare il tipo di spazio in altri modi genera un errore relativo a un argomento non valido. space_type non è supportato con useAdminAccess.

space_history_state: aggiorna le impostazioni della cronologia dello spazio attivando o disattivando la cronologia per lo spazio. Supportato solo se le impostazioni della cronologia sono attivate per l'organizzazione Google Workspace. Per aggiornare lo stato della cronologia dello spazio, devi omettere tutte le altre maschere di campo nella richiesta. space_history_state non è supportato con useAdminAccess.

access_settings.audience: aggiorna l'impostazione di accesso di chi può scoprire lo spazio, partecipare allo spazio e visualizzare l'anteprima dei messaggi nello spazio denominato in cui il campo spaceType è SPACE. Se lo spazio esistente ha un pubblico di destinazione, puoi rimuoverlo e limitare l'accesso allo spazio omettendo un valore per questa maschera di campo. Per aggiornare le impostazioni di accesso per uno spazio, l'utente che esegue l'autenticazione deve essere un gestore dello spazio e omettere tutte le altre maschere di campo nella richiesta. Non puoi aggiornare questo campo se lo spazio è in modalità di importazione. Per scoprire di più, vedi Rendere uno spazio rilevabile per utenti specifici. access_settings.audience non è supportato con useAdminAccess.

permission_settings: supporta la modifica delle impostazioni di autorizzazione di uno spazio. Quando aggiorni le impostazioni di autorizzazione, puoi specificare solo le maschere di campo permissionSettings; non puoi aggiornare contemporaneamente altre maschere di campo. permissionSettings non è supportato con useAdminAccess. Le maschere di campo supportate includono:

  • permission_settings.manageMembersAndGroups
  • permission_settings.modifySpaceDetails
  • permission_settings.toggleHistory
  • permission_settings.useAtMentionAll
  • permission_settings.manageApps
  • permission_settings.manageWebhooks
  • permission_settings.replyMessages
use_admin_access

bool

Facoltativo. Se true, il metodo viene eseguito utilizzando i privilegi di amministratore di Google Workspace dell'utente.

L'utente che effettua la chiamata deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'chat.admin.spaces ambito OAuth 2.0.

Alcuni valori FieldMask non sono supportati con l'accesso amministrativo. Per maggiori dettagli, consulta la descrizione di update_mask.

Utente

Un utente in Google Chat. Se l'app Chat si autentica come utente, l'output restituito da una richiesta per una risorsa User compila solo name e type dell'utente.

Campi
name

string

Nome della risorsa per un user di Google Chat.

Formato: users/{user}. users/app può essere utilizzato come alias per l'utente bot dell'app di chiamata.

Per human users, {user} è lo stesso identificatore utente di:

  • id per Person nell'API People. Ad esempio, users/123456789 nell'API Chat rappresenta la stessa persona dell'ID profilo della persona 123456789 nell'API People.

  • il valore id per un utente nell'API Admin SDK Directory.

  • l'indirizzo email dell'utente può essere utilizzato come alias per {user} nelle richieste API. Ad esempio, se l'ID profilo della persona dell'API People per user@example.com è 123456789, puoi utilizzare users/user@example.com come alias per fare riferimento a users/123456789. L'API restituirà solo il nome canonico della risorsa (ad es. users/123456789).

display_name

string

Solo output. Il nome visualizzato dell'utente.

domain_id

string

Identificatore univoco del dominio Google Workspace dell'utente.

type

Type

Tipo di utente.

is_anonymous

bool

Solo output. Se il valore è true, l'utente è stato eliminato o il suo profilo non è visibile.

Tipo

Enum
TYPE_UNSPECIFIED Valore predefinito per l'enum. NON UTILIZZARE.
HUMAN Utente umano.
BOT Utente dell'app di Chat.

UserMentionMetadata

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

Campi
user

User

L'utente menzionato.

type

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.

WidgetMarkup

Un widget è un elemento dell'interfaccia utente che presenta testo e immagini.

Campi
buttons[]

Button

Un elenco di pulsanti. Anche i pulsanti sono oneof data e deve essere impostato solo uno di questi campi.

Campo unione data. Un WidgetMarkup può avere solo uno dei seguenti elementi. Puoi utilizzare più campi WidgetMarkup per visualizzare più elementi. data può essere solo uno dei seguenti:
text_paragraph

TextParagraph

Mostra un paragrafo di testo in questo widget.

image

Image

Mostra un'immagine in questo widget.

key_value

KeyValue

Mostra un elemento chiave-valore in questo widget.

Pulsante

Un pulsante. Può essere un pulsante di testo o un pulsante immagine.

Campi

Campo unione type.

type può essere solo uno dei seguenti:

text_button

TextButton

Un pulsante con testo e azione onclick.

image_button

ImageButton

Un pulsante con immagine e azione onclick.

FormAction

Un'azione del modulo descrive il comportamento quando il modulo viene inviato. Ad esempio, puoi chiamare Apps Script per gestire il modulo.

Campi
action_method_name

string

Il nome del metodo viene utilizzato per identificare la parte del modulo che ha attivato l'invio del modulo. Queste informazioni vengono riportate nell'app Chat nell'ambito dell'evento di clic sulla scheda. Puoi utilizzare lo stesso nome di metodo per più elementi che attivano un comportamento comune.

parameters[]

ActionParameter

Elenco dei parametri di azione.

ActionParameter

Elenco di parametri di stringa da fornire quando viene invocato il metodo di azione. Ad esempio, considera tre pulsanti Posticipa: Posticipa ora, Posticipa di un giorno, Posticipa la prossima settimana. Puoi utilizzare action method = snooze(), passando il tipo di posticipazione e la relativa ora nell'elenco dei parametri di stringa.

Campi
key

string

Il nome del parametro per lo script dell'azione.

value

string

Il valore del parametro.

Icona

L'insieme di icone supportate.

Enum
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

Immagine

Un'immagine specificata da un URL e che può avere un'azione onclick.

Campi
image_url

string

L'URL dell'immagine.

on_click

OnClick

L'azione onclick.

aspect_ratio

double

Le proporzioni di questa immagine (larghezza e altezza). Questo campo ti consente di riservare l'altezza giusta per l'immagine in attesa del caricamento. Non ha lo scopo di sostituire le proporzioni predefinite dell'immagine. Se non è impostato, il server lo completa prelevando l'immagine.

ImageButton

Un pulsante immagine con un'azione onclick.

Campi
on_click

OnClick

L'azione onclick.

name

string

Il nome di questo image_button utilizzato per l'accessibilità. Se non viene specificato, viene fornito il valore predefinito.

Campo unione icons. L'icona può essere specificata tramite un Icon enum o un URL. icons può essere solo uno dei seguenti:
icon

Icon

L'icona specificata da un enum che fa riferimento a un'icona fornita dall'API Chat.

icon_url

string

L'icona specificata da un URL.

KeyValue

Un elemento dell'interfaccia utente contiene una chiave (etichetta) e un valore (contenuti). Questo elemento può contenere anche alcune azioni, ad esempio il pulsante onclick.

Campi
top_label

string

Il testo dell'etichetta superiore. Testo formattato supportato. Per saperne di più sulla formattazione del testo, vedi Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace.

content

string

Il testo dei contenuti. Testo formattato supportato e sempre obbligatorio. Per saperne di più sulla formattazione del testo, vedi Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace.

content_multiline

bool

Se i contenuti devono essere su più righe.

bottom_label

string

Il testo dell'etichetta in basso. Testo formattato supportato. Per saperne di più sulla formattazione del testo, vedi Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace.

on_click

OnClick

L'azione onclick. Solo l'etichetta superiore, l'etichetta inferiore e la regione dei contenuti sono cliccabili.

Campo unione icons. È necessario definire almeno uno degli elementi icone, top_label e bottom_label. icons può essere solo uno dei seguenti:
icon

Icon

Un valore enumerato sostituito dall'API Chat con l'immagine dell'icona corrispondente.

icon_url

string

L'icona specificata da un URL.

Campo unione control. Un widget di controllo. Puoi impostare button o switch_widget, ma non entrambi. control può essere solo uno dei seguenti:
button

Button

Un pulsante su cui è possibile fare clic per attivare un'azione.

OnClick

Un'azione onclick (ad esempio, aprire un link).

Campi

Campo unione data.

data può essere solo uno dei seguenti:

action

FormAction

Se specificata, questa azione onclick attiva un'azione di modulo.

TextButton

Un pulsante con testo e azione onclick.

Campi
text

string

Il testo del pulsante.

on_click

OnClick

L'azione onclick del pulsante.

TextParagraph

Un paragrafo di testo. Testo formattato supportato. Per saperne di più sulla formattazione del testo, vedi Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace.

Campi
text

string