En esta guía, se explica cómo usar el método create del recurso Section de la API de Google Chat para crear una nueva sección personalizada en Google Chat.
Las secciones ayudan a los usuarios a agrupar sus conversaciones y personalizar la lista de espacios que se muestra en el panel de navegación de Google Chat. Para obtener más información, consulta Cómo crear y organizar secciones en Google Chat.
Requisitos previos
Python
- Una cuenta de Google Workspace para empresas con acceso a Google Chat
- Configura tu entorno:
- Crea un proyecto de Google Cloud
- Configura la pantalla de consentimiento de OAuth.
- Habilita y configura la API de Google Chat con un nombre, un ícono y una descripción para tu app de Chat.
- Instala la biblioteca cliente de Cloud de Python.
-
Crea credenciales de ID de cliente de OAuth para una aplicación de escritorio. Para ejecutar la muestra en esta guía, guarda las credenciales como un archivo JSON llamado
credentials.jsonen tu directorio local.
- Elige un alcance de autorización que admita la autenticación del usuario.
Cómo crear una sección
Para crear una sección con autenticación de usuario, pasa lo siguiente en tu solicitud:
- Especifica el alcance de autorización
chat.users.sections. - Llama al método
CreateSection. - En el cuerpo de la solicitud, proporciona un recurso
Section:- Establece
displayNameen un nombre para la sección (hasta 80 caracteres). - Establece
typeenCUSTOM_SECTION.
- Establece
En el siguiente ejemplo, se crea una sección:
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)
Para ejecutar esta muestra, reemplaza lo siguiente:
SECTION_DISPLAY_NAME: Es el nombre de la sección nueva.
La API de Chat devuelve una instancia de Section que detalla la sección que se creó.
Temas relacionados
- Actualiza una sección
- Cómo borrar una sección
- Cómo cambiar la posición de una sección
- Secciones de la lista
- Cómo enumerar espacios en una sección
- Cómo mover un espacio a otra sección