คู่มือนี้อธิบายวิธีใช้เมธอด
get
ในทรัพยากร Membership ของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับการเป็นสมาชิกในพื้นที่ทำงาน
เจ้าของและผู้จัดการพื้นที่ทำงานสามารถ
จำกัดผู้ที่ดูรายชื่อสมาชิก
ในพื้นที่ทำงานได้ หากมีการจำกัดระดับการมองเห็น การเรียกไปยังเมธอดนี้ที่ทำด้วยการตรวจสอบสิทธิ์แอปเท่านั้น
จะแสดงการเป็นสมาชิกที่สมาชิกในพื้นที่ทำงานมองเห็น และแสดงข้อผิดพลาด
PERMISSION_DENIEDสำหรับการเป็นสมาชิกที่สมาชิกในพื้นที่ทำงานมองไม่เห็น การเรียกใช้เมธอดนี้ด้วยการตรวจสอบสิทธิ์ผู้ใช้
จะแสดงข้อผิดพลาด PERMISSION_DENIED
หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้เมธอด get
เพื่อดึงรายละเอียดเกี่ยวกับการเป็นสมาชิกในองค์กร Google Workspace
Membershipทรัพยากร
แสดงว่าผู้ใช้ที่เป็นมนุษย์หรือแอป Google Chat ได้รับเชิญให้เข้าร่วม
เป็นส่วนหนึ่งของ หรือไม่ได้อยู่ในพื้นที่ทำงาน
การตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ของแอป ช่วยให้แอป Chat ได้รับการเป็นสมาชิกจากพื้นที่ทำงานที่แอปมีสิทธิ์เข้าถึงใน Google Chat (เช่น พื้นที่ทำงานที่แอปเป็นสมาชิก) แต่จะไม่รวมการเป็นสมาชิกของแอป Chat รวมถึงการเป็นสมาชิกของแอปเอง การตรวจสอบสิทธิ์ ด้วย การตรวจสอบสิทธิ์ของผู้ใช้ จะแสดงการเป็นสมาชิกจากพื้นที่ทำงานที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์มีสิทธิ์เข้าถึง
ข้อกำหนดเบื้องต้น
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.botขอบเขตการให้สิทธิ์ เมื่อใช้การตรวจสอบสิทธิ์ของผู้ใช้ ให้ระบุขอบเขตการให้สิทธิ์chat.memberships.readonlyหรือchat.membershipsแนวทางปฏิบัติแนะนำคือการเลือกขอบเขตที่จำกัดมากที่สุดซึ่งยังคง อนุญาตให้แอปทำงานได้ - เรียกใช้เมธอด
GetMembership - ส่งต่อ
nameของการเป็นสมาชิกเพื่อรับสิทธิ์ รับชื่อการเป็นสมาชิกจาก แหล่งข้อมูลการเป็นสมาชิกของ Google Chat
รับสิทธิ์เป็นสมาชิกด้วยการตรวจสอบสิทธิ์ผู้ใช้
วิธีสมัครเป็นสมาชิกโดยใช้การตรวจสอบสิทธิ์ผู้ใช้มีดังนี้
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ข้อมูลต่อไปนี้
SPACE_NAME: รหัสจากnameของพื้นที่ คุณดูรหัสได้โดยการเรียกใช้เมธอดListSpacesหรือจาก URL ของพื้นที่ทำงานMEMBER_NAME: รหัสจากnameของสมาชิก คุณขอรับรหัสได้โดยการเรียกใช้เมธอดListMemberships
Chat API จะแสดงผลอินสแตนซ์ของ
Membership
ซึ่งแสดงรายละเอียดการเป็นสมาชิกที่ระบุ
สมัครเป็นสมาชิกด้วยการตรวจสอบสิทธิ์แอป
วิธีสมัครเป็นสมาชิกโดยใช้ การตรวจสอบสิทธิ์แอปมีดังนี้
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ข้อมูลต่อไปนี้
SPACE_NAME: รหัสจากnameของพื้นที่ คุณดูรหัสได้โดยการเรียกใช้เมธอดListSpacesหรือจาก URL ของพื้นที่ทำงานMEMBER_NAME: รหัสจากnameของสมาชิก คุณขอรับรหัสได้โดยการเรียกใช้เมธอดListMemberships
Chat API จะแสดงผลอินสแตนซ์ของ
Membership
ซึ่งแสดงรายละเอียดการเป็นสมาชิกที่ระบุ
ดูรายละเอียดเกี่ยวกับการเป็นสมาชิกในฐานะผู้ดูแลระบบ Google Workspace
หากคุณเป็นผู้ดูแลระบบ Google Workspace คุณสามารถเรียกใช้เมธอด
GetMembership เพื่อดึงรายละเอียดเกี่ยวกับการเป็นสมาชิกของผู้ใช้ในองค์กร Google Workspace
ได้
หากต้องการเรียกใช้เมธอดนี้ในฐานะผู้ดูแลระบบ Google Workspace ให้ทำดังนี้
- เรียกใช้เมธอดโดยใช้การตรวจสอบสิทธิ์ผู้ใช้ และระบุขอบเขตการให้สิทธิ์ ที่รองรับการเรียกใช้เมธอดโดยใช้สิทธิ์ของผู้ดูแลระบบ
- ในคำขอ ให้ระบุพารามิเตอร์การค้นหา
useAdminAccessถึงtrue
ดูข้อมูลเพิ่มเติมและตัวอย่างได้ที่ จัดการพื้นที่ Google Chat ในฐานะผู้ดูแลระบบ Google Workspace
หัวข้อที่เกี่ยวข้อง
- แสดงรายชื่อสมาชิกในพื้นที่ทำงาน
- เชิญหรือเพิ่มผู้ใช้หรือแอป Chat ไปยังพื้นที่ทำงาน
- อัปเดตการเป็นสมาชิกของผู้ใช้ในพื้นที่ใน Google Chat
- นำผู้ใช้หรือแอป Chat ออกจากพื้นที่ทำงาน