Package google.ads.searchads360.v0.resources

string

Название ресурса стратегии доступных ставок. Названия ресурсов AccessibleBiddingStrategy имеют следующий формат:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

Идентификатор стратегии торгов.

string

Название стратегии торгов.

BiddingStrategyType

Тип стратегии торгов.

int64

Идентификатор клиента, которому принадлежит стратегия назначения ставок.

string

descriptive_name — имя клиента, которому принадлежит стратегия назначения ставок.

MaximizeConversionValue

Автоматизированная стратегия назначения ставок, которая поможет получить максимальную конверсию от ваших кампаний при оптимальном расходовании бюджета.

MaximizeConversions

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

TargetCpa

Стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

TargetImpressionShare

Стратегия назначения ставок, которая автоматически оптимизирует показ в соответствии с выбранным процентом показов.

TargetRoas

Стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

TargetSpend

Стратегия назначения ставок, которая позволяет установить ставки таким образом, чтобы получить максимальное количество кликов в рамках вашего бюджета.

double

Параметр «Целевая рентабельность рекламных расходов» (ROAS). Если он установлен, стратегия назначения ставок будет максимизировать доход, усредняя при этом целевую рентабельность рекламных расходов. Если целевой показатель ROAS высок, стратегия назначения ставок может не позволить потратить весь бюджет. Если целевой показатель ROAS не установлен, стратегия назначения ставок будет стремиться достичь максимально возможного показателя ROAS для бюджета.

int64

Вариант целевой стоимости привлечения клиента (CPA). Это средняя сумма, которую вы хотели бы потратить на одно привлечение клиента.

int64

Вариант целевой стоимости привлечения клиента (CPA). Это средняя сумма, которую вы хотели бы потратить на одно привлечение клиента.

int64

Средний целевой показатель CPA. Этот показатель должен быть больше или равен минимальному количеству оплачиваемых единиц в зависимости от валюты счета.

TargetImpressionShareLocation

Целевое местоположение на странице результатов поиска.

int64

Выбранная доля рекламных объявлений, которые будут показаны в целевом местоположении, в микросекундах. Например, 1% равен 10 000.

int64

Максимальная ставка CPC, которую может установить автоматизированная система торгов. Это обязательное поле, заполняемое рекламодателем, которое устанавливает верхний предел и задается в локальных микросхемах.

double

Выбранный показатель выручки (на основе данных о конверсии) на единицу потраченных средств.

int64

Целевой показатель расходов, при котором планируется максимизировать количество кликов. Участник, устанавливающий целевую ставку TargetSpend, будет пытаться потратить меньшее из этого значения или естественной суммы ограничения расходов. Если не указано иное, в качестве целевого показателя расходов используется бюджет. Это поле устарело и больше не должно использоваться. Подробнее см. https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html .

int64

Максимально допустимая ставка, устанавливаемая стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией.

string

Название ресурса объявления. Названия ресурсов объявления имеют следующий формат:

customers/{customer_id}/ads/{ad_id}

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений для рекламы.

FinalAppUrl

Список конечных URL-адресов приложений, которые будут использоваться на мобильных устройствах, если у пользователя установлено данное приложение.

string

Список возможных конечных URL-адресов для мобильных устройств после всех междоменных перенаправлений для рекламы.

AdType

Тип рекламы.

SyntheticContentInfo

Информация о синтетическом контенте для объявления. Обновление с помощью поля synthetic_content_info возможно только для объявлений определенных типов.

Допустимые значения AdType : * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD

int64

Идентификатор объявления.

string

Шаблон URL для создания URL-адреса отслеживания.

string

Суффикс, используемый при формировании конечного URL-адреса.

string

URL-адрес, который отображается в описании объявления для некоторых форматов объявлений.

string

Название объявления. Оно используется только для идентификации объявления. Название не обязательно должно быть уникальным и не влияет на показ объявления.

SearchAds360TextAdInfo

Подробности, касающиеся текстового объявления.

SearchAds360ExpandedTextAdInfo

Подробности, касающиеся расширенного текстового объявления. Расширенные текстовые объявления устарели. Используйте вместо них SearchAds360ResponsiveSearchAd .

SearchAds360ResponsiveSearchAdInfo

Подробности, касающиеся адаптивной поисковой рекламы.

SearchAds360ProductAdInfo

Подробности, касающиеся рекламного объявления о товаре.

SearchAds360ExpandedDynamicSearchAdInfo

Подробности, касающиеся расширенной динамической поисковой рекламы.

string

Имя ресурса группы объявлений. Имена ресурсов группы объявлений имеют следующий формат:

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

Статус группы объявлений.

AdGroupType

Тип группы объявлений.

AdGroupAdRotationMode

Режим ротации объявлений в группе объявлений.

string

Отметка времени создания этой группы объявлений. Отметка времени указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

TargetingSetting

Настройки для целевых функций.

string

Названия ресурсов меток, прикрепленных к этой группе объявлений.

string

