このページは Cloud Translation API によって翻訳されました。

Archive: insert

メディアのアップロードを使用して、メールメッセージを Google グループのアーカイブに移行します。

このメソッドは /upload URI をサポートし、次の特性を持つアップロード済みのメディアを受け入れます。

最大ファイルサイズ: メールメッセージの最大サイズは 25 MB です。この上限には、メッセージのメタデータヘッダー、本文、添付ファイルが含まれます。
有効なメディア MIME タイプ: message/rfc822

Groups Migration API のプロジェクトの上限は、アカウントごとに 1 秒あたり 10 クエリ（QPS）です。1 日あたりの 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

プロパティ名	値	説明
`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 グループの共有オプションをご覧ください。 `SUCCESS` - メールがアカウントのグループアーカイブに正常にアーカイブされました。`200` HTTP ステータスコードが返されます。 `UNSUPPORTED_PARALLEL_OPERATION` - Groups Migration API は、同じグループアーカイブへのメッセージの並列挿入をサポートしていません。また、Groups Migration API はバッチリクエストをサポートしていません。ただし、Groups Migration API は、異なるグループアーカイブへのメール挿入の並列リクエストをサポートしています。`400` HTTP ステータスコードが返されます。

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 グループの共有オプションをご覧ください。

SUCCESS - メールがアカウントのグループアーカイブに正常にアーカイブされました。200 HTTP ステータスコードが返されます。

UNSUPPORTED_PARALLEL_OPERATION - Groups Migration API は、同じグループアーカイブへのメッセージの並列挿入をサポートしていません。また、Groups Migration API はバッチリクエストをサポートしていません。ただし、Groups Migration API は、異なるグループアーカイブへのメール挿入の並列リクエストをサポートしています。400 HTTP ステータスコードが返されます。