Method: users.messages.modify

แก้ไขป้ายกำกับและค่าป้ายกำกับการแยกประเภทในข้อความที่ระบุ สำหรับผู้ดูแลระบบที่แก้ไขข้อความของผู้ใช้ในองค์กร คำขอต้องมีการให้สิทธิ์ด้วยบัญชีบริการที่มีสิทธิ์มอบสิทธิ์ทั่วทั้งโดเมนเพื่อแอบอ้างเป็นผู้ใช้ที่มีขอบเขตhttps://www.googleapis.com/auth/gmail.modify.restricted

คำขอ HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

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

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

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

string

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

string

รหัสของข้อความที่จะแก้ไข

เนื้อหาคำขอ

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

การแสดง JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
ช่อง
addLabelIds[]

string

รายการรหัสของป้ายกำกับที่จะเพิ่มลงในข้อความนี้ คุณเพิ่มป้ายกำกับได้สูงสุด 100 รายการในการอัปเดตแต่ละครั้ง
removeLabelIds[]

string

รายการรหัสของป้ายกำกับที่จะนำออกจากข้อความนี้ คุณนำป้ายกำกับออกได้สูงสุด 100 รายการในการอัปเดตแต่ละครั้ง
addClassificationLabels[]

object (ClassificationLabelValue)

รายการค่าป้ายกำกับการแยกประเภทที่จะเพิ่ม หากมีการใช้ป้ายกำกับการแยกประเภทที่มีรหัสป้ายกำกับเดียวกันกับข้อความอยู่แล้ว ระบบจะอัปเดตช่องที่มีรหัสช่องที่มีอยู่ และเพิ่มช่องที่มีรหัสช่องใหม่ ค่าป้ายกำกับการแยกประเภทต่อคำขอมีได้สูงสุด 20 รายการ หากข้อความได้รับการแยกประเภทแล้วและจำนวนค่าป้ายกำกับการแยกประเภททั้งหมดเกินจำนวนค่าป้ายกำกับการแยกประเภทสูงสุดที่อนุญาตต่อข้อความ การแก้ไขจะล้มเหลว
removeClassificationLabelIds[]

string

รายการค่าป้ายกำกับการแยกประเภทที่จะนำออกจากข้อความนี้

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Message

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

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

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

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