Method: subscriptions.list

แสดงรายการการสมัครใช้บริการ Google Workspace หากต้องการดูวิธีใช้วิธีนี้ โปรดดูหัวข้อแสดงรายการการสมัครใช้บริการ Google Workspace

คำขอ HTTP

GET https://workspaceevents.googleapis.com/v1/subscriptions

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

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

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

integer

ไม่บังคับ จำนวนการสมัครใช้บริการสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุหรือตั้งค่าเป็น 0 ระบบจะแสดงผลการสมัครใช้บริการสูงสุด 50 รายการ

ค่าสูงสุดคือ 100 หากคุณระบุค่ามากกว่า 100 ระบบจะแสดงการสมัครรับข้อมูลเพียง 100 รายการเท่านั้น

pageToken

string

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

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

filter

string

ต้องระบุ ตัวกรองการค้นหา

คุณสามารถกรองการสมัครใช้บริการตามประเภทเหตุการณ์ (event_types) และทรัพยากรเป้าหมาย (target_resource) ได้

คุณต้องระบุประเภทเหตุการณ์อย่างน้อย 1 ประเภทในการค้นหา หากต้องการกรองเหตุการณ์หลายประเภท ให้ใช้โอเปอเรเตอร์ OR

หากต้องการกรองตามทั้งประเภทเหตุการณ์และทรัพยากรเป้าหมาย ให้ใช้โอเปอเรเตอร์ AND แล้วระบุชื่อทรัพยากรแบบเต็ม เช่น //chat.googleapis.com/spaces/{space}

ตัวอย่างเช่น การค้นหาต่อไปนี้ถูกต้อง

event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created"

event_types:"google.workspace.chat.message.v1.created" AND
  target_resource="//chat.googleapis.com/spaces/{space}"

( event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created" ) AND
  target_resource="//chat.googleapis.com/spaces/{space}"

เซิร์ฟเวอร์ปฏิเสธการค้นหาที่ไม่ถูกต้องที่มีข้อผิดพลาด INVALID_ARGUMENT

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

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

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

ข้อความตอบกลับสำหรับ SubscriptionsService.ListSubscriptions

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

การแสดง JSON
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
ช่อง
subscriptions[]

object (Subscription)

รายการการสมัครใช้บริการ

nextPageToken

string

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

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

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

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

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