이 페이지는 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 앱은 사용자에게 확인되지 않은 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를 찾습니다.
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 리디렉션을 계속 사용하지만 URI가 Cloud 콘솔에서 명시적으로 구성되지는 않습니다.
클라이언트 라이브러리를 구성할 때 필요하므로 확인 페이지에서 클라이언트 ID와 클라이언트 보안 비밀번호를 클립보드에 복사합니다. 나중에 사용자 인증 정보 페이지로 돌아가서 이러한 세부정보를 검색할 수도 있습니다.

개요

클라이언트 라이브러리