Method: contactGroups.members.modify

인증된 사용자가 소유한 연락처 그룹의 회원을 수정합니다.

구성원을 추가할 수 있는 시스템 연락처 그룹은 contactGroups/myContactscontactGroups/starred뿐입니다. 다른 시스템 주소록 그룹은 지원 중단되었으며 연락처만 삭제할 수 있습니다.

HTTP 요청

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

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

경로 매개변수

매개변수
resourceName

string

필수 항목입니다. 수정할 연락처 그룹의 리소스 이름입니다.

요청 본문

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

JSON 표현
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
필드
resourceNamesToAdd[]

string

선택사항입니다. people/{person_id} 형식으로 추가할 담당자의 리소스 이름입니다. resourceNamesToAddresourceNamesToRemove에 있는 리소스 이름의 총개수는 1,000개 이하여야 합니다.

resourceNamesToRemove[]

string

선택사항입니다. 삭제할 연락처 담당자의 리소스 이름(people/{person_id} 형식)입니다. resourceNamesToAddresourceNamesToRemove에 있는 리소스 이름의 총개수는 1,000개 이하여야 합니다.

응답 본문

연락처 그룹 회원 수정 요청에 대한 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
필드
notFoundResourceNames[]

string

연락처 담당자 리소스 이름을 찾을 수 없습니다.

canNotRemoveLastContactGroupResourceNames[]

string

마지막 연락처 그룹에서 삭제할 수 없는 연락처 사용자 리소스 이름입니다.

승인 범위

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

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

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