다음 몇 가지 사항을 아직 진행하지 않았다면 처음 클라이언트 애플리케이션의 코딩을 시작하기 전에 진행해야 합니다.
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를 참조하세요.