사용자 초대 만들기 및 관리

이 페이지에서는 Cloud ID 사용자 초대 API로 몇 가지 기본적인 작업을 수행하는 방법을 설명합니다.

시작하기 전에

참고: Cloud ID API를 사용하려면 먼저 Cloud ID를 설정해야 합니다. 자세한 내용은 Cloud ID 설정을 참조하세요.

이 페이지의 정보를 계속 진행하기 전에 다음 작업을 수행하세요.

초대 자격요건 결정

개요의 설명대로 사용자 계정을 초대하려면 여러 기준을 충족해야 합니다. IsInvitableUser() 메서드를 사용하면 특정 사용자 계정이 요건을 충족하는지 확인할 수 있습니다.

REST

사용자 계정 자격요건을 확인하려면 고객 ID와 계정의 이메일 주소를 사용하여 customers.userinvitations.isInvitableUser()를 호출합니다.

샘플 요청

GET https://cloudidentity.googleapis.com/v1/customers/C00000000/userinvitations/writer@altostrat.com:isInvitableUser

사용자 초대 검색

사용자 초대 API는 단일 사용자 초대를 검색하고 모두 가져오는 메서드를 제공합니다. 모든 사용자 초대를 검색할 때 선택적으로 상태별로 필터링하고 정렬 순서를 설정할 수 있습니다.

단일 사용자 초대 검색

REST

단일 사용자 초대를 검색하려면 고객 ID와 계정의 이메일 주소를 사용하여 customers.userinvitations.get()을 호출합니다.

샘플 요청

GET https://cloudidentity.googleapis.com/v1/customers/C00000000/userinvitations/writer@altostrat.com

사용자 초대 목록 검색

모든 비관리 사용자는 관리자나 최종 사용자가 조치를 취할 때까지 자동으로 NOT_YET_SENT 상태의 초대로 표시됩니다. 사용자가 초대를 수락하면 계정은 더 이상 관리되지 않는 것으로 간주됩니다.

필터에서 or 연산자를 추가하여 여러 상태를 확인할 수 있습니다. state=='accepted'||state=='declined'

REST

사용자 초대 목록을 가져오려면 고객 ID와 원하는 쿼리 매개변수를 사용하여 customers.userinvitations.list()를 호출하여 결과를 필터링, 정렬하고 페이지로 나눕니다. 다음 예시에서는 모든 비관리 사용자의 목록을 마지막 업데이트 시간 내림차순으로 정렬합니다.

샘플 요청

GET https://cloudidentity.googleapis.com/v1/customers/C00000000/userinvitations?filter=state!='accepted'&orderBy='updateTime desc'

사용자 초대 보내기

사용자 초대는 자동으로 자격 보유자에게 전송되지 않습니다. 초대하려는 사용자의 목록이 있으면 customers.userinvitations.send() 메서드를 사용할 수 있습니다. 또한 목록이 없으면 초대를 만듭니다.

REST

사용자에게 사용자 초대 이메일을 보내려면 고객 ID와 사용자 계정의 이메일 주소를 사용하여 customers.userinvitations.send()를 호출합니다.

샘플 요청

POST https://cloudidentity.googleapis.com/v1/customers/C00000000/userinvitations/writer@altostrat.com:send

사용자 초대 취소

사용자 초대가 수락되거나 거부되기까지 이 초대를 취소할 수 있습니다. 초대를 취소하려면 customers.userinvitations.cancel() 메서드를 호출합니다.

REST

사용자 초대를 취소하려면 고객 ID와 사용자 계정의 이메일 주소를 사용하여 customers.userinvitations.cancel()을 호출합니다.

샘플 요청

POST https://cloudidentity.googleapis.com/v1/customers/C00000000/userinvitations/writer@altostrat.com:cancel