Названия ресурсов эффективных меток, прикрепленных к этой группе объявлений. Эффективная метка — это метка, унаследованная или непосредственно присвоенная этой группе объявлений.

string

Идентификатор группы объявлений во внешнем аккаунте рекламной системы. Это поле предназначено только для аккаунтов, не относящихся к Google Ads, например, Yahoo Japan, Microsoft, Baidu и т. д. Для аккаунтов Google Ads используйте вместо этого "ad_group.id".

string

Дата начала показа рекламы в этой группе объявлений. По умолчанию показ начинается сейчас или в дату начала показа, в зависимости от того, какая дата позже. Если это поле задано, показ рекламы начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook Gateway.

Формат: ГГГГ-ММ-ДД. Пример: 2019-03-14

string

Дата окончания показа объявлений в группе объявлений. По умолчанию группа объявлений завершает свою работу в указанную дату. Если это поле задано, то группа объявлений завершает свою работу в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook Gateway.

Формат: ГГГГ-ММ-ДД. Пример: 2019-03-14

string

Язык объявлений и ключевых слов в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Подробнее: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

Дата и время последнего изменения этой группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

int64

Идентификатор группы объявлений.

string

Название группы объявлений.

Это обязательное поле, и его нельзя оставлять пустым при создании групп объявлений.

Оно должно содержать менее 255 символов полной ширины в кодировке UTF-8.

В тексте не должно содержаться нулевых символов (код 0x0), символов перевода строки (код 0xA) или возврата каретки (код 0xD).

string

Шаблон URL для создания URL-адреса отслеживания.

int64

Максимальная ставка CPC (стоимость за клик). Это поле используется, если эффективная стратегия назначения ставок для группы объявлений — «Ручная CPC». Это поле неприменимо и будет проигнорировано, если в кампании группы объявлений используется стратегия назначения ставок «Портфолио».

AdGroupEngineStatus

Статус поисковой системы для группы объявлений.

string

Шаблон URL-адреса для добавления параметров к итоговому URL-адресу.

string

Имя ресурса объявления. Имена ресурсов объявлений в группах объявлений имеют следующий формат:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

Статус объявления.

Ad

Реклама.

string

Отметка времени создания данного объявления в группе объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".

string

Названия ресурсов меток, прикрепленных к этому объявлению группы.

string

Названия ресурсов эффективных меток, прикрепленных к этому объявлению. Эффективная метка — это метка, унаследованная или непосредственно присвоенная этому объявлению.

string

Идентификатор объявления во внешнем аккаунте поисковой системы. Это поле предназначено только для аккаунтов Search Ads 360, например, Yahoo Japan, Microsoft, Baidu и т. д. Для аккаунтов, не относящихся к Search Ads 360, используйте вместо этого "ad_group_ad.ad.id".

AdGroupAdEngineStatus

Дополнительный статус объявления во внешнем аккаунте поисковой системы. Возможные статусы (в зависимости от типа внешнего аккаунта): активно, подходит, ожидает проверки и т. д.

string

Дата и время последнего изменения данного объявления в группе объявлений. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

string

Имя ресурса метки эффективного объявления группы объявлений. Имена ресурсов метки эффективного объявления группы объявлений имеют вид: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

string

Группа объявлений, к которой прикреплена соответствующая метка.

string

Эффективная метка, присвоенная объявлению в группе объявлений.

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

string

Имя ресурса метки объявления группы объявлений. Имена ресурсов меток объявлений группы объявлений имеют вид: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

string

Группа объявлений, к которой прикреплена метка.

string

Метка, присвоенная объявлению в группе объявлений.

int64

Идентификатор клиента, которому принадлежит этикетка.

string

Имя ресурса группы объявлений. Имена ресурсов AdGroupAsset имеют следующий формат:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

Обязательно. Группа объявлений, к которой привязан данный ресурс.

string

Обязательно. Объект, связанный с группой объявлений.

AssetLinkStatus

Статус актива группы объявлений.

string

Имя ресурса набора ресурсов группы объявлений. Имена ресурсов набора ресурсов группы объявлений имеют следующий формат:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

Группа объявлений, к которой привязан данный набор ресурсов.

string

Набор ресурсов, связанный с группой объявлений.

AssetSetLinkStatus

Статус набора ресурсов группы объявлений. Только для чтения.

string

Имя ресурса представления аудитории группы объявлений. Имена ресурсов представления аудитории группы объявлений имеют следующий формат:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

Имя ресурса модификатора ставок группы объявлений. Имена ресурсов модификатора ставок группы объявлений имеют следующий формат:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

Модификатор для ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 - 10,0. Используйте 0, чтобы отказаться от типа устройства.

DeviceInfo

Критерий устройства.

string

Имя ресурса критерия группы объявлений. Имена ресурсов критериев группы объявлений имеют следующий формат:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

string

Временная метка момента создания этого критерия для группы объявлений. Временная метка указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

AdGroupCriterionStatus

Статус критерия.

