Method: alerts.list

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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

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