В этом руководстве объясняется, как использовать метод patch ресурса Section API Google Chat для обновления пользовательского раздела в Google Chat.
Изменять можно только разделы типа CUSTOM_SECTION . Для получения дополнительной информации см. раздел «Создание и организация разделов в Google Chat» .
Предварительные требования
Python
- Корпоративный аккаунт Google Workspace с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект в Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения чата.
- Установите библиотеку Python Cloud Client .
- Создайте учетные данные клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде JSON-файла с именем
credentials.jsonв локальной директории.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
Обновить раздел
Для обновления раздела с аутентификацией пользователя передайте в запросе следующее:
- Укажите область авторизации
chat.users.sections. - Вызовите метод
UpdateSection. - В теле запроса укажите ресурс
Sectionи маску поля:- Укажите
nameраздела для обновления. - Установите
displayNameравным новому имени раздела. - Установите
updateMaskравнымdisplayName.
- Укажите
В следующем примере обновляется раздел:
Python
from google.cloud import chat_v1
from google.protobuf import field_mask_pb2
def update_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.UpdateSectionRequest(
section=chat_v1.Section(
name="SECTION_NAME",
display_name="NEW_SECTION_DISPLAY_NAME"
),
update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
)
# Make the request
response = client.update_section(request=request)
print(response)
Для запуска этого примера замените следующее:
-
SECTION_NAME: Имя ресурса раздела. Имя ресурса можно получить, вызвав методListSections. -
NEW_SECTION_DISPLAY_NAME: Новое название для раздела.
API чата возвращает обновленный экземпляр Section .
Связанные темы
- Создать раздел
- Удалить раздел
- Изменить положение раздела
- Список разделов
- Список пробелов в разделе
- Переместите пробел в другой раздел.