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 狀態碼。