Method: contactGroups.members.modify

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

구성원을 추가할 수 있는 유일한 시스템 연락처 그룹은 contactGroups/myContacts 및 contactGroups/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} 형식으로 추가할 연락처 담당자의 리소스 이름입니다. resourceNamesToAdd 및 resourceNamesToRemove의 총 리소스 이름 수는 1,000 이하여야 합니다.
resourceNamesToRemove[]

string

선택사항입니다. 삭제할 담당자의 리소스 이름(people/{person_id} 형식)입니다. resourceNamesToAdd 및 resourceNamesToRemove의 총 리소스 이름 수는 1,000 이하여야 합니다.

응답 본문

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

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

JSON 표현 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
입력란
notFoundResourceNames[]

string

찾을 수 없는 연락처 담당자 리소스 이름입니다.
canNotRemoveLastContactGroupResourceNames[]

string

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

승인 범위

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

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

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