Modificare la posizione di una sezione

Questa guida spiega come utilizzare il metodo position nella risorsa Section dell'API Google Chat per modificare l'ordine di ordinamento di una sezione in Google Chat.

Per saperne di più, vedi Creare e organizzare sezioni in Google Chat.

Prerequisiti

Python

Modificare la posizione di una sezione

Per modificare la posizione di una sezione con autenticazione utente, passa quanto segue nella richiesta:

  • Specifica l'ambito di autorizzazione chat.users.sections.
  • Chiama il metodo PositionSection.
  • Nel corpo della richiesta, specifica il name della sezione da posizionare e la nuova posizione:
    • Imposta sortOrder su una posizione assoluta (maggiore di 0).
    • OPPURE imposta relativePosition su START o END.

L'esempio seguente sposta una sezione all'inizio dell'elenco:

Python

from google.cloud import chat_v1

def position_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.PositionSectionRequest(
        name="SECTION_NAME",
        relative_position=chat_v1.PositionSectionRequest.Position.START
    )

    # Make the request
    response = client.position_section(request=request)

    print(response)

Per eseguire questo esempio, sostituisci quanto segue:

  • SECTION_NAME: il nome della risorsa della sezione. Puoi ottenere il nome della risorsa chiamando il metodo ListSections.

L'API Chat restituisce l'istanza aggiornata di Section.