Удалить пространство

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

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

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

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

Предварительные требования

Node.js

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

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

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

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

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME',
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

await main();

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

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

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

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

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

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

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

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

Python

  1. В рабочей директории создайте файл с именем chat_space_delete_app.py .

  2. Включите следующий код в 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()

  3. В коде замените следующее:

    • SPACE это имя пространства, которое можно получить из метода spaces.list в Chat API или из URL-адреса пространства.

  4. В рабочей директории соберите и запустите пример:

    python3 chat_space_delete_app.py

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

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

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

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

Для получения дополнительной информации и примеров см. раздел «Управление пространствами Google Chat в качестве администратора Google Workspace» .