Это статус сущности критерия группы объявлений, установленный клиентом. Примечание: отчеты пользовательского интерфейса могут содержать дополнительную информацию, влияющую на возможность запуска критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, может по-прежнему отображаться как включенный в пользовательском интерфейсе. Например, кампании по умолчанию показываются пользователям всех возрастных групп, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку она имеет право видеть объявления; но AdGroupCriterion.status будет отображаться как «удаленная», поскольку положительный критерий не был добавлен.

QualityInfo

Информация о качестве критерия.

CriterionType

Тип критерия.

string

Названия ресурсов меток, прикрепленных к этому критерию группы объявлений.

string

Названия ресурсов эффективных меток, присвоенных данному критерию группы объявлений. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данному критерию группы объявлений.

PositionEstimates

Оценки критериев для заявок на различных позициях.

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений для рекламы.

string

Список возможных конечных URL-адресов для мобильных устройств после всех междоменных перенаправлений.

CustomParameter

Список сопоставлений, используемых для замены пользовательских параметров в шаблонах tracking_url_template , final_urls или mobile_final_urls .

string

Идентификатор критерия группы объявлений во внешнем аккаунте рекламной системы. Это поле предназначено только для аккаунтов, отличных от Google Ads, например, Yahoo Japan, Microsoft, Baidu и т. д. Для сущностей Google Ads используйте вместо этого "ad_group_criterion.criterion_id".

string

Дата и время последнего изменения данного критерия группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".

int64

Идентификатор критерия.

string

Группа объявлений, к которой относится данный критерий.

bool

Следует ли применять данный критерий в качестве целевого ( false ) или исключать ( true ).

Это поле неизменяемо. Чтобы изменить критерий с положительного на отрицательный, удалите его, а затем добавьте заново.

double

Модификатор для ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы.

int64

Ставка CPC (стоимость за клик).

int64

Эффективная ставка CPC (стоимость за клик).

AdGroupCriterionEngineStatus

Критерий «Статус движка для группы объявлений».

string

Шаблон URL-адреса для добавления параметров к итоговому URL-адресу.

string

Шаблон URL для создания URL-адреса отслеживания.

KeywordInfo

Ключевое слово.

ListingGroupInfo

Группа объявлений.

AgeRangeInfo

Возрастной диапазон.

GenderInfo

Пол.

UserListInfo

Список пользователей.

WebpageInfo

Веб-страница

LocationInfo

Расположение.

int64

Расчетная ставка CPC, необходимая для отображения объявления в верхней части первой страницы результатов поиска.

int32

Оценка качества.

Это поле может быть незаполнено, если у Google недостаточно информации для определения значения.

string

Имя ресурса эффективной метки критерия группы объявлений. Имена ресурсов эффективной метки критерия группы объявлений имеют вид: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

string

Критерий группы объявлений, к которому относится эффективная метка.

string

Эффективная метка, присвоенная критерию группы объявлений.

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

string

Имя ресурса метки критерия группы объявлений. Имена ресурсов меток критерия группы объявлений имеют вид: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

string

Критерий рекламной группы, к которому относится метка.

string

Метка, присвоенная критерию группы объявлений.

int64

Идентификатор клиента, которому принадлежит этикетка.

string

Имя ресурса эффективной метки группы объявлений. Имена ресурсов эффективных меток групп объявлений имеют вид: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

string

Группа объявлений, к которой относится соответствующая метка.

string

Эффективная метка, присвоенная группе объявлений.

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

string

Имя ресурса метки группы объявлений. Имена ресурсов меток групп объявлений имеют вид: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}

string

Группа объявлений, к которой относится данная метка.

string

Метка, присвоенная группе объявлений.

int64

Идентификатор клиента, которому принадлежит этикетка.

string

Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют следующий формат:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

Название ресурса актива. Названия ресурсов активов имеют следующий формат:

customers/{customer_id}/assets/{asset_id}

AssetType

Тип актива.

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений.

string

Список возможных конечных URL-адресов для мобильных устройств после всех междоменных перенаправлений.

CustomParameter

Список сопоставлений, используемых для замены пользовательских параметров URL-адресов в шаблонах tracking_url_template, final_urls и/или final_mobile_urls.

AssetStatus

Состояние актива.

string

Отметка времени создания данного актива. Отметка времени указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

string

Дата и время последнего изменения данного актива. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

SyntheticContentInfo

Информация о синтетическом содержимом для ресурса. Обновление с помощью поля synthetic_content_info возможно только для ресурсов с определенными типами.

Допустимые значения AssetType : * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

int64

Идентификатор актива.

string

Необязательное название актива.

string

Шаблон URL для создания URL-адреса отслеживания.

string

Шаблон URL-адреса для добавления параметров к URL-адресам целевых страниц, используемых с параллельным отслеживанием.

AssetEngineStatus

Состояние двигателя для данного актива.

YoutubeVideoAsset

Видеоматериал для YouTube.

ImageAsset

Графический ресурс.

TextAsset

Текстовый ресурс.

UnifiedCalloutAsset

Единый элемент всплывающей подсказки.

UnifiedSitelinkAsset

Единый ресурс для создания ссылок на сайт.

