이전 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를 통해 번역되었습니다.

승인 설정

Search Ads 360 API에서는 모든 요청에서 인증을 위해 OAuth 2.0 액세스 토큰을 지정해야 합니다. 모든 표준 OAuth 2.0 인증 워크플로를 따라 토큰을 생성하여 Search Ads 360 API에 전달할 수 있습니다. 완전 자동 전환 업로드 및 보고서 다운로드에 적합하기 때문에 아래에 설명된 워크플로가 권장됩니다.

아래에 설명된 워크플로의 대안은 설치된 애플리케이션에 OAuth 2.0 사용 또는 서버 간 애플리케이션에 OAuth 2.0 사용을 참고하세요. 대체 워크플로를 사용하는 경우 OAuth 2.0 승인 코드를 요청할 때 다음 값을 scope 매개변수로 지정합니다.
https://www.googleapis.com/auth/doubleclicksearch
서버 간 경로를 따르는 경우 서비스 계정을 Search Ads 360 사용자로 추가합니다.

권장되는 승인 워크플로

Google API 콘솔로 이동하여 프로젝트를 선택합니다.
Google API 콘솔 프로젝트 및 OAuth 사용자 인증 정보를 아직 만들지 않았다면 클라이언트의 Google API 콘솔 프로젝트 및 OAuth 사용자 인증 정보 만들기의 안내를 따릅니다.

프로젝트의 OAuth 클라이언트 ID와 보안 비밀을 찾으려면 다음 단계를 따르세요.
1. 사용자 인증 정보 페이지를 엽니다.
2. 이름 열에서 OAuth 클라이언트의 이름을 클릭합니다.
3. 페이지에 클라이언트 ID와 보안 비밀이 표시됩니다.
웹브라우저를 열고 Search Ads 360에서 데이터 액세스 권한이 있는 Google 계정으로 Google에 로그인합니다.
API 클라이언트가 Search Ads 360 인증에 사용하는 Google 계정입니다. Google 계정 소유자가 퇴사하여 계정에서 Search Ads 360 액세스 권한을 삭제하면 이 승인 워크플로를 반복하고 다른 Google 계정을 지정해야 합니다.
다음과 같이 Search Ads 360 유틸리티 스크립트를 호출하여 갱신 토큰을 가져옵니다.
sa360Api.py --login

이 스크립트는 OAuth 클라이언트 ID와 보안 비밀을 사용하여 갱신 토큰을 얻는 과정을 안내합니다. 갱신 토큰은 이전 단계에서 로그인한 Google 계정에만 유효합니다.
이 프로세스의 일부로 스크립트가 URL을 생성하고 웹브라우저에서 URL을 방문하도록 안내합니다.
브라우저에서 Search Ads 360 데이터에 대한 OAuth 클라이언트 액세스를 허용하라는 메시지가 표시되면 앞서 로그인한 Google 계정이 표시되는지 확인합니다. 여러 Google 계정에 로그인되어 있는 경우 다른 계정이 표시될 수 있습니다.

프로세스가 끝나면 sa360Api.py 스크립트는 쉼표로 구분된 문자열을 출력합니다. 첫 번째 값은 제공된 클라이언트 ID, 두 번째 값은 제공한 클라이언트 보안 비밀번호, 세 번째 값은 갱신 토큰입니다. 다음 출력 예시에서 새로고침 토큰은 굵게 표시됩니다.
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
백엔드 데이터베이스 또는 애플리케이션에서 액세스할 수 있는 다른 안전한 위치에 클라이언트 ID, 클라이언트 보안 비밀번호, 갱신 토큰을 저장합니다.
sa360Api.py를 사용하여 샘플 JSON 요청을 Search Ads 360 API로 전송하려는 경우 전체 쉼표로 구분된 문자열을 편리한 위치에 보관합니다. 스크립트를 호출할 때마다 전체 문자열을 매개변수로 전달합니다.
다음을 수행하는 코드를 애플리케이션에 추가합니다.
1. 클라이언트 ID, 클라이언트 보안 비밀번호, 갱신 토큰을 사용하여 새 OAuth 2.0 액세스 토큰을 받습니다.
2. 새 액세스 토큰을 사용하여 Search Ads 360 API에 요청을 보냅니다.
클라이언트 라이브러리를 사용하는 경우 다음 섹션인 애플리케이션 설정에서 이 승인 코드를 애플리케이션에 추가하는 방법을 설명합니다.

클라이언트 라이브러리 중 하나를 사용하지 않는 경우 설치된 애플리케이션에 OAuth 2.0 사용에서 새로운 액세스 토큰을 얻는 방법에 대한 제안사항을 확인하세요.