Method: contactGroups.members.modify

修改已驗證使用者擁有的聯絡人群組成員。

唯一可新增成員的系統聯絡人群組為 contactGroups/myContacts 和 contactGroups/starred。其他系統聯絡人群組已淘汰，目前只能移除聯絡人。

HTTP 要求

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

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

路徑參數

參數
resourceName

string

必要欄位。要修改的聯絡人群組名稱。

要求主體

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

JSON 表示法 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
欄位
resourceNamesToAdd[]

string

選用設定。要新增的聯絡人資源名稱，格式為 people/{person_id}。resourceNamesToAdd 和 resourceNamesToRemove 中的資源名稱總數必須小於或等於 1000。
resourceNamesToRemove[]

string

選用設定。要移除的聯絡人資源名稱，格式為 people/{person_id}。resourceNamesToAdd 和 resourceNamesToRemove 中的資源名稱總數必須小於或等於 1000。

回應主體

修改聯絡人群組成員要求的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
欄位
notFoundResourceNames[]

string

找不到聯絡人資源名稱。
canNotRemoveLastContactGroupResourceNames[]

string

無法從最後的聯絡人群組中移除的聯絡人資源名稱。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。