คู่มือนี้อธิบายวิธีสร้างพื้นที่ทำงานที่มีชื่อโดยใช้เมธอด
create()
ในแหล่งข้อมูล Space
ของ Google Chat API
พื้นที่ทำงานที่มีชื่อ (ซึ่งspaceTypeอยู่SPACE) คือพื้นที่ที่ผู้คนส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน
พื้นที่ทำงานที่มีชื่อสามารถมีแอปใน Chat ได้ พื้นที่ทำงานที่มีชื่อจะมีผู้จัดการพื้นที่ทำงานที่สามารถใช้การตั้งค่าการดูแลระบบ คำอธิบาย รวมถึงเพิ่มหรือนำผู้คนและแอปออกได้
หากต้องการสร้างพื้นที่ใน Chat ประเภทต่างๆ
(รวมถึงข้อความส่วนตัวหรือข้อความกลุ่ม) ให้ใช้วิธี setUp() ในแหล่งข้อมูล
Space เพื่อสร้างพื้นที่ทำงานและเพิ่มสมาชิกพร้อมกัน โปรดดูรายละเอียดที่ตั้งค่าพื้นที่ทำงาน
หลังจากสร้างพื้นที่ทำงานที่มีชื่อแล้ว สมาชิกเพียงคนเดียวของพื้นที่ทำงานคือผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์
 หากต้องการเพิ่มสมาชิกไปยังพื้นที่ทำงาน ให้เรียกใช้เมธอด
create() ในทรัพยากร Membership
สำหรับ
แต่ละบุคคลหรือแอปที่ต้องการเพิ่ม หรือจะใช้วิธี setUp() เพื่อ
สร้างพื้นที่ทำงานที่มีชื่อและเพิ่มสมาชิกพร้อมกันก็ได้
ข้อกำหนดเบื้องต้น
Node.js
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
 
- ตั้งค่าสภาพแวดล้อมของคุณ ดังนี้
    
- สร้างโปรเจ็กต์ Google Cloud
 - กำหนดค่าหน้าจอขอความยินยอม OAuth
 - เปิดใช้และกำหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
 - ติดตั้ง Node.js Cloud Client Library
 - สร้างข้อมูลเข้าสู่ระบบเพื่อเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
        ดังนี้
        
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.jsonในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้
            สร้างบัญชีบริการ
            ข้อมูลเข้าสู่ระบบ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.json 
 - หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
 
 - เลือกขอบเขตการให้สิทธิ์ตามว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอปใน Chat
 
Python
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
 
- ตั้งค่าสภาพแวดล้อมของคุณ ดังนี้
    
- สร้างโปรเจ็กต์ Google Cloud
 - กำหนดค่าหน้าจอขอความยินยอม OAuth
 - เปิดใช้และกำหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
 - ติดตั้ง Python Cloud Client Library
 - สร้างข้อมูลเข้าสู่ระบบเพื่อเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
        ดังนี้
        
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.jsonในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้
            สร้างบัญชีบริการ
            ข้อมูลเข้าสู่ระบบ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.json 
 - หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
 
 - เลือกขอบเขตการให้สิทธิ์ตามว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอปใน Chat
 
Java
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
 
- ตั้งค่าสภาพแวดล้อมของคุณ ดังนี้
    
- สร้างโปรเจ็กต์ Google Cloud
 - กำหนดค่าหน้าจอขอความยินยอม OAuth
 - เปิดใช้และกำหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
 - ติดตั้ง Java Cloud Client Library
 - สร้างข้อมูลเข้าสู่ระบบเพื่อเข้าถึงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API
        ดังนี้
        
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.jsonในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้
            สร้างบัญชีบริการ
            ข้อมูลเข้าสู่ระบบ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
credentials.json 
 - หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้
            สร้างรหัสไคลเอ็นต์ OAuthและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
            
 
 - เลือกขอบเขตการให้สิทธิ์ตามว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอปใน Chat
 
Apps Script
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
 
- ตั้งค่าสภาพแวดล้อมของคุณ ดังนี้
    
- สร้างโปรเจ็กต์ Google Cloud
 - กำหนดค่าหน้าจอขอความยินยอม OAuth
 - เปิดใช้และกำหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
 - สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการ Chat ขั้นสูง
 - ในคู่มือนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หรือแอป หากต้องการตรวจสอบสิทธิ์ในฐานะแอป 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(คำอธิบายที่ผู้ใช้มองเห็นและชุดหลักเกณฑ์สำหรับพื้นที่ทำงาน) 
เขียนสคริปต์ที่เรียกใช้ Chat API
วิธีสร้างพื้นที่ทำงานที่มีชื่อมีดังนี้
Python
- สร้างไฟล์ชื่อ 
chat_space_create_named_app.pyในไดเรกทอรีการทำงาน ใส่รหัสต่อไปนี้ใน
chat_space_create_named_app.pyfrom 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) # 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()ในโค้ด ให้แทนที่ค่าต่อไปนี้
CUSTOMER: รหัสลูกค้าของโดเมนของ พื้นที่ในรูปแบบ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
ข้อจำกัดและข้อควรพิจารณา
- เมื่อสร้างพื้นที่ทำงานโดยใช้การตรวจสอบสิทธิ์แอป
ระบบจะเพิ่มแอป Chat ที่ตรวจสอบสิทธิ์
เป็นสมาชิกของพื้นที่ทำงาน แต่
ไม่เหมือนกับการตรวจสอบสิทธิ์ผู้ใช้ ซึ่งจะไม่เพิ่มเป็นผู้จัดการพื้นที่ทำงาน โดยค่าเริ่มต้น สมาชิกในพื้นที่ทำงาน
ทุกคนจะนำแอป Chat ออกได้ หากต้องการอนุญาตให้เฉพาะผู้จัดการพื้นที่ทำงาน
นำแอป Chat ออก ให้ตั้งค่า
permissionSettings.manageAppsเป็นmanagersAllowed 
หัวข้อที่เกี่ยวข้อง
- เพิ่มผู้คนและแอปไปยังพื้นที่ทำงานโดยสร้างสมาชิก
 - โพสต์ข้อความในพื้นที่ทำงานโดยสร้างข้อความ
 - ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
 - แสดงพื้นที่ทำงาน
 - อัปเดตพื้นที่ทำงาน
 - ลบพื้นที่ทำงาน
 - ตั้งค่าพื้นที่ทำงาน
 - ค้นหาพื้นที่ข้อความส่วนตัว
 - ทำให้ผู้ใช้บางรายค้นพบพื้นที่ทำงานได้