Questa guida spiega come utilizzare il metodo delete
nella risorsa membership
dell'API Google Chat per rimuovere il membro da uno spazio noto anche come eliminazione di un
. Non è possibile rimuovere i gestori dello spazio se sono l'unico gestore dello spazio
in uno spazio. Assegna un altro utente come gestore dello spazio prima di rimuovere questi
di abbonamento.
La
Membership
risorsa
indica se un utente umano o un'app Google Chat è invitato,
parte di o assente in uno spazio.
Prerequisiti
Python
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Configura l'ambiente:
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
- Installa il Python Libreria client delle API di Google.
-
Creare credenziali con ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questo
guida, salva le credenziali come file JSON denominato
client_secrets.json
nel tuo nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione degli utenti.
Rimuovere un membro da uno spazio
Per rimuovere un utente, un gruppo Google o un'app di Chat da un spazio:
- Per rimuovere un utente o un gruppo Google, specifica l'autorizzazione
chat.memberships
l'ambito di attività. Per rimuovere un'app di Chat, specificachat.memberships.app
ambito di autorizzazione (le app possono eliminare solo il proprio membership; non quella di altre app). Come best practice, scegli a un ambito restrittivo che consenta comunque il funzionamento dell'app. - Chiama il metodo
delete
ilmembership
risorsa. - Supera il
name
dell'abbonamento da eliminare. Se l'abbonamento appartiene solo gestore dello spazio in uno spazio, assegna il ruolo di gestore a un altro utente prima eliminando questo abbonamento.
Per eliminare un abbonamento:
Python
- Nella directory di lavoro, crea un file denominato
chat_membership_delete.py
. Includi il seguente codice in
chat_membership_delete.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the specified membership. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().delete( # The membership to delete. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. print(result) if __name__ == '__main__': main()
Nel codice, sostituisci quanto segue:
SPACE
: il nome di uno spazio, che puoi ottenere il metodospaces.list
nell'API Chat o dall'URL di uno spazio.MEMBER
: il nome di un membro, che puoi ottenere dal metodospaces.members.list
nell'API Chat. Per eliminare l'abbonamento a un'app, sostituisciMEMBER
conapp
.
Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_membership_delete.py
In caso di esito positivo, il corpo della risposta restituisce l'appartenenza con
'state': 'NOT_A_MEMBER'
, a indicare che il membro non è più nello spazio.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Argomenti correlati
- Ottenere dettagli sull'abbonamento di un utente o di un'app di Chat.
- Elenca i membri in uno spazio.
- Aggiornare l'appartenenza di un utente a uno spazio di Google Chat.
- Invitare o aggiungere un utente o un'app di Chat a uno spazio.