이메일 이전
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Groups Migration API를 사용하여 이메일을 Google 그룹스로 이전하기 전에
팔로잉
- 마이그레이션하기 전에 대상 그룹이 존재하고 그룹 이메일이 정확한지 확인하세요.
해당 그룹의 자료실로 이동합니다. 그룹 및 사용자를 나열하는 방법에 관한 자세한 내용은 Directory API를 참고하세요.
- 이메일 발신자가 대상 그룹과 동일한 도메인을 사용하는 경우 이메일 발신자가 존재하는지 확인합니다.
해야 합니다.
- 이메일 메시지 형식은 RFC 822 표준 정의에 따라야 합니다.
Content-type: message/rfc822 헤더를 사용합니다. 이메일 메시지의 To:, From:, Date: 필드가 올바른 형식인지 확인합니다. 응답은 JSON 데이터 형식으로 반환됩니다.
이메일 메시지를 그룹 자료실로 이전하려면 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의 보관 파일입니다. 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.
응답이 성공하면 200 HTTP 상태 코드와 이전 상태가 반환됩니다.
responseCode 값에 관한 자세한 내용은 Groups Migration API 참조를 참고하세요.
{
"kind": "groupsMigration#groups",
"responseCode": "SUCCESS",
}
Google 그룹스 인터페이스에서 가져온 메시지 보기
Google 그룹에서는 대화목록의 읽음/읽지 않음 상태가 사용자별로 별도로 저장됩니다. 날짜
Groups Migration API를 사용하여 메일 및 대화목록을 삽입하면
From: 헤더에서 사용자가 보냈습니다. 즉, 읽지 않은 상태로 표시됩니다.
(주소가 From: 헤더에 있는 사용자를 제외한 모든 사용자) 예를 들어 이전 JSON 요청 예시 후 samplesender@example.com가 Google 그룹스에 로그인한 경우 SUBJECT라는 제목의 메일이 읽은 상태로 표시되지만 다른 모든 사용자에게는 읽지 않은 상태로 표시됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Migrate emails\n\nBefore migrating an email to Google Groups by using the Groups Migration API, do the\nfollowing\n\n- Confirm that the target group exists and the group's email is accurate before migrating an email message to that group's archive. For more information about listing groups and users, see the [Directory API](/workspace/admin/directory).\n- If the email's sender has the same domain as the target group, confirm the email sender exists before migrating the email message to the target group's archive.\n- The email message format must be in the [RFC 822 standard definition](https://www.w3.org/Protocols/rfc822/). Use the `Content-type: message/rfc822` header. Confirm that the email message's `To:`, `From:`, and `Date:` fields are properly formed. The response is returned in the [JSON](https://www.json.org/) data format.\n\nMigrate an email message to Google Groups\n-----------------------------------------\n\nTo migrate an email message to a group's archive, send a `POST` HTTP request,\ninclude the `Authorization` header, and replace\n\u003cvar translate=\"no\"\u003eGROUP_EMAIL_ADDRESS\u003c/var\u003e with the email address of the group that the messages\nare intended for: \n\n```\nPOST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media\n```\n\n### Example request\n\nThis example migrates email messages to the samplegroup@googlegroups.com archive. The\n`Content-Length` is limited to 25MB which includes the message's meta data, body, and any\nattachments: \n\n```\nPOST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media\nHost: www.googleapis.com\nContent-Type: message/rfc822\nContent-Length: BYTES\nAuthorization: Bearer Auth token\n\nMETADATA_BODY\n```\n\nReplace the following:\n- \u003cvar translate=\"no\"\u003eBYTES\u003c/var\u003e: the number of bytes in the email.\n- \u003cvar translate=\"no\"\u003eAUTH_TOKEN\u003c/var\u003e: the `Authorization` header.\n- \u003cvar translate=\"no\"\u003eMETADATA_BODY\u003c/var\u003e: the email's metadata, body, and any attachments.\n- The following is an example email message in RFC 822 text format that was migrated into the archive of samplegroup@googlegroups.com. The `NNNN@mail.samplegroup.com` is this example's Message-ID. The migrated email's sender is samplesender@example.com and the email is migrated to the archive of the samplegroup@googlegroups.com group: \n\n```\n Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)\n Message-ID: \u003cNNNN@mail.samplegroup.com\u003e\n Date: Mon, 16 Jul 2007 10:12:26 -0700\n From: samplesender@example.com\n To: samplegroup@googlegroups.com\n Subject: SUBJECT\n MIME-Version: 1.0\n Content-Type: text/plain; charset=ISO-8859-1; format=flowed\n Content-Transfer-Encoding: 7bit\n Content-Disposition: inline\n Delivered-To: samplegroup@samplegroup.com\n\n This is the body of the migrated email message.\n```\n- A successful response returns a `200` HTTP status code and the migration status. For more information about `responseCode` values, see [the Groups Migration API reference](/workspace/admin/groups-migration/v1/reference/archive/insert). \n\n```text\n{\n \"kind\": \"groupsMigration#groups\",\n \"responseCode\": \"SUCCESS\",\n}\n```\n\nView imported messages on the Google Groups interface\n-----------------------------------------------------\n\n- On Google Groups, threads' read/unread state is stored separately for each user. When inserting messages and threads using the Groups Migration API, they're treated as if they were sent by the user in the `From:` header. This means that they appear as unread for all users, except for the user whose address is in the `From:` header. For example, after the previous JSON request example, the message titled `SUBJECT` appears as read if `samplesender@example.com` logged in to Google Groups, but appears as unread for all other users."]]
