빠른 시작

이 가이드에서는 클라이언트 라이브러리를 사용하여 Google Ads 캠페인을 검색합니다.

API 액세스를 사용 설정하려면 먼저 필요한 OAuth2 사용자 인증 정보를 가져옵니다.

그런 다음 구성 파일에 승인 및 계정 세부정보를 추가합니다. 구성 파일이 설정되면 API를 호출할 준비가 된 것입니다.

클라이언트 라이브러리의 구성 매개변수

클라이언트 라이브러리의 구성 파일에 다음 정보를 제공합니다.

개발자 토큰

개발자 토큰을 사용하면 앱에서 API에 액세스할 수 있지만 이 토큰이 한 개의 Google Ads 계정으로만 제한되지는 않습니다. 토큰이 승인되면 모든 Google Ads 계정에 대한 요청에 동일한 토큰을 사용할 수 있습니다. 해당 토큰이 토큰과 연결된 Google Ads 관리자 계정에 연결되어 있지 않아도 마찬가지입니다.

관리하는 계정은 관리자 계정의 OAuth 사용자 인증 정보로 승인됩니다. 관리자 계정에는 모든 하위 계정을 관리하는 데 필요한 사용자 인증 정보가 한 개만 필요합니다.

승인된 토큰만 프로덕션 Google Ads 계정의 API에 연결할 수 있습니다. 대기 중인 토큰은 테스트 계정에만 연결할 수 있습니다.

관리자 계정에 로그인한 후 API 센터 (도구 & 설정; g&; API 센터)로 이동하여 개발자 토큰을 가져올 수 있습니다.

고객 ID

클라이언트 고객 ID는 API로 관리하려는 Google Ads 고객 계정의 계정 번호이며, 일반적으로 123-456-7890 형식입니다.

필요한 경우 클라이언트 고객 ID를 구성 파일에서 제외하여 프로그래매틱 방식으로 설정할 수 있습니다. 개발자 토큰이 승인되면 테스트 계정 대신 프로덕션 계정의 클라이언트 고객 ID를 사용할 수 있습니다.

OAuth2 클라이언트 ID 및 클라이언트 보안 비밀번호

OAuth2 클라이언트 ID와 클라이언트 보안 비밀번호는 클라이언트 앱을 Google API 콘솔의 프로젝트에 매핑하고 OAuth2 인증에 사용됩니다. 그러면 앱이 계정 대신 작동할 수 있습니다. Google에서 앱을 식별하고 개발자가 Google Ads 사용자 관리를 위한 OAuth 토큰을 생성하도록 허용합니다. 자세한 내용은 클라이언트 ID 및 클라이언트 보안 비밀번호 만들기를 참조하세요.

OAuth2 액세스 및 갱신 토큰

앱에서 API를 사용하여 비공개 데이터에 액세스하려면 먼저 API에 대한 액세스 권한을 부여하는 OAuth2 액세스 토큰을 얻어야 합니다.

클라이언트 라이브러리를 사용하면 OAuth2 액세스 토큰이 자동으로 처리됩니다. 그렇지 않은 경우 OAuth 플레이그라운드를 통해 토큰을 가져옵니다.

OAuth2 액세스 토큰은 제한된 시간 후에 만료됩니다. 이러한 이유로 클라이언트 라이브러리는 OAuth2 갱신 토큰을 사용하여 OAuth2 액세스 토큰을 자동으로 다시 생성합니다. 액세스 및 갱신 토큰에 갱신 토큰을 만드는 방법이 나와 있습니다.