Большинство объектов Google Рекламы предоставляют метод getId() , который возвращает их идентификатор. Хотя в большинстве случаев идентификаторы не являются строго необходимыми, они могут пригодиться, когда
- Работа с отчетами
- Идентификаторы предоставляют хороший способ связать строку отчета с реальным объектом Google Рекламы.
- Поддержание сопоставления с внешним хранилищем данных
- Возможно, у вас уже есть информация на основе идентификатора, хранящаяся в вашей собственной базе данных.
- Ищу немного повышения производительности
Извлечение по идентификаторам часто происходит быстрее, чем альтернативные варианты. Код для получения одного объекта также немного проще:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Уникальность
Идентификаторы кампаний и групп объявлений уникальны: никакие две кампании или группы объявлений никогда не будут иметь один и тот же идентификатор. Однако объявления и ключевые слова имеют составные идентификаторы: уникальный идентификатор ключевого слова представляет собой комбинацию идентификатора группы объявлений и идентификатора ключевого слова. Аналогично, уникальный идентификатор объявления представляет собой комбинацию идентификатора группы объявлений и идентификатора объявления. Это влияет на способ вызова selector.withIds() .
Для кампаний и групп объявлений selector.withIds() ожидает массив чисел:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Однако для объявлений и ключевых слов selector.withIds() требует массива из двух элементов, первым элементом которого является идентификатор группы объявлений. Следующий фрагмент извлекает три ключевых слова из группы объявлений:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
Та же конструкция применяется при получении рекламы.