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

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