Method: spaces.patch

Aggiorna uno spazio. Ad esempio, vedi Aggiornare uno spazio.

Se aggiorni il campo displayName e ricevi il messaggio di errore ALREADY_EXISTS, prova con un nome visualizzato diverso. Questo nome visualizzato potrebbe essere già utilizzato da uno spazio esistente all'interno dell'organizzazione Google Workspace.

Richiede l'autenticazione dell'utente.

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

Nome risorsa dello spazio.

Formato: spaces/{space}

Parametri di ricerca

Parametri
updateMask

string (FieldMask format)

Obbligatoria. I percorsi dei campi aggiornati, separati da virgole, se presenti.

Percorsi dei campi attualmente supportati:

  • displayName (supporta solo la modifica del nome visualizzato di uno spazio con il tipo SPACE o, quando viene inclusa anche la maschera spaceType per cambiare un tipo di spazio GROUP_CHAT in SPACE). Se provi ad aggiornare il nome visualizzato di uno spazio GROUP_CHAT o DIRECT_MESSAGE, si verifica un errore relativo a un argomento non valido. Se ricevi il messaggio di errore ALREADY_EXISTS durante l'aggiornamento di displayName, prova con un altro displayName. Questo nome visualizzato potrebbe essere già utilizzato da uno spazio esistente all'interno dell'organizzazione Google Workspace.

  • 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 presenta già il tipo SPACE. Se provi ad aggiornare il tipo di spazio in altri modi, viene visualizzato un errore relativo a un argomento non valido. L'app spaceType non è supportata con l'accesso amministrativo.

  • spaceDetails

  • spaceHistoryState (supporta l'attivazione o la disattivazione della cronologia per lo spazio se l'organizzazione consente agli utenti di modificare le impostazioni della cronologia). Avviso: si escludono a vicenda con tutti gli altri percorsi di campo.) L'app spaceHistoryState non è supportata con l'accesso amministrativo.

  • Anteprima per gli sviluppatori: accessSettings.audience (supporta la modifica delle impostazioni di accesso di uno spazio. Se non viene specificato alcun segmento di pubblico nell'impostazione di accesso, l'impostazione di accesso dello spazio viene aggiornata in limitata. Avviso: si escludono a vicenda con tutti gli altri percorsi di campo.) L'app accessSettings.audience non è supportata con l'accesso amministrativo.

  • Anteprima per gli sviluppatori: supporta la modifica delle impostazioni delle autorizzazioni di uno spazio. I percorsi dei campi supportati includono: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (avviso: si escludono a vicenda tutti gli altri percorsi dei campi relativi alle impostazioni non di autorizzazione). L'app permissionSettings non è supportata con l'accesso amministrativo.
useAdminAccess

boolean

Quando true, il metodo viene eseguito utilizzando i privilegi amministrativi di Google Workspace dell'utente.

L'utente che chiama deve essere un amministratore di Google Workspace con il privilegio di gestione delle conversazioni di Chat e spazi.

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

Alcuni valori di FieldMask non sono supportati se utilizzi l'accesso amministrativo. Per maggiori dettagli, vedi 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.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Per ulteriori informazioni, consulta la Guida all'autorizzazione.