권장사항

이 페이지에서는 Google Ads 스크립트를 사용한 개발 관련 다양한 권장사항을 다룹니다.

선택기

Selector로 필터링

가능하면 필터를 사용하여 필요한 항목만 요청하세요. 적절한 필터를 적용하면 다음과 같은 이점이 있습니다.

  • 코드가 훨씬 간단하고 쉬워 이해하기 쉽습니다.
  • 스크립트가 훨씬 빠르게 실행됩니다.

다음 코드 스니펫을 비교해 보세요.

코딩 접근 방식 코드 스니펫
선택기를 사용한 필터링 (권장) 
var keywords = AdsApp.keywords()
    .withCondition('Clicks > 10')
    .forDateRange('LAST_MONTH')
    .get();
while (keywords.hasNext()) {
  var keyword = keywords.next();
  // Do work here.
}
코드에서 필터링 (권장되지 않음) 
var keywords = AdsApp.keywords().get();

while (keywords.hasNext()) {
  var keyword = keywords.next();
  var stats = keyword.getStatsFor(
      'LAST_MONTH');
  if (stats.getClicks() > 10) {
    // Do work here.
  }
}

두 번째 방법은 목록에 필터를 적용하기 위해 계정 내 모든 키워드 목록을 가져오려고 하므로 권장되지 않습니다.

캠페인 계층구조의 탐색 방지

특정 수준의 항목을 검색하려면 전체 캠페인 계층 구조를 순회하는 대신 해당 수준의 수집 메서드를 사용하세요. 이 방법은 간단할 뿐만 아니라 실적도 훨씬 우수합니다. 시스템이 불필요하게 모든 캠페인 및 광고 그룹을 읽지 않아도 됩니다.

계정의 모든 광고를 가져오는 다음 코드 스니펫을 비교해 보세요.

코딩 접근 방식 코드 스니펫
적절한 수집 방법 사용 (권장) 

var ads = AdsApp.ads();
계층 구조 탐색 (권장하지 않음) 
var campaigns = AdsApp.campaigns().get();
while (campaigns.hasNext()) {
  var adGroups = campaigns.next().
      adGroups().get();
  while (adGroups.hasNext()) {
    var ads = adGroups.next().ads().get();
    // Do your work here.
  }
}

두 번째 방법은 광고만 필요하지만 객체 (캠페인, 광고그룹)의 전체 계층 구조를 가져오려고 하므로 권장되지 않습니다.

특정 상위 접근자 메서드 사용

검색된 객체의 상위 항목을 가져와야 하는 경우가 있습니다. 이 경우 전체 계층 구조를 가져오는 대신 제공된 접근자 메서드를 사용해야 합니다.

지난 달에 50회 이상의 클릭이 발생한 텍스트 광고가 있는 광고그룹을 검색하는 다음 코드 스니펫을 비교해보세요.