UnifiedPageFeedAsset

Единый ресурс ленты новостей.

MobileAppAsset

Ресурс для мобильного приложения.

UnifiedCallAsset

Единый актив для колл-опционов.

CallToActionAsset

Призыв к действию.

UnifiedLocationAsset

Единый объект местоположения.

string

Название ресурса группы активов. Названия ресурсов групп активов имеют следующий формат:

customers/{customer_id}/assetGroups/{asset_group_id}

int64

Идентификатор группы активов.

string

Кампания, с которой связана данная группа активов. Актив, который связан с данной группой активов.

string

Обязательно. Название группы активов. Обязательно. Минимальная длина должна составлять 1, максимальная — 128 символов. Название должно быть уникальным в рамках одной кампании.

string

Список конечных URL-адресов после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отключена соответствующая опция.

string

Список конечных мобильных URL-адресов после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отключена соответствующая опция.

AssetGroupStatus

Состояние группы активов.

string

Первая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в рекламе.

string

Вторая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в рекламе. Это поле можно задать только в том случае, если задан параметр path1.

AdStrength

Общая эффективность рекламы в этой группе активов.

string

Название ресурса группы активов. Название ресурса группы активов имеет следующий формат:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

Группа активов, с которой связана данная группа активов.

string

Актив, с которым связана данная группа активов.

AssetFieldType

Описание места размещения актива в группе активов. Например: ЗАГОЛОВОК, ВИДЕО НА YOUTUBE и т. д.

AssetLinkStatus

Состояние связи между активом и группой активов.

AssetUsage

Обслуживаемые активы.

string

Имя ресурса фильтра группы списка активов. Имя ресурса фильтра группы списка активов имеет следующий формат:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

Группа активов, к которой относится данный фильтр группы активов.

int64

Идентификатор ListingGroupFilter.

ListingGroupFilterType

Тип узла фильтра группы объявлений.

ListingGroupFilterVertical

Вертикаль, которую представляет собой дерево текущих узлов. Все узлы в одном дереве должны принадлежать одной и той же вертикали.

ListingGroupFilterDimension

Значение измерения, с помощью которого эта группа элементов уточняет свою родительскую группу. Не определено для корневой группы.

string

Имя ресурса подразделения родительской группы объявлений. Для корневого узла фильтра группы объявлений значение равно null.

ListingGroupFilterDimensionPath

Путь измерений, определяющий фильтр для этой группы объявлений.

string

Имя ресурса сигнала группы активов. Имя ресурса сигнала группы активов имеет следующий формат:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

string

Группа активов, к которой относится данный сигнал группы активов.

AudienceInfo

Сигнал аудитории, который будет использоваться в рамках рекламной кампании Performance Max.

string

Имя ресурса представления «Топ-комбинация группы активов». Имена ресурсов представления «Топ-комбинация группы активов» имеют следующий формат: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

AssetGroupAssetCombinationData

Наилучшие сочетания активов, которые действовали сообща.

int64

Идентификатор набора активов.

string

Название ресурса набора активов. Названия ресурсов набора активов имеют следующий формат:

customers/{customer_id}/assetSets/{asset_set_id}

string

Имя ресурса набора активов. Имена ресурсов набора активов имеют следующий вид:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

Набор активов, к которому привязан данный набор активов.

string

Актив, к которому привязан данный набор активов.

AssetSetAssetStatus

Статус набора активов. Только для чтения.

string

Название ресурса аудитории. Названия аудитории имеют следующий формат:

customers/{customer_id}/audiences/{audience_id}

int64

Идентификация аудитории.

string

Обязательно. Название целевой аудитории. Оно должно быть уникальным для всех целевых аудиторий. Минимальная длина — 1, максимальная — 255 символов.

string

Описание целевой аудитории.

string

Название ресурса стратегии назначения ставок. Названия ресурсов стратегии назначения ставок имеют следующий формат:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

Состояние стратегии участия в тендере.

Это поле доступно только для чтения.

BiddingStrategyType

Тип стратегии назначения ставок. Создайте стратегию назначения ставок, задав схему назначения ставок.

Это поле доступно только для чтения.

string

Валюта, используемая в стратегии торгов (трехбуквенный код ISO 4217).

Для стратегий назначения ставок в управляемых клиентах эту валюту можно установить при создании, и по умолчанию она будет соответствовать валюте управляемого клиента. Для обслуживаемых клиентов это поле установить нельзя; все стратегии в обслуживаемом клиенте неявно используют валюту обслуживающего клиента. Во всех случаях поле effective_currency_code возвращает валюту, используемую стратегией.

int64

Идентификатор стратегии торгов.

string

Название стратегии назначения ставок. Все стратегии назначения ставок в рамках одного аккаунта должны иметь разные названия.

Длина этой строки должна быть в диапазоне от 1 до 255 байт в кодировке UTF-8 (без обрезки).

string

Валюта, используемая в стратегии торгов (трехбуквенный код ISO 4217).

Для стратегий назначения ставок в менеджерах-клиентах это валюта, установленная рекламодателем при создании стратегии. Для обслуживающих клиентов это валютный код клиента.

