Method: contactGroups.create

인증된 사용자가 소유한 새 연락처 그룹을 만듭니다.

생성된 연락처 그룹 이름은 사용자 연락처 그룹별로 고유해야 합니다. 중복된 이름으로 그룹을 만들려고 하면 HTTP 409 오류가 반환됩니다.

지연 시간 및 실패 증가를 방지하려면 동일한 사용자에 대한 변형 요청을 순차적으로 전송해야 합니다.

HTTP 요청

POST https://people.googleapis.com/v1/contactGroups

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
필드
contactGroup

object (ContactGroup)

필수 항목입니다. 생성할 연락처 그룹입니다.

readGroupFields

string (FieldMask format)

선택사항입니다. 반환되는 그룹의 필드를 제한하는 필드 마스크입니다. 설정하지 않거나 비워두면 기본값은 metadata, groupType, name입니다. 유효한 필드는 다음과 같습니다.

  • clientData
  • groupType
  • 메타데이터
  • 이름

응답 본문

성공한 경우 응답 본문에 새로 생성된 ContactGroup의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 승인 가이드를 참조하세요.