Method: users.sections.position

Modifica l'ordinamento di una sezione. Per maggiori dettagli, vedi Creare e organizzare le 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 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
Campi
Obbligatorio. La nuova posizione della sezione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
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.
Fine dei campi che si escludono a vicenda.

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.