Questa guida spiega come utilizzare il
create
metodo sulla risorsa Section dell'API Google Chat per creare una nuova
sezione personalizzata in Google Chat.
Le sezioni aiutano gli utenti a raggruppare le conversazioni e a personalizzare l'elenco degli spazi visualizzati nel pannello di navigazione di Google Chat. Per ulteriori informazioni, consulta Creare e organizzare le sezioni in Google Chat.
Prerequisiti
Python
- Un account Google Workspace Business o Enterprise con accesso a Google Chat.
- Configura l'ambiente:
- Crea un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Installa la libreria client Cloud di Python.
-
Crea le credenziali ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questa
guida, salva le credenziali come file JSON denominato
credentials.jsonnella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Crea una sezione
Per creare una sezione con l'autenticazione utente, passa quanto segue nella richiesta:
- Specifica l'ambito di autorizzazione
chat.users.sections. - Chiama il
CreateSectionmetodo. - Nel corpo della richiesta, fornisci una risorsa
Section:- Imposta
displayNamesu un nome per la sezione (fino a 80 caratteri). - Imposta
typesuCUSTOM_SECTION.
- Imposta
L'esempio seguente crea una sezione:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
Per eseguire questo esempio, sostituisci quanto segue:
SECTION_DISPLAY_NAME: il nome della nuova sezione.
L'API Chat restituisce un'istanza di
Section che descrive la sezione creata.
Argomenti correlati
- Aggiorna una sezione
- Elimina una sezione
- Modifica la posizione di una sezione
- Elenca le sezioni
- Elenca gli spazi in una sezione
- Sposta uno spazio in un'altra sezione