OAuth 2.0 사용자 인증 정보를 만들고, 사용자 동의 화면을 구성하고, 앱에 Google Ads API를 사용 설정하려면 Google API 콘솔 프로젝트가 필요합니다.
사용자 인증 정보는 Google 서버에서 Google Ads 사용자를 인증 및 승인하는 데 필요합니다. 이러한 사용자 인증 정보를 통해 API 호출에 사용할 OAuth 토큰을 생성할 수 있습니다.
Google API 콘솔 프로젝트 선택 또는 만들기
이미 Google API 콘솔 프로젝트가 있고 이를 사용하여 사용자 인증 정보를 만들려면 클라이언트 ID 및 클라이언트 보안 비밀번호 만들기로 건너뛰면 됩니다.
프로젝트를 만들려면 다음 안내를 따르세요.
- Google API 콘솔로 이동합니다.
- 프로젝트 만들기를 클릭합니다.
- 이름을 입력하거나 생성된 추천을 수락하세요.
- 나머지 필드 확인 또는 수정
- 만들기를 클릭합니다.
결제를 사용 설정한 경우 새 프로젝트의 결제 계정을 선택합니다. Google Ads API는 무료로 사용할 수 있지만 Cloud 프로젝트의 총 수에 할당량이 적용됩니다.
OAuth 동의 화면 구성
기존 Google API 콘솔 프로젝트를 사용 중이고 이전에 OAuth 동의 화면을 구성한 경우 이 단계를 건너뛰고 대신 Google Ads API OAuth 2.0 범위를 추가하여 동의 화면을 수정할 수 있습니다.
승인에 OAuth 2.0을 사용하면 Google에서 사용자에게 프로젝트 요약, 정책, 요청된 액세스 승인 범위가 포함된 동의 화면을 표시합니다. 앱의 OAuth 동의 화면을 구성하면 사용자와 앱 검토자에게 표시되는 내용이 정의되고 나중에 게시할 수 있도록 앱이 등록됩니다.
새 OAuth 동의 화면 구성
- 동의 화면 페이지를 열고 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
- 사용자 유형을 선택하고 만들기를 클릭합니다.
- 동의 화면 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장하고 계속하기를 클릭합니다.
- 다음 페이지에서 범위 추가 또는 삭제를 클릭합니다.
- 아래로 스크롤하여 수동으로 범위 추가 아래의 필드에 다음을 입력합니다.
https://www.googleapis.com/auth/adwords
- 테이블에 추가를 클릭합니다.
- 프로젝트에 필요할 수 있는 다른 범위를 추가한 후 업데이트를 클릭합니다.
- 저장 후 계속을 클릭합니다.
- 프로젝트를 즉시 게시하지 않으려면 테스트에 사용할 각 사용자 계정의 이메일 주소를 추가한 다음 저장 및 계속을 클릭합니다.
- 요약 페이지를 검토하고 대시보드로 돌아가기를 클릭합니다.
기존 OAuth 동의 화면 구성
- 동의 화면 페이지를 열고 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
- 앱 수정을 클릭합니다.
- OAuth 동의 화면 양식에서 저장하고 계속하기를 클릭합니다.
- 다음 페이지에서 범위 추가 또는 삭제를 클릭합니다.
- 아래로 스크롤하여 수동으로 범위 추가 아래의 필드에 다음을 입력합니다.
https://www.googleapis.com/auth/adwords
- 테이블에 추가를 클릭합니다.
- 저장 후 계속을 클릭합니다.
- 테스트 사용자 양식에서 저장하고 계속하기를 클릭합니다.
- 요약 페이지를 검토하고 대시보드로 돌아가기를 클릭합니다.
클라이언트 ID 및 클라이언트 비밀번호 만들기
이미 생성된 클라이언트 ID와 보안 비밀이 있는 기존 Google API 콘솔 프로젝트를 사용하는 경우 이 단계를 건너뛰어도 됩니다.
앱 유형을 확인한 후 아래 안내에 따라 OAuth 2.0 클라이언트 ID와 클라이언트 비밀번호를 생성합니다.
사용자 인증 정보 페이지를 엽니다. 이전에 만든 프로젝트를 선택하거나 새로 만듭니다.
사용자 인증 정보 화면에서 사용자 인증 정보 만들기를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.
이전에 이 프로젝트의 OAuth 동의 화면을 구성하지 않았으면 동의 화면 구성을 클릭합니다.
사용자 유형을 선택하고 만들기를 클릭합니다.
최초 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료하면 저장을 클릭합니다.
사용자 인증 정보 > 사용자 인증 정보 만들기 > OAuth 클라이언트 ID로 돌아가서 계속 진행합니다.
사용 사례에 따라 데스크톱 앱 또는 웹 애플리케이션을 앱 유형으로 선택합니다. 이 가이드에서는 앱 유형으로 데스크톱 앱을 사용합니다.
앱 이름을 입력한 다음 만들기를 클릭합니다.
확인 페이지에서 나중에 클라이언트 라이브러리를 구성할 수 있도록 클라이언트 ID와 클라이언트 보안 비밀번호를 클립보드에 복사합니다. 또한 사용자 인증 정보를 JSON 형식의
credentials.json
파일에 다운로드합니다.
프로젝트에서 Google Ads API 사용 설정
프로젝트에서 Google Ads API를 사용 설정하려면 다음 단계를 따르세요.
Google API 콘솔에서 API 라이브러리를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새 프로젝트를 만듭니다. API 라이브러리에는 사용 가능한 모든 API가 제품군 및 인기도별로 분류되어 있습니다.
목록에 Google Ads API가 표시되지 않으면 검색을 사용하여 Google Ads API를 찾습니다.
Google Ads API를 선택하고 사용 설정 버튼을 클릭합니다.