Method: users.watch

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

คำขอ HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/watch

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

พารามิเตอร์เส้นทาง

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

string

อีเมลของผู้ใช้ ค่าพิเศษ me ใช้เพื่อระบุผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้

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

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "labelIds": [
    string
  ],
  "labelFilterAction": enum (LabelFilterAction),
  "labelFilterBehavior": enum (LabelFilterAction),
  "topicName": string
}
ช่อง
labelIds[]

string

รายการ labelId เพื่อจํากัดการแจ้งเตือน โดยค่าเริ่มต้น ระบบจะพุชการเปลี่ยนแปลงทั้งหมดหากไม่ได้ระบุ หากระบุไว้ ระบบจะกำหนดป้ายกำกับที่จำเป็นในการสร้างข้อความ Push
labelFilterAction
(deprecated)

enum (LabelFilterAction)

ระบุลักษณะการกรองของ labelIds list ช่องนี้เลิกใช้งานแล้วเนื่องจากทําให้ระบบทํางานไม่ถูกต้องในบางกรณี ให้ใช้ labelFilterBehavior แทน
labelFilterBehavior

enum (LabelFilterAction)

ระบุลักษณะการกรองของ labelIds list ช่องนี้จะแทนที่ labelFilterAction หากตั้งค่าไว้ ระบบจะไม่สนใจ labelFilterAction
topicName

string

ชื่อหัวข้อ Google Cloud Pub/Sub API แบบเต็มที่จะใช้เผยแพร่เหตุการณ์ ชื่อหัวข้อนี้ต้องมีอยู่ใน Cloud Pub/Sub อยู่แล้ว และคุณต้องได้ให้สิทธิ์ "เผยแพร่" แก่ Gmail ในหัวข้อดังกล่าวแล้ว เช่น "projects/my-project-identifier/topics/my-topic-name" (ใช้รูปแบบการตั้งชื่อหัวข้อ "v1" ของ Cloud Pub/Sub)

โปรดทราบว่าส่วน "my-project-identifier" ต้องตรงกับรหัสโปรเจ็กต์นักพัฒนาแอป Google ของคุณทุกประการ (โปรเจ็กต์ที่ดำเนินการตามคำขอติดตามนี้)

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

การตอบสนองของนาฬิกาต่อข้อความ Push

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

การแสดง JSON 
{
  "historyId": string,
  "expiration": string
}
ช่อง
historyId

string

รหัสของระเบียนประวัติปัจจุบันของกล่องจดหมาย
expiration

string (int64 format)

เมื่อ Gmail จะหยุดส่งการแจ้งเตือนสำหรับการอัปเดตกล่องจดหมาย (epoch millis) โปรดโทรหา watch อีกครั้งก่อนถึงเวลาดังกล่าวเพื่อต่ออายุนาฬิกา

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

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

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

LabelFilterAction

ลักษณะการกรองของรายการ labelIds ที่ระบุ

Enum
include รับเฉพาะข้อความ Push สำหรับการเปลี่ยนแปลงข้อความที่เกี่ยวข้องกับ labelId ที่ระบุ
exclude รับข้อความ Push สำหรับการเปลี่ยนแปลงข้อความทั้งหมด ยกเว้นการเปลี่ยนแปลงที่เกี่ยวข้องกับ labelId ที่ระบุ