ก่อนย้ายข้อมูลอีเมลไปยัง Google Groups โดยใช้ Groups Migration API ให้ทำดังนี้
- โปรดยืนยันว่ามีกลุ่มเป้าหมายอยู่และอีเมลของกลุ่มถูกต้องก่อนย้ายข้อความอีเมลไปยังที่เก็บถาวรของกลุ่มนั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มรายชื่อและผู้ใช้ได้ที่ Directory API
- หากผู้ส่งอีเมลมีโดเมนเดียวกับกลุ่มเป้าหมาย โปรดยืนยันว่าผู้ส่งอีเมลนั้นมีอยู่ ก่อนย้ายข้อความอีเมลไปยังที่เก็บถาวรของกลุ่มเป้าหมาย
- รูปแบบข้อความอีเมลต้องอยู่ในคำจำกัดความมาตรฐาน RFC 822
ใช้ส่วนหัว
Content-type: message/rfc822
ยืนยันว่าช่องTo:
,From:
และDate:
ของข้อความอีเมลมีรูปแบบถูกต้อง การตอบกลับจะแสดงผลในรูปแบบข้อมูล JSON
ย้ายข้อความอีเมลไปยัง Google Groups
หากต้องการย้ายข้อความอีเมลไปยังที่เก็บถาวรของกลุ่ม ให้ส่งคำขอ HTTP POST
ใส่ส่วนหัว Authorization
แล้วแทนที่ GROUP_EMAIL_ADDRESS
ด้วยอีเมลของกลุ่มที่ใช้สำหรับข้อความดังกล่าว
POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media
ตัวอย่างคำขอ
ตัวอย่างนี้จะย้ายข้อความอีเมลไปยังที่เก็บถาวร samplegroup@googlegroups.com Content-Length
มีขนาดไม่เกิน 25 MB ซึ่งรวมถึงข้อมูลเมตา เนื้อหา และไฟล์แนบอื่นๆ ของข้อความ
POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer Auth token
METADATA_BODY
แทนที่รายการต่อไปนี้
BYTES
: จำนวนไบต์ในอีเมลAUTH_TOKEN
: ส่วนหัว Authorization
METADATA_BODY
: ข้อมูลเมตา เนื้อหา และไฟล์แนบของอีเมลต่อไปนี้เป็นตัวอย่างข้อความอีเมลในรูปแบบข้อความ RFC 822 ที่ย้ายข้อมูลไปที่ที่เก็บถาวรของ samplegroup@googlegroups.com โดย NNNN@mail.samplegroup.com
คือรหัสข้อความของตัวอย่างนี้ ผู้ส่งอีเมลที่ย้ายข้อมูลคือ samplesender@example.com และอีเมลถูกย้ายไปยังที่เก็บถาวรของกลุ่ม samplegroup@googlegroups.com
Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT) Message-ID: <NNNN@mail.samplegroup.com> Date: Mon, 16 Jul 2007 10:12:26 -0700 From: samplesender@example.com To: samplegroup@googlegroups.com Subject: SUBJECT MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline Delivered-To: samplegroup@samplegroup.com This is the body of the migrated email message.
การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200
และสถานะการย้ายข้อมูล
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับค่า responseCode
ที่เอกสารอ้างอิงสำหรับ Groups Migration API
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
ดูข้อความที่นำเข้าในอินเทอร์เฟซ Google Groups
ใน Google Groups ระบบจะจัดเก็บสถานะอ่านแล้ว/ยังไม่อ่านของชุดข้อความแยกกันสําหรับผู้ใช้แต่ละราย เมื่อแทรกข้อความและชุดข้อความโดยใช้ Groups Migration API ระบบจะปฏิบัติต่อข้อความและชุดข้อความราวกับว่าเป็นผู้ส่งในส่วนหัว From:
ซึ่งหมายความว่าสถานะนี้จะปรากฏว่ายังไม่ได้อ่านสำหรับผู้ใช้ทุกคน ยกเว้นผู้ใช้ซึ่งมีที่อยู่ในส่วนหัว From:
ตัวอย่างเช่น หลังจากตัวอย่างคำขอ JSON ก่อนหน้านี้ ข้อความชื่อ SUBJECT
จะปรากฏว่าอ่านแล้วหาก samplesender@example.com
เข้าสู่ระบบ Google Groups แต่ปรากฏว่ายังไม่อ่านสำหรับผู้ใช้รายอื่นๆ