คู่มือนี้อธิบายวิธีใช้เมธอด 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 Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างในคู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
- พื้นที่ใน Google Chat หากต้องการสร้างโดยใช้ Google Chat API โปรดดูหัวข้อสร้างพื้นที่ทำงาน หากต้องการสร้างใน Chat ให้ไปที่เอกสารประกอบในศูนย์ช่วยเหลือ
ลบพื้นที่ทำงานที่มีชื่อในฐานะผู้ใช้
หากต้องการลบพื้นที่ทำงานที่มีอยู่ใน Google Chat ด้วย การตรวจสอบสิทธิ์ผู้ใช้, ผ่าน ต่อไปนี้ในคำขอของคุณ
- ระบุ
chat.delete
ขอบเขตการให้สิทธิ์ - เรียกใช้
DeleteSpace()
- ส่งผ่าน
name
ของพื้นที่ทำงานเพื่อลบ
ต่อไปนี้เป็นวิธีลบพื้นที่ทำงาน
Node.js
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ SPACE_NAME
ด้วยรหัสจาก
ของ Space
name
ด้วย คุณสามารถรับรหัสโดยโทรไปที่
ListSpaces()
หรือจาก URL ของพื้นที่ทำงาน
ลบพื้นที่ทำงานที่มีชื่อเป็นแอป Chat
การตรวจสอบสิทธิ์แอปต้องใช้ครั้งเดียว การอนุมัติจากผู้ดูแลระบบ
เมื่อใช้การตรวจสอบสิทธิ์แอป คุณจะลบได้เฉพาะพื้นที่ทำงานที่สร้างโดย แอปแชท
หากต้องการลบพื้นที่ทำงานที่มีอยู่ใน Google Chat ด้วย การตรวจสอบสิทธิ์แอป ผ่าน ต่อไปนี้ในคำขอของคุณ
- ระบุขอบเขตการให้สิทธิ์
chat.app.delete
- เรียกใช้เมธอด
delete
ในทรัพยากรSpace
- ส่งผ่าน
name
ของพื้นที่ทำงานเพื่อลบ
สร้างคีย์ API
หากต้องการเรียกใช้เมธอด Developer Preview API คุณต้องใช้เอกสารการค้นพบ API เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ที่ไม่ได้เผยแพร่แบบสาธารณะ หากต้องการตรวจสอบสิทธิ์คำขอ คุณต้องส่งคีย์ API
หากต้องการสร้างคีย์ API ให้เปิดโปรเจ็กต์ Google Cloud ของแอปแล้วทําดังนี้
- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ
- คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
- คีย์ API ใหม่จะปรากฏขึ้น
- คลิกคัดลอก เพื่อคัดลอกคีย์ API เพื่อใช้ในโค้ดของแอป คีย์ API ยังทำหน้าที่เป็น ที่พบใน "คีย์ API" ของข้อมูลเข้าสู่ระบบของโปรเจ็กต์
- คลิกจำกัดคีย์เพื่ออัปเดตการตั้งค่าขั้นสูงและจำกัดการใช้งาน ของคีย์ API ดูรายละเอียดเพิ่มเติมได้ที่การใช้ข้อจำกัดของคีย์ API
เขียนสคริปต์ที่เรียกใช้ Chat API
วิธีลบพื้นที่ทำงานมีดังนี้
Python
- สร้างไฟล์ชื่อ
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, 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()
ในโค้ด ให้แทนที่ข้อมูลต่อไปนี้
API_KEY
: คีย์ API ที่คุณสร้างเพื่อสร้างอุปกรณ์ปลายทางบริการสำหรับ Chat APISPACE
พร้อมชื่อพื้นที่ทำงาน ซึ่งคุณดูได้จากเมธอด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
หัวข้อที่เกี่ยวข้อง
- สร้างพื้นที่ทำงาน
- ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- ระบุพื้นที่ทำงาน
- อัปเดตพื้นที่ทำงาน
- ลบพื้นที่ทำงาน
- ตั้งค่าพื้นที่ทำงาน
- ค้นหาพื้นที่ข้อความส่วนตัว