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 della risorsa dello spazio. Formato: |
type |
Solo output. Deprecato: utilizza |
spaceType |
Il tipo di spazio. Opzione obbligatoria quando crei uno spazio o ne aggiorni il tipo. Output solo per altri utilizzi. |
singleUserBotDm |
Campo facoltativo. Se lo spazio è un messaggio diretto tra un'app di Chat e una singola persona. |
threaded |
Solo output. Deprecato: utilizza |
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:
Per gli spazi esistenti, questo campo è solo di output. |
spaceThreadingState |
Solo output. Lo stato dell'organizzazione in thread nello spazio di Chat. |
spaceDetails |
Dettagli sullo spazio, incluse la descrizione e le regole. |
spaceHistoryState |
Lo stato della cronologia dei messaggi per i messaggi e i thread in questo spazio. |
importMode |
Campo facoltativo. Indica se questo spazio viene creato in |
createTime |
Campo facoltativo. Immutabile. Per gli spazi creati in Chat, la data e l'ora di creazione dello spazio. Questo campo è solo di output, tranne quando è 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 preservare la data e 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 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 come amministratore, l'app Chat deve includere la messaggistica diretta. |
membershipCount |
Solo output. Il numero di appartenenze a cui si è iscritti raggruppate per tipo di membro. Il campo viene compilato quando |
accessSettings |
Campo facoltativo. Specifica l'impostazione di accesso dello spazio. Compilato solo quando |
spaceUri |
Solo output. L'URI dello spazio. |
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 flat. 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, mantenendo 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. |
UNTHREADED_MESSAGES |
Messaggi diretti tra due persone e conversazioni di gruppo tra tre o più persone. |
SpaceDetails
Dettagli sullo spazio, incluse la descrizione e le regole.
Rappresentazione JSON |
---|
{ "description": string, "guidelines": string } |
Campi | |
---|---|
description |
Campo 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 |
Campo facoltativo. Regole, aspettative ed etichetta dello spazio. Supporta fino a 5000 caratteri. |
HistoryState
Lo stato della cronologia di messaggi e 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. Messaggi e thread vengono conservati per 24 ore. |
HISTORY_ON |
Cronologia attiva. Le regole di conservazione di Vault dell'organizzazione specificano per quanto tempo vengono conservati i messaggi e i thread. |
MembershipCount
Rappresentazione JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
Campi | |
---|---|
joinedDirectHumanUserCount |
Numero di utenti umani che si sono uniti direttamente allo spazio, esclusi quelli che si sono uniti a un gruppo iscritto. |
joinedGroupCount |
Numero di tutti i gruppi che si sono uniti direttamente allo 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 |
Campo facoltativo. Il nome della risorsa del pubblico di destinazione che può accedere allo spazio. Imposta questo campo su un ID pubblico di destinazione valido per rendere lo spazio rilevabile oppure utilizza l'alias |
AccessState
Rappresenta lo stato di accesso allo spazio.
Enum | |
---|---|
ACCESS_STATE_UNSPECIFIED |
Lo stato dell'accesso è sconosciuto o non supportato in questa API. |
PRIVATE |
Lo spazio può essere trovato dai membri o dai gruppi aggiunti o invitati. |
DISCOVERABLE |
Lo spazio può essere trovato dal pubblico di destinazione selezionato, nonché dai membri o gruppi aggiunti o invitati. |
Metodi |
|
---|---|
|
Completa la procedura di importazione per lo spazio specificato e lo rende visibile agli utenti. |
|
Crea uno spazio con nome. |
|
Elimina uno spazio denominato. |
|
Restituisce il messaggio diretto esistente con l'utente specificato. |
|
Restituisce i dettagli su uno spazio. |
|
Elenca gli spazi di cui è membro il chiamante. |
|
Aggiorna uno spazio. |
|
|
|
Crea uno spazio a cui vengono aggiunti utenti specifici. |