이 가이드에서는 자체 사용자 인증 정보와 데스크톱 흐름 또는 웹 흐름을 사용하여 API 액세스를 위한 OAuth 2.0을 설정하는 방법을 설명합니다. OAuth 2.0 사용자 인증 정보의 허용된 범위를 취소, 삭제 또는 변경해야 하는 경우가 아니라면 이 단계는 한 번만 수행하면 됩니다.
OAuth 2.0 사용자 인증 정보 만들기
단계에 따라 Google Ads API용 Google API 콘솔 프로젝트를 구성합니다.
클라이언트 ID와 클라이언트 보안 비밀번호를 기록한 후 이 페이지로 돌아옵니다.
클라이언트 라이브러리 설정
-
터미널에서
GenerateUserCredentials
예시를 실행합니다. 메시지가 표시되면 OAuth 2.0 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.dotnet run GenerateUserCredentials.csproj
이 코드 예에서는 브라우저에서 URL을 자동으로 엽니다. 브라우저 세션에 로그인하지 않은 경우 웹페이지에 Google 계정에 로그인하라는 메시지가 표시됩니다. 이미 로그인되어 있는 경우 로그인 메시지가 건너뛰어지고 앱이 대신 Google Ads 계정에 액세스하도록 승인해야 하는 URL로 리디렉션됩니다.
Google Ads에 액세스하는 데 사용하는 Google 계정으로 로그인합니다. 일반적으로 계정 계층 구조에서 관리해야 하는 모든 계정이 포함된 Google Ads 관리자 계정의 로그인 이메일입니다. OAuth 2.0 동의 화면에서 계속을 클릭합니다.
승인이 완료되었다는 메시지가 포함된 페이지로 이동합니다.
Your refresh token has been fetched. Check the console output for further instructions.
코드 예시를 실행 중인 콘솔로 돌아갑니다. 코드 예시가 완료되고 새로고침 토큰과 몇 가지 안내가 표시된 후 클라이언트 라이브러리를 구성하는 데 필요한 안내가 표시됩니다.
Copy the following content into your
App.config
file. <add key = 'OAuth2Mode' value = 'APPLICATION' /> <add key = 'OAuth2ClientId' value = '******' /> <add key = 'OAuth2ClientSecret' value = '******' /> <add key = 'OAuth2RefreshToken' value = '******' />App.config
파일에서LOGIN_CUSTOMER_ID
헤더도 설정해야 합니다. 자세한 내용은 구성 가이드를 참고하세요.<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
대체 구성 옵션은 구성 가이드를 참고하세요.
양방향 애플리케이션용 OAuth2 사용자 인증 정보 생성
API를 호출할 Google Ads 계정을 미리 알지 못하는 경우 세션에 로그인한 사용자의 사용자 인증 정보를 사용하여 런타임에 계정을 찾을 수 있습니다. 현재 로그인한 사용자가 인증되고 런타임에 OAuth2 사용자 인증 정보가 가져온 예는 AuthenticateInAspNetCoreApplication
를 참고하세요.