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 จะแสดงขึ้น