사용자 초대 만들기 및 관리

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

시작하기 전에

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

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

초대 자격 결정

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

REST

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

샘플 요청

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

사용자 초대 검색

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

단일 사용자 초대 검색

REST

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

샘플 요청

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

사용자 초대 목록 검색

관리자 또는 최종 사용자가 작업을 수행할 때까지 모든 비관리 사용자가 NOT_YET_SENT 상태에 초대로 자동 표시됩니다. 사용자가 초대를 수락하면 계정이 더 이상 관리되지 않는 것으로 간주되지 않습니다.

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

REST

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

샘플 요청

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

사용자 초대 보내기

사용자 초대장은 요건을 충족하는 사용자에게 자동으로 전송되지 않습니다. 초대할 사용자 목록이 있는 경우 customers.userinvitations.send() 메서드를 사용할 수 있습니다. 또한 존재하지 않는 경우에도 초대장도 생성됩니다.

REST

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

샘플 요청

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

사용자 초대 취소

사용자 초대는 수락되거나 거부될 때까지 취소할 수 있습니다. customers.userInvites.cancel() 메서드를 호출하여 초대를 취소합니다.

REST

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

샘플 요청

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