코딩 접근 방식 코드 스니펫
적절한 상위 접근자 방법 사용 (권장) 
var ads = AdsApp.ads()
    .withCondition('Clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();

while (ads.hasNext()) {
  var ad = ads.next();
  var adGroup = ad.getAdGroup();
  var campaign = ad.getCampaign();
  // Store (campaign, adGroup) to an array.
}
계층 구조 순회 (권장되지 않음) 
var campaigns = AdsApp.campaigns().get();
while (campaigns.hasNext()) {
  var adGroups = campaigns.next()
      .adGroups()
      .get();
  while (adGroups.hasNext()) {
    var ads = adGroups.ads()
       .withCondition('Clicks > 50')
       .forDateRange('LAST_MONTH')
       .get();
    if (ads.totalNumEntities() > 0) {
      // Store (campaign, adGroup) to an array.
    }
  }
}

두 번째 방법은 계정에서 전체 캠페인 및 광고 그룹 계층 구조를 가져오므로 권장되지 않습니다. 반면에 광고 집합과 연결된 캠페인 및 광고 그룹의 하위 집합만 있으면 됩니다. 첫 번째 방법은 관련 광고 컬렉션만 가져오도록 제한하고 적절한 메서드를 사용하여 상위 객체에 액세스합니다.

특정 상위 필터 사용하기

특정 캠페인 또는 광고 그룹 내의 항목에 액세스하려면 계층 구조를 가져와 순회하는 대신 선택기에서 특정 필터를 사용합니다.

지정된 캠페인 및 지난 달에 50회 이상의 클릭이 발생한 광고그룹의 텍스트 광고 목록을 가져오는 다음 코드 스니펫을 비교해 보세요.

코딩 접근 방식 코드 스니펫
적절한 상위 수준 필터 사용 (권장) 
var ads = AdsApp.ads()
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .withCondition('Clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();

while (ads.hasNext()) {
  var ad = ads.next();
  var adGroup = ad.getAdGroup();
  var campaign = ad.getCampaign();
  // Store (campaign, adGroup, ad) to
  // an array.
}
계층 구조 순회 (권장되지 않음) 
var campaigns = AdsApp.campaigns()
    .withCondition('Name = "Campaign 1"')
    .get();

while (campaigns.hasNext()) {
  var adGroups = campaigns.next()
      .adGroups()
      .withCondition('Name = "AdGroup 1"')
      .get();
  while (adGroups.hasNext()) {
    var ads = adGroups.ads()
       .withCondition('Clicks > 50')
       .forDateRange('LAST_MONTH')
       .get();
    while (ads.hasNext()) {
      var ad = ads.next();
      // Store (campaign, adGroup, ad) to
      // an array.
    }
  }
}

두 번째 방법은 계정의 캠페인 및 광고그룹 계층 구조에서 반복되지만 선택된 광고 집합과 상위 캠페인 및 광고그룹만 있으면 되므로 권장되지 않습니다. 첫 번째 방법은 선택 도구에서 상위 항목에 특정 필터를 적용하여 광고 목록에 대한 반복을 제한합니다.

가능한 경우 ID를 사용해 필터링하세요.

항목을 필터링할 때는 다른 필드 대신 ID로 항목을 필터링하는 것이 좋습니다.

캠페인을 선택하는 다음 코드 스니펫을 살펴보세요.

코딩 접근 방식 코드 스니펫
ID로 필터링 (권장) 
var campaign = AdsApp.campaigns()
    .withIds([12345])
    .get()
    .next();
이름으로 필터링 (최적의 수준은 낮음) 
var campaign = AdsApp.campaigns()
    .withCondition('Name="foo"')
    .get()
    .next();

두 번째 방법은 ID가 아닌 필드로 필터링하므로 최적이 아닙니다.

가능한 경우 자녀 유무로 필터링

항목을 선택할 때 가능하면 상위 ID로 필터링하세요. 이렇게 하면 결과를 필터링할 때 서버에서 검색하는 항목 목록을 제한하여 쿼리 속도를 높일 수 있습니다.

ID로 광고그룹을 검색하는 다음 코드 스니펫을 참조하세요. 상위 캠페인 ID를 알고 있다고 가정해 보겠습니다.

코딩 접근 방식 코드 스니펫
캠페인 및 광고 그룹 ID로 필터링하기 (권장) 
var adGroup = AdsApp.adGroups()
    .withIds([12345])
    .withCondition('CampaignId="54678"')
    .get()
    .next();
광고 그룹 ID로만 필터링 (최적의 경우는 적음) 
var adGroup = AdsApp.adGroups()
    .withIds([12345])
    .get()
    .next();

두 코드 스니펫 모두 동일한 결과를 제공하지만 상위 ID (CampaignId="54678")를 사용하는 코드 스니펫 1에서 추가 필터링을 하면 서버에서 결과를 필터링할 때 반복해야 하는 항목 목록을 제한하여 코드를 더 효율적으로 만들 수 있습니다.

필터링 조건이 너무 많은 경우 라벨 사용

필터링 조건이 너무 많으면 처리할 항목에 라벨을 만들고 이 라벨을 사용하여 항목을 필터링하는 것이 좋습니다.

이름으로 캠페인 목록을 검색하는 다음 코드 스니펫을 살펴보세요.

코딩 접근 방식 코드 스니펫
라벨 사용 (권장) 
var label = AdsApp.labels()
    .withCondition('Name = "My Label"')
    .get()
    .next();
var campaigns = label.campaigns.get();
while (campaigns.hasNext()) {
  var campaign = campaigns.next();
  // Do more work
}
복잡한 선택기 빌드 (권장하지 않음) 
var campaignNames = [‘foo’, ‘bar’, ‘baz’];

for (var i = 0; i < campaignNames.length; i++) {
  campaignNames[i] = '"' + campaignNames[i] + '"';
}

var campaigns = AdsApp.campaigns
    .withCondition('CampaignName in [' + campaignNames.join(',') + ']')
    .get();

while (campaigns.hasNext()) {
  var campaign = campaigns.next();
  // Do more work.
}

두 코드 스니펫 모두 비슷한 수준의 성능을 제공하지만, 두 번째 방법에서는 선택기의 조건 수가 늘어날수록 더 복잡한 코드가 생성되는 경향이 있습니다. 또한 새 항목을 포함하도록 스크립트를 수정하는 것보다 새 항목에 라벨을 적용하는 것이 더 쉽습니다.

IN 절의 조건 수를 제한하세요.

스크립트를 실행할 때 일반적인 사용 사례는 항목 목록에 대한 보고서를 실행하는 것입니다. 개발자는 일반적으로 IN 절을 사용하여 항목 ID를 필터링하는 매우 긴 AWQL 쿼리를 구성하여 이를 수행합니다. 이 방법은 항목 수가 제한된 경우에 효과적입니다. 그러나 쿼리 길이가 늘어남에 따라 다음 두 가지 이유로 스크립트 성능이 저하됩니다.

  • 쿼리가 길수록 파싱 시간이 오래 걸립니다.
  • IN 절에 추가하는 각 ID는 평가할 추가 조건이므로 시간이 더 오래 걸립니다.

이러한 조건에서는 항목에 라벨을 적용한 후 LabelId로 필터링하는 것이 좋습니다.

코딩 접근 방식 코드 스니펫
라벨 적용 및 labelID로 필터링 (권장) 
// The label applied to the entity is "Report Entities"
var label = AdsApp.labels()
    .withCondition('LabelName contains "Report Entities"')
    .get()
    .next();

var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' +
    'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT ' +
    'WHERE LabelId = "' + label.getId() + '"');
IN 절을 사용하여 긴 쿼리 작성 (권장하지 않음) 
var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' +
    'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT WHERE ' +
    'AdGroupId IN (123, 456) and Id in (123,345, 456…)');

