사용자 액세스 관리

관리자는 Google Ads 계정의 사용자 액세스 수준과 역할을 관리할 수 있습니다. Google Ads API를 사용하여 사용자 역할을 검색 및 업데이트하고, 사용자 초대를 보내고, 계정에 대한 사용자 액세스를 종료할 수 있습니다. 계정 액세스 수준에 대해 자세히 알아보기

사용자 액세스를 관리하려면 호출하는 사용자 또는 서비스 계정에 타겟 계정에 대한 ADMIN 액세스 권한이 있어야 합니다.

사용자 초대

계정에 액세스할 수 있는 신규 사용자를 초대하려면 CustomerUserAccessInvitationService를 사용하여 초대를 만들고 전송합니다 (사용자 액세스 초대 관리 참고). 사용자가 초대를 수락하면 CustomerUserAccess에 확인된 사용자로 표시됩니다.

사용자 역할 가져오기

고객 ID와 연결된 모든 CustomerUserAccess 항목을 쿼리하는 Google Ads 쿼리 언어 문을 작성하여 계정에 액세스할 수 있는 사용자 목록을 가져올 수 있습니다. 일반적인 쿼리는 다음과 같습니다.

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

사용자 역할 수정

기존 사용자 역할을 업데이트하려면 UPDATE 작업을 사용하여 CustomerUserAccessService.MutateCustomerUserAccess를 호출합니다. 사용자 역할을 수정할 때는 다음을 제공해야 합니다.

• 수정할 CustomerUserAccess 항목의 리소스 이름입니다(customers/{customer_id}/customerUserAccesses/{user_id} 형식).
• access_role의 신규 사용자 역할입니다.
• access_role를 지정하는 update_mask (FieldMask)

사용자 삭제

사용자의 계정 액세스 권한을 종료하려면 리소스 이름(customers/{customer_id}/customerUserAccesses/{user_id})을 지정하는 REMOVE 작업과 함께 CustomerUserAccessService.MutateCustomerUserAccess를 호출합니다.

액세스 변경에 대한 복수 사용자 승인 체계

MutateCustomerUserAccess 호출 시 다자간 승인 요청이 트리거되는 경우:

• MutateCustomerUserAccessResult 객체(MutateCustomerUserAccessResponse의 result 필드 내에 포함됨)는 승인이 필요한 검토 대기 중인 리소스 이름으로 multi_party_auth_review 필드를 채웁니다.
• MutateCustomerUserAccessResult의 resource_name 필드는 채워지지 않습니다.
• 대기 중인 검토 요청은 두 번째 관리자가 MultiPartyAuthReviewService.ResolveMultiPartyAuthReview 메서드를 사용하여 승인하거나 거부할 수 있습니다. 자세한 내용은 복수 사용자 승인 체계 가이드를 참고하세요.