หน้านี้ได้รับการแปลโดย Cloud Translation API

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

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย
`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`

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