Method: contactGroups.create

建立已驗證使用者擁有的新聯絡人群組。

建立的聯絡人群組名稱不得重複。如果嘗試以重複的名稱建立群組，會傳回 HTTP 409 錯誤。

請為同一位使用者依序傳送 Mutate 要求，以避免延遲時間增加和失敗。

HTTP 要求

POST https://people.googleapis.com/v1/contactGroups

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
欄位
contactGroup

object (ContactGroup)

必要欄位。要建立的聯絡人群組。
readGroupFields

string (FieldMask format)

選用設定。欄位遮罩，用於限制傳回群組中的欄位。如未設定或設為空白，預設值為 metadata、groupType 和 name。有效欄位如下：

  • clientData
  • groupType
  • 中繼資料
  • 名稱

回應主體

如果成功，回應主體會包含新建立的 ContactGroup 例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/contacts

詳情請參閱授權指南。