Method: contactGroups.create

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

建立的聯絡人群組名稱必須專屬於使用者聯絡人群組。如果嘗試以重複的名稱建立群組,系統將傳回 HTTP 409 錯誤。

請依序傳送對同一位使用者的變動要求,以免增加延遲時間和失敗。

HTTP 要求

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

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

要求主體

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

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

object (ContactGroup)

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

readGroupFields

string (FieldMask format)

選用設定。欄位遮罩可限制要傳回群組中的哪些欄位。如果未設定或設為空白,預設值為 metadatagroupTypename。有效的欄位如下:

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

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南