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

Richiede l'autenticazione degli utenti.

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 della risorsa dello spazio.

Formato: spaces/{space}

Parametri di ricerca

Parametri
updateMask

string (FieldMask format)

obbligatorio. I percorsi dei campi aggiornati, separati da virgole se sono multipli.

Percorsi dei campi attualmente supportati:

  • displayName (Supporta solo la modifica del nome visualizzato di uno spazio con il tipo SPACE o quando si include anche la maschera spaceType per modificare un tipo di spazio GROUP_CHAT in SPACE. Se provi ad aggiornare il nome visualizzato di uno spazio GROUP_CHAT o DIRECT_MESSAGE, viene restituito un errore relativo a un argomento non valido. Se ricevi il messaggio di errore ALREADY_EXISTS durante l'aggiornamento di displayName, prova a utilizzare un displayName diverso. uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe utilizzare già 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 viene restituito un errore relativo all'argomento non valido).

  • 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.)

  • Anteprima per sviluppatori: accessSettings.audience (supporta la modifica dell'impostazione di accesso di uno spazio. Se non è specificato alcun pubblico nell'impostazione di accesso, l'impostazione di accesso dello spazio viene aggiornata in Con restrizioni. Avviso: si escludono a vicenda con tutti gli altri percorsi di campo.)

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.import
  • https://www.googleapis.com/auth/chat.spaces

Per ulteriori informazioni, consulta la guida all'autorizzazione.