Удалить пространство (original) (raw)

В этом руководстве объясняется, как использовать метод delete() ресурса Space API Google Chat для удаления именованного пространства, когда оно больше не нужно. Удаление пространства также удаляет всё его содержимое, включая сообщения и вложения.

Если вы являетесь администратором Google Workspace, вы можете вызвать метод delete() , чтобы удалить любое именованное пространство в вашей организации Google Workspace.

Ресурс Space представляет собой место, где пользователи и чат-приложения могут отправлять сообщения, обмениваться файлами и работать вместе. Существует несколько типов пространств:

Прямые сообщения (ЛС) — это беседы между двумя пользователями или пользователем и приложением чата.
Групповые чаты — это беседы между тремя и более пользователями и приложениями чата.
Именованные пространства — это постоянные места, где люди отправляют сообщения, обмениваются файлами и сотрудничают.

Предпосылки

Node.js

Учетная запись Google Workspace Business или Enterprise с доступом к Google Chat .
Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения Chat.
- Установите облачную клиентскую библиотеку Node.js.
- Создайте учётные данные OAuth-клиента для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учётные данные в виде JSON-файла с именем credentials.json в локальном каталоге.
  Для получения руководства выполните шаги по настройке вашей среды, описанные в этом кратком руководстве .
Выберите область авторизации , поддерживающую аутентификацию пользователя.
Пространство Google Chat. Чтобы создать его с помощью API Google Chat, см. раздел Создание пространства . Чтобы создать пространство в Chat, посетите документацию Справочного центра .

Удалить именованное пространство как пользователь

Чтобы удалить существующее пространство в Google Chat с аутентификацией пользователя , передайте в запросе следующее:

Укажите область авторизации chat.delete .
Вызовите метод DeleteSpace() .
Передайте name пространства, которое нужно удалить.

Вот как удалить пробел:

Node.js

Чтобы запустить этот пример, замените SPACE_NAME на идентификатор из поля name пространства. Идентификатор можно получить, вызвав метод ListSpaces() или перейдя по URL-адресу пространства.

Удалить именованное пространство как приложение чата

Аутентификация приложения требует однократного одобрения администратора .

При аутентификации в приложении вы сможете удалять только пространства, созданные приложениями чата.

Чтобы удалить существующее пространство в Google Chat с аутентификацией приложения , передайте в запросе следующее:

Укажите область авторизации chat.app.delete .
Вызовите метод delete на ресурсе Space .
Передайте name пространства, которое нужно удалить.

Напишите скрипт, который вызывает Chat API

Вот как удалить пробел:

Питон

В рабочем каталоге создайте файл с именем chat_space_delete_app.py .
Включите следующий код в chat_space_delete_app.py :

from google.oauth2 import service_account  
from apiclient.discovery import build  
# Define your app's authorization scopes.  
# When modifying these scopes, delete the file token.json, if it exists.  
SCOPES = ["https://www.googleapis.com/auth/chat.app.delete"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then deletes the specified space.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # Build a service endpoint for Chat API.  
    chat = build('chat', 'v1', credentials=creds)  
    # Use the service endpoint to call Chat API.  
    result = chat.spaces().delete(  
          # The space to delete.  
          #  
          # Replace SPACE with a space name.  
          # Obtain the space name from the spaces resource of Chat API,  
          # or from a space's URL.  
          name='spaces/SPACE'  
      ).execute()  
    # Print Chat API's response in your command line interface.  
    # When deleting a space, the response body is empty.  
    print(result)  
if __name__ == '__main__':  
    main()

В коде замените следующее:
- SPACE с именем пространства, которое можно получить из метода spaces.list в Chat API или из URL-адреса пространства.
В вашем рабочем каталоге соберите и запустите пример:

python3 chat_space_delete_app.py

В случае успеха тело ответа пустое, что указывает на то, что пространство удалено.

Удалить именованное пространство от имени администратора Google Workspace

Если вы являетесь администратором Google Workspace, вы можете вызвать метод DeleteSpace() , чтобы удалить любое именованное пространство в вашей организации Google Workspace.

Чтобы вызвать этот метод от имени администратора Google Workspace, выполните следующие действия:

Вызовите метод, используя аутентификацию пользователя, и укажите область авторизации , которая поддерживает вызов метода с использованием привилегий администратора .
В запросе укажите параметр запроса useAdminAccess в true .

Дополнительную информацию и примеры см. в статье Управление пространствами Google Chat в качестве администратора Google Workspace .