REST Resource: contactGroups

資源：ContactGroup

聯絡人群組。

JSON 表示法 
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (ContactGroupMetadata)
  },
  "groupType": enum (GroupType),
  "name": string,
  "formattedName": string,
  "memberResourceNames": [
    string
  ],
  "memberCount": integer,
  "clientData": [
    {
      object (GroupClientData)
    }
  ]
}
欄位
resourceName

string

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

string

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

object (ContactGroupMetadata)

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

enum (GroupType)

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

string

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

contactGroups.create 或 contactGroups.update 的使用者名稱專屬於使用者聯絡人群組。如果嘗試以重複的名稱建立群組，會傳回 HTTP 409 錯誤。
formattedName

string

僅供輸出。依據檢視者帳戶語言代碼或系統群組名稱的 Accept-Language HTTP 標頭語言代碼，完成翻譯和格式設定的名稱。擁有者設定的群組名稱會與名稱相同。
memberResourceNames[]

string

僅供輸出。聯絡人群組成員的聯絡人資源名稱清單。這個欄位只會在 GET 要求中填入，而且在 get 要求中傳回的成員數量只會像 maxMembers 一樣的上限。
memberCount

integer

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

object (GroupClientData)

群組的用戶端資料。

ContactGroupMetadata

聯絡人群組的中繼資料。

JSON 表示法 
{
  "updateTime": string,
  "deleted": boolean
}
欄位
updateTime

string (Timestamp format)

僅供輸出。群組上次更新的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
deleted

boolean

僅供輸出。如果聯絡人群組資源已遭刪除，則為「是」。僅針對包含同步權杖的 contactGroups.list 要求填入。

GroupType

聯絡人群組類型。

列舉
GROUP_TYPE_UNSPECIFIED 未指明
USER_CONTACT_GROUP 使用者定義的聯絡人群組。
SYSTEM_CONTACT_GROUP 系統定義的聯絡人群組。

GroupClientData

由用戶端填入的任意客戶資料。索引鍵和值可以重複。

JSON 表示法 
{
  "key": string,
  "value": string
}
欄位
key

string

用戶端指定的用戶端資料金鑰。
value

string

用戶端指定用戶端資料的值。

方法

batchGet

 指定聯絡人群組資源名稱清單，取得已驗證使用者擁有的聯絡人群組清單。

create

 建立已驗證使用者擁有的新聯絡人群組。

delete

 指定聯絡人群組的資源名稱，刪除已驗證使用者擁有的現有聯絡人群組。

get

 指定聯絡人群組的資源名稱，取得已驗證使用者擁有的特定聯絡人群組。

list

 列出已驗證使用者擁有的所有聯絡人群組。

update

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