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 alcance 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 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field 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.

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 Es el final de la lista de secciones.