Method: people.createContact

建立新聯絡人,並傳回該聯絡人的人員資源。

如果聯絡人來源的單例模式指定多個欄位,要求會傳回 400 錯誤:

  • 傳記
  • 生日
  • 性別
  • names

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

HTTP 要求

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

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

查詢參數

參數
personFields

string (FieldMask format)

必要欄位。欄位遮罩,用於限制傳回每個人上的欄位。如要指定多個欄位,請用半形逗號分隔。如果沒有設定,則預設為所有欄位。以下為有效值:

  • addresses
  • ageRanges
  • 傳記
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • 活動
  • externalIds
  • 性別
  • imClients
  • 興趣
  • locales
  • 地點
  • 會籍
  • 中繼資料
  • miscKeywords
  • names
  • 暱稱
  • 職業
  • organizations
  • phoneNumbers
  • 相片
  • 關係
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

選用設定。要傳回哪些來源類型的遮罩。如未設定,預設值為 READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE

要求主體

要求主體包含 Person 的例項。

回應主體

如果成功,回應主體會包含 Person 的執行例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南