Method: otherContacts.copyOtherContactToMyContactsGroup

複製「其他聯絡人」使用者「myContacts」中的新聯絡人群組

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

HTTP 要求

POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

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

路徑參數

參數
resourceName

string

必要欄位。「其他聯絡人」的資源名稱才能複製

要求主體

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

JSON 表示法
{
  "copyMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
欄位
copyMask

string (FieldMask format)

必要欄位。欄位遮罩,用於限制將哪些欄位複製到新聯絡人中。有效值如下:

  • emailAddresses
  • 名稱
  • phoneNumbers
readMask

string (FieldMask format)

選用設定。欄位遮罩可限制系統可傳回使用者的哪些欄位。如要指定多個欄位,請以半形逗號分隔。如未設定,則會預設為包含中繼資料和成員資格欄位的複製遮罩。有效值如下:

  • addresses
  • ageRanges
  • 傳記
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • 活動
  • externalIds
  • 性別
  • imClients
  • 興趣
  • locales
  • 位置
  • 會籍
  • 中繼資料
  • miscKeywords
  • 名稱
  • 暱稱
  • 職業
  • 機構組織
  • phoneNumbers
  • 相片
  • 關係
  • sipAddresses
  • skills
  • 網址
  • userDefined
sources[]

enum (ReadSourceType)

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

回應主體

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

授權範圍

需要下列其中一種 OAuth 範圍:

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

詳情請參閱授權指南