یک فاصله را حذف کنید

این راهنما توضیح می‌دهد که چگونه از متد delete() در منبع Space از API چت گوگل برای حذف یک فضای نام‌گذاری شده در زمانی که دیگر نیازی به آن نیست، استفاده کنید. حذف یک فضا، هر آنچه را که در آن قرار دارد، از جمله پیام‌ها و پیوست‌ها، نیز حذف می‌کند.

اگر شما مدیر Google Workspace هستید، می‌توانید متد delete() را برای حذف هر فضای نامگذاری شده در سازمان Google Workspace خود فراخوانی کنید.

منبع Space مکانی را نشان می‌دهد که افراد و برنامه‌های چت می‌توانند در آن پیام ارسال کنند، فایل‌ها را به اشتراک بگذارند و با یکدیگر همکاری کنند. چندین نوع Space وجود دارد:

  • پیام‌های مستقیم (DM) مکالماتی بین دو کاربر یا یک کاربر و یک برنامه چت هستند.
  • چت‌های گروهی، مکالماتی بین سه یا چند کاربر و برنامه‌های چت هستند.
  • فضاهای نامگذاری شده مکان‌های پایداری هستند که افراد در آنها پیام می‌فرستند، فایل‌ها را به اشتراک می‌گذارند و با یکدیگر همکاری می‌کنند.

پیش‌نیازها

نود جی اس

حذف یک فضای نامگذاری شده به عنوان کاربر

برای حذف یک فضای موجود در گوگل چت با احراز هویت کاربر ، موارد زیر را در درخواست خود وارد کنید:

  • دامنه مجوز chat.delete را مشخص کنید.
  • متد DeleteSpace() را فراخوانی کنید.
  • name فضایی که می‌خواهید حذف کنید را ارسال کنید.

نحوه حذف فاصله به این صورت است:

نود جی اس

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 ، شناسه (ID) فیلد name فضا را وارد کنید. می‌توانید شناسه را با فراخوانی متد ListSpaces() یا از طریق URL فضا به دست آورید.

حذف یک فضای نامگذاری شده به عنوان یک برنامه چت

احراز هویت برنامه نیاز به تأیید یک‌باره مدیر دارد.

با احراز هویت برنامه، فقط می‌توانید فضاهای ایجاد شده توسط برنامه‌های چت را حذف کنید.

برای حذف یک فضای موجود در گوگل چت با احراز هویت برنامه ، موارد زیر را در درخواست خود وارد کنید:

  • دامنه مجوز 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، موارد زیر را انجام دهید:

  • با استفاده از احراز هویت کاربر، متد را فراخوانی کنید و یک محدوده مجوز مشخص کنید که از فراخوانی متد با استفاده از امتیازات مدیر پشتیبانی کند.
  • در درخواست خود، پارامتر query useAdminAccess را برابر با true قرار دهید.

برای اطلاعات و مثال‌های بیشتر، به مدیریت فضاهای چت گوگل به عنوان مدیر فضای کاری گوگل مراجعه کنید.