Archive: insert

使用媒體上傳功能，將電子郵件遷移至 Google 群組封存檔。

這個方法支援 /upload URI，可接受具備下列特性的上傳媒體：

  • 檔案大小上限：郵件大小上限為 25 MB。這個限制包括郵件中繼資料標頭、內文和任何附件。
  • 接受的媒體 MIME 類型： message/rfc822

Groups Migration API 的專案限制為每個帳戶每秒查詢 10 次 (QPS)。每天 API 要求次數上限為 500,000 次。如要進一步瞭解 RFC822 格式，請參閱 RFC822 標準格式。

要求

HTTP 要求

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

參數

參數名稱 值 說明
路徑參數
groupId string 遷移電子郵件後，儲存電子郵件的群組電子郵件地址。這個電子郵件地址是要求網址路徑中的變數。如果群組擁有者透過管理控制台或 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 欄位。
  • 如果 message 中的一行未遭 CR+LF (亦即 "\r\n") 樣式換行符號終止，就會發生錯誤。
  • 電子郵件內容為空白。
  • 遷移作業的目標群組不存在，或是處於「唯讀」模式。如要進一步瞭解唯讀共用模式，請參閱 Google 網路論壇企業版的共用選項。

SUCCESS：郵件已成功封存在帳戶的群組封存資料中。系統會傳回 200 HTTP 狀態碼。

UNSUPPORTED_PARALLEL_OPERATION：Groups Migration API 不支援在同一個群組封存檔中並行插入訊息。此外，Groups Migration API 不支援批次要求。不過，Groups Migration API 支援將電子郵件插入不同群組檔案的並行要求。系統會傳回 400 HTTP 狀態碼。