Archive: insert

ย้ายข้อความอีเมลไปยังที่เก็บถาวรของกลุ่ม Google โดยใช้การอัปโหลดสื่อ

วิธีนี้รองรับ URI /upload และยอมรับสื่อที่อัปโหลดแล้วที่มีลักษณะดังต่อไปนี้

  • ขนาดไฟล์สูงสุด:ขนาดสูงสุดของอีเมลคือ 25 MB ขีดจํากัดนี้จะรวมถึงส่วนหัวของข้อมูลเมตาของเนื้อหา เนื้อหา และไฟล์แนบ
  • ประเภท MIME ของสื่อที่ยอมรับ: message/rfc822

ขีดจํากัดของโปรเจ็กต์สําหรับ Groups Migration API คือคําค้นหา 10 รายการต่อวินาที (QPS) ต่อบัญชี จํานวนคําขอ API สูงสุดต่อวันคือ 500,000 รายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบ RFC822 ได้ที่รูปแบบมาตรฐาน RFC822

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
groupId string อีเมลของกลุ่มที่ใช้เก็บอีเมลที่ย้ายข้อมูลแล้ว เนื่องจากอีเมลนี้เป็นตัวแปรในเส้นทาง URL ของคําขอ หากเจ้าของกลุ่มเปลี่ยนอีเมลของกลุ่มโดยใช้คอนโซลผู้ดูแลระบบหรือ Directory API คุณต้องใช้อีเมลใหม่ในตัวแปร groupId
พารามิเตอร์การค้นหาที่จําเป็น
uploadType string

ประเภทคําขออัปโหลดไปยัง URI /upload ที่มีค่าใดค่าหนึ่งต่อไปนี้

  • media - การอัปโหลดง่ายๆ ที่อัปโหลดข้อมูลสื่อ
  • resumable - การอัปโหลดที่กลับมาทํางานอีกครั้งซึ่งอัปโหลดไฟล์แบบกลับมาทํางานอีกครั้งโดยใช้ชุดคําขออย่างน้อย 2 รายการ

การให้สิทธิ์

คําขอนี้ต้องได้รับอนุญาตจากขอบเขตต่อไปนี้

ขอบเขต
https://www.googleapis.com/auth/apps.groups.migration

ดูข้อมูลเพิ่มเติมที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์

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

อย่าให้เนื้อหาคําขอด้วยวิธีนี้

คำตอบ

หากสําเร็จ วิธีนี้จะแสดงผลเนื้อหาการตอบกลับที่มีโครงสร้างต่อไปนี้

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
kind string ประเภททรัพยากรแทรกนี้ ค่า: groupsmigration#groups
responseCode string

รหัสสถานะการตอบกลับ API สําหรับคําขอการย้ายข้อมูลพร้อมด้วยรหัสสถานะ HTTP ค่าสถานะ responseCode มีดังนี้

AUTHORIZATION FAILURE — ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของผู้ดูแลระบบไม่ถูกต้อง ส่งคืนรหัสสถานะ HTTP 401

BACKEND FAILURE - เซิร์ฟเวอร์มีปัญหาหรือไม่ว่าง ระบบจะแสดงผลรหัสสถานะ HTTP 503 เมื่อใช้อัลกอริทึม Exponential Backoff โปรดรอสักเล็กน้อยก่อนลองทําการโทรที่ล้มเหลวอีกครั้ง

INVALID MESSAGE FAILURE — ข้อความอีเมลอยู่ในรูปแบบที่ไม่ถูกต้อง หากข้อความถูกปฏิเสธเนื่องจากมีรูปแบบไม่ถูกต้อง คุณจะได้รับรหัสสถานะ HTTP 400 Bad Request ตัวอย่างรูปแบบที่ไม่ถูกต้องมีดังนี้

  • ข้อความอาจไม่มีช่อง From, To และ Date
  • ข้อผิดพลาดจะเกิดขึ้นหากบรรทัดในข้อความไม่ได้ถูกสิ้นสุดการทํางานโดย CR+LF (ซึ่งก็คือ "\r\n") บรรทัดใหม่
  • ข้อความอีเมลว่างเปล่า
  • ไม่มีกลุ่มเป้าหมายของการย้ายข้อมูลหรืออยู่ในโหมด "อ่านอย่างเดียว" ดูข้อมูลเพิ่มเติมเกี่ยวกับโหมดการแชร์แบบอ่านอย่างเดียวได้ที่ตัวเลือกการแชร์ของ Google Groups for Business

SUCCESS - เก็บอีเมลไว้ในที่เก็บถาวรของกลุ่มของบัญชีเรียบร้อยแล้ว ส่งคืนรหัสสถานะ HTTP 200

UNSUPPORTED_PARALLEL_OPERATION - Groups Migration API ไม่รองรับการแทรกข้อความพร้อมกันในที่เก็บถาวรกลุ่มเดียวกัน นอกจากนี้ Groups Migration API ไม่รองรับคําขอแบบกลุ่มด้วย แต่ Groups Migration API รองรับคําขอพร้อมกันสําหรับการแทรกอีเมลไปยังที่เก็บถาวรของกลุ่มต่างๆ ส่งคืนรหัสสถานะ HTTP 400