대부분의 Google Ads 항목은 식별자를 반환하는 getId() 메서드를 노출합니다. 대부분의 경우 반드시 필요한 것은 아니지만 다음과 같은 경우 ID가 유용할 수 있습니다.
- 보고서 사용
- ID는 보고서 행을 실제 Google Ads 항목에 연결하는 좋은 방법입니다.
- 외부 데이터 스토어와의 매핑 유지
- 자체 데이터베이스에 ID 기반 정보가 이미 저장되어 있을 수 있습니다.
- 성능 향상을 꾀하는 경우
ID로 가져오는 것이 다른 방법보다 빠른 경우가 많습니다. 단일 항목을 가져오는 코드도 약간 더 쉽습니다.
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // versus let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
고유성
캠페인 ID와 광고 그룹 ID는 고유합니다. 두 캠페인 또는 광고 그룹이 동일한 ID를 공유하지 않습니다. 그러나 광고와 키워드에는 복합 ID가 있습니다. 키워드의 고유 식별자는 광고 그룹 ID와 키워드 ID의 조합입니다.
마찬가지로 광고의 고유 식별자는 광고 그룹 ID와 광고 ID의 조합입니다. 이는 selector.withIds()가 호출되는 방식에 영향을 미칩니다.
캠페인 및 광고 그룹의 경우 selector.withIds()는 숫자 배열을 예상합니다.
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
하지만 광고 및 키워드의 경우 selector.withIds()에 두 요소 배열의 배열이 필요하며, 첫 번째 요소는 광고 그룹 ID입니다. 다음 스니펫은 광고 그룹에서 키워드 3개를 가져옵니다.
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
광고를 가져올 때도 동일한 구조가 적용됩니다.
임시 ID
여러 작업이 포함된 mutate 요청을 사용하는 경우 API 응답을 받을 때까지 전체 리소스 이름을 사용할 수 없으므로 임시 ID를 사용하여 리소스를 서로 연결해야 하는 경우가 있습니다. 임시 ID는 -1로 시작하는 음수여야 하며 동일한 mutate 요청 내에서 반복될 수 없습니다. 임시 ID를 효과적으로 사용하려면 중복된 임시 ID를 만들지 않도록 코드를 작성해야 합니다.
let nextId = -1;
function getNextTempId() {
const ret = nextId;
nextId -= 1;
return ret;
}
getNextTempId를 연속으로 호출할 때마다 이전보다 1만큼 작은 숫자가 반환됩니다. 모든 임시 ID는 음수여야 하므로 -1부터 시작합니다.
임시 ID는 작업 또는 mutate 요청 간에 기억되지 않습니다. 이전 mutate 요청에서 생성된 리소스를 참조하려면 실제 리소스 이름을 사용합니다.