프롬프트 UI 상태에 관한 알림 수신

사용자가 쉽게 로그인하거나 가입할 수 있도록 여러 ID 제공업체와 통신하여 사용 가능한 사용자 인증 정보를 찾을 수 있습니다. 다음 ID 공급자를 호출할 수 있도록 프롬프트 UI 상태를 알아야 할 수 있습니다.

여러 시점에서 프롬프트 UI 상태에 관한 알림을 받으려면 콜백 함수 이름을 data-moment_callback 속성에 설정하거나 JavaScript API를 사용하는 경우 함수를 prompt() 메서드에 설정합니다.

다음과 같은 경우에 알림이 전송됩니다.

  • 표시 순간: prompt() 메서드가 호출된 후에 발생합니다. 알림에는 UI가 표시되는지 여부를 나타내는 불리언 값이 포함됩니다.

  • 건너뛴 순간: 자동 취소, 수동 취소로 원탭 메시지가 닫히거나 Google에서 인증 정보를 발급하지 못할 때(예: 선택한 세션에서 Google에 로그아웃한 경우) 발생합니다.

    이 경우 다음 ID 제공업체(있는 경우)로 계속 진행하는 것이 좋습니다.

  • 닫힘 순간: Google에서 사용자 인증 정보를 가져오거나 사용자가 사용자 인증 정보 가져오기 흐름을 중지하려고 할 때 발생합니다. 예를 들어 사용자가 로그인 대화상자에 사용자 이름과 비밀번호를 입력하기 시작하면 google.accounts.id.cancel() 메서드를 호출하여 원탭 메시지를 닫고 닫힌 순간을 트리거할 수 있습니다.

다음 코드 예에서는 건너뛴 순간을 구현합니다.

<script>
  function continueWithNextIdp(notification) {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
          // try Next provider if One Tap is not displayed or skipped
      }
  }
</script>
...
<div id="g_id_onload"
     data-client_id="YOUR_GOOGLE_CLIENT_ID"
     data-login_uri="https://your.domain/your_login_endpoint"
     data-moment_callback="continueWithNextIdp"
</div>