En esta guía, se explica cómo usar el método patch en el recurso Section de la API de Google Chat para actualizar una sección personalizada en Google Chat.
Solo se pueden actualizar las secciones de tipo CUSTOM_SECTION. 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 o Enterprise 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 actualizar una sección
Para actualizar 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
UpdateSection. - En el cuerpo de la solicitud, proporciona un recurso
Sectiony una máscara de campo:- Establece el
namede la sección que se actualizará. - Establece
displayNameen el nombre nuevo de la sección. - Establece
updateMaskendisplayName.
- Establece el
En el siguiente ejemplo, se actualiza una sección:
Python
from google.cloud import chat_v1
from google.protobuf import field_mask_pb2
def update_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.UpdateSectionRequest(
section=chat_v1.Section(
name="SECTION_NAME",
display_name="NEW_SECTION_DISPLAY_NAME"
),
update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
)
# Make the request
response = client.update_section(request=request)
print(response)
Para ejecutar esta muestra, reemplaza lo siguiente:
SECTION_NAME: Es el nombre del recurso de la sección. Puedes obtener el nombre del recurso llamando al métodoListSections.NEW_SECTION_DISPLAY_NAME: Es el nombre nuevo de la sección.
La API de Chat devuelve la instancia actualizada de Section.
Temas relacionados
- Cómo crear 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