Method: users.sections.position  |  Google Chat  |  Google for Developers (original) (raw)

Cambia el orden de clasificación de una sección. Para obtener más información, consulta Cómo crear y organizar secciones en Google Chat.

Requiere autenticación del usuario con el alcance de autorización:

Solicitud HTTP

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name string Obligatorio. Es el nombre del recurso de la sección que se posicionará.Formato: users/{user}/sections/{section}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{ "sortOrder": integer, "relativePosition": enum (Position) }
Campos
Campo de unión position. Obligatorio. Es la nueva posición de la sección. position puede ser solo uno de los parámetros siguientes:
sortOrder integer Opcional. Es la posición absoluta de la sección en la lista de secciones. La posición debe ser mayor que 0. Si la posición es mayor que la cantidad de secciones, la sección se agregará al final de la lista. Esta operación inserta la sección en la posición indicada y desplaza la sección original en esa posición, y las que están debajo de ella, a la siguiente posición.
relativePosition enum (Position) Opcional. Es la posición relativa de la sección en la lista de secciones.

Cuerpo de la respuesta

Es el mensaje de respuesta para posicionar una sección.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{ "section": { object (Section) } }
Campos
section object (Section) Es la sección actualizada.

Requiere el siguiente permiso de OAuth:

Para obtener más información, consulta la Guía de autorización.

Posición

Es la posición de la sección.

Enums
POSITION_UNSPECIFIED Posición no especificada.
START Es el inicio de la lista de secciones.
END Es el final de la lista de secciones.