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 altro nome visualizzato. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.

Supporta i seguenti tipi di autenticazione:

  • Autenticazione dell'app con approvazione dell'amministratore e uno dei seguenti ambiti di autorizzazione:

    • https://www.googleapis.com/auth/chat.app.spaces

  • Autenticazione utente con uno dei seguenti ambiti di autorizzazione:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (solo spazi in modalità di importazione)
    • L'autenticazione utente concede privilegi amministrativi quando un account amministratore esegue l'autenticazione, useAdminAccess è true e viene utilizzato il seguente ambito di autorizzazione:
      • https://www.googleapis.com/auth/chat.admin.spaces

L'autenticazione delle app presenta le seguenti limitazioni:

  • Per aggiornare space.predefined_permission_settings o space.permission_settings, l'app deve essere il creatore dello spazio.
  • L'aggiornamento di space.access_settings.audience non è supportato per l'autenticazione dell'app.

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 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 più di uno.

Puoi aggiornare i seguenti campi per uno spazio:

spaceDetails: aggiorna la descrizione dello spazio. Supporta fino a 150 caratteri.

displayName: supporta solo l'aggiornamento del nome visualizzato 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. Se provi ad aggiornare il tipo di spazio in altri modi, si verifica un errore di 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 attive 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 con nome 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 saperne di più, vedi Rendere uno spazio rilevabile per utenti specifici. accessSettings.audience non è supportato con useAdminAccess.

permissionSettings: supporta la modifica delle impostazioni delle autorizzazioni di uno spazio. Quando aggiorni le impostazioni delle autorizzazioni, puoi specificare solo le maschere dei campi permissionSettings; non puoi aggiornare altre maschere dei campi contemporaneamente. 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) Quando true, il metodo viene eseguito utilizzando i privilegi di amministratore Google Workspace dell'utente.

L'utente chiamante deve essere un amministratore di Google Workspace con il privilegio Gestisci spazi e conversazioni di Chat.

Richiede l'ambito OAuth 2.0 chat.admin.spaces.

Alcuni valori di FieldMask non sono supportati utilizzando 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.