REST Resource: spaces

string

Identificatore. Nome 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.

enum (Type)

Solo output. Deprecato: utilizza spaceType. Il tipo di spazio.

enum (SpaceType)

(Facoltativo) Il tipo di spazio. Obbligatorio quando crei uno spazio o aggiorni il tipo di spazio. Solo output per altri utilizzi.

boolean

(Facoltativo) Se lo spazio è un messaggio diretto tra un'app di chat e una singola persona.

boolean

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

string

(Facoltativo) Il nome visualizzato dello spazio. Obbligatorio quando crei uno spazio con un spaceType di SPACE. Se ricevi il messaggio di errore ALREADY_EXISTS quando crei uno spazio o aggiorni il displayName, prova un altro displayName. 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.

boolean

(Facoltativo) Immutabile. Indica se questo spazio consente a qualsiasi utente di Google Chat di diventare membro. Input 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 è aperto a qualsiasi utente di Google Chat.

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

enum (SpaceThreadingState)

Solo output. Lo stato dei thread nello spazio di Chat.

object (SpaceDetails)

(Facoltativo) Dettagli sullo spazio, inclusi descrizione e regole.

enum (HistoryState)

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

boolean

(Facoltativo) Se questo spazio viene 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é non viene completata.

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

string (Timestamp format)

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

Compilato nell'output solo quando spaceType è GROUP_CHAT o SPACE.

string (Timestamp format)

Solo output. Timestamp dell'ultimo messaggio nello spazio.

boolean

Solo output. Per gli spazi di messaggi diretti con un'app di chat, 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 propria organizzazione.

Per supportare l'installazione da parte dell'amministratore, l'app di chat deve includere la messaggistica diretta.

object (MembershipCount)

Solo output. Il conteggio degli abbonamenti sottoscritti raggruppati per tipo di membro. Viene compilato quando spaceType è SPACE, DIRECT_MESSAGE o GROUP_CHAT.

object (AccessSettings)

(Facoltativo) Specifica l'impostazione di accesso dello spazio. Compilato solo quando spaceType è SPACE.

string

Solo output. L'URI per l'accesso di un utente allo spazio.

string (Timestamp format)

Solo output. Il momento 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.

string

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

Nel formato customers/{customer}, dove customer è id della risorsa cliente dell'SDK Admin. 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.

enum (PredefinedPermissionSettings)

(Facoltativo) Solo input. Impostazioni delle autorizzazioni dello spazio predefinite, inserite 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 compilate nel campo PermissionSettings.

L'impostazione di autorizzazioni predefinite supporta:

• Autenticazione dell'app con approvazione dell'amministratore con gli ambiti chat.app.spaces o chat.app.spaces.create.

• Autenticazione utente

object (PermissionSettings)

(Facoltativo) Impostazioni delle autorizzazioni dello spazio per gli spazi esistenti. Input per l'aggiornamento delle impostazioni delle autorizzazioni esatte per lo spazio, in cui le impostazioni delle autorizzazioni esistenti vengono sostituite. Elenca le impostazioni di autorizzazione correnti.

La lettura e l'aggiornamento delle impostazioni delle autorizzazioni supportano:

• Autenticazione dell'app con approvazione dell'amministratore con l'ambito chat.app.spaces. Compilato e impostabile solo quando lo spazio è stato creato dall'app Chat.

• Autenticazione utente