Method: spaces.members.delete

Elimina un abbonamento. Per un esempio, vedi Rimuovere un utente o un'app Google Chat da uno spazio.

Supporta i seguenti tipi di autenticazione:

  • Autenticazione dell'app con approvazione dell'amministratore e ambito di autorizzazione:

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

  • Autenticazione utente con uno dei seguenti ambiti di autorizzazione:

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

L'autenticazione dell'app non è supportata per i seguenti casi d'uso:

  • Rimozione di un gruppo Google da uno spazio.
  • Rimozione di un'app di chat da uno spazio.

Per eliminare le iscrizioni per i gestori dello spazio, il richiedente deve essere un gestore dello spazio. Se utilizzi l'autenticazione dell'app, l'app Chat deve essere il creatore dello spazio.

Richiesta HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/members/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome risorsa dell'abbonamento da eliminare. Le app di chat possono eliminare gli abbonamenti degli utenti umani o i propri. Le app di chat non possono eliminare gli abbonamenti di altre app.

Quando si elimina un abbonamento umano, richiede l'ambito chat.memberships con l'autenticazione utente o l'ambito chat.memberships.app con l'autenticazione app e il formato spaces/{space}/members/{member}. Puoi utilizzare l'email come alias per {member}. Ad esempio, spaces/{space}/members/example@gmail.com, dove example@gmail.com è l'email dell'utente di Google Chat.

Quando elimini un'appartenenza, sono necessari l'ambito chat.memberships.app e il formato spaces/{space}/members/app.

Formato: spaces/{space}/members/{member} o spaces/{space}/members/app.

Parametri di query

Parametri
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.memberships.

L'eliminazione delle appartenenze alle app in uno spazio non è supportata tramite l'accesso amministrativo.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Membership.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

Per ulteriori informazioni, consulta la Guida all'autorizzazione.