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 플레이그라운드 페이지의 안내에 따라 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>

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