Move a space to a different section

This guide explains how to use the move method on the SectionItem resource of the Google Chat API to move an item (such as a space) from one section to another.

For more information, see Create and organize sections in Google Chat.

Prerequisites

Python

Move a space to a different section

To move a space to a different section with user authentication, pass the following in your request:

  • Specify the chat.users.sections authorization scope.
  • Call the MoveSectionItem method.
  • In the request body, specify the name of the section item to move and the targetSection:
    • Set name to the resource name of the section item (for example, users/me/sections/default-spaces/items/spaces/123456).
    • Set targetSection to the resource name of the section you want to move the item to.

The following example moves a space to a different section:

Python

from google.cloud import chat_v1

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

    # Initialize request
    request = chat_v1.MoveSectionItemRequest(
        name="SECTION_ITEM_NAME",
        target_section="TARGET_SECTION_NAME"
    )

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

    print(response)

To run this sample, replace the following:

  • SECTION_ITEM_NAME: The resource name of the section item.
  • TARGET_SECTION_NAME: The resource name of the target section.

The Chat API returns the updated instance of SectionItem.