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

서버에서 할당한 연락처 그룹의 리소스 이름입니다. contactGroups/{contactGroupId} 형식의 ASCII 문자열.
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 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
deleted

boolean

출력 전용입니다. 연락처 그룹 리소스가 삭제된 경우 true입니다. 동기화 토큰이 포함된 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

 인증된 사용자가 소유한 기존 연락처 그룹의 이름을 업데이트합니다.