建立新聯絡人,並傳回該聯絡人的人員資源。
如果聯絡人來源的單例模式指定多個欄位,要求會傳回 400 錯誤:
- 傳記
- 生日
- 性別
- names
請為同一位使用者依序傳送 Mutate 要求,以避免延遲時間增加和失敗。
HTTP 要求
POST https://people.googleapis.com/v1/people:createContact
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
personFields |
必要欄位。欄位遮罩,用於限制傳回每個人上的欄位。如要指定多個欄位,請用半形逗號分隔。如果沒有設定,則預設為所有欄位。以下為有效值:
|
sources[] |
選用設定。要傳回哪些來源類型的遮罩。如未設定,預設值為 |
要求主體
要求主體包含 Person
的例項。
回應主體
如果成功,回應主體會包含 Person
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/contacts
詳情請參閱授權指南。