Method: users.sections.position

Muda a ordem de classificação de uma seção. Saiba mais em Criar e organizar seções no Google Chat.

Exige autenticação do usuário com o escopo de autorização:

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

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso da seção a ser posicionada.

Formato: users/{user}/sections/{section}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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ão position. Obrigatório. A nova posição da seção. position pode ser apenas de um dos tipos a seguir:
sortOrder

integer

Opcional. A posição absoluta da seção na lista de seções. A posição precisa ser maior que 0. Se a posição for maior que o número de seções, a seção será anexada ao final da lista. Essa operação insere a seção na posição especificada e move a seção original nessa posição e as abaixo dela para a próxima posição.
relativePosition

enum (Position)

Opcional. A posição relativa da seção na lista de seções.

Corpo da resposta

Mensagem de resposta para posicionar uma seção.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "section": {
    object (Section)
  }
}
Campos
section

object (Section)

A seção atualizada.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte o guia de autorização.

Posição

A posição da seção.

Tipos enumerados
POSITION_UNSPECIFIED Posição não especificada.
START Início da lista de seções.
END Fim da lista de seções.