Method: users.sections.position

Cambia el orden de clasificación de una sección. Para obtener más información, consulta Crea y organiza secciones en Google Chat.

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

  • https://www.googleapis.com/auth/chat.users.sections

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
Obligatorio. Es la nueva posición de la sección. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
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.
Es el final de los campos mutuamente excluyentes.

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.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/chat.users.sections

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 Fin de la lista de secciones.