คู่มือนี้อธิบายวิธีใช้เมธอด create()
ในทรัพยากร Space
ของ Google Chat API เพื่อสร้างพื้นที่ทำงานที่มีชื่อ
Space
ทรัพยากรแสดงถึงสถานที่ที่ผู้ใช้และแอป Chat สามารถส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้ พื้นที่ทำงานมีด้วยกันหลายประเภท ดังนี้
- ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนหรือผู้ใช้ 1 รายกับแอป Chat
- แชทกลุ่มเป็นการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปกับแอป Chat
- พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ทำงานถาวรที่ผู้ใช้สามารถส่งข้อความ แชร์ไฟล์ และทำงานร่วมกันได้
พื้นที่ทำงานที่มีชื่อคือที่ที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน พื้นที่ทำงานที่มีชื่ออาจมีแอปใน Chat พื้นที่ทำงานที่มีชื่อจะมีฟีเจอร์เพิ่มเติมที่การสนทนากลุ่มและข้อความส่วนตัวที่ไม่มีชื่อไม่มี เช่น ผู้จัดการพื้นที่ทำงานที่ใช้การตั้งค่าการดูแลระบบ คำอธิบาย รวมถึงเพิ่มหรือนำบุคคลและแอปออกได้ หลังจากสร้างพื้นที่ทำงานที่มีชื่อ สมาชิกเพียงคนเดียวของพื้นที่ทำงานนี้คือผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว พื้นที่ทำงานนี้จะไม่มีบุคคลหรือแอปอื่นๆ แม้แต่แอป Chat ที่สร้างพื้นที่ทำงานดังกล่าว หากต้องการเพิ่มสมาชิกไปยังพื้นที่ทำงาน โปรดดูหัวข้อสร้างการเป็นสมาชิก
หากต้องการสร้างพื้นที่ทำงานที่มีชื่อซึ่งมีสมาชิกหลายคน เช่น แชทเป็นกลุ่มที่ไม่มีชื่อระหว่างบุคคลตั้งแต่ 3 คนขึ้นไป การสนทนาทางข้อความส่วนตัวระหว่าง 2 คน หรือการสนทนาระหว่างบุคคลกับแอป Chat ที่เรียกใช้ Chat API ให้สร้างพื้นที่ทำงานแทน
ข้อกำหนดเบื้องต้น
Node.js
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
- สร้างข้อมูลเข้าสู่ระบบตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API ดังนี้
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์เป็นแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอปใน Chat
Python
- บัญชี Google Workspace Business หรือ Enterprise ที่มีสิทธิ์ใช้งาน Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Python
- สร้างข้อมูลเข้าสู่ระบบตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API ดังนี้
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอปใน Chat
Java
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Java
- สร้างข้อมูลเข้าสู่ระบบตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API ดังนี้
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอป Chat
Apps Script
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการแชทขั้นสูง
- ในคู่มือนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้หรือแอป หากต้องการตรวจสอบสิทธิ์ว่าเป็นแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ ดูขั้นตอนได้ที่หัวข้อตรวจสอบสิทธิ์และให้สิทธิ์ในฐานะแอป Google Chat
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอป Chat
สร้างพื้นที่ทำงานที่มีชื่อในฐานะผู้ใช้
หากต้องการสร้างพื้นที่ทำงานที่มีชื่อซึ่งมีการตรวจสอบสิทธิ์ผู้ใช้ ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ระบุขอบเขตการให้สิทธิ์
chat.spaces.create
หรือchat.spaces
- เรียกใช้เมธอด
CreateSpace()
โดยส่งspace
เป็นอินสแตนซ์ของSpace
ด้วยช่องต่อไปนี้- ตั้งค่า
spaceType
เป็นSPACE
displayName
ตั้งค่าเป็นชื่อที่ผู้ใช้มองเห็นของพื้นที่ทำงาน- ตั้งค่าแอตทริบิวต์อื่นๆ หากต้องการ เช่น
spaceDetails
- คำอธิบายและชุดหลักเกณฑ์ที่แสดงต่อผู้ใช้สำหรับพื้นที่ทำงานpredefinedPermissionSettings
- สิทธิ์ที่กำหนดไว้ล่วงหน้าสำหรับพื้นที่ทำงาน เช่น คุณสามารถกำหนดค่าให้สมาชิกทุกคนหรือเฉพาะผู้จัดการพื้นที่ทำงานเท่านั้นที่โพสต์ข้อความได้
- ตั้งค่า
วิธีสร้างพื้นที่ทำงานที่มีชื่อมีดังนี้
Node.js
Python
Java
Apps Script
สร้างพื้นที่ทำงานที่มีชื่อเป็นแอป Chat
การตรวจสอบสิทธิ์แอปต้องใช้การอนุมัติจากผู้ดูแลระบบแบบครั้งเดียว
หากต้องการเชิญหรือเพิ่มผู้ใช้ไปยังพื้นที่ทำงานที่มีการตรวจสอบสิทธิ์ของแอป ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ระบุขอบเขตการให้สิทธิ์
chat.app.spaces.create
หรือchat.app.spaces
- เรียกใช้เมธอด
create
ในแหล่งข้อมูลSpace
- ตั้งค่า
spaceType
เป็นSPACE
- ตั้งค่า
displayName
เป็นชื่อพื้นที่ทำงานที่ผู้ใช้มองเห็นได้ ในตัวอย่างนี้displayName
มีการตั้งค่าเป็นAPI-made
- ระบุรหัสลูกค้าของโดเมน Google Workspace โดยใช้ช่อง
customer
- (ไม่บังคับ) ตั้งค่าแอตทริบิวต์อื่นๆ ของพื้นที่ทำงาน เช่น
spaceDetails
(คำอธิบายและชุดหลักเกณฑ์ที่ผู้ใช้มองเห็นสำหรับพื้นที่ทำงาน)
สร้างคีย์ API
หากต้องการเรียกใช้เมธอด Developer Preview API คุณต้องใช้เอกสารการค้นพบ API เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ที่ไม่ได้เผยแพร่แบบสาธารณะ คุณต้องส่งคีย์ API เพื่อตรวจสอบสิทธิ์คําขอ
หากต้องการสร้างคีย์ API ให้เปิดโปรเจ็กต์ Google Cloud ของแอปแล้วทําดังนี้
- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ
- คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
- คีย์ API ใหม่จะปรากฏขึ้น
- คลิกคัดลอก เพื่อคัดลอกคีย์ API ไปใช้ในโค้ดของแอป หรือจะดูคีย์ API ในส่วน "คีย์ API" ของข้อมูลเข้าสู่ระบบของโปรเจ็กต์ก็ได้
- คลิกจํากัดคีย์เพื่ออัปเดตการตั้งค่าขั้นสูงและจํากัดการใช้คีย์ API โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อการใช้ข้อจำกัดของคีย์ API
เขียนสคริปต์ที่เรียกใช้ Chat API
วิธีสร้างพื้นที่ทำงานที่มีชื่อมีดังนี้
Python
- สร้างไฟล์ชื่อ
chat_space_create_named_app.py
ในไดเรกทอรีทํางาน ใส่รหัสต่อไปนี้ใน
chat_space_create_named_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.spaces.create"] def main(): ''' Authenticates with Chat API using app authentication, then creates a Chat 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made', # The customer ID of the Workspace domain. 'customer': 'CUSTOMER' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
ในโค้ด ให้แทนที่
API_KEY
: คีย์ API ที่คุณสร้างเพื่อสร้างปลายทางบริการสำหรับ Chat APICUSTOMER
: รหัสลูกค้าของโดเมนของพื้นที่ทำงานในรูปแบบcustomer/{customer}
โดยที่{customer}
คือID
จากทรัพยากรลูกค้าของ Admin SDK หากต้องการสร้างพื้นที่ทำงานในองค์กร Google Workspace เดียวกันกับแอป Chat ให้ใช้customers/my_customer
ในไดเรกทอรีการทำงาน ให้สร้างและเรียกใช้ตัวอย่างด้วยคำสั่งต่อไปนี้
python3 chat_space_create_named_app.py
เปิดพื้นที่ทำงานใน Google Chat
หากต้องการไปยังพื้นที่ทำงาน ให้ใช้รหัสทรัพยากรของพื้นที่ทำงานเพื่อสร้าง URL ของพื้นที่ทำงาน คุณจะดูรหัสทรัพยากรได้จากพื้นที่ทำงาน name
ในเนื้อหาการตอบกลับของ Google Chat เช่น หากname
ของพื้นที่ทำงานคือ spaces/1234567
คุณจะไปยังพื้นที่ทำงานได้โดยใช้ URL https://mail.google.com/chat/u/0/#chat/space/1234567
หัวข้อที่เกี่ยวข้อง
- เพิ่มบุคคลและแอปไปยังพื้นที่ทำงานโดยสร้างสมาชิก
- โพสต์ข้อความในพื้นที่ทำงานโดยสร้างข้อความ
- ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- แสดงพื้นที่ทำงาน
- อัปเดตพื้นที่ทำงาน
- ลบพื้นที่ทำงาน
- ตั้งค่าพื้นที่ทำงาน
- ค้นหาพื้นที่ทำงานของข้อความส่วนตัว
- ทำให้ผู้ใช้บางรายค้นพบพื้นที่ทำงานได้