제한

이 페이지에서는 Google Ads 스크립트에서 알아두어야 할 다양한 한도 및 제한사항을 설명합니다. 이러한 한도는 언제든지 예고 없이 변경될 수 있으므로 스크립트가 유연하고 오류 처리를 포함하도록 하세요.

실행 시간 한도

Google Ads 스크립트

광고주 계정의 Google Ads 스크립트는 최대 30 분 동안 실행될 수 있으며, 그 이후에는 취소됩니다. 스크립트가 취소되기 전에 이루어진 변경사항은 모두 적용됩니다.

Ads Manager 스크립트

Ads Manager 스크립트는 일반적으로 최대 30분 동안 실행될 수 있으며, 그 이후 에는 취소됩니다. 하지만 Ads Manager 스크립트가 executeInParallel 메서드를 사용하여 계정을 병렬로 처리하고 콜백 메서드를 지정하는 경우 취소되기 전에 최대 60분 동안 실행될 수 있습니다. 다음 그림에서는 processAccount가 병렬 함수이고 allFinished가 executeInParallel을 호출할 때의 콜백 메서드입니다.

스크립트가 취소되기 전에 이루어진 변경사항은 모두 적용됩니다.

항목 한도

Google Ads 계정의 스크립트

  • 단일 반복기 는 기본적으로 최대 50,000개의 결과를 반환합니다. 선택기에서 withLimit()를 호출하여 이 값을 수정할 수 있습니다.

  • 단일 선택기 는 selector.withIds()에서 최대 10,000개의 ID를 처리할 수 있습니다. 10,000개 이상의 ID가 지정되면 selector.get()에서 런타임 오류가 발생합니다. 마찬가지로 10,000개 이상의 ID 목록으로 Id IN [LIST] 조건을 지정하면 런타임 오류가 발생합니다.

  • 로깅 출력은 100KB에서 잘립니다. 이 경우 경고가 기록됩니다.

관리자 계정의 스크립트

  • Ads Manager 스크립트에서 처리하는 각 계정에는 이전 섹션에 나열된 자체 할당량이 부여됩니다.

  • executeInParallel 메서드를 사용하는 경우 스크립트는 최대 50 개의 계정을 처리할 수 있습니다.

  • executeInParallel의 processAccount 메서드는 최대 10MB 의 데이터를 반환할 수 있습니다.

일괄 업로드 한도

  • 업로드 파일은 50MB 및 100만 행으로 제한되며, 이러한 한도를 초과하는 경우 제출 시 거부됩니다.

  • 업로드 작업은 2시간 후에 시간 초과되며 작업은 업로드된 파일의 나머지 데이터 처리를 중지합니다.

Google 서비스 할당량

기본 Google Apps Script 서비스는 일부 기능에 일일 할당량과 하드 한도를 적용합니다. 이러한 할당량과 함께 제공되는 예외 메시지 목록을 참고하세요.

승인된 스크립트

OAuth2는 스크립트를 승인하는 데 사용됩니다. 각 계정에는 250 개의 승인된 스크립트 한도가 있습니다. 이 한도를 초과하면 이전에 승인된 스크립트 중 하나가 승인 취소됩니다. 이는 일시적이며 다음에 스크립트를 열 때 다시 승인할 수 있습니다.

이 한도가 자주 발생하는 경우 여러 사용자 계정을 사용하여 다양한 스크립트 집합을 승인하는 것이 좋습니다.

동영상 및 쇼핑 캠페인

표준 캠페인 선택기 (AdsApp.campaigns().get())는 결과에서 동영상 및 쇼핑 캠페인을 필터링합니다. 대신 전용 캠페인 선택기를 사용하세요.