В этом руководстве объясняется, как использовать метод position ресурса Section API Google Chat для изменения порядка сортировки раздела в Google Chat.
Для получения дополнительной информации см. раздел «Создание и организация разделов в Google Chat» .
Предварительные требования
Python
- Корпоративный аккаунт Google Workspace с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект в Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения чата.
- Установите библиотеку Python Cloud Client .
- Создайте учетные данные клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде JSON-файла с именем
credentials.jsonв локальной директории.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
Изменить положение раздела
Чтобы изменить положение раздела с аутентификацией пользователя , передайте в запросе следующее:
- Укажите область авторизации
chat.users.sections. - Вызовите метод
PositionSection. - В теле запроса укажите
nameраздела для позиционирования и новую позицию:- Установите
sortOrderв качестве абсолютного значения (больше 0). - ИЛИ установите
relativePositionвSTARTилиEND.
- Установите
В следующем примере раздел перемещается в начало списка:
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)
Для запуска этого примера замените следующее:
-
SECTION_NAME: Имя ресурса раздела. Имя ресурса можно получить, вызвав методListSections.
API чата возвращает обновленный экземпляр Section .
Связанные темы
- Создать раздел
- Обновить раздел
- Удалить раздел
- Список разделов
- Список пробелов в разделе
- Переместите пробел в другой раздел.