Показатели стратегии назначения ставок приводятся в этой валюте.

Это поле доступно только для чтения.

int64

Количество кампаний, связанных с данной стратегией торгов.

Это поле доступно только для чтения.

int64

Количество неудалённых кампаний, связанных с данной стратегией торгов.

Это поле доступно только для чтения.

EnhancedCpc

Стратегия назначения ставок, которая повышает ставки для кликов, которые, по всей видимости, с большей вероятностью приведут к конверсии, и понижает их для кликов, которые, по всей видимости, с меньшей вероятностью приведут к конверсии.

MaximizeConversionValue

Автоматизированная стратегия назначения ставок, которая поможет получить максимальную конверсию от ваших кампаний при оптимальном расходовании бюджета.

MaximizeConversions

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

TargetCpa

Стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

TargetImpressionShare

Стратегия назначения ставок, которая автоматически оптимизирует показ в соответствии с выбранным процентом показов.

TargetOutrankShare

Стратегия назначения ставок, устанавливающая ставки на основе целевой доли аукционов, в которых рекламодатель должен превзойти конкретного конкурента. Это поле устарело. Создание новой стратегии назначения ставок с этим полем или прикрепление стратегий назначения ставок с этим полем к кампании приведет к ошибке. Допускаются изменения стратегий, в которых эта схема уже заполнена.

TargetRoas

Стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

TargetSpend

Стратегия назначения ставок, которая позволяет установить ставки таким образом, чтобы получить максимальное количество кликов в рамках вашего бюджета.

string

Название ресурса кампании. Названия ресурсов кампании имеют следующий формат:

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

Текущее состояние кампании.

При добавлении новой кампании ее статус по умолчанию устанавливается на «ВКЛЮЧЕНО».

CampaignServingStatus

Статус показа рекламы в рамках кампании.

BiddingStrategySystemStatus

Системный статус стратегии назначения ставок в рамках кампании.

AdServingOptimizationStatus

Статус оптимизации показа рекламы в рамках кампании.

AdvertisingChannelType

Основной целевой объект для показа объявлений в рамках кампании. Параметры таргетинга можно уточнить в network_settings .

Это поле обязательно для заполнения и не должно быть пустым при создании новых кампаний.

Этот параметр можно установить только при создании кампаний. После создания кампании изменить это поле невозможно.

AdvertisingChannelSubType

Дополнительное поле для уточнения параметра advertising_channel_type . Должно быть допустимым подтипом родительского типа канала.

Этот параметр можно установить только при создании кампаний. После создания кампании изменить это поле невозможно.

CustomParameter

Список сопоставлений, используемых для замены пользовательских параметров в шаблонах tracking_url_template , final_urls или mobile_final_urls .

RealTimeBiddingSetting

Настройки для торгов в реальном времени — функция, доступная только для кампаний, ориентированных на рекламную сеть Ad Exchange.

NetworkSettings

Настройки сети для кампании.

DynamicSearchAdsSetting

Настройки для управления динамической поисковой рекламой (DSA).

ShoppingSetting

Настройки для управления торговыми кампаниями.

GeoTargetTypeSetting

Настройки геотаргетинга рекламы.

string

Названия ресурсов эффективных меток, присвоенных данной кампании. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данной кампании.

string

Названия ресурсов этикеток, прикрепленных к этой кампании.

BiddingStrategyType

Тип стратегии торгов.

Стратегию назначения ставок можно создать, задав либо схему назначения ставок для создания стандартной стратегии, либо поле bidding_strategy для создания портфельной стратегии назначения ставок.

Это поле доступно только для чтения.

string

Имя ресурса AccessibleBiddingStrategy, представляющего собой доступное только для чтения представление неограниченных атрибутов прикрепленной стратегии назначения ставок для портфеля, идентифицируемой параметром 'bidding_strategy'. Пусто, если кампания не использует стратегию портфеля. Неограниченные атрибуты стратегии доступны всем клиентам, с которыми стратегия используется совместно, и считываются из ресурса AccessibleBiddingStrategy. В отличие от этого, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Ограниченные атрибуты можно считывать только из ресурса BiddingStrategy.

FrequencyCapEntry

Список, ограничивающий частоту показа рекламы данной кампании каждому пользователю.

SelectiveOptimization

Выборочная настройка оптимизации для этой кампании, включающая набор действий по конверсии, на основе которых будет производиться оптимизация кампании. Эта функция применяется только к кампаниям приложений, в которых в качестве AdvertisingChannelType используется MULTI_CHANNEL, а в качестве AdvertisingChannelSubType — APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT.

OptimizationGoalSetting

Настройка целей оптимизации для данной кампании, включающая набор типов целей оптимизации.

TrackingSetting

Настройки отслеживания информации на уровне кампании.

string

ID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.

AssetFieldType

The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. create_time will be deprecated in v1. Use creation_time instead.

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

string

The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

AssetSetType

Types of feeds that are attached directly to this campaign.

int64

