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를 사용 설정하려면 다음 단계를 따르세요.

  1. Google API 콘솔에서 API 라이브러리를 엽니다. 메시지가 표시되면 프로젝트를 선택하거나 새 프로젝트를 만듭니다. API 라이브러리에는 사용 가능한 모든 API가 제품군 및 인기도별로 분류되어 있습니다.

  2. 목록에 Google Ads API가 표시되지 않으면 검색을 사용하여 Google Ads API를 찾습니다.

  3. 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명으로 제한됩니다.

  1. 동의 화면 페이지를 열고 페이지 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.

  2. 사용자 유형을 선택하고 만들기를 클릭합니다.

  3. 동의 화면 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료되면 저장하고 계속하기를 클릭합니다.

  4. 다음 페이지에서 범위 추가 또는 삭제를 클릭합니다.

    • 아래로 스크롤하여 수동으로 범위 추가 아래의 필드에 다음을 입력합니다.

      https://www.googleapis.com/auth/adwords
      
    • 테이블에 추가를 클릭합니다.

    • 프로젝트에서 요청할 다른 범위를 추가한 후 업데이트를 클릭합니다.

    • 저장 후 계속을 클릭합니다.

  5. 프로젝트를 즉시 게시하지 않으려면 테스트에 사용할 각 사용자 계정의 이메일 주소를 추가한 다음 저장 및 계속을 클릭합니다.

  6. 요약 페이지를 검토하고 대시보드로 돌아가기를 클릭합니다.

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

앱 유형 선택

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

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

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

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

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

  1. 사용자 인증 정보 페이지를 엽니다. 이전에 만든 프로젝트를 선택하거나 새로 만듭니다.

  2. 사용자 인증 정보 화면에서 사용자 인증 정보 만들기를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.

    1. 이전에 이 프로젝트에 OAuth 동의 화면을 구성하지 않은 경우 지금 구성하도록 안내됩니다. 동의 화면 구성을 클릭합니다.

      1. 사용자 유형을 선택하고 만들기를 클릭합니다.

      2. 최초 양식을 작성합니다. 필요한 경우 나중에 수정할 수 있습니다. 완료하면 저장을 클릭합니다.

    2. 사용자 인증 정보 > 사용자 인증 정보 만들기 > OAuth 클라이언트 ID로 돌아가서 계속 진행합니다.

  3. 사용 사례에 따라 데스크톱 앱 또는 웹 애플리케이션을 앱 유형으로 선택합니다.

  4. 이름을 지정한 다음 만들기를 클릭합니다.

  5. 클라이언트 유형이 웹 애플리케이션이면 승인된 리디렉션 URI를 하나 이상 추가합니다.

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

    데스크톱 앱 클라이언트의 경우 루프백 IP 리디렉션이 계속 사용되지만 Cloud Console에서 URI가 명시적으로 구성되지는 않습니다.

  6. 확인 페이지에서 클라이언트 라이브러리를 구성할 때 필요하므로 클라이언트 ID클라이언트 보안 비밀번호를 클립보드에 복사합니다. 나중에 사용자 인증 정보 페이지로 돌아가서 세부정보를 검색할 수도 있습니다.