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

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

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

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

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

Предпосылки

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);
}

main().catch(console.error);

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

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

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

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

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

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

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

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

Питон

  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 .