계정 업데이트

일괄 변경 수행

Google Ads 항목을 변경해도 Google Ads 스크립트에서 변경사항을 즉시 실행하지는 않습니다. 대신 여러 변경사항을 배치로 결합하여 여러 변경사항을 수행하는 단일 요청을 실행할 수 있도록 합니다. 이 방법을 사용하면 스크립트 속도가 빨라지고 Google Ads 서버의 부하가 줄어듭니다. 그러나 Google Ads 스크립트에서 작업 배치를 자주 플러시하도록 하여 스크립트가 느리게 실행되도록 하는 코드 패턴이 있습니다.

키워드 목록의 입찰가를 업데이트하는 다음 스크립트를 살펴보세요.

코딩 접근 방식 코드 스니펫
업데이트된 요소 추적하기 (권장) 
var keywords = AdsApp.keywords()
    .withCondition('Clicks > 50')
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .forDateRange('LAST_MONTH')
    .get();

var list = [];
while (keywords.hasNext()) {
  var keyword = keywords.next();
  keyword.bidding().setCpc(1.5);
  list.push(keyword);
}

for (var i = 0; i < list.length; i++) {
  var keyword = list[i];
  Logger.log('%s, %s', keyword.getText(),
      keyword.bidding().getCpc());
}
긴밀한 루프에서 업데이트된 요소 가져오기 (권장하지 않음) 
var keywords = AdsApp.keywords()
    .withCondition('Clicks > 50')
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .forDateRange('LAST_MONTH')
    .get();

while (keywords.hasNext()) {
  var keyword = keywords.next();
  keyword.bidding().setCpc(1.5);
  Logger.log('%s, %s', keyword.getText(),
      keyword.bidding().getCpc());
}

keyword.bidding().getCpc()를 호출하면 Google Ads 스크립트에서 setCpc() 작업을 삭제하고 한 번에 하나의 작업만 실행하므로 두 번째 방법은 권장되지 않습니다. 첫 번째 접근 방식은 두 번째 접근 방식과 비슷하지만 getCpc() 호출이 setCpc()가 호출되는 루프와 별도의 루프에서 실행되므로 일괄 처리를 지원하는 추가적인 이점이 있습니다.

가능한 경우 빌더 사용

Google Ads 스크립트는 새 객체를 만드는 두 가지 방법, 즉 빌더와 만들기 메서드를 지원합니다. 빌더는 API 호출에서 생성된 객체에 액세스할 수 있는 권한을 제공하므로 생성 메서드보다 더 유연합니다.

다음 코드 스니펫을 살펴보세요.

코딩 접근 방식 코드 스니펫
빌더 사용 (권장) 
var operation = adGroup.newKeywordBuilder()
    .withText('shoes')
    .build();
