이전 Search Ads 360 Reporting API의 지원이 종료되며 2024년 6월 30일에 사용 중단됩니다. Search Ads 360 Conversion API는 영향을 받지 않으며 계속 지원됩니다. 모든 보고 개발에서는 새 Search Ads 360 Reporting API를 사용해야 합니다.

2024년 4월부터 보고서를 요청할 때 지원되지 않는 APIVersion 오류가 반환됩니다. 자세한 내용은 여기를 참조하세요.

또한 기존 Search Ads 360 구현을 새 API로 이전하는 것이 좋습니다. 자세한 내용은 새 Search Ads 360 Reporting API 시작하기 및 이전 가이드를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

첫 앱: 기본 요건

다음 몇 가지 사항을 아직 진행하지 않았다면 첫 번째 클라이언트 애플리케이션 코딩을 시작하기 전에 진행해야 합니다.

Google 계정 만들기 및 Search Ads 360 권한 얻기

Search Ads 360 API를 사용하려면 Google 계정과 Search Ads 360에서 해당 계정에 부여된 적절한 권한이 필요합니다.

아직 Google 계정이 없다면 계정을 만드세요.
내 Search Ads 360 대행사 관리자에게 내 Google 계정의 Search Ads 360 사용자를 생성해 달라고 요청합니다.

보고서를 다운로드하려면 작업할 광고주의 보기 권한이 필요합니다.

전환을 추가하거나 수정하려면 작업할 광고주의 수정 권한이 필요합니다. 공유 플러드라이트 구성에서는 전환을 업로드할 각 하위 광고주의 수정 권한이 필요합니다. 상위 광고주에 대한 액세스 권한 또는 전환을 업로드하지 않는 하위 광고주에 대한 액세스 권한이 필요하지 않습니다. 클릭 ID를 사용하여 전환에 기여도를 부여하는 경우 클릭 ID를 생성한 광고주에 대한 수정 액세스 권한이 있어야 합니다. 수정 권한이 없는 광고주의 클릭 ID를 지정하면 요청이 성공하지 못합니다.

대행사 관리자는 계정을 특정 광고주에 액세스할 수 있는 광고주 사용자로 설정하거나 대행사의 모든 광고주에 액세스할 수 있는 대행사 사용자와 같이 더 높은 수준의 액세스 권한으로 계정을 설정할 수 있습니다.

API 전환 서비스 활성화

전환에 대한 데이터를 업로드하려면 대행사 관리자 권한이 있는 Search Ads 360 사용자가 Search Ads 360 UI에 로그인하고 API 전환 서비스를 활성화해야 합니다. 자세한 안내는 Search Ads 360 고객센터를 참조하세요.

클라이언트를 위한 Google API 콘솔 프로젝트 및 OAuth 사용자 인증 정보 만들기

Google API 콘솔 설정 도구를 시작합니다.
설정 도구에서는 프로젝트를 만들거나 기존 프로젝트를 사용하고 Search Ads 360 API를 사용 설정하며 OAuth 2.0 사용자 인증 정보를 만드는 과정을 안내합니다.
애플리케이션 등록 페이지에서 기존 프로젝트를 선택하거나 프로젝트 만들기를 선택합니다. 그런 다음 계속을 클릭합니다.
Google API 콘솔에서 Search Ads 360 API를 사용 설정한 후 사용자 인증 정보로 이동 버튼을 클릭합니다.
사용자 인증 정보 만들기 페이지에서 다음 정보를 입력합니다.
- 어떤 API를 사용 중이신가요? Search Ads 360 API
- 어떤 데이터에 액세스하시나요?: 사용자 데이터
다음 버튼을 클릭합니다.
이제 설정 도구를 사용하여 OAuth 2.0 클라이언트 ID를 만들 수 있습니다.
설정 도구의 나머지 단계를 따릅니다.

sa360Api.py 설치

Search Ads 360은 승인 설정 절차를 원활하게 하는 유틸리티 스크립트를 제공합니다. 전체 애플리케이션을 설계하고 작성하기 전에 데이터를 송수신하려면 이 스크립트를 사용하여 JSON 형식으로 데이터를 주고받으면 됩니다. 이 문서 사이트에서 여러 JSON 예시를 복사하여 스크립트에 직접 입력할 수 있습니다.

스크립트를 설치하려면 다음 안내를 따르세요.

Python 2.7을 설치합니다.
Python 3.x에서는 스크립트가 작동하지 않습니다.
cURL을 설치합니다.
sa360Api.zip을 다운로드합니다.
sa360Api.zip에서 sa360Api.py를 추출합니다.
sa360Api.py를 실행 가능하게 만듭니다.

REST 기본사항 알아보기

API를 호출하는 방법에는 2가지가 있습니다.

클라이언트 라이브러리 사용
HTTP 요청 전송 및 응답 파싱

클라이언트 라이브러리를 사용하지 않으려면 REST의 기본사항을 이해해야 합니다.

REST는 데이터 요청 및 수정에 대한 간편하고 일관성 있는 접근 방식을 제공하는 소프트웨어 아키텍처 스타일입니다.

REST는 'Representational State Transfer'의 줄임말로, Google API의 맥락에서 REST는 HTTP 동사를 사용하여 Google이 저장한 데이터 표현을 검색 및 수정하는 방법을 의미합니다.

RESTful 시스템에서는 리소스가 데이터 저장소에 저장되고, 클라이언트는 서버에서 특정 작업(리소스 생성, 검색, 업데이트, 삭제 등)을 수행하라는 요청을 전송하며, 서버는 작업을 수행하고 응답을 전송합니다. 이 응답은 지정된 리소스 표현의 형식을 취하는 경우가 많습니다.

Google의 RESTful API에서는 클라이언트가 POST, GET, PUT, DELETE 등의 HTTP 동사를 사용하여 작업을 지정합니다. 리소스를 다음과 같은 형식의 고유한 URI로 지정합니다.

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

모든 API 리소스에는 HTTP에서 액세스할 수 있는 고유 URI가 있으므로 REST는 데이터 캐싱을 지원하며 웹의 분산형 인프라와의 연동성이 뛰어납니다.

HTTP 1.1 표준 문서의 메서드 정의를 확인하면 유용합니다. 문서에 GET, POST, PUT, DELETE의 사양이 포함되어 있습니다.

Search Ads 360 API의 REST

Search Ads 360 API 작업은 REST HTTP 동사에 직접 매핑됩니다.

Search Ads 360 API URI의 구체적인 형식은 다음과 같습니다.

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

API에서 지원되는 각 작업에 사용되는 전체 URI 집합은 API 참조에 요약되어 있습니다.

JSON 기본사항 알아보기

REST를 사용하는 경우 요청 본문에 JSON 형식을 사용해야 합니다. 응답을 JSON 또는 CSV 형식으로 지정할 수 있습니다.

JSON(JavaScript Object Notation)은 특정 언어에 의존하지 않는 일반적인 데이터 형식으로, 임의의 데이터 구조를 간단한 텍스트로 표현할 수 있습니다. 자세한 내용은 json.org를 참조하세요.