คำแนะนำนี้จะอธิบายวิธีใช้เมธอด delete
ในแหล่งข้อมูล Message
ของ
Google Chat API เพื่อลบ SMS หรือข้อความในการ์ด
ใน Chat API ข้อความใน Chat จะแสดงด้วยส่วนหัว
แหล่งข้อมูล Message
แม้ว่าผู้ใช้ Chat จะส่งได้เฉพาะข้อความที่มีข้อความเท่านั้น
แอปแชทสามารถใช้ฟีเจอร์การรับส่งข้อความอื่นๆ ได้มากมาย รวมถึง
แสดงอินเทอร์เฟซผู้ใช้แบบคงที่หรือแบบอินเทอร์แอกทีฟ ซึ่งรวบรวมข้อมูลจาก
ผู้ใช้ และการส่งข้อความแบบส่วนตัว หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการรับส่งข้อความ
ฟีเจอร์ที่ใช้ได้กับ Chat API โปรดดู
ภาพรวมข้อความ Google Chat
เมื่อใช้การตรวจสอบสิทธิ์แอป คุณสามารถใช้วิธีนี้เพื่อลบข้อความที่ ส่งแอป Chat แล้ว ด้วย การตรวจสอบสิทธิ์ผู้ใช้ สามารถใช้วิธีการนี้เพื่อลบข้อความที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ส่ง ถ้า ผู้ใช้เป็นผู้จัดการพื้นที่ทำงานของพื้นที่ทำงานนั้นๆ คุณยังอาจลบ ข้อความที่สมาชิกคนอื่นในพื้นที่ทำงานส่ง สำหรับข้อมูลเพิ่มเติม โปรดดู เรียนรู้เกี่ยวกับ บทบาทของคุณในฐานะผู้จัดการพื้นที่ทำงาน
ข้อกำหนดเบื้องต้น
Python
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างใน
ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไฟล์ ไดเรกทอรีในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
ลบข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้
หากต้องการลบข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้ ส่งต่อสิ่งต่อไปนี้ในคำขอของคุณ
- ระบุขอบเขตการให้สิทธิ์
chat.messages
- เรียกใช้
delete
วิธี ใน แหล่งข้อมูลMessage
- ตั้งค่า
name
เป็นชื่อทรัพยากรของข้อความที่จะลบ
ตัวอย่างต่อไปนี้ลบข้อความที่มี การตรวจสอบสิทธิ์ผู้ใช้:
Python
- ในไดเรกทอรีการทำงาน ให้สร้างไฟล์ชื่อ
chat_message_delete_user.py
รวมรหัสต่อไปนี้ใน
chat_message_delete_user.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.messages"] def main(): ''' Authenticates with Chat API via user credentials, then deletes a message. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().messages().delete( # The message 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. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name = 'spaces/SPACE/messages/MESSAGE' ).execute() # Prints response to the Chat API call. # When deleting a message, the response body is empty. print(result) if __name__ == '__main__': main()
ในโค้ด ให้แทนที่
SPACE
: ชื่อพื้นที่ทำงานซึ่งดูได้จาก เวลาspaces.list
วิธี ใน Chat API หรือจาก URL ของพื้นที่ทำงานMESSAGE
: ชื่อข้อความซึ่งคุณจะดูได้ จากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้างข้อความแบบไม่พร้อมกัน ด้วย Chat API หรือ ชื่อที่กำหนดเอง ที่กำหนดให้กับข้อความขณะสร้าง
ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่างด้วยคำสั่งต่อไปนี้
python3 chat_message_delete_user.py
หากสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า ซึ่งระบุว่าข้อความ ลบแล้ว
ลบข้อความที่มีการตรวจสอบสิทธิ์แอป
เมื่อต้องการลบข้อความที่มี การตรวจสอบสิทธิ์แอป ให้ผ่านการตรวจสอบ ต่อไปนี้ในคำขอของคุณ:
- ระบุขอบเขตการให้สิทธิ์
chat.bot
- เรียกใช้
delete
วิธี ในแหล่งข้อมูลMessage
- ตั้งค่า
name
เป็นชื่อทรัพยากรของข้อความที่จะลบ
ตัวอย่างต่อไปนี้ลบข้อความที่มี การตรวจสอบสิทธิ์แอป:
Python
- ในไดเรกทอรีการทำงาน ให้สร้างไฟล์ชื่อ
chat_delete_message_app.py
รวมรหัสต่อไปนี้ใน
chat_delete_message_app.py
:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Delete a Chat message. result = chat.spaces().messages().delete( # The message 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. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name='spaces/SPACE/messages/MESSAGE' ).execute() # Print Chat API's response in your command line interface. # When deleting a message, the response body is empty. print(result)
ในโค้ด ให้แทนที่
SPACE
:name
ของพื้นที่ทำงานที่ โพสต์ข้อความไปแล้ว ซึ่งคุณสามารถดูได้จาก เมธอดspaces.list
ใน Chat API หรือจาก URL ของพื้นที่ทำงานMESSAGE
: ชื่อข้อความ ซึ่งคุณสามารถดูได้จาก จากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้างข้อความแบบไม่พร้อมกัน ด้วย Chat API หรือ ชื่อที่กำหนดเอง ที่กำหนดให้กับข้อความขณะสร้าง
ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่างด้วยคำสั่งต่อไปนี้
python3 chat_delete_message_app.py
หากสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า ซึ่งระบุว่าข้อความ ลบแล้ว