Method: contactGroups.update

更新已驗證使用者所擁有的現有聯絡人群組名稱。

更新的聯絡人群組名稱不得重複。如果嘗試以重複的名稱建立群組，系統將傳回 HTTP 409 錯誤。

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

HTTP 要求

PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}

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

路徑參數

參數
contactGroup.resourceName

string

伺服器指派的聯絡人群組的資源名稱。ASCII 字串，格式為 contactGroups/{contactGroupId}。

要求主體

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

JSON 表示法 
{
  "contactGroup": {
    "resourceName": string,
    "etag": string,
    "metadata": {
      "updateTime": string,
      "deleted": boolean
    },
    "groupType": enum (GroupType),
    "name": string,
    "formattedName": string,
    "memberResourceNames": [
      string
    ],
    "memberCount": integer,
    "clientData": [
      {
        "key": string,
        "value": string
      }
    ]
  },
  "updateGroupFields": string,
  "readGroupFields": string
}
欄位
contactGroup.etag

string

資源的 HTTP 實體標記。用於網頁快取驗證。
contactGroup.metadata

object (ContactGroupMetadata)

僅供輸出。聯絡人群組的中繼資料。
contactGroup.groupType

enum (GroupType)

僅供輸出。聯絡人群組類型。
contactGroup.name

string

群組擁有者設定的聯絡人群組名稱，或是系統群組的名稱。

contactGroups.create 或 contactGroups.update 的名稱不得重複。如果嘗試以重複的名稱建立群組，系統將傳回 HTTP 409 錯誤。
contactGroup.formattedName

string

僅供輸出。以檢視者帳戶語言代碼或 Accept-Language HTTP 標頭語言代碼 (系統群組名稱) 的翻譯和格式設定名稱。擁有者設定的群組名稱與名稱相同。
contactGroup.memberResourceNames[]

string

僅供輸出。具備聯絡人群組成員的聯絡人資源名稱清單。這個欄位只會針對 GET 要求填入，且在 get 要求中只會傳回 maxMembers 名成員。
contactGroup.memberCount

integer

僅供輸出。群組中的聯絡人總數 (無論要求中指定的成員人數上限為何)。
contactGroup.clientData[]

object (GroupClientData)

群組的用戶端資料。
updateGroupFields

string (FieldMask format)

選用設定。欄位遮罩，可限制要更新群組中的哪些欄位。如要指定多個欄位，請以半形逗號分隔。如未設定或設為空白，則預設值為 name。系統會替換更新的欄位。有效值如下：

  • clientData
  • 名稱
readGroupFields

string (FieldMask format)

選用設定。欄位遮罩可限制要傳回群組中的哪些欄位。如果未設定或設為空白，預設值為 metadata、groupType 和 name。有效的欄位如下：

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

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。