The ID of the campaign.

string

The name of the campaign.

This field is required and should not be empty when creating new campaigns.

It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.

string

The URL template for constructing a tracking URL.

string

The resource name of the campaign budget of the campaign.

string

The date when campaign started in serving customer's timezone in YYYY-MM-DD format.

string

The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.

string

Suffix used to append query parameters to landing pages that are served with parallel tracking.

bool

Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.

string

The resource name of the portfolio bidding strategy used by the campaign.

ManualCpa

Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.

ManualCpc

Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.

ManualCpm

Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.

MaximizeConversions

Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.

MaximizeConversionValue

Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.

TargetCpa

Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

TargetImpressionShare

Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.

TargetRoas

Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).

TargetSpend

Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.

PercentCpc

Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.

TargetCpm

A bidding strategy that automatically optimizes cost per thousand impressions.

string

Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

string

Required. The language code specifying the language of the domain, for example, "en".

bool

Whether the campaign uses advertiser supplied URLs exclusively.

PositiveGeoTargetType

The setting used for positive geotargeting in this particular campaign.

NegativeGeoTargetType

The setting used for negative geotargeting in this particular campaign.

bool

Whether ads will be served with google.com search results.

bool

Whether ads will be served on sites in the Google Search Partners Network (requires target_google_search to also be true ).

bool

Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.

bool

Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use target_search_network for that instead.

OptimizationGoalType

The list of optimization goal types.

string

The selected set of resource names for conversion actions for optimizing this campaign.

string

Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated sales_country in the two-letter country code ( XX ) format, the feed_label field should be used instead. For more information see the feed label support article.

bool

Whether to target Vehicle Listing inventory.

int64

ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.

string

Sales country of products to include in the campaign.

int32

Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.

bool

Whether to include local products.

string

The url used for dynamic tracking.

string

The resource name of the campaign asset. CampaignAsset resource names have the form:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

Status of the campaign asset.

string

The campaign to which the asset is linked.

string

The asset which is linked to the campaign.

string

The resource name of the campaign asset set. Asset set asset resource names have the form:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

string

The campaign to which this asset set is linked.

string

The asset set which is linked to the campaign.

AssetSetLinkStatus

The status of the campaign asset set asset. Read-only.

string

The resource name of the campaign audience view. Campaign audience view resource names have the form:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

The resource name of the campaign budget. Campaign budget resource names have the form:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

BudgetDeliveryMethod

The delivery method that determines the rate at which the campaign budget is spent.

Defaults to STANDARD if unspecified in a create operation.

BudgetPeriod

Period over which to spend the budget. Defaults to DAILY if not specified.

int64

The average daily amount to be spent by the campaign. This field is used when the CampaignBudget period is set to DAILY , which is the default.

Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount.

This field is mutually exclusive with 'total_amount_micros'. Only one of 'amount_micros' or 'total_amount_micros' should be set.

string

The resource name of the campaign criterion. Campaign criterion resource names have the form:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

The display name of the criterion.

This field is ignored for mutates.

CriterionType

The type of the criterion.

CampaignCriterionStatus

The status of the criterion.

string

The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

int64

The ID of the criterion.

This field is ignored during mutate.

float

The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.

bool

Whether to target ( false ) or exclude ( true ) the criterion.

KeywordInfo

Ключевое слово.

LocationInfo

Расположение.

DeviceInfo

Устройство.

AgeRangeInfo

Age range.

GenderInfo

Пол.

UserListInfo

User List.

LanguageInfo

Язык.

WebpageInfo

Веб-страница.

LocationGroupInfo

Location Group

string

Name of the resource. CampaignEffectivelabel resource names have the form: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

string

The campaign to which the effective label is attached.

string

The effective label assigned to the campaign.

int64

The ID of the Customer which owns the effective label.

string

Name of the resource. Campaign label resource names have the form: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}

string

The campaign to which the label is attached.

string

The label assigned to the campaign.

int64

The ID of the Customer which owns the label.

string

The resource name of the Cart data sales view. Cart data sales view resource names have the form: customers/{customer_id}/cartDataSalesView

string

The resource name of the conversion. Conversion resource names have the form:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

The ID of the conversion

int64

Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.

int64

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

int64

Ad ID. A value of 0 indicates that the ad is unattributed.

string

A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.

int64

The Search Ads 360 visit ID that the conversion is attributed to.

string

For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlight_order_id column depending on the advertiser's Floodlight instructions.

string

The ID of the product clicked on.

ProductChannel

The sales channel of the product that was clicked on: Online or Local.

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

string

The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.

AttributionType

What the conversion is attributed to: Visit or Keyword+Ad.

string

The timestamp of the conversion event.

string

The timestamp of the last time the conversion was modified.

string

The timestamp of the visit that the conversion is attributed to.

int64

The quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.

int64

The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.

int64

The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.

string

The Floodlight order ID provided by the advertiser for the conversion.

ConversionStatus

The status of the conversion, either ENABLED or REMOVED..

int64

ID of the asset which was interacted with during the conversion event.

AssetFieldType

Asset field type of the conversion event.

string

