En esta guía, se explica cómo usar el
create
método en el Section recurso 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 muestran 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
- 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, ícono y descripción para tu app de Chat.
- Instala la biblioteca cliente de Cloud para Python .
-
Crea credenciales de ID de cliente de OAuth para una aplicación de escritorio. Para ejecutar la muestra de 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
CreateSectionmétodo. - 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: El nombre de la sección nueva.
La API de Chat muestra una instancia de
Section que detalla la sección que se creó.
Temas relacionados
- Actualiza una sección
- Borra una sección
- Cambia la posición de una sección
- Crea listas de secciones
- Crea listas de espacios en una sección
- Mueve un espacio a otra sección