Method: groups.list

เรียกข้อมูลกลุ่มทั้งหมดของโดเมนหรือผู้ใช้ที่ระบุ userKey (ใส่เลขหน้า)

คำขอ HTTP

GET https://admin.googleapis.com/admin/directory/v1/groups

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
customer

string

รหัสที่ไม่ซ้ำกันสำหรับบัญชี Google Workspace ของลูกค้า ในกรณีของบัญชีหลายโดเมน หากต้องการดึงข้อมูลกลุ่มทั้งหมดสำหรับลูกค้า ให้ใช้ช่องนี้แทน domain คุณยังใช้ชื่อแทน my_customer เพื่อแสดง customerId ของบัญชีได้ด้วย และจะแสดงผล customerId เป็นส่วนหนึ่งของทรัพยากร Users ด้วย คุณต้องระบุพารามิเตอร์ customer หรือ domain
domain

string

ชื่อโดเมน ใช้ฟิลด์นี้เพื่อรับกลุ่มจากโดเมนเดียวเท่านั้น หากต้องการแสดงโดเมนทั้งหมดสำหรับบัญชีลูกค้า ให้ใช้พารามิเตอร์การค้นหา customer แทน
maxResults

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าสูงสุดที่อนุญาตคือ 200
orderBy

enum (OrderBy)

คอลัมน์ที่จะใช้จัดเรียงผลลัพธ์
pageToken

string

โทเค็นที่จะระบุหน้าถัดไปในรายการ
query

string

การค้นหาสตริงการค้นหา ควรอยู่ในรูปแบบ "" ดูเอกสารฉบับเต็มได้ที่ https: //developers.google.com/admin-sdk/directory/v1/guides/search-groups
sortOrder

enum (SortOrder)

แสดงผลลัพธ์ในลำดับจากน้อยไปมากหรือมากไปน้อย ใช้เมื่อมีการใช้ orderBy เท่านั้น
userKey

string

อีเมลหรือรหัสที่เปลี่ยนแปลงไม่ได้ของผู้ใช้ หากมีการระบุเฉพาะกลุ่มเหล่านั้น แสดงว่าผู้ใช้ดังกล่าวเป็นสมาชิกของ หากเป็นรหัส รหัสควรตรงกับรหัสของออบเจ็กต์ผู้ใช้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "groups": [
    {
      object (Group)
    }
  ],
  "nextPageToken": string
}
ช่อง
kind

string

นี่เป็นแหล่งข้อมูล
etag

string

ETag ของทรัพยากร
groups[]

object (Group)

รายการออบเจ็กต์กลุ่ม
nextPageToken

string

โทเค็นที่ใช้ในการเข้าถึงหน้าถัดไปของผลการค้นหานี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://apps-apis.google.com/a/feeds/groups/
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.group.readonly

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์

สั่งโดย

Enum
EMAIL อีเมลของกลุ่ม

SortOrder

Enum
ASCENDING ลำดับจากน้อยไปมาก
DESCENDING ลำดับจากมากไปน้อย