The resource name of the conversion action. Conversion action resource names have the form:

customers/{customer_id}/conversionActions/{conversion_action_id}

string

Timestamp of the Floodlight activity's creation, formatted in ISO 8601.

ConversionActionStatus

The status of this conversion action for conversion event accrual.

ConversionActionType

The type of this conversion action.

ConversionActionCategory

The category of conversions reported for this conversion action.

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

AttributionModelSettings

Settings related to this conversion action's attribution model.

FloodlightSettings

Floodlight settings for Floodlight conversion types.

int64

The ID of the conversion action.

string

The name of the conversion action.

This field is required and should not be empty when creating new conversion actions.

bool

If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional.

string

The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.

bool

Whether this conversion action should be included in the "client_account_conversions" metric.

bool

Whether this conversion action should be included in the "conversions" metric.

int64

The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.

string

App ID for an app conversion action.

AttributionModel

The attribution model type of this conversion action.

DataDrivenModelStatus

The status of the data-driven attribution model for the conversion action.

string

String used to identify a Floodlight activity group when reporting conversions.

string

String used to identify a Floodlight activity when reporting conversions.

int64

ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).

double

The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.

string

The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.

bool

Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.

string

The resource name of the conversion custom variable. Conversion custom variable resource names have the form:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

The ID of the conversion custom variable.

string

Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.

string

Required. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".

ConversionCustomVariableStatus

The status of the conversion custom variable for conversion event accrual.

string

The resource name of the customer that owns the conversion custom variable.

ConversionCustomVariableFamily

Family of the conversion custom variable.

ConversionCustomVariableCardinality

Cardinality of the conversion custom variable.

FloodlightConversionCustomVariableInfo

Fields for Search Ads 360 floodlight conversion custom variables.

int64

The IDs of custom columns that use this conversion custom variable.

FloodlightVariableType

Floodlight variable type defined in Search Ads 360.

FloodlightVariableDataType

Floodlight variable data type defined in Search Ads 360.

bool

Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709 .

ConversionTrackingStatus

Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.

bool

Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.

string

The resource name of the customer where conversions are created and managed. This field is read-only.

int64

The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.

int64

The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.

int64

The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.

string

The resource name of the custom column. Custom column resource names have the form:

customers/{customer_id}/customColumns/{custom_column_id}

int64

ID of the custom column.

string

User-defined name of the custom column.

string

User-defined description of the custom column.

CustomColumnValueType

The type of the result value of the custom column.

bool

True when the custom column is referring to one or more attributes.

bool

True when the custom column is referring to one or more metrics.

bool

True when the custom column is available to be used in the query of SearchAds360Service.Search and SearchAds360Service.SearchStream.

string

The list of the referenced system columns of this custom column. For example, A custom column "sum of impressions and clicks" has referenced system columns of {"metrics.clicks", "metrics.impressions"}.

CustomColumnRenderType

How the result value of the custom column should be interpreted.

string

The resource name of the customer. Customer resource names have the form:

customers/{customer_id}

ConversionTrackingSetting

Conversion tracking setting for a customer.

AccountType

Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

AccountStatus

Account status, for example, Enabled, Paused, Removed, etc.

string

The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

string

ID of the account in the external engine account.

CustomerStatus

The status of the customer.

string

The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

int64

The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.

string

The descriptive name of the manager.

int64

The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.

string

The descriptive name of the sub manager.

int64

The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.

string

The descriptive name of the associate manager.

AccountLevelType

The account level of the customer: Manager, Sub-manager, Associate manager, Service account.

int64

The ID of the customer.

string

Optional, non-unique descriptive name of the customer.

string

The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.

string

The local timezone ID of the customer.

string

The URL template for constructing a tracking URL out of parameters.

string

The URL template for appending params to the final URL.

bool

Whether auto-tagging is enabled for the customer.

bool

Whether the customer is a manager.

string

The resource name of the customer asset. CustomerAsset resource names have the form:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

Required. The asset which is linked to the customer.

AssetLinkStatus

Status of the customer asset.

string

The resource name of the customer asset set. Asset set asset resource names have the form:

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

The asset set which is linked to the customer.

string

The customer to which this asset set is linked.

AssetSetLinkStatus

The status of the customer asset set asset. Read-only.

string

The resource name of the customer client. CustomerClient resource names have the form: customers/{customer_id}/customerClients/{client_customer_id}

string

The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form:

customers/{customer_id}/labels/{label_id}

CustomerStatus

The status of the client customer. Read only.

string

The resource name of the client-customer which is linked to the given customer. Read only.

bool

Specifies whether this is a hidden account.

Read only.

int64

Distance between given customer and client. For self link, the level value will be 0. Read only.

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

bool

Identifies if the client is a test account. Read only.

bool

Identifies if the client is a manager. Read only.

string

Descriptive name for the client. Read only.

string

Currency code (for example, 'USD', 'EUR') for the client. Read only.

int64

The ID of the client customer. Read only.

string

Name of the resource. CustomerManagerLink resource names have the form: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}

ManagerLinkStatus

