고급 API

Google Ads 스크립트의 고급 API를 사용하면 숙련된 개발자가 HTTP 인터페이스를 사용하는 것보다 낮은 설정으로 특정 공개 Google API에 연결할 수 있습니다. 이러한 API는 스크립트의 내장 서비스와 매우 유사하며 자동 완성 및 자동 승인과 같은 편리한 기능을 제공합니다.

고급 API의 가능한 용도

Google 애널리틱스
Google 애널리틱스를 사용하면 웹사이트로 유입되는 트래픽을 추적하고 그에 따라 캠페인 입찰가를 조정할 수 있습니다. Google 애널리틱스 속성을 Google Ads 계정에 연결하면 웹사이트에서 이루어지는 고객의 활동을 분석할 수도 있습니다. 이 정보를 이용하면 얼마나 많은 웹사이트 트래픽 또는 판매가 Google Ads에서 발생하는지 파악하고 광고와 웹사이트를 보다 효과적으로 개선할 수 있습니다. 애널리틱스 계정과 Google Ads 계정을 연결하는 방법은 고객센터에서 자세히 알아보세요.
Google BigQuery
Google Cloud Storage에 대량의 데이터를 로드한 다음 Google BigQuery를 사용하여 해당 데이터를 쿼리할 수 있습니다. 예를 들어 지난 10년 동안의 공개 날씨 데이터를 로드한 후 이 정보를 사용하여 입찰가 조정에 사용하는 스크립트에서 지역의 평균 기온을 쿼리할 수 있습니다. 또 다른 용도는 몇 년 동안의 계정 실적 데이터를 수치화하는 것입니다.
YouTube 및 YouTube 분석
동영상, 재생목록 등은 물론 동영상의 실적 데이터를 검색하고 업데이트하여 입찰 결정을 내릴 수 있습니다.
Google Calendar
스크립트를 사용하여 향후 작업을 위한 이벤트를 만들거나 (예: 오늘부터 2주 동안의 캠페인 실적 보고서 실행) 캘린더에서 생성한 항목을 기반으로 작업을 수행할 수 있습니다 (예: 특정 날짜에 캠페인 사용 설정).
쇼핑 콘텐츠
스크립트는 Apps Script에서 쇼핑용 Google Content API를 사용할 수 있습니다. 이 API를 사용하면 Google 판매자 센터 사용자가 제품 등록정보를 업로드 및 관리하고 판매자 센터 계정을 관리할 수 있습니다. 스크립트에서 이 기능은 제품 등록정보를 확인하고 특정 제품을 특정 광고에 연결하는 데 유용할 수 있습니다.
Google Tasks
스크립트는 향후 작업을 위한 알림 목록을 만들거나 (예: 오늘부터 2주 후의 캠페인 실적 보고서 실행) 알림 목록에서 만든 항목을 기반으로 작업을 수행 (예: 특정 날짜에 캠페인 사용 설정)할 수 있습니다.
Google Slides
스크립트는 캠페인 세부정보나 통계를 Google Slides로 내보내 이러한 정보를 표시 가능한 형식으로 게시할 수 있습니다.

고급 API 사용 설정

고급 API로 사용할 수 있는 Google API를 확인하려면 상단 편집기 막대에서 고급 API 버튼을 클릭합니다.

그러면 Advanced API 대화상자가 표시됩니다. 사용 설정할 API를 선택합니다.

그런 다음 Google API 콘솔 링크를 클릭하여 콘솔에서 스크립트와 연결된 프로젝트와 함께 API 콘솔 페이지를 표시합니다. 프로젝트가 아직 선택되지 않은 경우 프로젝트 드롭다운 목록에서 선택합니다. 검색창에 API 이름을 입력하여 스크립트에서 사용할 API를 검색합니다.

검색결과에서 API를 선택하고 다음 페이지에서 사용 설정을 선택합니다. 사용 중지 버튼이 표시되면 이 API가 이미 사용 설정된 것입니다. 사용 설정할 각 API에 대해 이 작업을 반복합니다.

