OAuth 설정 및 사용

모든 Local Services API 호출은 OAuth 2.0을 통해 승인되어야 합니다. 이를 통해 지역 서비스 API 클라이언트 앱은 사용자의 로그인 정보를 처리하거나 저장하지 않고도 사용자의 지역 서비스 광고 계정에 액세스할 수 있습니다.

Local Services API는 OAuth 2.0 프로토콜을 사용하여 사용자를 인증합니다. OAuth 2.0에 대해 자세히 알아보려면 OAuth 2.0을 사용하여 Google API에 액세스하기를 참고하세요.

Local Services API용 Google API 콘솔 프로젝트 구성

Google Ads 사용자를 인증하고 승인하려면 Google의 OAuth 2.0 서버에 액세스할 수 있는 사용자 인증 정보가 있어야 합니다. 이 사용자 인증 정보는 Google에 애플리케이션을 식별하고 Google Ads 사용자를 관리하기 위한 OAuth 토큰을 생성할 수 있도록 합니다. Google API 콘솔을 사용하여 Google OAuth 2.0 사용자 인증 정보에 대한 액세스를 관리합니다.

이 사용자 인증 정보를 받으려면 다음 단계를 따르세요.

  1. 프로젝트를 만듭니다. 이렇게 하려면 Google API 콘솔로 이동하세요. 프로젝트 만들기를 클릭하고 이름을 입력한 다음 만들기를 클릭합니다.

  2. 프로젝트에서 Local Services API를 사용 설정합니다.

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

      Local Services API가 목록에 표시되지 않으면 검색창을 사용하여 찾습니다.

    2. Local Services API를 선택한 다음 사용 설정을 클릭합니다.

  3. 앱 유형을 선택합니다. Local Services API는 Google Ads API와 동일한 앱 유형을 사용합니다. 사용할 앱 유형에 관한 자세한 내용은 앱 유형 선택을 참고하세요.

  4. 클라이언트 ID와 클라이언트 보안 비밀번호를 만듭니다. Local Services API의 경우 Google Ads API에 사용되는 것과 동일한 단계에 따라 클라이언트 ID와 클라이언트 보안 비밀을 만듭니다. 두 사용 사례의 단계는 동일합니다.

클라이언트 라이브러리를 사용하여 OAuth 2.0 토큰 가져오기

OAuth 2.0 승인 요청을 만드는 데 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참고하세요. 라이브러리별 안내에 따라 갱신 토큰을 사용하여 새 액세스 토큰을 획득하는 방법을 알아보세요.

OAuth 2.0 갱신 토큰을 가져오는 방법

프로덕션에서 클라이언트 라이브러리를 사용하여 사용자를 인증하는 것이 좋습니다. 테스트 목적으로 HTTP 클라이언트를 사용하려면 다음 안내에 따라 OAuth 2.0 갱신 토큰과 액세스 토큰을 획득하세요. 1, 2, 3단계는 수동으로 실행해야 하는 일회성 설정 안내이며, 4, 5단계는 크론 작업과 같이 사람의 개입 없이 실행되도록 나중에 자동화할 수 있습니다.

  1. HTTP 웹 요청을 만드는 명령줄 도구인 curl을 다운로드하여 설치합니다.

  2. OAuth Playground 페이지의 안내에 따라 OAuth 2.0 갱신 토큰을 획득합니다. Local Services API에는 다음 범위를 사용하세요.

    https://www.googleapis.com/auth/adwords

    Google Ads API에서 사용하는 것과 동일한 OAuth 2.0 범위입니다.

    이 단계가 끝나면 갱신 토큰과 액세스 토큰이라는 두 개의 토큰이 제공됩니다. 둘 다 저장합니다.

  3. 명령 프롬프트에서 다음 명령어를 실행하여 이전 단계가 성공했는지 확인합니다.

    curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>

    명령어 출력에 다음과 같은 메시지가 표시되면 성공한 것입니다.

    {
  "azp": "************-********************************.apps.googleusercontent.com",
  "aud": "************-********************************.apps.googleusercontent.com",
  "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
  "exp": "1611183382",
  "expires_in": "3482",
  "access_type": "offline"
}

    오류가 있거나 범위가 올바르지 않으면 토큰을 다시 생성해 보세요.

  4. 수동 개입 없이 새 액세스 토큰을 생성합니다. 액세스 토큰은 매시간 만료되므로 이 작업이 중요합니다. 갱신 토큰은 만료되는 데 훨씬 더 오래 걸리므로 더 이상 필요하지 않은 경우 수동으로 취소해야 하는 경우가 많습니다.

    새 액세스 토큰을 가져오려면 다음 명령어를 실행합니다.

    curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”

  5. 다음 API 호출을 실행합니다.

    curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>

    이 호출이 성공하면 설정이 완료된 것입니다.