- Risorsa: spazio
- Metodi
Risorsa: 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.
Rappresentazione JSON |
---|
{ "name": string, "type": enum ( |
Campi | |
---|---|
name |
Nome risorsa dello spazio. Formato: dove |
type |
Solo output. Deprecato: usa invece |
spaceType |
Il tipo di spazio. Obbligatorio quando crei uno spazio o aggiorni il tipo di spazio di uno spazio. Output solo per altri utilizzi. |
singleUserBotDm |
(Facoltativo) Indica se lo spazio è un messaggio diretto tra un'app di Chat e un singolo essere umano. |
threaded |
Solo output. Deprecato: usa invece |
displayName |
Il nome visualizzato dello spazio. Obbligatorio durante la creazione di uno spazio. Se ricevi il messaggio di errore Per i messaggi diretti, questo campo potrebbe essere vuoto. Supporta fino a 128 caratteri. |
externalUserAllowed |
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:
Questo campo viene restituito solo per gli spazi esistenti. |
spaceThreadingState |
Solo output. Lo stato dei thread nello spazio di Chat. |
spaceDetails |
Dettagli sullo spazio, tra cui descrizione e regole. |
spaceHistoryState |
Lo stato della cronologia dei messaggi per i messaggi e i thread in questo spazio. |
importMode |
(Facoltativo) Indica se questo spazio è stato creato in |
createTime |
(Facoltativo) Immutabile. Per gli spazi creati in Chat, la data e l'ora di creazione dello spazio. Questo campo viene solo generato, tranne quando viene utilizzato negli spazi in modalità di importazione. Per gli spazi in modalità di importazione, imposta questo campo sul timestamp storico in cui lo spazio è stato creato nell'origine per conservare l'ora di creazione originale. Compilato nell'output solo quando |
lastActiveTime |
Solo output. Timestamp dell'ultimo messaggio nello spazio. |
adminInstalled |
Solo output. Per gli spazi di messaggi diretti (DM) 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 loro organizzazione. Per supportare l'installazione da parte degli amministratori, l'app Chat deve includere la messaggistica diretta. |
membershipCount |
Solo output. Il numero di iscrizioni raggruppate per tipo di membro. Compilato quando |
accessSettings |
(Facoltativo) Specifica l'impostazione di accesso dello spazio. Compilato solo quando |
spaceUri |
Solo output. L'URI di un utente per accedere allo spazio. |
Campo unione space_permission_settings . Rappresenta le impostazioni dell'autorizzazione di uno spazio. Compilato solo quando space_type è SPACE . space_permission_settings può essere solo uno dei seguenti: |
|
predefinedPermissionSettings |
(Facoltativo) Solo input. Impostazioni di autorizzazione dello spazio. Input per la creazione di uno spazio, se questo campo non viene impostato viene creato uno spazio di collaborazione. Dopo aver creato lo spazio, le impostazioni vengono compilate nel campo |
permissionSettings |
(Facoltativo) Impostazioni di autorizzazione esatte che possono essere impostate per aggiornare lo spazio. Input per l'aggiornamento di uno spazio. In caso contrario, solo output. Per la creazione dello spazio, usa invece |
Tipo
Deprecato: usa invece SpaceType
.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Riservato. |
ROOM |
Conversazioni tra due o più persone. |
DM |
Messaggio diretto 1:1 tra un utente e un'app di Chat, in cui tutti i messaggi sono piatti. Tieni presente che non sono inclusi i messaggi diretti tra due persone. |
SpaceType
Il tipo di spazio. Obbligatorio quando crei o aggiorni 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 una persona e un'app di Chat. |
SpaceThreadingState
Specifica il tipo di stato dei thread 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 rispondere in thread, conservando la risposta 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 insieme. |
UNTHREADED_MESSAGES |
Messaggi diretti tra due persone e conversazioni di gruppo tra tre o più persone. |
SpaceDetails
Dettagli sullo spazio, tra cui descrizione e regole.
Rappresentazione JSON |
---|
{ "description": string, "guidelines": string } |
Campi | |
---|---|
description |
(Facoltativo) Una descrizione dello spazio. Ad esempio, descrivi l'argomento di discussione, lo scopo funzionale o i partecipanti dello spazio. Supporta fino a 150 caratteri. |
guidelines |
(Facoltativo) Le regole, le aspettative e l'etichetta dello spazio. Supporta fino a 5000 caratteri. |
HistoryState
Lo stato della cronologia per i messaggi e gli spazi. Specifica per quanto tempo vengono conservati i messaggi e i thread di conversazione dopo la creazione.
Enum | |
---|---|
HISTORY_STATE_UNSPECIFIED |
Valore predefinito. Non utilizzare. |
HISTORY_OFF |
Cronologia disattivata. I messaggi e i thread vengono conservati per 24 ore. |
HISTORY_ON |
Cronologia attivata. Le regole di conservazione di Vault dell'organizzazione specificano la durata di conservazione dei messaggi e dei thread. |
MembershipCount
Rappresentazione JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Campi | |
---|---|
joinedDirectHumanUserCount |
Numero di utenti umani che sono entrati direttamente nello spazio, senza contare gli utenti che si sono uniti a un gruppo iscritto. |
joinedGroupCount |
Numero di tutti i gruppi che sono entrati direttamente nello spazio. |
AccessSettings
Rappresenta l'impostazione di accesso dello spazio.
Rappresentazione JSON |
---|
{
"accessState": enum ( |
Campi | |
---|---|
accessState |
Solo output. Indica lo stato di accesso allo spazio. |
audience |
(Facoltativo) Il nome della risorsa del pubblico di destinazione che può scoprire lo spazio, partecipare allo spazio e visualizzare l'anteprima dei messaggi nello spazio. Se il criterio non viene configurato, solo gli utenti o i gruppi Google che sono stati invitati singolarmente o sono stati aggiunti allo spazio potranno accedervi. Per maggiori dettagli, vedi Rendere uno spazio rilevabile per un pubblico di destinazione. Formato: Per utilizzare il pubblico di destinazione predefinito per l'organizzazione Google Workspace, imposta |
AccessState
Rappresenta lo stato di accesso allo spazio.
Enum | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Lo stato dell'accesso è sconosciuto o non supportato in questa API. |
PRIVATE |
Solo gli utenti o i gruppi Google che sono stati aggiunti o invitati singolarmente da altri utenti o da amministratori di Google Workspace possono rilevare 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 che sono stati aggiunti o invitati singolarmente allo spazio possono scoprire lo spazio e accedervi. Per scoprire di più, consulta Rendere uno spazio rilevabile per utenti specifici. |
PredefinedPermissionSettings
Le impostazioni delle autorizzazioni per lo spazio che puoi specificare quando crei uno spazio denominato. In futuro potrebbero essere aggiunte altre impostazioni. Per maggiori dettagli sulle impostazioni delle autorizzazioni per gli spazi denominati, vedi Scopri di più 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. |
PermissionSettings
Impostazioni delle autorizzazioni per uno spazio denominato. Per configurare le impostazioni di autorizzazione quando crei uno spazio, specifica il campo PredefinedPermissionSettings
nella richiesta.
Rappresentazione JSON |
---|
{ "manageMembersAndGroups": { object ( |
Campi | |
---|---|
manageMembersAndGroups |
Impostazione per la gestione di membri e gruppi in uno spazio. |
modifySpaceDetails |
Impostazione per l'aggiornamento del nome dello spazio, dell'avatar, della descrizione e delle linee guida. |
toggleHistory |
Impostazione per attivare e disattivare la cronologia degli spazi. |
useAtMentionAll |
Impostazione per l'utilizzo di @tutti in uno spazio. |
manageApps |
Impostazione per la gestione delle app in uno spazio. |
manageWebhooks |
Impostazione per la gestione dei webhook in uno spazio. |
postMessages |
Solo output. Impostazione per la pubblicazione di messaggi in uno spazio. |
replyMessages |
Impostazione per rispondere ai messaggi in uno spazio. |
PermissionSetting
Rappresenta un'impostazione di autorizzazione dello spazio.
Rappresentazione JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
Campi | |
---|---|
managersAllowed |
Indica se i gestori degli spazi hanno questa autorizzazione. |
membersAllowed |
Indica se i membri non amministratori dispongono di questa autorizzazione. |
Metodi |
|
---|---|
|
Completa il processo di importazione per lo spazio specificato e lo rende visibile agli utenti. |
|
Crea uno spazio denominato. |
|
Elimina uno spazio denominato. |
|
Restituisce il messaggio diretto esistente con l'utente specificato. |
|
Restituisce i dettagli di uno spazio. |
|
Elenca gli spazi di cui il chiamante è membro. |
|
Aggiorna uno spazio. |
|
|
|
Crea uno spazio e vi aggiunge utenti specificati. |