이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Ads API용 Google API 콘솔 프로젝트 구성

Google Ads 사용자를 인증하고 승인하려면 Google의 OAuth2 서버에 액세스하기 위한 사용자 인증 정보가 필요합니다. 이러한 사용자 인증 정보로 Google에서 앱을 식별하여 Google Ads 사용자 관리를 위한 OAuth 토큰을 생성할 수 있습니다. Google OAuth2 사용자 인증 정보에 대한 액세스는 Google API 콘솔에서 관리합니다.

이 동영상에서 Cloud 프로젝트 권장사항을 확인하세요.

Google OAuth 인증

Google Ads API 범위의 사용자 인증 정보를 얻는 데 사용되는 모든 Google Cloud 앱은 Google OAuth 인증을 거쳐야 사용자가 확인되지 않은 UI 화면을 방지할 수 있습니다. 이 맥락에서 앱은 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 Cloud 조직과 연결된 프로젝트에서만 사용할 수 있습니다. OAuth 동의 화면에 표시된 테스트 사용자는 최대 100명으로 제한됩니다. 테스트 사용자는 프로젝트와 연결된 Google Cloud 조직의 내부 사용자여야 합니다. 승인은 동의 시점으로부터 7일 후에 만료됩니다.
외부 도메인	테스트	모든 프로젝트에 사용할 수 있습니다. OAuth 동의 화면에 표시된 테스트 사용자는 최대 100명으로 제한됩니다. 테스트 사용자는 Google 계정이 있는 모든 사용자일 수 있습니다. 승인은 동의 시점으로부터 7일 후에 만료됩니다.
내부	프로덕션 단계	Google Cloud 조직과 연결된 프로젝트에서만 사용할 수 있습니다. 프로젝트와 연결된 Google Cloud 조직 내 모든 사용자를 승인할 수 있습니다.
외부 도메인	프로덕션 단계	모든 프로젝트에 사용할 수 있습니다. Google 계정이 있는 모든 사용자를 승인할 수 있습니다.

Google OAuth 인증을 완료하지 않으면 프로젝트의 사용자 유형 또는 게시 상태와 관계없이 다음과 같은 결과가 발생합니다.

승인 프로세스 중에 사용자에게 확인되지 않은 UI 화면이 표시됩니다.
사용자 100명만 승인할 수 있습니다.

OAuth 동의 화면 구성

동의 화면 페이지를 열고 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
사용자 유형을 선택하고 만들기를 클릭합니다.
동의 화면 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장 및 계속을 클릭합니다.
다음 페이지에서 범위 추가 또는 삭제를 클릭합니다.
- 아래로 스크롤하여 수동으로 범위 추가 아래의 필드에 다음을 입력합니다.
```
https://www.googleapis.com/auth/adwords
```
- 표에 추가를 클릭합니다.
- 프로젝트에서 요청할 모든 범위를 추가한 후 업데이트를 클릭합니다.
- 저장하고 계속하기를 클릭합니다.
프로젝트를 즉시 게시할 계획이 없다면 테스트에 사용할 각 사용자 계정의 이메일 주소를 추가한 후 저장하고 계속하기를 클릭합니다.
요약 페이지를 검토하고 대시보드로 돌아가기를 클릭합니다.

애플리케이션 및 승인 프로세스를 테스트한 후 대시보드로 돌아와 앱 게시를 클릭하면 게시 상태가 테스트에서 프로덕션 단계로 변경될 수 있습니다.

앱 유형 선택

Google Ads API에는 데스크톱 또는 웹이라는 두 가지 앱 유형 옵션이 있습니다. 다음 표를 참고하여 빌드하려는 앱에 가장 적합한 유형을 확인합니다.

이 앱 유형 선택	판단 기준
데스크톱 앱	단일 최상위 관리자 계정을 사용하여 모든 Google Ads 계정을 관리합니다. 처음 사용하는 경우 또는 간단한 설정으로 빠르게 시작하려는 경우 앱은 한 머신에서만 Google 사용자를 인증합니다.
웹 앱	앱에 Google Ads 계정 데이터에 대한 액세스 권한을 부여할 수 있는 사용자로 인증하려고 합니다. 예를 들어 서드 파티 계정을 관리하기 위해 여러 개의 승인 사용자 인증 정보를 쉽게 생성할 수 있습니다. 앱에 콜백 URL이 필요합니다. 콜백 URL은 데스크톱 앱 흐름에서 지원되지 않습니다.

자세한 내용은 데스크톱 앱 또는 웹 앱에 대한 Google Identity Platform OAuth 문서를 참조하세요.

클라이언트 ID 및 클라이언트 비밀번호 만들기

앱 유형을 확인한 후 아래 안내에 따라 OAuth2 클라이언트 ID와 클라이언트 보안 비밀번호를 생성합니다.

사용자 인증 정보 페이지를 엽니다. 이전에 만든 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
사용자 인증 정보 화면에서 사용자 인증 정보 만들기를 클릭한 후 OAuth 클라이언트 ID를 선택합니다.
1. 이전에 이 프로젝트에 OAuth 동의 화면을 구성하지 않았으면 지금 구성하라는 메시지가 표시됩니다. 동의 화면 구성을 클릭합니다.
  1. 사용자 유형을 선택하고 만들기를 클릭합니다.
  2. 초기 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장을 클릭합니다.
2. 사용자 인증 정보 > 사용자 인증 정보 만들기 > OAuth 클라이언트 ID로 돌아가서 계속하세요.
사용 사례에 따라 앱 유형으로 데스크톱 앱 또는 웹 애플리케이션을 선택합니다.
이름을 지정한 후 만들기를 클릭합니다.
클라이언트 유형이 웹 애플리케이션이면 승인된 리디렉션 URI를 하나 이상 추가합니다.

클라이언트 라이브러리 예시의 기본 구성과 호환되는 로컬 테스트에는 http://127.0.0.1를 사용합니다.

참고: 포트 번호를 리디렉션 URI에 추가하여 사용량을 특정 포트로 제한할 수 있습니다. 포트가 설정되지 않은 경우 OAuth 클라이언트가 모든 포트로 리디렉션될 수 있습니다.

데스크톱 앱 클라이언트의 경우 루프백 IP 리디렉션이 계속 사용되지만 Cloud Console에서 URI가 명시적으로 구성되지 않습니다.
확인 페이지에서 클라이언트 ID와 클라이언트 보안 비밀번호를 클립보드에 복사합니다. 클라이언트 라이브러리를 구성할 때 필요합니다. 나중에 사용자 인증 정보 페이지로 돌아와서 세부정보를 검색할 수도 있습니다.

개요

클라이언트 라이브러리