var keyword = operation.getResult();
생성 방법 사용 (권장하지 않음) 
adGroup.createKeyword('shoes');
var keyword = adGroup.keywords()
    .withCondition('KeywordText="shoes"')
    .get()
    .next();

두 번째 방법은 키워드 검색 시 추가 선택 작업이 포함되기 때문에 권장하지 않습니다. 생성 메서드도 지원 중단되었습니다.

하지만 빌더를 잘못 사용하면 Google Ads 스크립트가 작업을 일괄 처리하지 못할 수 있습니다.

키워드 목록을 만들고 새로 만든 키워드의 ID를 출력하는 다음 코드 스니펫을 살펴보세요.

코딩 접근 방식 코드 스니펫
업데이트된 요소 추적하기 (권장) 
var keywords = [‘foo’, ‘bar’, ‘baz’];

var list = [];
for (var i = 0; i < keywords.length; i++) {
  var operation = adGroup.newKeywordBuilder()
      .withText(keywords[i])
      .build();
  list.push(operation);
}

for (var i = 0; i < list.length; i++) {
  var operation = list[i];
  var result = operation.getResult();
  Logger.log('%s %s', result.getId(),
      result.getText());
}
긴밀한 루프에서 업데이트된 요소 가져오기 (권장하지 않음) 
var keywords = [‘foo’, ‘bar’, ‘baz’];

for (var i = 0; i < keywords.length; i++) {
  var operation = adGroup.newKeywordBuilder()
      .withText(keywords[i])
      .build();
  var result = operation.getResult();
  Logger.log('%s %s', result.getId(),
      result.getText());
}

두 번째 방법은 작업을 생성하는 동일한 루프 내에서 operation.getResult()를 호출하여 Google Ads 스크립트가 한 번에 하나의 작업을 실행해야 하므로 선호되지 않습니다. 첫 번째 접근 방식도 비슷하지만, 배치가 생성된 곳과 다른 루프에서 job.getResult()를 호출하기 때문에 일괄 처리가 가능합니다.

대규모 업데이트에 일괄 업로드 사용

개발자가 수행하는 일반적인 작업은 보고서를 실행하고 현재 실적 값에 따라 항목 속성 (예: 키워드 입찰가)을 업데이트하는 것입니다. 다수의 항목을 업데이트해야 하는 경우 일괄 업로드를 사용하면 성능이 향상됩니다. 예를 들어 지난달 TopImpressionPercentage > 0.4이 있는 키워드의 MaxCpc를 늘리는 다음 스크립트를 사용해 보세요.

코딩 접근 방식 코드 스니펫
일괄 업로드 사용 (권장) 

var report = AdsApp.report(
  'SELECT AdGroupId, Id, CpcBid FROM KEYWORDS_PERFORMANCE_REPORT ' +
  'WHERE TopImpressionPercentage > 0.4 DURING LAST_MONTH');

var upload = AdsApp.bulkUploads().newCsvUpload([
  report.getColumnHeader('AdGroupId').getBulkUploadColumnName(),
  report.getColumnHeader('Id').getBulkUploadColumnName(),
  report.getColumnHeader('CpcBid').getBulkUploadColumnName()]);
upload.forCampaignManagement();

var reportRows = report.rows();
while (reportRows.hasNext()) {
  var row = reportRows.next();
  row['CpcBid'] = row['CpcBid'] + 0.02;
  upload.append(row.formatForUpload());
}

upload.apply();
ID별로 키워드 선택 및 업데이트 (최적의 결과가 적음) 
var reportRows = AdsApp.report('SELECT AdGroupId, Id, CpcBid FROM ' +
    'KEYWORDS_PERFORMANCE_REPORT WHERE TopImpressionPercentage > 0.4 ' +
    ' DURING LAST_MONTH')
    .rows();

var map = {
};

while (reportRows.hasNext()) {
  var row = reportRows.next();
  var adGroupId = row['AdGroupId'];
  var id = row['Id'];

  if (map[adGroupId] == null) {
    map[adGroupId] = [];
  }
  map[adGroupId].push([adGroupId, id]);
}

for (var key in map) {
  var keywords = AdsApp.keywords()
      .withCondition('AdGroupId="' + key + '"')
      .withIds(map[key])
      .get();

  while (keywords.hasNext()) {
    var keyword = keywords.next();
    keyword.bidding().setCpc(keyword.bidding().getCpc() + 0.02);
  }
}

