Questa guida spiega come utilizzare il metodo
create
nella 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 saperne di più, vedi Creare e organizzare 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 Python Cloud.
-
Crea le credenziali dell'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 autenticazione utente, passa quanto segue nella richiesta:
- Specifica l'ambito di autorizzazione
chat.users.sections. - Chiama il metodo
CreateSection. - 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 in dettaglio la sezione creata.
Argomenti correlati
- Aggiornare una sezione
- Eliminare una sezione
- Modificare la posizione di una sezione
- Sezioni degli elenchi
- Elencare gli spazi in una sezione
- Spostare uno spazio in una sezione diversa