REST Resource: spaces

{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}

string

Nome risorsa dello spazio.

Formato: spaces/{space}

dove {space} rappresenta l'ID assegnato dal sistema per lo 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: usa invece spaceType. Il tipo di uno spazio.

enum (SpaceType)

Il tipo di spazio. Obbligatorio quando crei uno spazio o aggiorni il tipo di spazio di uno spazio. Output solo per altri utilizzi.

boolean

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

boolean

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

string

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. Questo nome visualizzato potrebbe essere già utilizzato da uno spazio esistente all'interno dell'organizzazione Google Workspace.

Per i messaggi diretti, questo campo potrebbe essere vuoto.

Supporta fino a 128 caratteri.

boolean

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 autorizza qualsiasi utente di Google Chat.

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

enum (SpaceThreadingState)

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

object (SpaceDetails)

Dettagli sullo spazio, tra cui descrizione e regole.

enum (HistoryState)

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

boolean

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

string (Timestamp format)

(Facoltativo) Immutabile. Per gli spazi creati in Chat, la data e l'ora di creazione dello 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.

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 con messaggi diretti (MD) 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 parte degli amministratori, l'app Chat deve includere la messaggistica diretta.

object (MembershipCount)

Solo output. Il numero di abbonamenti uniti raggruppati per tipo di abbonamento. 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 che consente a un utente di accedere allo spazio.

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). Anche le app private possono 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 predefinite per le autorizzazioni per lo spazio, da inserire solo durante la 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.

object (PermissionSettings)

(Facoltativo) Impostazioni delle autorizzazioni per gli spazi esistenti. Input per l'aggiornamento delle impostazioni esatte relative alle autorizzazioni per gli spazi, in cui le impostazioni di autorizzazione esistenti vengono sostituite. L'output elenca le impostazioni di autorizzazione correnti.