Google에서는 계정 연결 과정에서 OAuth2 엔드포인트를 호출합니다. 이러한 호출은 다른 이유로 실패할 수 있습니다. 이러한 오류에 대한 자세한 정보가 로깅되며 Cloud Console 프로젝트의 로그 탐색기 페이지에서 모니터링할 수 있습니다.
계정 연결 오류 필터링
로그 탐색기 페이지에서 쿼리 필터를 다음과 같이 설정하고 쿼리 실행 버튼을 클릭합니다.
- 리소스: Actions on Google 콘솔을 통해 프로젝트를 만든 경우 Google 어시스턴트 작업 프로젝트를 선택하고, 그 외의 경우 Google 프로젝트 옵션을 선택합니다.
- 로그 이름: Google 계정 연결 오류 옵션을 선택합니다.
- 심각도: 오류로 설정합니다. 모든 계정 연결 항목은 오류로 분류됩니다.
다음 스크린샷과 같이 로그 탐색기 페이지 상단에서 기간을 업데이트하여 날짜별로 필터링할 수도 있습니다.
그림 1. 로그 탐색기 쿼리 필터
로그 탐색기 사용 방법에 관한 자세한 내용은 로그 탐색기 문서를 참고하세요.
오류 데이터의 콘텐츠
계정 연결 오류 데이터는 오류 항목의 jsonPayload 속성에 포함됩니다. 데이터에는 다음 필드가 포함됩니다.
@type(String): 항상type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError로 설정됩니다.step(String): 오류가 발생한 연결 단계입니다. 다음 값 중 하나로 설정합니다.ACCOUNT_LINKING_STEP_UNDEFINED: 정의되지 않은 단계입니다.AUTH_CODE_EXCHANGE: 인증 코드를 액세스 또는 갱신 토큰으로 교환하는 단계입니다.REFRESH_ACCESS_TOKEN: 액세스 토큰을 갱신하는 단계입니다.TOKEN_REVOCATION: 토큰을 취소하는 단계입니다.USERINFO: 액세스 토큰으로 사용자 정보를 가져오는 단계입니다.ASSERTION: 어설션으로 링크를 만드는 단계입니다.
response(String, optional): HTTP 응답을 나타냅니다.status: HTTP 응답의 상태입니다.body: 오류 설명 및 오류 문자열입니다.
request(String, optional): HTTP 요청을 나타내며 메서드, 본문, URI, 헤더와 같은 HTTP 요청 매개변수를 포함합니다.
request 및 response 필드는 로그 뷰어에서 두 가지 항목으로 구분되므로 선택사항입니다.
Google 계정 연결 OAuth 서버 및 효율적인 Google 계정 연결 OAuth 서버를 구현할 때는 서로 다른 상태에 특정 HTTP 응답 코드를 사용해야 합니다. 반환되는 값은 문서에 나열된 올바른 상태와 일치해야 합니다.