Groups Migration API를 사용하여 이메일을 Google 그룹스로 이전하기 전에 다음 작업을 실행하세요.
- 이메일 메시지를 그룹의 자료실로 마이그레이션하기 전에 대상 그룹이 존재하고 그룹의 이메일이 정확한지 확인하세요. 그룹 및 사용자 나열에 대한 자세한 내용은 Directory API를 참고하세요.
- 이메일 발신자의 도메인이 대상 그룹과 동일한 경우 이메일 메시지를 대상 그룹의 보관 파일로 마이그레이션하기 전에 이메일 발신자가 존재하는지 확인하세요.
- 이메일 메시지 형식은 RFC 822 표준 정의와 일치해야 합니다.
Content-type: message/rfc822
헤더를 사용합니다. 이메일 메시지의To:
,From:
,Date:
필드가 제대로 입력되었는지 확인합니다. 응답은 JSON 데이터 형식으로 반환됩니다.
이메일 메시지를 Google 그룹스로 이전
이메일 메시지를 그룹 자료실로 마이그레이션하려면 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
는 메시지의 메타데이터, 본문, 첨부파일을 포함하여 25MB로 제한됩니다.
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
: 이메일의 메타데이터, 본문, 첨부파일입니다.다음은 samplegroup@googlegroups.com의 자료실로 이전된 RFC 822 텍스트 형식의 이메일 메시지 예시입니다. NNNN@mail.samplegroup.com
는 이 예시의 Message-ID입니다. 마이그레이션된 이메일의 발신자는 sampleender@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.
성공 응답이 반환되면 200
HTTP 상태 코드와 이전 상태가 반환됩니다.
responseCode
값에 대한 자세한 내용은 Groups Migration API 참조를 확인하세요.
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
Google 그룹스 인터페이스에서 가져온 메일 보기
Google 그룹스에서 대화목록의 읽음/읽지 않음 상태는 각 사용자별로 저장됩니다. Groups Migration API를 사용하여 메시지와 대화목록을 삽입할 때 사용자가 From:
헤더에 메시지를 보낸 것처럼 처리됩니다. 즉, From:
헤더에 주소가 있는 사용자를 제외한 모든 사용자에게 읽지 않은 상태로 표시됩니다. 예를 들어 이전의 JSON 요청 예시 이후 samplesender@example.com
가 Google 그룹스에 로그인하면 SUBJECT
라는 메시지가 읽음으로 표시되지만 다른 모든 사용자에게는 읽지 않은 것으로 표시됩니다.