Archive: insert

미디어 업로드를 사용하여 이메일 메시지를 Google 그룹의 자료실로 이전합니다.

이 메서드는 /upload URI를 지원하며 다음 특성을 가진 업로드된 미디어를 허용합니다.

  • 최대 파일 크기: 메일 메시지의 최대 크기는 25MB입니다. 이 한도에는 메시지의 메타데이터 헤더, 본문, 첨부파일이 포함됩니다.
  • 허용되는 미디어 MIME 유형: message/rfc822

Groups Migration API의 프로젝트 한도는 계정당 초당 쿼리 수 (QPS) 10개입니다. 일일 최대 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

/upload URI에 대한 업로드 요청 유형과 다음 값 중 하나를 포함합니다.

  • media - 미디어 데이터를 업로드하는 간단한 업로드입니다.
  • resumable - 2개 이상의 일련의 요청을 사용하여 재개 가능한 방식으로 파일을 업로드하는 재개 가능한 업로드입니다.

승인

다음 범위를 사용하여 이 요청을 인증받아야 합니다.

범위
https://www.googleapis.com/auth/apps.groups.migration

자세한 내용은 인증 및 승인 페이지를 참조하세요.

요청 본문

이 메서드에는 요청 본문을 제공하지 않습니다.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
속성 이름 설명
kind string 삽입 리소스의 종류입니다. 값: groupsmigration#groups
responseCode string

HTTP 상태 코드와 함께 표시되는 마이그레이션 요청에 대한 API 응답 상태 코드 responseCode 상태 값에는 다음이 포함됩니다.

AUTHORIZATION FAILURE - 관리자의 승인 사용자 인증 정보가 잘못되었습니다. 401 HTTP 상태 코드가 반환됩니다.

BACKEND FAILURE — 서버에 문제가 있거나 사용 중입니다. 503 HTTP 상태 코드가 반환됩니다. 지수 백오프 알고리즘을 사용하여 작은 지연을 기다렸다가 실패한 호출을 다시 시도합니다.

INVALID MESSAGE FAILURE — 이메일 메시지의 형식이 잘못되었습니다. 잘못된 형식으로 인해 메시지가 거부되면 400 Bad Request HTTP 상태 코드가 수신됩니다. 잘못된 형식의 예는 다음과 같습니다.

  • 메일에 From, To, Date 필드가 누락되었을 수 있습니다.
  • 메시지의 줄이 CR+LF (즉, "\r\n") 스타일의 줄바꿈으로 끝나지 않으면 오류가 발생합니다.
  • 이메일 메시지가 비어 있습니다.
  • 마이그레이션의 대상 그룹이 존재하지 않거나 '읽기 전용' 모드입니다. 읽기 전용 공유 모드에 대한 자세한 내용은 Google Groups for Business 공유 옵션을 참조하세요.

SUCCESS - 메일이 계정의 그룹 자료실에 성공적으로 보관처리되었습니다. 200 HTTP 상태 코드가 반환됩니다.

UNSUPPORTED_PARALLEL_OPERATION - Groups Migration API는 동일한 그룹 자료실로의 동시 메시지 삽입을 지원하지 않습니다. Groups Migration API도 일괄 요청을 지원하지 않습니다. 하지만 Groups Migration API는 다른 그룹 자료실에 이메일을 삽입하는 동시 요청을 지원합니다. 400 HTTP 상태 코드가 반환됩니다.