Method: spaces.patch
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:
Richiesta HTTP
PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
space.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 .
|
Parametri di query
Parametri |
updateMask |
string (FieldMask format)
Obbligatorio. I percorsi dei campi aggiornati, separati da virgole se sono presenti più campi. Puoi aggiornare i seguenti campi per uno spazio: spaceDetails : aggiorna la descrizione dello spazio. Supporta fino a 150 caratteri.
displayName : 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.
spaceType : supporta solo la modifica di un tipo di spazio GROUP_CHAT in SPACE . Includi displayName insieme a spaceType 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 spaceType 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. spaceType non è supportato con useAdminAccess .
spaceHistoryState : 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. spaceHistoryState non è supportato con useAdminAccess .
accessSettings.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. accessSettings.audience non è supportato con useAdminAccess .
permissionSettings : 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:
permissionSettings.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
|
useAdminAccess |
boolean
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 updateMask .
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Space
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Space
.
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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-02-27 UTC.
[null,null,["Ultimo aggiornamento 2025-02-27 UTC."],[[["Updates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings."],["Requires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges."],["Supports partial updates using the `updateMask` query parameter to specify the fields to be modified."],["Provides options for using administrator privileges with the `useAdminAccess` query parameter, but some fields and functionalities are not supported in this mode."],["Uses the PATCH HTTP method and gRPC Transcoding syntax for the request URL."]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"]]