En esta guía, se explica cómo usar el
patch
método 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
- 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 la nube de 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 actualizar una sección
Para actualizar una sección con la autenticación del 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 deseas 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: El nombre del recurso de la sección. Puedes obtener el nombre del recurso llamando alListSectionsmétodo.NEW_SECTION_DISPLAY_NAME: 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
- Cómo crear listas de secciones
- Cómo crear listas de espacios en una sección
- Cómo mover un espacio a otra sección