ก่อนย้ายข้อมูลอีเมลไปยัง Google Groups โดยใช้ Groups Migration API ให้ทำดังนี้
- ยืนยันว่ากลุ่มเป้าหมายมีอยู่และอีเมลของกลุ่มถูกต้องก่อนย้ายข้อมูลข้อความอีเมลไปยังที่เก็บถาวรของกลุ่ม ดูข้อมูลเพิ่มเติมเกี่ยวกับการแสดงรายการกลุ่มและผู้ใช้ได้ที่ Directory API
- หากผู้ส่งอีเมลมีโดเมนเดียวกับกลุ่มเป้าหมาย ให้ยืนยันว่าผู้ส่งอีเมลมีอยู่ก่อนย้ายข้อมูลข้อความอีเมลไปยังที่เก็บถาวรของกลุ่มเป้าหมาย
- รูปแบบข้อความอีเมลต้องเป็นไปตามข้อกำหนดมาตรฐาน
RFC 822 ใช้ส่วนหัว
Content-type: message/rfc822ยืนยันว่าช่องTo:,From:และDate:ของข้อความอีเมลมีรูปแบบที่ถูกต้อง ระบบจะแสดงการตอบกลับ ในรูปแบบข้อมูล JSON
ย้ายข้อมูลข้อความอีเมลไปยัง Google Groups
หากต้องการย้ายข้อมูลข้อความอีเมลไปยังที่เก็บถาวรของกลุ่ม ให้ส่งคำขอ POST HTTP,
ใส่ส่วนหัว 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: ส่วนหัวAuthorizationMETADATA_BODY: ข้อมูลเมตา เนื้อหา และไฟล์แนบของอีเมล
ตัวอย่างต่อไปนี้คือข้อความอีเมลในรูปแบบข้อความ RFC 822 ที่ย้ายข้อมูลไปยังที่เก็บถาวรของ samplegroup@googlegroups.com โดย NNNN@mail.samplegroup.com คือ Message-ID ของตัวอย่างนี้ ผู้ส่งอีเมลที่ย้ายข้อมูลคือ 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 แต่จะปรากฏเป็นยังไม่อ่านสำหรับผู้ใช้รายอื่นๆ