Google Ads 스크립트의 고급 API를 사용하면 개발자가 HTTP 인터페이스를 사용하는 것보다 적은 설정으로 특정 공개 Google API에 연결할 수 있습니다. 이러한 API는 스크립트의 기본 제공 서비스와 마찬가지로 사용할 수 있으며 자동 완성 및 자동 승인과 같은 동일한 편의성을 제공합니다.
이러한 API를 사용하는 방법을 보여주는 몇 가지 예는 코드 스니펫 페이지를 참고하세요.
사용 가능한 고급 API
- Google 애널리틱스
- 참고: 고급 API 대화상자의
Analytics고급 API는 종료된 유니버설 애널리틱스 v3 API를 타겟팅하며 요청이 실패합니다. Google Ads 스크립트는 Google 애널리틱스 4AnalyticsData또는AnalyticsAdmin고급 서비스를 지원하지 않습니다. 스크립트에서 Google 애널리틱스 4 데이터를 쿼리하려면UrlFetchApp서비스와 OAuth 2.0을 사용하여 Google Analytics Data API에 HTTPS 요청을 전송합니다. Google 애널리틱스 4 속성을 Google Ads 계정에 연결하여 웹사이트 및 앱 전환 데이터를 직접 공유할 수도 있습니다. 설정 안내는 애널리틱스 설정 가이드를 참고하세요. - Google BigQuery
- Google Cloud Storage에 대량의 데이터를 로드한 다음 Google BigQuery를 사용하여 해당 데이터를 쿼리할 수 있습니다. 예를 들어 지난 10년간의 공개 날씨 데이터를 로드한 다음 입찰가를 조정하는 데 해당 정보를 사용하는 스크립트에서 지역의 평균 기온을 쿼리할 수 있습니다. 또 다른 용도는 수년에 걸친 계정의 실적 데이터에 대한 수치 연산을 수행하는 것입니다.
- Google Calendar
- 스크립트는 향후 작업에 대한 이벤트를 만들거나 (예: 오늘부터 2주 동안 캠페인에 대한 실적 보고서 실행) 캘린더에 만든 항목을 기반으로 작업을 수행할 수 있습니다 (예: 특정 날짜에 캠페인 사용 설정).
- Google Slides
- 스크립트는 캠페인 세부정보 또는 통계를 Google 슬라이드로 내보내 이러한 정보를 발표 가능한 형식으로 게시할 수 있습니다.
- Google Tasks
- 스크립트는 향후 작업에 대한 리마인더 목록을 만들거나 (예: 오늘부터 2주 후에 캠페인 실적 보고서 실행) 리마인더 목록에 만든 항목을 기반으로 작업을 수행할 수 있습니다 (예: 특정 날짜에 캠페인 사용 설정).
- Merchant API
- 스크립트는 Merchant API를 사용하여 제품 등록정보를 업로드 및 관리하고 Google 판매자 센터 계정을 관리할 수 있습니다. 스크립트에서 이 기능은 제품 등록정보를 확인하고 특정 제품을 특정 광고에 연결하는 데 유용할 수 있습니다. Merchant API에는 고급 API 대화상자에서 개별적으로 사용 설정할 수 있는 하위 API가 있습니다. 개발자로 등록 가이드를 통해 Google 판매자 센터 계정 연결에 대해 자세히 알아볼 수 있습니다.
- 쇼핑 콘텐츠
- 스크립트는 Google Content API for Shopping을 사용하여 제품 등록정보를 업로드 및 관리하고 Google 판매자 센터 계정을 관리할 수 있습니다. 스크립트에서 이 기능은 제품 등록정보를 확인하고 특정 제품을 특정 광고에 연결하는 데 유용할 수 있습니다. 참고: Content API for Shopping은 2026년 8월 18일에 지원 종료됩니다. 대신 이전 섹션에서 설명한 Merchant API를 사용하세요.
- YouTube 및 YouTube 분석
- 동영상, 재생목록 등과 동영상 실적 데이터를 검색하고 업데이트하여 입찰 결정을 내릴 수 있습니다.
고급 API 사용 설정
고급 API로 사용할 수 있는 Google API를 확인하려면 상단 편집기 표시줄에서 고급 API를 클릭하여 고급 API 대화상자를 표시합니다. 사용 설정할 API를 선택합니다.
저장을 클릭하여 선택사항을 저장하고 스크립트 편집기로 돌아갑니다. 새 API가 스크립트에 사용 설정되고 자동 완성 목록에 표시됩니다.
추가 고려사항
고급 API를 사용할 때는 몇 가지 유의해야 할 사항이 있습니다.
종속 항목
계정에서 스크립트를 만든 사용자만 해당 스크립트의 고급 API 종속 항목을 변경할 수 있습니다.
권한
고급 API에 액세스할 때 스크립트는 스크립트를 승인한 사용자의 권한을 사용합니다. 승인하는 사용자에게는 스크립트에 필요한 모든 데이터에 대한 필수 액세스 권한이 있어야 합니다. 예를 들어 BigQuery 고급 API를 사용하려면 승인하는 사용자에게 대상 Google Cloud 프로젝트 및 BigQuery 데이터 세트에 필요한 권한이 있어야 합니다.
2019년 5월 이전 스크립트 관련 고려사항
2019년 5월 이전에 만든 스크립트의 경우 스크립트와 연결된 Google Cloud 프로젝트에서 관련 API를 수동으로 사용 설정해야 할 수 있습니다. 고급 API 대화상자에 Google Cloud 콘솔 링크가 표시되면 스크립트가 영향을 받는 것입니다.
고급 API 사용 설정
2019년 이전 스크립트의 경우 스크립트에서 사용하려는 각 고급 API를 수동으로 사용 설정해야 합니다.
- 고급 API 버튼을 클릭합니다. 다음 대화상자 창에서 Google Cloud 콘솔 링크를 클릭합니다.
- 프로젝트가 아직 선택되지 않은 경우 프로젝트 드롭다운 목록에서 프로젝트를 선택합니다.
- 검색창에 API 이름을 입력하여 스크립트에서 사용할 API를 검색합니다.
- 검색 결과에서 API를 선택하고 다음 페이지에서 '사용 설정' 버튼을 클릭합니다.
스크립트를 만든 사용자가 나중에 계정에서 삭제되면 스크립트에 액세스하려는 신규 사용자에게 고급 API 종속 항목을 다시 사용 설정하고 스크립트를 다시 승인하라는 메시지가 표시됩니다.