프로젝트에 사용 설정된 API 목록을 보려면 대시보드 페이지를 선택합니다. 스크립트에 사용할 모든 Advanced API가 나열되어 있는지 확인합니다.

이제 Advanced API 대화상자를 닫고 편집기로 돌아갑니다. 새 API가 스크립트에 대해 사용 설정되고 자동 완성 목록에서 사용할 수 있습니다.

사용 가능한 API

다음 API를 사용할 수 있습니다.

API 이름 문서
Google 애널리틱스 https://developers.google.com/apps-script/advanced/analytics
Google BigQuery https://developers.google.com/apps-script/advanced/bigquery
Google Calendar https://developers.google.com/apps-script/advanced/calendar
Google Slides https://developers.google.com/apps-script/advanced/slides
Google Tasks https://developers.google.com/apps-script/advanced/tasks
쇼핑 콘텐츠 https://developers.google.com/apps-script/advanced/shopping-content
YouTube https://developers.google.com/apps-script/advanced/youtube
YouTube 분석 https://developers.google.com/apps-script/advanced/youtube-analytics

코드 스니펫 페이지에서 이러한 API를 사용하는 방법의 몇 가지 예를 확인할 수도 있습니다.

최종 고려사항

고급 API로 작업할 때 유의해야 할 몇 가지 사항이 있습니다.

프로젝트 ID

각 Google Ads 스크립트에는 Google Cloud Platform 프로젝트 ID (프로젝트 번호라고도 함)가 연결되어 있습니다. 고급 API 대화상자에서 Google API 콘솔 페이지를 열어 스크립트의 프로젝트 번호를 찾을 수 있습니다. 이 프로젝트 ID는 스크립트를 만들 때 생성되며 Google Ads 스크립트를 만든 사용자와 연결됩니다. 스크립트를 만든 사용자가 나중에 계정에서 삭제되면 스크립트에 액세스하려는 사용자에게 스크립트를 재승인하고 고급 API 종속 항목을 다시 설정하라는 메시지가 표시됩니다. 새로운 Google 개발자 프로젝트 ID도 생성되므로 이 문서의 앞부분에서 설명한 대로 Advanced API를 다시 설정해야 합니다.

종속 항목

계정에서 스크립트를 만든 사용자만 스크립트의 Advanced API 종속 항목을 변경할 수 있습니다.

권한

API에 액세스할 때 스크립트는 스크립트를 승인한 사용자의 권한을 사용합니다. 스크립트를 승인한 사용자에게 스크립트에 필요한 데이터와 사용 중인 모든 Advanced API에 대한 필수 액세스 권한이 있는지 확인합니다. Google 애널리틱스 API를 사용하는 경우 스크립트를 승인한 사용자에게 액세스하려는 애널리틱스 계정에 필요한 권한이 있는지 확인합니다.

이용약관

각 고급 API에는 Google API 콘솔에서 API를 사용 설정할 때 동의해야 하는 자체 이용약관이 있을 수 있습니다.

할당량

대부분의 Advanced API에는 무료 일일 할당량이 있습니다. 스크립트가 이 할당량을 초과하면 추가 데이터를 요청하거나 무료 할당량이 보충될 때까지 API 작동이 중지됩니다. 고급 API 대화상자에서 스크립트에 대한 Google API 콘솔을 열어 스크립트에서 사용하는 할당량을 모니터링할 수 있습니다. Google API 콘솔에서는 API에 대한 추가 할당량을 요청할 수도 있습니다.

청구

일부 고급 API는 사용료를 지불해야 합니다. 이러한 결제는 Google Ads가 아니라 스크립트와 연결된 Google Cloud Platform 프로젝트를 통해 관리됩니다. 스크립트의 Google Cloud Platform 프로젝트에 결제를 사용 설정하는 방법에 대한 자세한 내용은 문서를 참조하세요.