คู่มือนี้อธิบายวิธีใช้เมธอด
setUp()
ในทรัพยากร Space ของ Google Chat API เพื่อสร้างพื้นที่ใน Chat และเพิ่มสมาชิกในพื้นที่ดังกล่าว
ทรัพยากร
Spaceแสดงถึงพื้นที่ที่ผู้คนและแอปใน Chat สามารถส่งข้อความ
แชร์ไฟล์ และทำงานร่วมกันได้ พื้นที่ทำงานมีหลายประเภท ดังนี้
- ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คน หรือระหว่างผู้ใช้กับแอปใน Chat
- การแชทเป็นกลุ่มคือการสนทนาระหว่างผู้ใช้ 3 คนขึ้นไปกับแอปใน Chat
- พื้นที่ทำงานที่มีชื่อเป็นพื้นที่ถาวรที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน
คุณสามารถใช้เมธอด setUp() เพื่อดำเนินการต่อไปนี้
- สร้างพื้นที่ทำงานที่มีชื่อพร้อมสมาชิกเริ่มต้น
- สร้างข้อความส่วนตัว (DM) ระหว่างบุคคล 2 คน
- ตั้งค่าข้อความกลุ่มระหว่างบุคคลหลายคน
เมื่อตั้งค่าพื้นที่ทำงาน ให้พิจารณาสิ่งต่อไปนี้
- ระบบจะเพิ่มผู้ใช้ที่เรียก (ซึ่งผ่านการตรวจสอบสิทธิ์แล้ว) ลงในพื้นที่ทำงานโดยอัตโนมัติ คุณจึงไม่จำเป็นต้องระบุการเป็นสมาชิกของผู้ใช้ในคำขอ
- เมื่อสร้างข้อความส่วนตัว (DM) หากมี DM ระหว่างผู้ใช้ 2 คนอยู่แล้ว ระบบจะแสดง DM นั้น แต่หากไม่มี ระบบจะสร้าง DM ขึ้น
- เมื่อสร้างการแชทเป็นกลุ่ม หากเพิ่มการเป็นสมาชิกที่ระบุไว้ในคำขอลงในการแชทเป็นกลุ่มไม่สำเร็จ (เช่น ปัญหาเกี่ยวกับสิทธิ์) ระบบอาจสร้างการแชทเป็นกลุ่มที่ว่างเปล่า (มีเพียงผู้ใช้ที่เรียกเท่านั้น)
- คุณไม่สามารถตั้งค่าพื้นที่ทำงานที่มีการตอบกลับแบบแยกชุดข้อความหรือเพิ่มบุคคลภายนอกองค์กร Google Workspace ได้
- ระบบจะกรองการเป็นสมาชิกที่ซ้ำกัน (รวมถึงผู้ใช้ที่เรียก) ที่ระบุไว้ในคำขอออกแทนที่จะทำให้เกิดข้อผิดพลาดในคำขอ
- เมื่อผู้ดูแลระบบ Google Workspace ติดตั้งแอปใน Chat ให้กับทั้ง องค์กร Google Workspace, Google Chat จะสร้าง DM ระหว่างแอปใน Chat ที่ติดตั้งกับผู้ใช้แต่ละคนในองค์กร คุณจึง ไม่จำเป็นต้องตั้งค่า DM แบบเป็นโปรแกรม แต่ให้แสดงพื้นที่ทำงาน เพื่อแสดง DM ทั้งหมดหรือ ค้นหาข้อความส่วนตัว เพื่อดูรายละเอียดเกี่ยวกับ DM ที่เฉพาะเจาะจงแทน
ข้อกำหนดเบื้องต้น
Node.js
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอปใน Chat
- ติดตั้งไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างใน
คู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonใน ไดเรกทอรีภายในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
Python
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอปใน Chat
- ติดตั้งไลบรารีของไคลเอ็นต์ Cloud สำหรับ Python
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างใน
คู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonใน ไดเรกทอรีภายในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
Java
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอปใน Chat
- ติดตั้งไลบรารีของไคลเอ็นต์ Cloud สำหรับ Java
-
สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth สำหรับแอปพลิเคชันบนเดสก์ท็อป หากต้องการเรียกใช้ตัวอย่างใน
คู่มือนี้ ให้บันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.jsonใน ไดเรกทอรีภายในเครื่อง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
Apps Script
- บัญชี Google Workspace เวอร์ชัน Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API ด้วยชื่อ ไอคอน และคำอธิบายสำหรับแอปใน Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน, แล้วเปิดใช้บริการ Chat ขั้นสูง
- เลือกขอบเขตการให้สิทธิ์ที่รองรับการตรวจสอบสิทธิ์ผู้ใช้
ตั้งค่าพื้นที่ทำงาน
หากต้องการตั้งค่าพื้นที่ทำงาน ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ระบุขอบเขตการให้สิทธิ์
chat.spaces.createหรือchat.spaces - เรียกใช้เมธอด
SetUpSpace() - ส่ง
spaceเป็นอินสแตนซ์ของSpaceพร้อมช่องที่จำเป็นทั้งหมด เช่นdisplayNameหรือspaceType - ส่ง
membershipsเป็นอาร์เรย์ของMembershipอินสแตนซ์ โดยสำหรับแต่ละอินสแตนซ์ ให้ทำดังนี้- ระบุ
users/{user}เพื่อเพิ่มผู้ใช้ที่เป็นบุคคลจริงเป็นสมาชิกในพื้นที่ทำงาน โดย{user}จะเป็น{person_id}สำหรับpersonจาก People API หรือรหัสของuserใน Directory API เช่น หากresourceNameของบุคคลใน People API คือpeople/123456789คุณสามารถเพิ่มผู้ใช้ลงในพื้นที่ทำงานได้โดยใส่การเป็นสมาชิกที่มีusers/123456789เป็นmember.name - ระบุ
groups/{group}เพื่อเพิ่มกลุ่มเป็นสมาชิกในพื้นที่ทำงาน โดย{group}คือรหัสกลุ่มที่ต้องการสร้างการเป็นสมาชิก คุณสามารถดึงข้อมูลรหัสของกลุ่ม ได้โดยใช้ Cloud Identity API เช่น หาก Cloud Identity API แสดงกลุ่มที่มีชื่อgroups/123456789ให้ตั้งค่าmembership.groupMember.nameเป็นgroups/123456789คุณไม่สามารถเพิ่ม Google Groups ลงในการแชทเป็นกลุ่มหรือ DM ได้ แต่จะเพิ่มได้เฉพาะพื้นที่ทำงานที่มีชื่อเท่านั้น
- ระบุ
หากต้องการสร้าง DM ระหว่างผู้ใช้ที่เรียกกับผู้ใช้ที่เป็นบุคคลจริงรายอื่น ให้ระบุการเป็นสมาชิกของผู้ใช้ที่เป็นบุคคลจริงในคำขอ
หากต้องการสร้าง DM ระหว่างผู้ใช้ที่เรียกกับแอปที่เรียก ให้ตั้งค่า space.singleUserBotDm เป็น true และไม่ต้องระบุการเป็นสมาชิกใดๆ คุณจะใช้วิธีนี้เพื่อตั้งค่า DM กับแอปที่เรียกเท่านั้น หากต้องการเพิ่มแอปที่เรียกเป็นสมาชิกในพื้นที่ทำงานหรือ DM ที่มีอยู่ระหว่างผู้ใช้ที่เป็นบุคคลจริง 2 คน โปรดดูสร้างการเป็นสมาชิก
ตัวอย่างต่อไปนี้จะสร้างพื้นที่ทำงานที่มีชื่อและสร้างการเป็นสมาชิก 1 รายการในพื้นที่ทำงานสำหรับผู้ใช้ที่เป็นบุคคลจริง 2 คน (ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์และผู้ใช้รายอื่น)
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่าง ให้แทนที่ข้อมูลต่อไปนี้
DISPLAY_NAME: ชื่อที่แสดงของพื้นที่ทำงานใหม่USER_NAME: รหัสของผู้ใช้รายอื่นที่จะรวมการเป็นสมาชิก
หากต้องการไปที่พื้นที่ทำงาน ให้ใช้รหัสทรัพยากรของพื้นที่ทำงานเพื่อสร้าง URL ของพื้นที่ทำงาน
คุณสามารถรับรหัสทรัพยากรจาก name ของพื้นที่ทำงานในเนื้อหาการตอบกลับของ Google Chat เช่น หาก name ของพื้นที่ทำงานคือ spaces/1234567 คุณจะไปที่พื้นที่ทำงานได้โดยใช้ URL https://mail.google.com/chat/u/0/#chat/space/1234567
หัวข้อที่เกี่ยวข้อง
- สร้างพื้นที่ทำงาน
- ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
- แสดงพื้นที่ทำงาน
- อัปเดตพื้นที่ทำงาน
- ลบพื้นที่ทำงาน
- ค้นหาพื้นที่ทำงานสำหรับข้อความส่วนตัว
- ทำให้พื้นที่ทำงานค้นพบได้สำหรับผู้ใช้ที่เฉพาะเจาะจง