Google Ads 사용자를 인증하고 승인하려면 Google의 OAuth2 서버에 액세스하기 위한 사용자 인증 정보가 필요합니다. 이 사용자 인증 정보는 Google에 앱을 식별하여 Google Ads 사용자를 관리하기 위한 OAuth 토큰을 생성할 수 있도록 합니다. Google OAuth2 사용자 인증 정보에 대한 액세스는 Google API 콘솔에서 관리됩니다.
Google OAuth 인증
Google Ads API 범위의 사용자 인증 정보를 얻는 데 사용되는 모든 Google Cloud 앱은 사용자에게 확인되지 않은 UI 화면이 표시되지 않도록 Google OAuth 인증을 거쳐야 합니다. 이 맥락에서 앱은 Google Cloud의 고유한 OAuth 2.0 클라이언트 ID로 정의됩니다.
이 인증은 개발자 토큰 승인 절차의 일부로 진행되는 검토와 별개로 진행되며, Google Ads API 범위가 민감한 범위이므로 필요합니다.
Google 인증은 무료이며 일반적으로 영업일 기준 3~5일 이내에 완료됩니다. 이 정책은 모든 앱에 적용됩니다.
비즈니스 중단을 방지하려면 모든 앱이 최대한 빨리 Google OAuth 인증 절차를 거치는 것이 좋습니다.
프로젝트 만들기
Google API 콘솔로 이동합니다. 프로젝트 만들기를 클릭하고 이름을 입력한 다음 만들기를 클릭합니다.
프로젝트에서 Google Ads API 사용 설정
프로젝트에 Google Ads API를 사용 설정하려면 다음 단계를 따르세요.
Google API 콘솔에서 API 라이브러리를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새 프로젝트를 만듭니다. API 라이브러리에는 사용 가능한 모든 API가 제품군 및 인기도별로 분류되어 있습니다.
목록에 Google Ads API가 표시되지 않으면 검색을 사용하여 찾습니다.
Google Ads API를 선택한 다음 사용 설정 버튼을 클릭합니다.
사용자 유형 및 게시 상태 선택
API를 사용 설정한 후에는 프로젝트의 사용자 유형 및 게시 상태를 지정해야 합니다. 다음 표에는 이러한 설정의 각 조합에 관한 몇 가지 주요 속성과 제한사항이 요약되어 있습니다. 자세한 내용은 Google Cloud Platform 문서를 참고하세요.
| 사용자 유형 | 게시 상태 | 제한사항 |
|---|---|---|
| 내부 | 테스트 |
|
| 외부 | 테스트 |
|
| 내부 | 프로덕션 단계 |
|
| 외부 | 프로덕션 단계 |
|
Google OAuth 인증을 완료하지 않으면 프로젝트의 사용자 유형 또는 게시 상태와 관계없이 다음과 같은 결과가 발생합니다.
승인 프로세스 중에 사용자에게 확인되지 않은 UI 화면이 표시됩니다.
사용자는 100명으로 제한됩니다.
OAuth 동의 화면 구성
동의 화면 페이지를 열고 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
사용자 유형을 선택하고 만들기를 클릭합니다.
동의 화면 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장 후 계속을 클릭합니다.
다음 페이지에서 범위 추가 또는 삭제를 클릭합니다.
아래로 스크롤하여 수동으로 범위 추가 아래의 필드에 다음을 입력합니다.
https://www.googleapis.com/auth/adwords테이블에 추가를 클릭합니다.
프로젝트에서 요청할 다른 범위를 추가한 다음 업데이트를 클릭합니다.
저장 후 계속을 클릭합니다.
프로젝트를 즉시 게시할 계획이 아니라면 테스트에 사용할 각 사용자 계정의 이메일 주소를 추가한 다음 저장 및 계속을 클릭합니다.
요약 페이지를 검토하고 대시보드로 돌아가기를 클릭합니다.
애플리케이션과 승인 프로세스를 테스트한 후 대시보드로 돌아가 앱 게시를 클릭하여 게시 상태를 테스트에서 프로덕션으로 변경할 수 있습니다.
앱 유형 선택
Google Ads API에는 데스크톱 또는 웹이라는 두 가지 앱 유형 옵션이 있습니다. 다음 표를 참고하여 빌드하려는 앱에 가장 적합한 유형을 결정하세요.
| 이 앱 유형 선택 | 판단 기준 |
|---|---|
| 데스크톱 앱 |
|
| 웹 앱 |
|
자세한 내용은 데스크톱 앱 또는 웹 앱용 Google Identity Platform OAuth 문서를 참고하세요.
클라이언트 ID 및 클라이언트 비밀번호 만들기
앱 유형을 결정한 후 아래 안내에 따라 OAuth2 클라이언트 ID 및 클라이언트 보안 비밀을 생성합니다.
사용자 인증 정보 페이지를 엽니다. 이전에 만든 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
사용자 인증 정보 화면에서 사용자 인증 정보 만들기를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.
이전에 이 프로젝트에 대해 OAuth 동의 화면을 구성하지 않은 경우 지금 구성하라는 메시지가 표시됩니다. 동의 화면 구성을 클릭합니다.
사용자 유형을 선택하고 만들기를 클릭합니다.
초기 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장을 클릭합니다.
계속하려면 사용자 인증 정보 > 사용자 인증 정보 만들기 > OAuth 클라이언트 ID로 돌아갑니다.
사용 사례에 따라 앱 유형으로 데스크톱 앱 또는 웹 애플리케이션을 선택합니다.
이름을 지정한 다음 만들기를 클릭합니다.
클라이언트 유형이 웹 애플리케이션인 경우 승인된 리디렉션 URI를 하나 이상 추가합니다.
클라이언트 라이브러리 예시의 기본 구성과 호환되는 로컬 테스트의 경우
http://127.0.0.1를 사용하세요.데스크톱 앱 클라이언트의 경우에도 루프백 IP 리디렉션을 사용하지만 URI는 Cloud 콘솔에서 명시적으로 구성되지 않습니다.
확인 페이지에서 클라이언트 ID 및 클라이언트 보안 비밀번호를 클립보드에 복사합니다. 클라이언트 라이브러리를 구성할 때 필요합니다. 나중에 사용자 인증 정보 페이지로 돌아가 이러한 세부정보를 검색할 수도 있습니다.