두 번째 접근 방식이 꽤 좋은 성능을 제공하지만 첫 번째 접근 방식이 선호됩니다.

  • Google Ads 스크립트에는 한 번의 실행으로 검색하거나 업데이트할 수 있는 객체 수에 제한이 있으며, 두 번째 접근 방식의 선택 및 업데이트 작업이 한도에 반영됩니다.

  • 일괄 업로드는 업데이트할 수 있는 항목 수와 전체 실행 시간 측면에서 모두 한도가 더 높습니다.

일괄 업로드를 캠페인별로 그룹화

일괄 업로드를 만들 때 상위 캠페인별로 작업을 그룹화해 보세요. 이렇게 하면 효율성이 높아지고 변경사항 / 동시 실행 오류의 충돌 가능성이 줄어듭니다.

두 개의 일괄 업로드 작업을 동시에 실행한다고 생각해 보세요. 하나는 광고그룹의 광고를 일시중지하고, 다른 하나는 키워드 입찰가를 조정합니다. 이러한 작업은 서로 관련이 없지만 동일한 광고 그룹에 속한 항목 (또는 동일한 캠페인에 속한 두 개의 서로 다른 광고 그룹)에 적용될 수 있습니다. 이 경우 시스템에서 상위 항목 (공유 광고그룹 또는 캠페인)을 잠그므로 일괄 업로드 작업이 서로 차단됩니다.

Google Ads 스크립트는 단일 일괄 업로드 작업 내에서 실행을 최적화할 수 있습니다. 따라서 가장 간단한 방법은 계정당 한 번에 하나의 일괄 업로드 작업만 실행하는 것입니다. 계정당 일괄 업로드를 두 개 이상 실행하려면 최적의 성능을 위해 일괄 업로드가 상호 배타적인 캠페인 목록(및 하위 항목)에 대해 작동해야 합니다.

보고서

보고서를 사용하여 통계 가져오기

많은 양의 항목과 관련 통계를 검색하려면 표준 AdsApp 메서드보다 보고서를 사용하는 것이 더 좋은 경우가 많습니다. 보고서를 사용하는 것이 좋은 이유는 다음과 같습니다.

  • 보고서를 사용하면 대규모 검색어에 대해 더 나은 실적을 얻을 수 있습니다.
  • 보고서가 정상적인 가져오기 할당량에 도달하지 않습니다.

지난 달에 50회 이상의 클릭이 발생한 모든 키워드의 클릭수, 노출수, 비용, 텍스트를 가져오는 다음 코드 스니펫을 비교해보세요.

코딩 접근 방식 코드 스니펫
보고서 사용 (권장) 
  report = AdsApp.search(
      'SELECT ' +
      '   ad_group_criterion.keyword.text, ' +
      '   metrics.clicks, ' +
      '   metrics.cost_micros, ' +
      '   metrics.impressions ' +
      'FROM ' +
      '   keyword_view ' +
      'WHERE ' +
      '   segments.date DURING LAST_MONTH ' +
      '   AND metrics.clicks > 50');
  while (report.hasNext()) {
    var row = report.next();
    Logger.log('Keyword: %s Impressions: %s ' +
        'Clicks: %s Cost: %s',
        row.adGroupCriterion.keyword.text,
        row.metrics.impressions,
        row.metrics.clicks,
        row.metrics.cost);
  }
