Method: users.sections.position

Modifica l'ordinamento di una sezione. Per maggiori dettagli, vedi Creare e organizzare sezioni in Google Chat.

Richiede l'autenticazione utente con l'ambito di autorizzazione:

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa della sezione da posizionare.

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
Campo unione position. Obbligatorio. La nuova posizione della sezione. position può essere solo uno dei seguenti tipi:
sortOrder

integer

Facoltativo. La posizione assoluta della sezione nell'elenco delle sezioni. La posizione deve essere maggiore di 0. Se la posizione è maggiore del numero di sezioni, la sezione verrà aggiunta alla fine dell'elenco. Questa operazione inserisce la sezione nella posizione specificata e sposta la sezione originale in quella posizione e quelle sottostanti nella posizione successiva.

relativePosition

enum (Position)

Facoltativo. La posizione relativa della sezione nell'elenco delle sezioni.

Corpo della risposta

Messaggio di risposta per il posizionamento di una sezione.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "section": {
    object (Section)
  }
}
Campi
section

object (Section)

La sezione aggiornata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Posizione

La posizione della sezione.

Enum
POSITION_UNSPECIFIED Posizione non specificata.
START Inizio dell'elenco delle sezioni.
END Fine dell'elenco delle sezioni.