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 - 두 개 이상의 일련의 요청을 사용하여 파일을 재개 가능한 방식으로 업로드하는 재개 가능한 업로드입니다.

승인

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

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

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

요청 본문

이 메서드에는 요청 본문을 제공하지 마세요.

응답

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

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

마이그레이션 요청에 대한 API 응답의 상태 코드로, HTTP 상태 코드가 포함됩니다. 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 상태 코드가 반환됩니다.