2단계 인증
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Ads 승인은 Google Ads 계정에서 2단계 인증을 사용 설정하는 것을 지원합니다. 다음 표에는 2단계 인증을 사용 설정하는 세 가지 시나리오가 나와 있습니다.
사용자가 자신의 Google 계정에서 2단계 인증을 사용 설정함
|
사용자가 Google 계정에 2단계 인증을 사용 설정할 수 있습니다.
2단계 인증이 사용 설정된 후
OAuth2 인증 흐름 중에 Google은 갱신 토큰을 발급하기 전에 사용자에게 2단계 인증을 요청합니다.
발급된 갱신 토큰은 API 호출에 필요한 액세스 토큰을 생성하는 데 사용할 수 있습니다.
이전 갱신 토큰
사용자가 2단계 인증을 사용 설정하기 전에 발급된 새로고침 토큰은 사용자가 2단계 인증을 사용 설정한 후에도 유효합니다. 갱신 토큰은 평소와 같이 유효한 액세스 토큰을 발급하는 데 사용할 수 있습니다.
|
관리자가 Google Ads 계정 사용자에게 Google 계정에서 2단계 인증을 사용 설정하도록 요구
|
계정 관리자는 Google Ads 계정의 모든 사용자에게 Google 계정에서 2단계 인증을 사용 설정하도록 요구할 수 있습니다.
사용자가 2단계 인증을 사용 설정함
OAuth2 인증 흐름 중에 Google은 갱신 토큰을 발급하기 전에 사용자에게 2단계 인증을 요청합니다.
발급된 갱신 토큰은 API 호출에 필요한 액세스 토큰을 생성하는 데 사용할 수 있습니다.
사용자가 2단계 인증을 사용 설정하지 않음
인증 흐름 중에 사용자에게 2단계 인증 메시지가 표시되지 않습니다. 이 환경은 Google Ads 계정의 설정과 무관합니다.
발급된 갱신 토큰은 액세스 토큰을 발급하는 데 사용할 수 있습니다. 하지만 사용자가 Google 계정에서 2단계 인증을 사용 설정할 때까지 이 액세스 토큰을 사용하여 이루어진 API 호출은
TWO_STEP_VERIFICATION_NOT_ENROLLED 오류와 함께 실패합니다.
이전 갱신 토큰
이 규칙은 2단계 인증 요구사항 이전에 발급된 새로고침 토큰에도 적용됩니다. 새로고침 토큰을 사용하여 액세스 토큰을 생성할 수 있지만, 사용자가 Google 계정에서 2단계 인증을 사용 설정할 때까지 이러한 액세스 토큰으로 이루어진 API 호출은
TWO_STEP_VERIFICATION_NOT_ENROLLED 오류와 함께 실패합니다.
|
Google에서는 Google Ads 계정의 모든 사용자가 Google 계정에서 2단계 인증을 선택하도록 요구합니다. {:#require-2-step}
|
경우에 따라 Google에서 Google Ads 계정의 모든 사용자에게 Google 계정에서 2단계 인증을 사용 설정하도록 요구할 수 있습니다.
2단계 인증이 사용 설정된 후
OAuth2 인증 흐름 중에 Google은 갱신 토큰을 발급하기 전에 사용자에게 2단계 인증을 요청합니다.
이 환경은 Google에서 모든 사용자가 2단계 인증을 사용 설정하도록 요구하는 Google Ads 계정을 선택했는지 여부와 관계없이 적용됩니다.
발급된 갱신 토큰은 API 호출에 필요한 액세스 토큰을 평소와 같이 생성하는 데 사용할 수 있습니다.
이전 갱신 토큰
사용자가 2단계 인증을 사용 설정하기 전에 발급된 새로고침 토큰은 사용자가 2단계 인증을 사용 설정한 후에도 유효합니다. 갱신 토큰은 평소와 같이 유효한 액세스 토큰을 발급하는 데 사용할 수 있습니다.
이 액세스 토큰을 사용하여 이루어진 API 호출은 TWO_STEP_VERIFICATION_NOT_ENROLLED 오류가 발생하지 않습니다. 2단계 인증 선택은 Google Ads 계정 관리자가 아닌 Google에서 시작했기 때문입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\u003cp\u003eGoogle Ads authorization supports enabling 2-Step Verification for enhanced security, impacting how refresh and access tokens function.\u003c/p\u003e\n"],["\u003cp\u003eUsers voluntarily enabling 2-Step Verification or being required to by administrators or Google will encounter a 2-Step Verification prompt during authentication.\u003c/p\u003e\n"],["\u003cp\u003eIf an administrator requires 2-Step Verification, API calls will fail with an error until it's enabled, even with existing refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eRefresh tokens issued before enabling 2-Step Verification generally remain valid but may be subject to the specific scenario and enforcement level.\u003c/p\u003e\n"],["\u003cp\u003eGoogle enforcing 2-Step Verification differs from administrator enforcement, as API calls with existing refresh tokens won't encounter the \u003ccode\u003eTWO_STEP_VERIFICATION_NOT_ENROLLED\u003c/code\u003e error.\u003c/p\u003e\n"]]],[],null,["# 2-Step Verification\n\nGoogle Ads authorization supports enabling [2-Step Verification on your Google Ads\naccount](//support.google.com/google-ads/answer/12864186). The following table\npresents the three scenarios for enabling 2-Step Verification.\n\n|-----------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### User turns on 2-Step Verification on their own Google Account | *A user might decide on their own to turn on 2-Step Verification for their Google Account.* #### After 2-Step Verification is enabled During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. Once issued, the refresh token can be used to generate the access token needed in API calls. #### Previous refresh tokens A refresh token that was issued before the user enabled 2-Step Verification remains valid after the user enables 2-Step Verification. The refresh token can be used to issue valid access tokens as usual. |\n| ### Administrator requires users of a Google Ads account to enable 2-Step Verification on their Google Account | *An account administrator can require all users of a Google Ads account to [enable 2-Step Verification](https://support.google.com/google-ads/answer/12865295) on their Google Account.* #### User enables 2-Step Verification During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. Once issued, the refresh token can be used to generate the access token needed in API calls. #### User doesn't enable 2-Step Verification During the authentication flow, the user won't see the 2-Step Verification prompt. This experience is independent of any settings on the Google Ads account. Once issued, the refresh token can be used to issue access tokens. However, the API calls made using this access token will fail with a [`TWO_STEP_VERIFICATION_NOT_ENROLLED`](/google-ads/api/reference/rpc/v21/AuthenticationErrorEnum.AuthenticationError#two_step_verification_not_enrolled) error until the user enables 2-Step Verification in their Google Account. ##### Previous refresh tokens This rule applies to refresh tokens issued prior to the 2-Step Verification requirement as well---the refresh token can be used to generate access tokens, but API calls made with these access tokens will fail with a [`TWO_STEP_VERIFICATION_NOT_ENROLLED`](/google-ads/api/reference/rpc/v21/AuthenticationErrorEnum.AuthenticationError#two_step_verification_not_enrolled) error until the user enables 2-Step Verification in their Google Account. |\n| ### Google requires all users of a Google Ads account to opt in to 2-step verification on their Google Account {:#require-2-step} | *In some cases, Google might require all users of a Google Ads account to enable 2-step verification on their Google Account.* #### After 2-Step Verification is enabled During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. This experience is independent of whether Google opted in the Google Ads account to require all its users to enable 2-factor verification. Once issued, the refresh token can be used to generate the access token needed in API calls as usual. #### Previous refresh tokens A refresh token that was issued before the user enabled 2-Step Verification remains valid after the user enables 2-Step Verification. The refresh token can be used to issue a valid access token as usual. API calls made using this access token won't encounter the `TWO_STEP_VERIFICATION_NOT_ENROLLED` error because the 2-Step Verification opt-in was initiated by Google and not by the Google Ads account administrator. |"]]
