คู่มือนี้อธิบายวิธีใช้เมธอด
get()
ในทรัพยากร Space ของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน
เช่น ชื่อที่แสดง คำอธิบาย และหลักเกณฑ์
หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้เมธอด get()
เพื่อดึงรายละเอียดเกี่ยวกับพื้นที่ใดก็ได้ในองค์กร Google Workspace
Spaceทรัพยากร
แสดงถึงสถานที่ที่ผู้ใช้และแอป Chat สามารถส่งข้อความ
แชร์ไฟล์ และทำงานร่วมกันได้ พื้นที่ทำงานมีหลายประเภท ดังนี้
- ข้อความส่วนตัว (DM) คือการสนทนาระหว่างผู้ใช้ 2 คนหรือผู้ใช้กับแอป Chat
 - แชทกลุ่มคือการสนทนาระหว่างผู้ใช้ตั้งแต่ 3 คนขึ้นไปและแอป Chat
 - พื้นที่ทำงานที่มีชื่อคือพื้นที่ถาวรที่ผู้คนใช้ส่งข้อความ แชร์ไฟล์ และทำงานร่วมกัน
 
การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ของแอป ช่วยให้แอปใน Chat ดูรายละเอียดเกี่ยวกับพื้นที่ทำงาน ที่แอปใน Chat เป็นสมาชิกได้ การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ผู้ใช้ จะช่วยให้คุณเข้าถึงพื้นที่ทำงานที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์มีสิทธิ์เข้าถึงได้ ไม่ว่าจะเป็นในฐานะ สมาชิกในพื้นที่ทำงานหรือผู้ดูแลระบบ Google Workspace
ข้อกำหนดเบื้องต้น
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
 
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือแอป Chat ที่โทรเป็นสมาชิก หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้เพิ่มแอป 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
 
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือแอป Chat ที่โทรเป็นสมาชิก หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้เพิ่มแอป 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
 
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือแอป Chat ที่โทรเป็นสมาชิก หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้เพิ่มแอป Chat ลงในพื้นที่ทำงาน
 
Apps Script
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
 
- ตั้งค่าสภาพแวดล้อม โดยทำดังนี้
    
- สร้างโปรเจ็กต์ Google Cloud
 - กำหนดค่าหน้าจอขอความยินยอม OAuth
 - เปิดใช้และกำหนดค่า Google Chat API พร้อมชื่อ ไอคอน และคำอธิบายสำหรับแอป Chat
 - สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการ Chat ขั้นสูง
 - ในคู่มือนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หรือแอป หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้าง ข้อมูลเข้าสู่ระบบของบัญชีบริการ ดูขั้นตอนได้ที่ ตรวจสอบสิทธิ์และให้สิทธิ์ในฐานะ แอป Google Chat
 
 - เลือกขอบเขตการให้สิทธิ์ตามว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือ แอปใน Chat
 
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือแอป Chat ที่โทรเป็นสมาชิก หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้เพิ่มแอป Chat ลงในพื้นที่ทำงาน
 
รับพื้นที่ทำงาน
หากต้องการรับพื้นที่ใน Google Chat ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ขอบเขตการให้สิทธิ์
- เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้
ให้ระบุ
chat.spaces.readonlyหรือchat.spacesขอบเขตการให้สิทธิ์ - เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้
ระบุ
chat.botขอบเขตการให้สิทธิ์หรือขอบเขตchat.app.spaceschat.app.spacesขอบเขตพร้อมใช้งานในเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ และต้องมีการอนุมัติจากผู้ดูแลระบบแบบครั้งเดียว 
 - เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้
ให้ระบุ
 - เรียกใช้เมธอด
GetSpace()โดยส่งnameของพื้นที่ทำงานที่จะรับ รับชื่อพื้นที่ทำงานจากSpaceทรัพยากรของ Google Chat หรือจาก URL ของพื้นที่ทำงาน 
ดูรายละเอียดของพื้นที่ทำงานในฐานะผู้ใช้
วิธีดูรายละเอียดพื้นที่โดยใช้การตรวจสอบสิทธิ์ผู้ใช้มีดังนี้
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ SPACE_NAME ด้วยรหัสจาก
ฟิลด์
name
ของพื้นที่ คุณรับรหัสได้โดยเรียกใช้เมธอด
ListSpaces()
หรือจาก URL ของพื้นที่ทำงาน
Chat API จะแสดงอินสแตนซ์ของ
Space
ซึ่งแสดงรายละเอียดของพื้นที่ที่ระบุ
ดูรายละเอียดพื้นที่เก็บข้อมูลในฐานะผู้ดูแลระบบ Google Workspace
หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้เมธอด GetSpace
เพื่อดึงรายละเอียดเกี่ยวกับพื้นที่ใดก็ได้ในองค์กร Google Workspace
หากต้องการเรียกใช้เมธอดนี้ในฐานะผู้ดูแลระบบ Google Workspace ให้ทำดังนี้
- เรียกใช้เมธอดโดยใช้การตรวจสอบสิทธิ์ผู้ใช้ และระบุขอบเขตการให้สิทธิ์ ที่รองรับการเรียกใช้เมธอดโดยใช้สิทธิ์ของผู้ดูแลระบบ
 - ในคำขอ ให้ระบุพารามิเตอร์การค้นหา 
useAdminAccessเป็นtrue 
ดูข้อมูลเพิ่มเติมและตัวอย่างได้ที่หัวข้อจัดการพื้นที่ใน Google Chat ในฐานะผู้ดูแลระบบ Google Workspace
ดูรายละเอียดของพื้นที่ทำงานในฐานะแอป Chat
วิธีดูรายละเอียดพื้นที่โดยใช้การตรวจสอบสิทธิ์แอปมีดังนี้
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ SPACE_NAME ด้วยรหัสจาก
ฟิลด์
name
ของพื้นที่ คุณรับรหัสได้โดยเรียกใช้เมธอด
ListSpaces()
หรือจาก URL ของพื้นที่ทำงาน
Chat API จะแสดงอินสแตนซ์ของ
Space
ซึ่งแสดงรายละเอียดของพื้นที่ที่ระบุ
ข้อจำกัดและข้อควรพิจารณา
- ฟิลด์
accessSettingspredefinedPermissionSettingsและpermissionSettingsจะแสดงข้อมูลเมื่อคุณตรวจสอบสิทธิ์ด้วยขอบเขตchat.app.spacesเท่านั้น และการตั้งค่าสิทธิ์จะจำกัดไว้เฉพาะพื้นที่ที่แอป Chat สร้างขึ้น 
หัวข้อที่เกี่ยวข้อง
- สร้างพื้นที่ทำงาน
 - ตั้งค่าพื้นที่ทำงาน
 - แสดงพื้นที่ทำงาน
 - อัปเดตพื้นที่ทำงาน
 - ลบพื้นที่ทำงาน
 - ค้นหาพื้นที่ข้อความส่วนตัว