Archive: insert

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

วิธีการนี้รองรับ 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