Method: alerts.list

แสดงรายการการแจ้งเตือน

คำขอ HTTP

GET https://alertcenter.googleapis.com/v1beta1/alerts

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

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

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

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำของบัญชี Google Workspace ของลูกค้าที่มีการเชื่อมโยงการแจ้งเตือน customerId ต้องตัด "C" แรกออก (เช่น 046psxkn) ระบบจะอนุมานจากข้อมูลประจำตัวของผู้โทรหากไม่ได้ระบุ ค้นหารหัสลูกค้า
pageSize

integer

ไม่บังคับ ขนาดหน้าเว็บที่ขอ เซิร์ฟเวอร์อาจแสดงรายการน้อยกว่าที่ขอ หากไม่ระบุ เซิร์ฟเวอร์จะเลือกค่าเริ่มต้นที่เหมาะสม
pageToken

string

ไม่บังคับ โทเค็นที่ระบุหน้าผลการค้นหาที่เซิร์ฟเวอร์ควรแสดง หากเป็นค่าว่าง ระบบจะเริ่มการวนซ้ำใหม่ หากต้องการดำเนินการซ้ำ ให้ส่งค่าจากช่อง nextPageToken ของ ListAlertsResponse รายการก่อนหน้า
filter

string

ไม่บังคับ สตริงการค้นหาสำหรับกรองผลการแจ้งเตือน โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อตัวกรองการค้นหาและฟิลด์ตัวกรองการค้นหาที่รองรับ
orderBy

string

ไม่บังคับ ลําดับการจัดเรียงของผลการค้นหารายการ หากไม่ระบุ ระบบอาจแสดงผลลัพธ์ตามลำดับที่กำหนดเอง คุณจัดเรียงผลลัพธ์ตามลําดับจากมากไปน้อยตามการประทับเวลาการสร้างได้โดยใช้ orderBy="createTime desc" ปัจจุบันการเรียงลำดับที่รองรับคือ createTime asc, createTime desc, updateTime desc

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

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

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

ข้อความตอบกลับสําหรับคําขอข้อมูลการแจ้งเตือน

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

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

object (Alert)

รายการการแจ้งเตือน
nextPageToken

string

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

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/apps.alerts

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