Status of the link between the customer and the manager.

string

The manager customer linked to the customer.

int64

ID of the customer-manager link. This field is read only.

string

The timestamp when the CustomerManagerLink was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

int64

ID of the Campaign Manager advertiser associated with this customer.

int64

ID of the Campaign Manager network associated with this customer.

string

Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

string

The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

string

The dynamically selected landing page URL of the impression.

This field is read-only.

string

The resource name of the gender view. Gender view resource names have the form:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

The resource name of the geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

Geo target constant status.

int64

The ID of the geo target constant.

string

Geo target constant English name.

string

The ISO-3166-1 alpha-2 country code that is associated with the target.

string

Geo target constant target type.

string

The fully qualified English name, consisting of the target's name and that of its parent and country.

string

The resource name of the parent geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{parent_geo_target_constant_id}

string

The resource name of the keyword view. Keyword view resource names have the form:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

Name of the resource. Label resource names have the form: customers/{owner_customer_id}/labels/{label_id}

LabelStatus

Status of the label. Read only.

TextLabel

A type of label displaying text on a colored background.

int64

ID of the label. Read only.

string

The name of the label.

This field is required and should not be empty when creating a new label.

The length of this string should be between 1 and 80, inclusive.

string

The resource name of the language constant. Language constant resource names have the form:

languageConstants/{criterion_id}

int64

The ID of the language constant.

string

The language code, for example, "en_US", "en_AU", "es", "fr", etc.

string

The full name of the language in English, for example, "English (US)", "Spanish", etc.

bool

Whether the language is targetable.

ProductBiddingCategory

Bidding category of a product offer.

ProductBrand

Brand of a product offer.

ProductChannel

Locality of a product offer.

ProductCondition

Condition of a product offer.

ProductCustomAttribute

Custom attribute of a product offer.

ProductItemId

Item id of a product offer.

ProductType

Type of a product offer.

ListingGroupFilterBiddingCategoryLevel

Indicates the level of the category in the taxonomy.

int64

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436

string

String value of the product brand.

ListingGroupFilterProductChannel

Value of the locality.

ListingGroupFilterProductCondition

Value of the condition.

ListingGroupFilterCustomAttributeIndex

Indicates the index of the custom attribute.

string

String value of the product custom attribute.

string

Value of the id.

ListingGroupFilterProductTypeLevel

Level of the type.

string

Value of the type.

ListingGroupFilterDimension

The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.

string

The resource name of the location view. Location view resource names have the form:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

The resource name of the product bidding category. Product bidding category resource names have the form:

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

Level of the product bidding category.

ProductBiddingCategoryStatus

Status of the product bidding category.

int64

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

string

Two-letter upper-case country code of the product bidding category.

string

Resource name of the parent product bidding category.

string

Language code of the product bidding category.

string

Display value of the product bidding category localized according to language_code.

string

The resource name of the product group view. Product group view resource names have the form:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

The resource name of the artifact. Artifact resource names have the form:

SearchAds360Fields/{name}

SearchAds360FieldCategory

The category of the artifact.

string

The names of all resources, segments, and metrics that are selectable with the described artifact.

string

The names of all resources that are selectable with the described artifact. Fields from these resources do not segment metrics when included in search queries.

This field is only set for artifacts whose category is RESOURCE.

string

This field lists the names of all metrics that are selectable with the described artifact when it is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.

string

This field lists the names of all artifacts, whether a segment or another resource, that segment metrics when included in search queries and when the described artifact is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.

string

Values the artifact can assume if it is a field of type ENUM.

This field is only set for artifacts of category SEGMENT or ATTRIBUTE.

SearchAds360FieldDataType

This field determines the operators that can be used with the artifact in WHERE clauses.

string

The name of the artifact.

bool

Whether the artifact can be used in a SELECT clause in search queries.

bool

Whether the artifact can be used in a WHERE clause in search queries.

bool

Whether the artifact can be used in a ORDER BY clause in search queries.

string

The URL of proto describing the artifact's data type.

bool

Whether the field artifact is repeated.

string

The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView

string

The resource name of the user list. User list resource names have the form:

customers/{customer_id}/userLists/{user_list_id}

UserListType

Type of this list.

This field is read-only.

int64

Id of the user list.

string

Name of this user list. Unique per user list, except in some cases where a user list of the same name has access_reason set to SHARED .

string

The resource name of the user location view. UserLocation view resource names have the form:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

Criterion Id for the country.

bool

Indicates whether location was targeted or not.

string

The resource name of the visit. Visit resource names have the form:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

The ID of the visit.

int64

Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.

int64

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

int64

Ad ID. A value of 0 indicates that the ad is unattributed.

string

A unique string for each visit that is passed to the landing page as the click id URL parameter.

string

The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

string

The ID of the product clicked on.

ProductChannel

The sales channel of the product that was clicked on: Online or Local.

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

string

The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.

int64

ID of the asset which was interacted with during the visit event.

AssetFieldType

Asset field type of the visit event.

string

The resource name of the webpage view. Webpage view resource names have the form:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}