AdsApp 반복자 사용 (권장하지 않음) 
var keywords = AdsApp.keywords()
    .withCondition('metrics.clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();
while (keywords.hasNext()) {
  var keyword = keywords.next();
  var stats = keyword.getStatsFor('LAST_MONTH');
  Logger.log('Keyword: %s Impressions: %s ' +
      'Clicks: %s Cost: %s',
      keyword.getText(),
      stats.getImpressions(),
      stats.getClicks(),
      stats.getCost());
}

두 번째 접근 방식은 키워드를 반복하고 한 번에 한 항목씩 통계를 검색하므로 선호되지 않습니다. 이 경우 보고서가 더 빠르게 실행됩니다. 한 번의 호출로 모든 데이터를 가져오고 필요에 따라 스트리밍하기 때문입니다. 또한 두 번째 접근 방식에서 검색된 키워드는 get() 호출을 사용하여 검색된 항목 수에 대한 스크립트 할당량에 포함됩니다.

보고서 대신 검색 사용

이 보고 메서드는 이전 인프라용으로 빌드되었으며, GAQL을 사용하더라도 결과를 플랫 형식으로 출력합니다. 즉, 이전 스타일과 일치하도록 쿼리 결과를 변환해야 합니다. 이전 스타일은 일부 필드에서 지원되지 않으며 각 호출에 오버헤드를 추가합니다.

대신 검색을 사용하여 새 Google Ads API 보고의 모든 기능을 활용하는 것이 좋습니다.

AWQL보다 GAQL을 선호

AWQL은 보고서 쿼리 및 withCondition 호출에서 계속 지원되지만 실제 AWQL과 완전히 호환되지 않는 변환 레이어를 통해 실행됩니다. 쿼리를 완벽하게 제어하려면 GAQL을 사용해야 합니다.

번역하려는 기존 AWQL 쿼리가 있는 경우 쿼리 이전 도구를 사용하면 됩니다.

필요한 것보다 더 많은 행을 선택하지 마세요.

보고서 (및 선택기)의 실행 속도는 보고서를 반복하는지와 관계없이 보고서에서 반환하는 총 행 수를 기준으로 합니다. 즉, 사용 사례에 맞게 결과 집합을 최대한 최소화하기 위해 항상 특정 필터를 사용해야 합니다.

예를 들어 입찰가가 특정 범위를 벗어나는 광고 그룹을 찾으려는 경우 모든 광고 그룹을 가져오고 관심 없는 광고그룹을 무시하는 것보다는 두 개의 별도 쿼리를 실행하는 것이 더 빠릅니다. 최저 기준점 미만인 입찰가에 대한 쿼리와 최고 기준점보다 높은 입찰가를 위한 쿼리를 실행하는 것이 더 빠릅니다.

코딩 접근 방식 코드 스니펫
쿼리 2개 사용 (권장) 
var adGroups = []
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group WHERE ad_group.cpc_bid_micros < 1000000');

while (report.hasNext()) {
  var row = report.next();
  adGroups.push(row.adGroup);
}
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group WHERE ad_group.cpc_bid_micros > 2000000');

while (report.hasNext()) {
  var row = report.next();
  adGroups.push(row.adGroup);
}
일반 검색어에서 필터링 (권장하지 않음) 
var adGroups = []
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group');

while (report.hasNext()) {
  var row = report.next();
  var cpcBidMicros = row.adGroup.cpcBidMicros;
  if (cpcBidMicros < 1000000 || cpcBidMicros > 2000000) {
    adGroups.push(row.adGroup);
  }
}

광고 관리자 (MCC) 스크립트

직렬 실행보다 launchInParallel을 선호함

관리자 계정용 스크립트를 작성할 때는 가능하면 연속 실행 대신 executeInParallel()를 사용하세요. executeInParallel()를 사용하면 스크립트의 처리 시간 (최대 1시간)과 계정당 최대 30분(직렬 실행에 총 30분)을 사용할 수 있습니다. 자세한 내용은 한도 페이지를 참고하세요.

스프레드시트

스프레드시트 업데이트 시 일괄 작업 사용

스프레드시트를 업데이트할 때는 한 번에 하나의 셀을 업데이트하는 메서드보다 일괄 작업 메서드(예: getRange())를 사용해 보세요.

스프레드시트에서 프랙털 패턴을 생성하는 다음 코드 스니펫을 살펴보세요.

코딩 접근 방식 코드 스니펫
한 번의 호출로 셀 범위 업데이트하기 (권장) 
var colors = new Array(100);
for (var y = 0; y < 100; y++) {
  xcoord = xmin;
  colors[y] = new Array(100);
  for (var x = 0; x < 100; x++) {
    colors[y][x] = getColor_(xcoord, ycoord);
    xcoord += xincrement;
  }
  ycoord -= yincrement;
}
sheet.getRange(1, 1, 100, 100).setBackgroundColors(colors);
한 번에 하나의 셀 업데이트 (권장하지 않음) 
var cell = sheet.getRange('a1');
for (var y = 0; y < 100; y++) {
  xcoord = xmin;
  for (var x = 0; x < 100; x++) {
    var c = getColor_(xcoord, ycoord);
    cell.offset(y, x).setBackgroundColor(c);
    xcoord += xincrement;
  }
  ycoord -= yincrement;
  SpreadsheetApp.flush();
}

Google 스프레드시트는 값을 캐시하여 두 번째 코드 스니펫을 최적화하려고 하지만 API 호출 수로 인해 첫 번째 스니펫에 비해 성능이 좋지 않습니다.