ลบพื้นที่ทำงาน

คู่มือนี้อธิบายวิธีใช้เมธอด delete() ในทรัพยากร Space ของ Google Chat API เพื่อลบพื้นที่ที่มีชื่อเมื่อไม่จําเป็นต้องใช้อีกต่อไป การลบพื้นที่ทำงานจะเป็นการลบข้อมูลทุกอย่างในนั้นด้วย ซึ่งรวมถึงข้อความและไฟล์แนบ

หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้delete()วิธีนี้เพื่อลบพื้นที่ทำงานที่มีชื่อในองค์กร Google Workspace

แหล่งข้อมูล Space รายการ แสดงถึงสถานที่ที่ผู้คนและแอป Chat ส่งข้อความได้ แชร์ไฟล์ และทำงานร่วมกัน พื้นที่ทำงานมีด้วยกันหลายประเภท ดังนี้

  • ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนหรือผู้ใช้ 1 ราย แอปใน Chat
  • แชทกลุ่มเป็นการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปกับแอป Chat
  • พื้นที่ทำงานที่มีชื่อคือที่ที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน

ข้อกำหนดเบื้องต้น

Node.js

  • ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat

ลบพื้นที่ทำงานที่มีชื่อในฐานะผู้ใช้

หากต้องการลบพื้นที่ทำงานที่มีอยู่ใน 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 ด้วยรหัสจาก ของ Space name ด้วย คุณสามารถรับรหัสโดยโทรไปที่ ListSpaces() หรือจาก URL ของพื้นที่ทำงาน

ลบพื้นที่ทำงานที่มีชื่อเป็นแอป Chat

การตรวจสอบสิทธิ์แอปต้องใช้ครั้งเดียว การอนุมัติจากผู้ดูแลระบบ

เมื่อใช้การตรวจสอบสิทธิ์แอป คุณจะลบได้เฉพาะพื้นที่ทำงานที่สร้างโดย แอปแชท

หากต้องการลบพื้นที่ทำงานที่มีอยู่ใน Google Chat ด้วย การตรวจสอบสิทธิ์แอป ผ่าน ต่อไปนี้ในคำขอของคุณ

  • ระบุขอบเขตการให้สิทธิ์ chat.app.delete
  • เรียกใช้เมธอด delete ในทรัพยากร Space
  • ส่งผ่าน name ของพื้นที่ทำงานเพื่อลบ

สร้างคีย์ API

หากต้องการเรียกใช้เมธอด Developer Preview API คุณต้องใช้เอกสารการค้นพบ API เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ที่ไม่ได้เผยแพร่แบบสาธารณะ หากต้องการตรวจสอบสิทธิ์คำขอ คุณต้องส่งคีย์ API

หากต้องการสร้างคีย์ API ให้เปิดโปรเจ็กต์ Google Cloud ของแอปแล้วทําดังนี้

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ

    ไปที่ข้อมูลเข้าสู่ระบบ

  2. คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
  3. คีย์ API ใหม่จะปรากฏขึ้น
    • คลิกคัดลอก เพื่อคัดลอกคีย์ API เพื่อใช้ในโค้ดของแอป คีย์ API ยังทำหน้าที่เป็น ที่พบใน "คีย์ API" ของข้อมูลเข้าสู่ระบบของโปรเจ็กต์
    • คลิกจำกัดคีย์เพื่ออัปเดตการตั้งค่าขั้นสูงและจำกัดการใช้งาน ของคีย์ API ดูรายละเอียดเพิ่มเติมได้ที่การใช้ข้อจำกัดของคีย์ API

เขียนสคริปต์ที่เรียกใช้ Chat 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, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')
    
        # 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. ในโค้ด ให้แทนที่ข้อมูลต่อไปนี้

    • API_KEY: คีย์ API ที่คุณสร้างเพื่อสร้างอุปกรณ์ปลายทางบริการสำหรับ Chat API

    • 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