Package google.ads.searchads360.v0.resources

Индекс

• AccessibleBiddingStrategy (сообщение)
• AccessibleBiddingStrategy.MaximizeConversionValue (сообщение)
• AccessibleBiddingStrategy.MaximizeConversions (сообщение)
• AccessibleBiddingStrategy.TargetCpa (сообщение)
• AccessibleBiddingStrategy.TargetImpressionShare (сообщение)
• AccessibleBiddingStrategy.TargetRoas (сообщение)
• AccessibleBiddingStrategy.TargetSpend (сообщение)
• Ad (сообщение)
• AdGroup (сообщение)
• AdGroupAd (сообщение)
• AdGroupAdEffectiveLabel (сообщение)
• AdGroupAdLabel (сообщение)
• AdGroupAsset (сообщение)
• AdGroupAssetSet (сообщение)
• AdGroupAudienceView (сообщение)
• AdGroupBidModifier (сообщение)
• AdGroupCriterion (сообщение)
• AdGroupCriterion.PositionEstimates (сообщение)
• AdGroupCriterion.QualityInfo (сообщение)
• AdGroupCriterionEffectiveLabel (сообщение)
• AdGroupCriterionLabel (сообщение)
• AdGroupEffectiveLabel (сообщение)
• AdGroupLabel (сообщение)
• AgeRangeView (сообщение)
• Asset (сообщение)
• AssetGroup (сообщение)
• AssetGroupAsset (сообщение)
• AssetGroupAssetCombinationData (сообщение)
• AssetGroupListingGroupFilter (сообщение)
• AssetGroupSignal (сообщение)
• AssetGroupTopCombinationView (сообщение)
• AssetSet (сообщение)
• AssetSetAsset (сообщение)
• Audience (сообщение)
• BiddingStrategy (сообщение)
• Campaign (сообщение)
• Campaign.DynamicSearchAdsSetting (сообщение)
• Campaign.GeoTargetTypeSetting (сообщение)
• Campaign.NetworkSettings (сообщение)
• Campaign.OptimizationGoalSetting (сообщение)
• Campaign.SelectiveOptimization (сообщение)
• Campaign.ShoppingSetting (сообщение)
• Campaign.TrackingSetting (сообщение)
• CampaignAsset (сообщение)
• CampaignAssetSet (сообщение)
• CampaignAudienceView (сообщение)
• CampaignBudget (сообщение)
• CampaignCriterion (сообщение)
• CampaignEffectiveLabel (сообщение)
• CampaignLabel (сообщение)
• CartDataSalesView (сообщение)
• Conversion (сообщение)
• ConversionAction (сообщение)
• ConversionAction.AttributionModelSettings (сообщение)
• ConversionAction.FloodlightSettings (сообщение)
• ConversionAction.ValueSettings (сообщение)
• ConversionCustomVariable (сообщение)
• ConversionCustomVariable.FloodlightConversionCustomVariableInfo (сообщение)
• ConversionTrackingSetting (сообщение)
• CustomColumn (сообщение)
• Customer (сообщение)
• CustomerAsset (сообщение)
• CustomerAssetSet (сообщение)
• CustomerClient (сообщение)
• CustomerManagerLink (сообщение)
• DoubleClickCampaignManagerSetting (сообщение)
• DynamicSearchAdsSearchTermView (сообщение)
• GenderView (сообщение)
• GeoTargetConstant (сообщение)
• KeywordView (сообщение)
• Label (сообщение)
• LanguageConstant (сообщение)
• ListingGroupFilterDimension (сообщение)
• ListingGroupFilterDimension.ProductBiddingCategory (сообщение)
• ListingGroupFilterDimension.ProductBrand (сообщение)
• ListingGroupFilterDimension.ProductChannel (сообщение)
• ListingGroupFilterDimension.ProductCondition (сообщение)
• ListingGroupFilterDimension.ProductCustomAttribute (сообщение)
• ListingGroupFilterDimension.ProductItemId (сообщение)
• ListingGroupFilterDimension.ProductType (сообщение)
• ListingGroupFilterDimensionPath (сообщение)
• LocationView (сообщение)
• ProductBiddingCategoryConstant (сообщение)
• ProductGroupView (сообщение)
• SearchAds360Field (сообщение)
• ShoppingPerformanceView (сообщение)
• UserList (сообщение)
• UserLocationView (сообщение)
• Visit (сообщение)
• WebpageView (сообщение)

Доступная стратегия торгов

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

В отличие от BiddingStrategy, этот ресурс включает стратегии, принадлежащие менеджерам клиента и общие для этого клиента, в дополнение к стратегиям, принадлежащим этому клиенту. Этот ресурс не предоставляет метрики и только раскрывает ограниченное подмножество атрибутов BiddingStrategy.

Поля
resource_name	string Имя ресурса доступной стратегии торгов. Имена ресурсов AccessibleBiddingStrategy имеют вид: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 Идентификатор стратегии торгов.
name	string Название стратегии торгов.
type	BiddingStrategyType Тип стратегии торгов.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит стратегия торгов.
owner_descriptive_name	string descriptive_name Заказчика, которому принадлежит стратегия торгов.
scheme поля Союза. Схема торгов. Можно задать только одну схему. scheme может быть только одной из следующих:
maximize_conversion_value	MaximizeConversionValue Автоматизированная стратегия назначения ставок, которая поможет вам получить максимальную ценность конверсии от ваших кампаний, тратя при этом весь ваш бюджет.
maximize_conversions	MaximizeConversions Автоматизированная стратегия назначения ставок, которая поможет вам получить максимум конверсий в ваших кампаниях, не теряя при этом свой бюджет.
target_cpa	TargetCpa Стратегия назначения ставок, которая устанавливает ставки, помогающие получить как можно больше конверсий по установленной вами целевой цене за конверсию (CPA).
target_impression_share	TargetImpressionShare Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов.
target_roas	TargetRoas Стратегия назначения ставок, которая помогает вам максимизировать доход, достигая при этом определенной целевой рентабельности инвестиций в рекламу (ROAS).
target_spend	TargetSpend Стратегия ставок, которая устанавливает ставки таким образом, чтобы получить как можно больше кликов в рамках вашего бюджета.

МаксимизироватьЦенностьКонверсии

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

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

МаксимизироватьКонверсии

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

Поля
target_cpa	int64 Параметр «Целевая стоимость за приобретение» (CPA). Это средняя сумма, которую вы хотели бы потратить на приобретение.
target_cpa_micros	int64 Параметр «Целевая стоимость за приобретение» (CPA). Это средняя сумма, которую вы хотели бы потратить на приобретение.

TargetCpa

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

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

TargetImpressionShare

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

Поля
location	TargetImpressionShareLocation Целевое местоположение на странице результатов поиска.
location_fraction_micros	int64 Выбранная доля объявлений, которые будут показаны в целевом местоположении в микро. Например, 1% равен 10 000.
cpc_bid_ceiling_micros	int64 Самая высокая ставка CPC, которую разрешено указывать автоматизированной системе торгов. Это обязательное поле, вводимое рекламодателем, который устанавливает потолок и указывается в локальных микро.

TargetRoas

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

Поля
target_roas	double Выбранный доход (на основе данных о конверсиях) на единицу расходов.

TargetSpend

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

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

Объявление

Реклама.

Поля
resource_name	string Имя ресурса объявления. Имена ресурсов объявления имеют вид: customers/{customer_id}/ads/{ad_id}
final_urls[]	string Список возможных конечных URL-адресов после всех кросс-доменных перенаправлений для объявления.
type	AdType Тип объявления.
id	int64 Идентификатор объявления.
display_url	string URL-адрес, который отображается в описании объявления для некоторых форматов объявлений.
name	string Имя объявления. Используется только для идентификации объявления. Оно не обязательно должно быть уникальным и не влияет на обслуживаемое объявление. Поле имени в настоящее время поддерживается только для DisplayUploadAd, ImageAd, ShoppingComparisonListingAd и VideoAd.
Поле объединения ad_data . Подробности, относящиеся к типу объявления. Должно быть установлено ровно одно значение. ad_data может быть только одним из следующих:
text_ad	SearchAds360TextAdInfo Подробная информация, касающаяся текстового объявления.
expanded_text_ad	SearchAds360ExpandedTextAdInfo Подробная информация о развернутом текстовом объявлении.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo Подробная информация об адаптивной поисковой рекламе.
product_ad	SearchAds360ProductAdInfo Подробная информация, касающаяся рекламы продукта.
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo Подробная информация о расширенном динамическом поисковом объявлении.

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

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

Поля
resource_name	string Название ресурса группы рекламы. Имена ресурсов AD Group имеют форму: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus Статус группы объявлений.
type	AdGroupType Тип группы объявлений.
ad_rotation_mode	AdGroupAdRotationMode Режим ротации объявлений группы объявлений.
creation_time	string Временная метка, когда была создана эта ad_group. Временная метка находится в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss".
targeting_setting	TargetingSetting Настройка для таргетинга связанных функций.
labels[]	string Названия ресурсов меток, прикрепленных к этой группе объявлений.
effective_labels[]	string Имена ресурсов эффективных меток, прикрепленных к этой группе объявлений. Эффективная метка — это метка, унаследованная или напрямую назначенная этой группе объявлений.
engine_id	string Идентификатор группы объявлений во внешнем аккаунте движка. Это поле предназначено только для аккаунтов, отличных от Google Ads, например Yahoo Japan, Microsoft, Baidu и т. д. Для сущности Google Ads используйте вместо этого "ad_group.id".
start_date	string Дата, когда эта группа объявлений начинает показывать объявления. По умолчанию группа объявлений начинается сейчас или в дату начала группы объявлений, в зависимости от того, что наступит позже. Если это поле задано, то группа объявлений начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook gateway. Формат: ГГГГ-ММ-ДД Пример: 2019-03-14
end_date	string Дата, когда группа объявлений завершает показ объявлений. По умолчанию группа объявлений заканчивается в дату окончания группы объявлений. Если это поле задано, то группа объявлений заканчивается в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook gateway. Формат: ГГГГ-ММ-ДД Пример: 2019-03-14
language_code	string Язык объявлений и ключевые слова в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Подробнее: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string Дата и время последнего изменения этой группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".
id	int64 Идентификатор группы объявлений.
name	string Название группы объявлений. Это поле обязательно и не должно быть пустым при создании новых групп объявлений. Он должен содержать менее 255 символов полной ширины UTF-8. Он не должен содержать никаких нулевых символов (кодовая точка 0x0), символов перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD).
cpc_bid_micros	int64 Максимальная ставка CPC (цена за клик).
engine_status	AdGroupEngineStatus Статус движка для группы объявлений.

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

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

Поля
resource_name	string Имя ресурса объявления. Имена ресурсов объявлений группы объявлений имеют вид: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus Статус объявления.
ad	Ad Реклама.
creation_time	string Временная метка создания этого ad_group_ad. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".
labels[]	string Названия ресурсов меток, прикрепленных к данной группе объявлений.
effective_labels[]	string Имена ресурсов эффективных меток, прикрепленных к этому объявлению. Эффективная метка — это метка, унаследованная или напрямую назначенная этому объявлению.
engine_id	string Идентификатор объявления во внешнем аккаунте движка. Это поле предназначено только для аккаунта Search Ads 360, например Yahoo Japan, Microsoft, Baidu и т. д. Для сущности, не относящейся к Search Ads 360, используйте вместо этого "ad_group_ad.ad.id".
engine_status	AdGroupAdEngineStatus Дополнительный статус объявления в учетной записи внешнего движка. Возможные статусы (в зависимости от типа внешней учетной записи) включают активное, приемлемое, ожидающее рассмотрения и т. д.
last_modified_time	string Дата и время последнего изменения этого объявления группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdEffectiveLabel

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

Поля
resource_name	string Имя ресурса эффективной метки объявления группы объявлений. Имена ресурсов эффективной метки объявления группы объявлений имеют вид: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Группа объявлений, к которой прикреплена эффективная метка.
label	string Эффективная метка, присвоенная группе объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит действующая метка.

AdGroupAdLabel

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

Поля
resource_name	string Имя ресурса метки объявления группы объявлений. Имена ресурсов метки объявления группы объявлений имеют вид: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Группа объявлений, к которой прикреплена метка.
label	string Метка, присвоенная группе объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит этикетка.

AdGroupAsset

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

Поля
resource_name	string Имя ресурса актива группы объявлений. Имена ресурсов AdGroupAsset имеют вид: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Требуется AD Group, с которой связан актив.
asset	string Обязательно. Актив, связанный с группой объявлений.
status	AssetLinkStatus Статус актива группы объявлений.

AdGroupAssetSet

AdGroupAssetSet — это связь между группой объявлений и набором активов. Создание AdGroupAssetSet связывает набор активов с группой объявлений.

Поля
resource_name	string Имя ресурса набора активов группы объявлений. Имена ресурсов набора активов группы объявлений имеют форму: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string Группа объявлений, с которой связан этот набор активов.
asset_set	string Набор активов, связанный с группой объявлений.
status	AssetSetLinkStatus Статус набора активов группы объявлений. Только для чтения.

AdGroupAudienceView

Представление аудитории группы объявлений. Включает данные об эффективности из интересов и списков ремаркетинга для рекламы в контекстно-медийной сети и сети YouTube, а также списков ремаркетинга для поисковой рекламы (RLSA), агрегированные на уровне аудитории.

Поля
resource_name	string Имя ресурса представления аудитории группы объявлений. Имена ресурсов представления аудитории группы объявлений имеют вид: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

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

Поля
resource_name	string Имя ресурса модификатора ставок группы объявлений. Имена ресурсов модификатора ставок группы объявлений имеют вид: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double Модификатор для ставки при соответствии критерию. Модификатор должен быть в диапазоне: 0,1 - 10,0. Диапазон составляет 1,0 - 6,0 для PreferredContent. Используйте 0, чтобы отказаться от типа устройства.
criterion поля объединения. Критерий модификатора ставок этой группы объявлений. Требуется в операциях создания, начиная с версии 5. criterion может быть только одним из следующих:
device	DeviceInfo Критерий устройства.

AdGroupCriterion

Критерий группы объявлений. Отчет ad_group_criterion возвращает только критерии, которые были явно добавлены в группу объявлений.

Поля
resource_name	string Имя ресурса критерия группы объявлений. Имена ресурсов критерия группы объявлений имеют вид: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string Временная метка, когда был создан этот критерий группы объявлений. Временная метка находится в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss".
status	AdGroupCriterionStatus Статус критерия. Это статус сущности критерия группы объявлений, установленный клиентом. Примечание: отчеты пользовательского интерфейса могут включать дополнительную информацию, которая влияет на то, может ли критерий быть запущен. В некоторых случаях критерий, УДАЛЕННЫЙ в API, может по-прежнему отображаться как включенный в пользовательском интерфейсе. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. Пользовательский интерфейс будет отображать каждый возрастной диапазон как «включенный», поскольку они имеют право видеть рекламу; но AdGroupCriterion.status будет отображать «удален», поскольку не было добавлено ни одного положительного критерия.
quality_info	QualityInfo Информация о качестве критерия.
type	CriterionType Тип критерия.
labels[]	string Названия ресурсов меток, прикрепленных к этому критерию группы объявлений.
effective_labels[]	string Имена ресурсов эффективных меток, прикрепленных к этому критерию группы объявлений. Эффективная метка — это метка, унаследованная или напрямую назначенная этому критерию группы объявлений.
position_estimates	PositionEstimates Оценки критериальных ставок на различных позициях.
final_urls[]	string Список возможных конечных URL-адресов после всех кросс-доменных перенаправлений для объявления.
engine_id	string Идентификатор критерия группы объявлений во внешнем аккаунте движка. Это поле предназначено только для аккаунтов, отличных от Google Ads, например Yahoo Japan, Microsoft, Baidu и т. д. Для сущности Google Ads используйте вместо этого "ad_group_criterion.criterion_id".
last_modified_time	string Дата и время последнего изменения критерия группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".
criterion_id	int64 Идентификатор критерия.
ad_group	string Группа объявлений, к которой принадлежит критерий.
negative	bool Следует ли использовать критерий в качестве целевого ( false ) или исключить ( true ). Это поле неизменяемо. Чтобы изменить критерий с положительного на отрицательный, удалите его, а затем добавьте заново.
bid_modifier	double Модификатор для ставки при совпадении критерия. Модификатор должен быть в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы.
cpc_bid_micros	int64 Ставка CPC (цена за клик).
effective_cpc_bid_micros	int64 Эффективная ставка CPC (цена за клик).
engine_status	AdGroupCriterionEngineStatus Статус двигателя для критерия группы объявлений.
final_url_suffix	string Шаблон URL для добавления параметров к конечному URL.
tracking_url_template	string Шаблон URL для построения URL-адреса отслеживания.
criterion поля объединения. Критерий группы объявлений. Необходимо задать только один критерий. criterion может быть только одним из следующих:
keyword	KeywordInfo Ключевое слово.
listing_group	ListingGroupInfo Группа листинга.
age_range	AgeRangeInfo Возрастной диапазон.
gender	GenderInfo Пол.
user_list	UserListInfo Список пользователей.
webpage	WebpageInfo Веб-страница
location	LocationInfo Расположение.

ПозицияОценки

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

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

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

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

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

AdGroupCriterionEffectiveLabel

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

Поля
resource_name	string Имя ресурса эффективной метки критерия группы объявлений. Имена ресурсов эффективной метки критерия группы объявлений имеют вид: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Критерий группы объявлений, к которому прикреплена эффективная метка.
label	string Эффективная метка, присвоенная критерию группы объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит действующая метка.

AdGroupCriterionLabel

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

Поля
resource_name	string Имя ресурса метки критерия группы объявлений. Имена ресурсов метки критерия группы объявлений имеют вид: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Критерий группы объявлений, к которому прикреплена метка.
label	string Метка, присвоенная критерию группы объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит этикетка.

AdGroupEffectiveLabel

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

Поля
resource_name	string Имя ресурса эффективной метки группы объявлений. Имена ресурсов эффективной метки группы объявлений имеют вид: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string Группа объявлений, к которой прикреплена эффективная метка.
label	string Эффективная метка, присвоенная группе объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит действующая метка.

AdGroupLabel

Связь между группой объявлений и меткой.

Поля
resource_name	string Имя ресурса метки группы объявлений. Имена ресурсов метки группы объявлений имеют вид: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Группа объявлений, к которой прикреплена метка.
label	string Метка, присвоенная группе объявлений.
owner_customer_id	int64 Идентификатор клиента, которому принадлежит этикетка.

ВозрастДиапазонПросмотр

Представление возрастного диапазона.

Поля
resource_name	string Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют форму: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Объект

Актив — это часть рекламы, которая может быть общей для нескольких объявлений. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Активы неизменяемы и не могут быть удалены. Чтобы остановить показ актива, удалите его из сущности, которая его использует.

Поля
resource_name	string Имя ресурса актива. Имена ресурсов актива имеют форму: customers/{customer_id}/assets/{asset_id}
type	AssetType Тип актива.
final_urls[]	string Список возможных конечных URL-адресов после всех кросс-доменных перенаправлений.
status	AssetStatus Статус актива.
creation_time	string Временная метка, когда был создан этот актив. Временная метка находится в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss".
last_modified_time	string Дата и время последнего изменения этого актива. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".
id	int64 Идентификатор актива.
name	string Необязательное имя актива.
tracking_url_template	string Шаблон URL для построения URL-адреса отслеживания.
engine_status	AssetEngineStatus Статус двигателя для актива.
Поле объединения asset_data . Конкретный тип актива asset_data может быть только одним из следующих:
youtube_video_asset	YoutubeVideoAsset Видеоматериал YouTube.
image_asset	ImageAsset Имиджевый актив.
text_asset	TextAsset Текстовый актив.
callout_asset	UnifiedCalloutAsset Унифицированный актив выноски.
sitelink_asset	UnifiedSitelinkAsset Унифицированный ресурс дополнительных ссылок.
page_feed_asset	UnifiedPageFeedAsset Унифицированный ресурс подачи страниц.
mobile_app_asset	MobileAppAsset Актив мобильного приложения.
call_asset	UnifiedCallAsset Единый актив вызова.
call_to_action_asset	CallToActionAsset Актив призыва к действию.
location_asset	UnifiedLocationAsset Единый локационный актив.

Группа активов

Группа активов. AssetGroupAsset используется для привязки актива к группе активов. AssetGroupSignal используется для привязки сигнала к группе активов.

Поля
resource_name	string Название ресурса группы активов. Имена ресурсов группы Asset Group имеют форму: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 Идентификатор группы активов.
campaign	string Кампания, с которой связана эта группа активов. Актив, который связан с группой активов.
name	string Обязательно. Имя группы активов. Обязательно. Оно должно иметь минимальную длину 1 и максимальную длину 128. Оно должно быть уникальным в рамках кампании.
final_urls[]	string Список конечных URL после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отказано.
final_mobile_urls[]	string Список конечных мобильных URL после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отказано.
status	AssetGroupStatus Статус группы активов.
path1	string Первая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в объявлении.
path2	string Вторая часть текста, которая может отображаться в добавлении к URL, отображаемому в объявлении. Это поле может быть установлено только при установке path1.
ad_strength	AdStrength Общая эффективность рекламы этой группы активов.

Группа активовАктив

AssetGroupAsset — это связь между активом и группой активов. Добавление AssetGroupAsset связывает актив с группой активов.

Поля
resource_name	string Имя ресурса группы активов. Имя ресурса группы активов имеет вид: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string Группа активов, с которой связан данный актив группы активов.
asset	string Актив, с которым связан данный актив группы активов.
field_type	AssetFieldType Описание размещения актива в группе активов. Например: HEADLINE, YOUTUBE_VIDEO и т.д.
status	AssetLinkStatus Статус связи между активом и группой активов.

AssetGroupAssetCombinationData

Данные о комбинации активов группы активов

Поля
asset_combination_served_assets[]	AssetUsage Обслуживаемые активы.

ГруппаАктивовГруппаЛистингаФильтр

AssetGroupListingGroupFilter представляет собой узел дерева фильтров группы листинга в группе активов.

Поля
resource_name	string Имя ресурса фильтра группы списка активов. Имя ресурса фильтра группы списка активов имеет форму: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string Группа активов, к которой относится данный фильтр группы активов.
id	int64 Идентификатор ListingGroupFilter.
type	ListingGroupFilterType Тип узла фильтра группы листинга.
vertical	ListingGroupFilterVertical Вертикаль, которую представляет текущее дерево узлов. Все узлы в одном дереве должны принадлежать к одной вертикали.
case_value	ListingGroupFilterDimension Значение измерения, с которым эта группа листинга уточняет своего родителя. Не определено для корневой группы.
parent_listing_group_filter	string Имя ресурса родительского подразделения группы листинга. Null для корневого узла фильтра группы листинга.
path	ListingGroupFilterDimensionPath Путь измерений, определяющих этот фильтр группы листинга.

AssetGroupSignal

AssetGroupSignal представляет собой сигнал в группе активов. Наличие сигнала сообщает кампании Performance Max, кто, скорее всего, конвертируется. Performance Max использует сигнал для поиска новых людей с похожим или более сильным намерением для поиска конверсий в Поиске, Дисплее, Видео и т. д.

Поля
resource_name	string Имя ресурса сигнала группы активов. Имя ресурса сигнала группы активов имеет вид: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string Группа активов, к которой принадлежит данный сигнал группы активов.
signal поля объединения. Сигнал группы активов. signal может быть только одним из следующих:
audience	AudienceInfo Сигнал аудитории, который будет использоваться в кампании по достижению максимальной эффективности.

AssetGroupTopCombinationView

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

Поля
resource_name	string Имя ресурса вида верхней комбинации группы активов. Имена ресурсов вида верхней комбинации AssetGroup имеют форму: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData Лучшие комбинации активов, которые использовались вместе.

Набор активов

Набор активов, представляющий собой коллекцию активов. Используйте AssetSetAsset для привязки актива к набору активов.

Поля
id	int64 Идентификатор набора активов.
resource_name	string Имя ресурса набора активов. Имена ресурсов набора активов имеют вид: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset — это связь между активом и набором активов. Добавление AssetSetAsset связывает актив с набором активов.

Поля
resource_name	string Имя ресурса набора активов. Имена ресурсов набора активов имеют вид: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string Набор активов, с которым связан данный набор активов.
asset	string Актив, с которым связан данный набор активов.
status	AssetSetAssetStatus Статус набора активов. Только для чтения.

Аудитория

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

Поля
resource_name	string Имя ресурса аудитории. Имя аудитории имеет вид: customers/{customer_id}/audiences/{audience_id}
id	int64 Идентификатор аудитории.
name	string Обязательно. Имя аудитории. Оно должно быть уникальным среди всех аудиторий. Оно должно иметь минимальную длину 1 и максимальную длину 255.
description	string Описание этой аудитории.

Стратегия торгов

Стратегия торгов.

Поля
resource_name	string Имя ресурса стратегии торгов. Имена ресурсов стратегии торгов имеют вид: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus Статус стратегии торгов. Это поле доступно только для чтения.
type	BiddingStrategyType Тип стратегии торгов. Создайте стратегию торгов, установив схему торгов. Это поле доступно только для чтения.
currency_code	string Валюта, используемая стратегией торгов (трехбуквенный код ISO 4217). Для стратегий ставок в клиентах-менеджерах эта валюта может быть установлена ​​при создании и по умолчанию равна валюте клиента-менеджера. Для обслуживающих клиентов это поле не может быть установлено; все стратегии в обслуживающем клиенте неявно используют валюту обслуживающего клиента. Во всех случаях поле effective_currency_code возвращает валюту, используемую стратегией.
id	int64 Идентификатор стратегии торгов.
name	string Название стратегии торгов. Все стратегии торгов в рамках аккаунта должны иметь отдельные названия. Длина этой строки должна быть от 1 до 255 включительно в байтах UTF-8 (обрезанная).
effective_currency_code	string Валюта, используемая стратегией торгов (трехбуквенный код ISO 4217). Для стратегий ставок в менеджерских клиентах это валюта, установленная рекламодателем при создании стратегии. Для обслуживающих клиентов это currency_code клиента. Показатели стратегии торгов отображаются в этой валюте. Это поле доступно только для чтения.
campaign_count	int64 Количество кампаний, привязанных к данной стратегии ставок. Это поле доступно только для чтения.
non_removed_campaign_count	int64 Количество неудалённых кампаний, привязанных к данной стратегии ставок. Это поле доступно только для чтения.
scheme поля Союза. Схема торгов. Можно задать только одну схему. scheme может быть только одной из следующих:
enhanced_cpc	EnhancedCpc Стратегия торгов, которая поднимает ставки на клики, которые, кажется, с большей вероятностью приведут к преобразованию и снижает их для кликов, где они кажутся менее вероятными.
maximize_conversion_value	MaximizeConversionValue Автоматизированная стратегия назначения ставок, которая поможет вам получить максимальную ценность конверсии от ваших кампаний, тратя при этом весь ваш бюджет.
maximize_conversions	MaximizeConversions Автоматизированная стратегия назначения ставок, которая поможет вам получить максимум конверсий в ваших кампаниях, не теряя при этом свой бюджет.
target_cpa	TargetCpa Стратегия назначения ставок, которая устанавливает ставки, помогающие получить как можно больше конверсий по установленной вами целевой цене за конверсию (CPA).
target_impression_share	TargetImpressionShare Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов.
target_outrank_share	TargetOutrankShare Стратегия ставок, которая устанавливает ставки на основе целевой доли аукционов, где рекламодатель должен превзойти определенного конкурента. Это поле устарело. Создание новой стратегии ставок с этим полем или присоединение стратегий ставок с этим полем к кампании не удастся. Разрешены мутации в стратегии, в которых эта схема уже заполнена.
target_roas	TargetRoas Стратегия назначения ставок, которая помогает вам максимизировать доход, достигая при этом определенной целевой рентабельности инвестиций в рекламу (ROAS).
target_spend	TargetSpend Стратегия ставок, которая устанавливает ставки таким образом, чтобы получить как можно больше кликов в рамках вашего бюджета.

Кампания

Кампания.

Поля
resource_name	string Имя ресурса кампании. Имена ресурсов кампании имеют вид: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus Статус кампании. При добавлении новой кампании статус по умолчанию — ВКЛЮЧЕНО.
serving_status	CampaignServingStatus Статус показа рекламы в кампании.
bidding_strategy_system_status	BiddingStrategySystemStatus Системный статус стратегии назначения ставок кампании.
ad_serving_optimization_status	AdServingOptimizationStatus Статус оптимизации показа рекламы в кампании.
advertising_channel_type	AdvertisingChannelType Основная цель показа объявлений в рамках кампании. Параметры таргетинга можно уточнить в network_settings . Это поле обязательно и не должно быть пустым при создании новых кампаний. Можно задать только при создании кампаний. После создания кампании поле изменить нельзя.
advertising_channel_sub_type	AdvertisingChannelSubType Необязательное уточнение advertising_channel_type . Должен быть допустимым подтипом родительского типа канала. Можно задать только при создании кампаний. После создания кампании поле изменить нельзя.
url_custom_parameters[]	CustomParameter Список сопоставлений, используемых для замены пользовательских тегов параметров в tracking_url_template , final_urls или mobile_final_urls .
real_time_bidding_setting	RealTimeBiddingSetting Настройки ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange.
network_settings	NetworkSettings Сетевые настройки кампании.
dynamic_search_ads_setting	DynamicSearchAdsSetting Настройка управления динамическими поисковыми объявлениями (DSA).
shopping_setting	ShoppingSetting Настройка управления торговыми кампаниями.
geo_target_type_setting	GeoTargetTypeSetting Настройка геотаргетинга рекламы.
effective_labels[]	string Имена ресурсов эффективных меток, прикрепленных к этой кампании. Эффективная метка — это метка, унаследованная или напрямую назначенная этой кампании.
labels[]	string Названия ресурсов меток, прикрепленных к этой кампании.
bidding_strategy_type	BiddingStrategyType Тип стратегии торгов. Стратегию торгов можно создать, установив либо схему торгов для создания стандартной стратегии торгов, либо поле bidding_strategy для создания портфельной стратегии торгов. Это поле доступно только для чтения.
accessible_bidding_strategy	string Имя ресурса AccessibleBiddingStrategy, доступное только для чтения представление неограниченных атрибутов прикрепленной стратегии ставок портфеля, идентифицированной как 'bidding_strategy'. Пусто, если кампания не использует стратегию портфеля. Неограниченные атрибуты стратегии доступны всем клиентам, с которыми стратегия совместно используется, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу клиента стратегии и его менеджерам. Ограниченные атрибуты можно считывать только из ресурса BiddingStrategy.
frequency_caps[]	FrequencyCapEntry Список, ограничивающий частоту показа объявлений этой кампании каждому пользователю.
selective_optimization	SelectiveOptimization Выборочная настройка оптимизации для этой кампании, которая включает набор действий конверсии для оптимизации этой кампании. Эта функция применима только к кампаниям приложений, которые используют MULTI_CHANNEL как AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT как AdvertisingChannelSubType.
optimization_goal_setting	OptimizationGoalSetting Постановка целей оптимизации для этой кампании, которая включает набор типов целей оптимизации.
tracking_setting	TrackingSetting Настройки на уровне кампании для отслеживания информации.
engine_id	string Идентификатор кампании в учетной записи внешнего движка. Это поле предназначено только для учетной записи, отличной от Google Ads, например Yahoo Japan, Microsoft, Baidu и т. д. Для сущности Google Ads используйте вместо этого "campaign.id".
excluded_parent_asset_field_types[]	AssetFieldType Типы полей активов, которые следует исключить из этой кампании. Ссылки активов с этими типами полей не будут унаследованы этой кампанией с верхнего уровня.
create_time	string Временная метка создания этой кампании. Временная метка находится в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss". create_time будет устаревшим в v1. Вместо этого используйте creation_time.
creation_time	string Временная метка, когда была создана эта кампания. Временная метка находится в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss".
last_modified_time	string DateTime, когда эта кампания была в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss».
id	int64 Идентификатор кампании.
name	string Название кампании. Это поле обязательно и не должно быть пустым при создании новых кампаний. Он не должен содержать никаких нулевых символов (кодовая точка 0x0), символов перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD).
tracking_url_template	string Шаблон URL для построения URL-адреса отслеживания.
campaign_budget	string Название ресурса бюджета кампании.
start_date	string Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД.
end_date	string Последний день кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию 2037-12-30, что означает, что кампания будет работать бесконечно. Чтобы задать существующую кампанию на неопределенный срок, установите это поле на 2037-12-30.
final_url_suffix	string Суффикс, используемый для добавления параметров запроса к целевым страницам, обслуживаемым с параллельным отслеживанием.
url_expansion_opt_out	bool Представляет отказ от расширения URL-адресов до более целевых URL-адресов. Если отключено (true), то таргетируются только конечные URL-адреса в группе активов или URL-адреса, указанные в Google Merchant Center или бизнес-каналах данных рекламодателя. Если включено (false), то таргетируется весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false.
Союз полевой campaign_bidding_strategy . Стратегия торгов для кампании. Должен быть либо портфель (созданный через сервис Biddingstrategy), либо стандарт, который встроен в кампанию. campaign_bidding_strategy может быть только одним из следующих:
bidding_strategy	string Название ресурса стратегии торгов портфелем, используемой кампанией.
manual_cpa	ManualCpa Стандартная стратегия ставок CPA. Стратегия ручной торговли, которая позволяет рекламодателю установить предложение на предложение по рекламодателю. Поддерживается только для местных кампаний по обслуживанию.
manual_cpc	ManualCpc Стандартная стратегия ставок на CPC. Руководство на основе кликов, где пользователь оплачивает за клик.
manual_cpm	ManualCpm Стандартная стратегия ставок на CPM. Ручные впечатления, основанные на торгах, где пользователь платит за тысячу впечатлений.
maximize_conversions	MaximizeConversions Стандарт максимизирует стратегию преобразований, которые автоматически максимизируют количество конверсий, тратя ваш бюджет.
maximize_conversion_value	MaximizeConversionValue Стандартная стратегия преобразования преобразования, которая автоматически устанавливает предложения для максимизации дохода при трати в свой бюджет.
target_cpa	TargetCpa Стандартная целевая стратегия ставок CPA, которая автоматически устанавливает ставки, чтобы помочь получить как можно больше конверсий на целевой стоимости за затраты на получение (CPA), которую вы устанавливаете.
target_impression_share	TargetImpressionShare Целевое впечатление от стратегии торгов. Автоматизированная стратегия торгов, которая устанавливает ставки для достижения выбранного процента впечатлений.
target_roas	TargetRoas Стандартная целевая стратегия ставок ROAS, которая автоматически максимизирует доход, в среднем определенную целевую доходность по расходам на рекламу (ROAS).
target_spend	TargetSpend Стандартная стратегия потрат на целевые расходы, которая автоматически устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета.
percent_cpc	PercentCpc Стандартная процентная стратегия ставок CPC, где ставки - это часть рекламируемой цены на что -то хорошее или услуги.
target_cpm	TargetCpm Стратегия торга, которая автоматически оптимизирует стоимость за тысячу впечатлений.

DynamicSearchAdsSetting

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

Поля
domain_name	string Требуется Имя домена в Интернете, которое эта настройка представляет, например, «Google.com» или «www.google.com».
language_code	string Требуется Языковой код, определяющий язык домена, например, «en».
use_supplied_urls_only	bool Использует ли кампания только URL -адреса.

GeotargetTypesetting

Представляет коллекцию настроек, связанных с геотаргетинг рекламы.

Поля
positive_geo_target_type	PositiveGeoTargetType Установка, используемая для положительной геотаргетирования в этой конкретной кампании.
negative_geo_target_type	NegativeGeoTargetType Настройка, используемая для негативной геотаргетинг в этой конкретной кампании.

Настройки сети

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

Поля
target_google_search	bool Будут ли подавать рекламу с результатами поиска Google.com.
target_search_network	bool Будет ли объявлена ​​реклама на сайтах партнеров в сети поиска Google (требует target_google_search , чтобы также быть true ).
target_content_network	bool Будет ли подано реклама в указанных размещениях в сети дисплея Google. Размещение указывается с использованием критерия размещения.
target_partner_search_network	bool Будет ли подано реклама в Google Partner Network. Это доступно только для некоторых выбранных учетных записей Google.

Оптимизация GoalSetting

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

Поля
optimization_goal_types[]	OptimizationGoalType Список типов целей оптимизации.

Селективоптимизация

Селективная настройка оптимизации для этой кампании, которая включает в себя набор действий по конверсии для оптимизации этой кампании. Эта функция применяется только к кампаниям приложений, которые используют multi_channel в качестве рекламы changanneltype и app_campaign или app_campaign_for_engagement в качестве рекламы.

Поля
conversion_actions[]	string Выбранный набор имен ресурсов для действий по преобразованию для оптимизации этой кампании.

ПокупкиУстановка

Установка для покупок. Определяет вселенную продуктов, которая может быть рекламирована кампанией, и как эта кампания взаимодействует с другими покупками.

Поля
feed_label	string Кормовая метка продуктов для включения в кампанию. Может быть установлен только один из FEED_LABEL или Sales_country. Если используется вместо Sales_country, поле FEED_LABEL принимает коды страны в одном и том же формате, например: 'xx'. В противном случае может быть любая строка, используемая для метки подачи в Google Merchant Center.
use_vehicle_inventory	bool Нацеливаться ли инвентаризацию перечисления транспортных средств.
merchant_id	int64 Удостоверение личности с учетной записью центрального центра. Это поле требуется для создания операций. Это поле неизбежно для покупок.
sales_country	string Страна продаж продукции для включения в кампанию.
campaign_priority	int32 Приоритет кампании. Кампании с численно более высокими приоритетами имеют приоритет над теми с более низкими приоритетами. Это поле требуется для покупок, со значениями от 0 до 2, включительно. Это поле не является обязательным для интеллектуальных покупок, но должно быть равным 3, если установлено.
enable_local	bool Должны ли включать местные продукты.

Отслеживание

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

Поля
tracking_url	string URL используется для динамического отслеживания.

Кампания

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

Поля
resource_name	string Название ресурса актива кампании. Имена ресурсов кампании имеет форму: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus Статус актива кампании.
campaign	string Кампания, с которой связан актив.
asset	string Актив, который связан с кампанией.

Кампания

Кампания - это связь между кампанией и набором активов. Добавление кампании, нанявших набор активов с кампанией.

Поля
resource_name	string Название ресурса набора активов кампании. Набор активов имена ресурсов активов есть форма: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string Кампания, с которой этот набор активов связана.
asset_set	string Набор активов, который связан с кампанией.
status	AssetSetLinkStatus Статус актива активов кампании. Только для чтения.

Кампания AudienceView

Представление об аудитории кампании. Включает данные о производительности от интересов и списков ремаркетинга для отображения сети и сетевых рекламных объявлений YouTube, а также списки ремаркетинга для поисковых рекламных объявлений (RLSA), агрегированы по кампании и критерию аудитории. Эта точка зрения включает в себя только аудиторию, прикрепленную на уровне кампании.

Поля
resource_name	string Название ресурса представления аудитории кампании. Аудитория кампании. Название ресурсов имеет форму: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

Кампания Budget

Бюджет кампании.

Поля
resource_name	string Название ресурса бюджета кампании. Имена ресурсов бюджета кампании имеют форму: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod Метод доставки, который определяет ставку, на которую тратится бюджет кампании. По умолчанию стандартные, если не указано в операции создания.
period	BudgetPeriod Период, на который можно тратить бюджет. По умолчанию ежедневно, если не указано.
amount_micros	int64 Сумма бюджета в местной валюте для счета. Сумма указана в микросхеме, где один миллион эквивалентен одной валютной единице. Ежемесячные расходы ограничены в 30,4 раза больше этой суммы.

Критерий кампании

Критерий кампании.

Поля
resource_name	string Название ресурса критерия кампании. Названия ресурсов критерия кампании имеют форму: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string Отображаемое имя критерия. Это поле игнорируется для мутатов.
type	CriterionType Тип критерия.
status	CampaignCriterionStatus Статус критерия.
last_modified_time	string DateTime, когда этот критерий кампании был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss».
criterion_id	int64 Идентификатор критерия. Это поле игнорируется во время мутата.
bid_modifier	float Модификатор для заявок, когда критерий соответствует. Модификатор должен быть в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы. Используйте 0, чтобы отказаться от типа устройства.
negative	bool Нацеливаться ли ( false ) или исключить ( true ) критерий.
Полевой criterion Союза. Критерий кампании. Именно один должен быть установлен. criterion может быть только одним из следующих:
keyword	KeywordInfo Ключевое слово.
location	LocationInfo Расположение.
device	DeviceInfo Устройство.
age_range	AgeRangeInfo Возрастной диапазон.
gender	GenderInfo Пол.
user_list	UserListInfo Список пользователей.
language	LanguageInfo Язык.
webpage	WebpageInfo Веб-страница.
location_group	LocationGroupInfo Расположение группы

CampaignefcecteVelabel

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

Поля
resource_name	string Название ресурса. Имена ресурсов AffeefcecteVelabel есть форма: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string Кампания, к которой прикреплен эффективная этикетка.
label	string Эффективный ярлык, назначенный для кампании.
owner_customer_id	int64 Идентификатор клиента, который владеет эффективной этикеткой.

Кампания

Представляет отношения между кампанией и ярлыком.

Поля
resource_name	string Название ресурса. Имена ресурсов метки кампании имеет форму: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string Кампания, к которой прикреплен этикетка.
label	string Этикетка назначена для кампании.
owner_customer_id	int64 Идентификатор клиента, который владеет этикеткой.

Cartdatasalesview

Cart Data Sales View.

Поля
resource_name	string Название ресурса представления продаж данных CART. Названия ресурсов с продажей корзины имеют форму: customers/{customer_id}/cartDataSalesView

Конверсия

Конверсия.

Поля
resource_name	string Название ресурса конверсии. Имена ресурсов конверсии имеют форму: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 Идентификатор конверсии
criterion_id	int64 Поиск объявлений 360 идентификатор критерия. Значение 0 указывает на то, что критерий не приспособлен.
merchant_id	int64 Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360.
ad_id	int64 Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено.
click_id	string Уникальная строка для посещения, к которому приписывается преобразование, которая передается на целевую страницу в качестве параметра URL -адреса Click.
visit_id	int64 Поиск объявлений 360 посещает идентификатор, с которым приписывается конверсия.
advertiser_conversion_id	string Для автономных преобразований это идентификатор, предоставленный рекламодателями. Если рекламодатель не указывает такой идентификатор, поиск объявления 360 генерирует один. Для онлайн -преобразований это равна столбцу ID или столбца Floodlight_order_id в зависимости от инструкций по прожектор рекламодателя.
product_id	string Идентификатор продукта нажал на.
product_channel	ProductChannel Канал продаж продукта, который был нажат на: онлайн или локальный.
product_language_code	string Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте.
product_store_id	string Магазин в локальном инвентарном объявлении, на который нажимались. Это должно соответствовать идентификаторам магазина, используемым в вашей местной продукции.
product_country_code	string Страна (ISO-3166-формат) зарегистрирована для подачи инвентаризации, которая содержит нажатый продукт.
attribution_type	AttributionType На что приписывается конверсия: посетить или ключевое слово+ad.
conversion_date_time	string TimeStamp of the Convertion Event.
conversion_last_modified_date_time	string Неэппаратная метка прошлого раз преобразования была изменена.
conversion_visit_date_time	string Неэппаратная метка визита, с которой приписывается преобразование.
conversion_quantity	int64 Количество элементов, записанных преобразованием, как определено параметром QTY URL. Рекламодатель отвечает за динамически заполнение параметра (например, количество предметов, продаваемых при преобразовании), в противном случае он по умолчанию до 1.
conversion_revenue_micros	int64 Скорректированный доход в микросхеме для события конверсии. Это всегда будет в валюте сервировочного счета.
floodlight_original_revenue	int64 Первоначальный, неизменный доход, связанный с событием прожектора (в валюте текущего отчета), перед модификациями инструкции по валюте прожектора.
floodlight_order_id	string Идентификатор заказа прожектора, предоставленный рекламодателем для преобразования.
status	ConversionStatus Состояние конверсии, включенное или удаленное ..
asset_id	int64 ID актива, с которым взаимодействовали во время конверсии.
asset_field_type	AssetFieldType Тип поля актива события конверсии.

Преобразование

Действие конверсии.

Поля
resource_name	string Имя ресурса действия преобразования. Имена ресурсов действий преобразования имеют форму: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Неэппаратная метка создания деятельности прожектора, отформатированная в ISO 8601.
status	ConversionActionStatus Статус этого действия преобразования для начисления события конверсии.
type	ConversionActionType Тип этого действия преобразования.
category	ConversionActionCategory Категория конверсий, представленная для этого действия по конверсии.
value_settings	ValueSettings Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии.
attribution_model_settings	AttributionModelSettings Настройки, связанные с моделью атрибуции действия этой преобразования.
floodlight_settings	FloodlightSettings Настройки прожектора для типов преобразования прожектора.
id	int64 Идентификатор действия преобразования.
name	string Имя действия преобразования. Это поле требуется и не должно быть пустым при создании новых действий конверсии.
primary_for_goal	bool Если бит первичного действия по обращению с преобразованием является ложным, действие по преобразованию не является разбитым для всех кампаний независимо от цели их преобразования клиентов или цели преобразования кампании. Тем не менее, пользовательские цели преобразования не уважают primary_for_goal, поэтому, если кампания имеет пользовательскую цель преобразования, настроенная с помощью действия Primary_for_goal = false преобразования, это действие преобразования по -прежнему остается в курсе. По умолчанию, Promaning_FOR_GOAL будет правдой, если не установлен. В V9 Primary_FOR_GOAL может быть установлен на FALSE только после создания через операцию «обновления», потому что она не объявлена ​​необязательной.
owner_customer	string Имя ресурса клиента владельца действий по конверсии или NULL, если это системное действие конверсии.
include_in_client_account_conversions_metric	bool Должно ли это действие преобразования быть включено в метрику "client_account_conversions".
include_in_conversions_metric	bool Должно ли это действие преобразования быть включено в метрику «преобразования».
click_through_lookback_window_days	int64 Максимальное количество дней, которые могут пройти между взаимодействием (например, кликом) и событием конверсии.
app_id	string Идентификатор приложения для действия преобразования приложения.

Attributionmodelsettings

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

Поля
attribution_model	AttributionModel Тип модели атрибуции этого действия преобразования.
data_driven_model_status	DataDrivenModelStatus Состояние модели атрибуции, управляемой данными, для действия преобразования.

Заборы прожекторов

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

Поля
activity_group_tag	string Строка, используемая для идентификации группы активности прожектора при отчетности.
activity_tag	string Строка, используемая для идентификации активности прожектора при отчетности.
activity_id	int64 Идентификация деятельности прожектора в DoubleClick Manager кампании (DCM).

ValueSettings

Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии.

Поля
default_value	double Значение для использования, когда события преобразования для этого действия преобразования отправляются с недопустимым, запрещенным или отсутствующим значением, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию.
default_currency_code	string Код валюты для использования, когда события преобразования для этого действия преобразования отправляются с неверным или отсутствующим кодом валюты, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию.
always_use_default_value	bool Управляет, используются ли значение значения по умолчанию и код валюты по умолчанию вместо значения и кода валюты, указанного в событиях преобразования для этого действия преобразования.

ConversionCustomVariable

Пользовательская переменная преобразования. См. «О настраиваемых показателях и размерах прожектора прожектора в новой поисковой рекламе 360» по адресу https://support.google.com/sa360/answer/13567857

Поля
resource_name	string Имя ресурса пользовательской переменной конверсии. Преобразование пользовательские имена ресурсов имеют форму: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 Идентификатор конверсии пользовательской переменной.
name	string Требуется Название пользовательской переменной преобразования. Имя должно быть уникальным. Максимальная длина имени составляет 100 символов. Не должно быть никаких дополнительных пространств до и после.
tag	string Требуется Тег пользовательской переменной преобразования. Тег должен быть уникальным и состоять из символа «u», следовавшего непосредственно с числом меньше, чем Ormequal до 100. Например: «U4».
status	ConversionCustomVariableStatus Статус пользовательской переменной конверсии для начисления событий конверсии.
owner_customer	string Имя ресурса клиента, которая владеет пользовательской переменной конверсии.
family	ConversionCustomVariableFamily Семейство из пользовательской переменной конверсии.
cardinality	ConversionCustomVariableCardinality Кардинальность пользовательской переменной конверсии.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Поля для поисковой рекламы 360 Конверсии прожектора пользовательских переменных.
custom_column_ids[]	int64 Идентификаторы пользовательских столбцов, которые используют эту пользовательскую переменную преобразования.

FlorlightConversionCustomVariableInfo

Информация для поиска объявлений 360 Преобразование прожектора пользовательских переменных.

Поля
floodlight_variable_type	FloodlightVariableType Тип переменной прожектора, определенный в поисковой рекламе 360.
floodlight_variable_data_type	FloodlightVariableDataType Тип данных переменной прожектора, определенный в поисковой рекламе 360.

ConversionTrackingSetting

Коллекция настройки по всему клиенту, связанные с отслеживанием конверсии 360.

Поля
accepted_customer_data_terms	bool Принял ли клиент условия данных клиента. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения. Для получения дополнительной информации см. Https://support.google.com/adspolicy/answer/7475709 .
conversion_tracking_status	ConversionTrackingStatus Статус отслеживания конверсии. Это указывает, использует ли клиент отслеживание конверсии, и кто является владельцем отслеживания конверсий этого клиента. Если этот клиент использует отслеживание преобразования перекрестного аккунтирования, возвращаемое значение будет отличаться в зависимости от login-customer-id в систему запроса.
enhanced_conversions_for_leads_enabled	bool Будет ли клиент выбрано для улучшенных конверсий для потенциальных клиентов. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения.
google_ads_conversion_customer	string Название ресурса клиента, где конверсии создаются и управляются. Это поле только для чтения.
conversion_tracking_id	int64 Идентификатор отслеживания преобразования, используемый для этой учетной записи. Этот идентификатор не указывает, использует ли клиент отслеживание конверсии (это делает Conversion_tracking_status). Это поле только для чтения.
google_ads_cross_account_conversion_tracking_id	int64 Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание конверсии, и он переопределяет Conversion_tracking_id. Это поле можно управлять только через пользовательский интерфейс Google Ads. Это поле только для чтения.
cross_account_conversion_tracking_id	int64 Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание преобразования перекрестного аккаунта, и он переопределяет Conversion_tracking_id.

Customcolumn

Пользовательский столбец. См. Поиск объявлений 360 пользовательский столбец по адресу https://support.google.com/sa360/answer/9633916

Поля
resource_name	string Имя ресурса пользовательского столбца. Пользовательские имена ресурсов столбца имеют форму: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 Идентификатор пользовательского столбца.
name	string Пользовательский название пользовательского столбца.
description	string Пользовательский описание пользовательского столбца.
value_type	CustomColumnValueType Тип значения результата пользовательского столбца.
references_attributes	bool TRUE, когда пользовательский столбец ссылается на один или несколько атрибутов.
references_metrics	bool Верно, когда пользовательский столбец ссылается на один или несколько метрик.
queryable	bool TRUE, когда пользовательский столбец доступен для использования в запросе searchAds360service.search и searchads360service.searchstream.
referenced_system_columns[]	string Список ссылочных системных столбцов этого пользовательского столбца. Например, пользовательский столбец «Сумма впечатлений и щелчков» ссылается на системные столбцы {"metrics.clicks", "metrics.impressions"}.
render_type	CustomColumnRenderType Как следует интерпретировать значение результата пользовательского столбца.

Клиент

Клиент.

Поля
resource_name	string Название ресурса клиента. Имена ресурсов клиентов имеют форму: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Настройка отслеживания конверсии для клиента.
account_type	AccountType Тип учетной записи двигателя, например, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Track и т. Д.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера.
account_status	AccountStatus Статус учетной записи, например, включен, приостановлен, удален и т. Д.
last_modified_time	string DateTime, когда этот клиент был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss».
engine_id	string ID учетной записи в учетной записи внешнего двигателя.
status	CustomerStatus Статус клиента.
creation_time	string Неэппредактирование, когда этот клиент был создан. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS».
manager_id	int64 Идентификатор клиента менеджера. Значение 0 указывает на то, что у клиента нет менеджера SA360.
manager_descriptive_name	string Описательное имя менеджера.
sub_manager_id	int64 Идентификатор клиента субжерателя. Значение 0 указывает на то, что у клиента нет менеджера Sub SA360.
sub_manager_descriptive_name	string Описательное название подготовительного менеджера.
associate_manager_id	int64 Идентификатор клиента ассоциированного менеджера. Значение 0 указывает на то, что у клиента нет ассоциированного менеджера SA360.
associate_manager_descriptive_name	string Описательное название ассоциированного менеджера.
account_level	AccountLevelType Уровень учетной записи клиента: менеджер, суб-менеджер, помощник менеджера, Сервисная учетная запись.
id	int64 Идентификатор клиента.
descriptive_name	string Необязательное, не одночернее описательное название клиента.
currency_code	string Валюта, в которой работает учетная запись. Подмножество валютных кодов из стандарта ISO 4217 поддерживается.
time_zone	string Местный идентификатор часового пояса клиента.
tracking_url_template	string Шаблон URL для построения URL -адреса отслеживания из параметров.
final_url_suffix	string Шаблон URL для добавления параметров к окончательному URL.
auto_tagging_enabled	bool Удалена ли автоматическая загрязнение для клиента.
manager	bool Является ли клиент менеджером.

CustomerAsset

Связь между клиентом и активом.

Поля
resource_name	string Название ресурса актива клиента. Названия ресурсов CustomerAsset имеют форму: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string Требуется Актив, который связан с клиентом.
status	AssetLinkStatus Статус актива клиента.

CustomerAssetSet

CustomerAssetSet - это связь между клиентом и набором активов. Добавление клиентских ссылок набор активов с клиентом.

Поля
resource_name	string Имя ресурса набора активов клиента. Набор активов имена ресурсов активов есть форма: customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string Набор активов, который связан с клиентом.
customer	string Клиент, с которым этот набор активов связан.
status	AssetSetLinkStatus Статус актива актива клиента. Только для чтения.

CustomerClient

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

Поля
resource_name	string Имя ресурса клиента. Имена ресурсов CustomerClient имеют форму: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string Названия ресурсов меток, принадлежащих запрашивающему клиенту, которые применяются к клиенту. Имена ресурсов метки имеют форму: customers/{customer_id}/labels/{label_id}
status	CustomerStatus Статус клиента клиента. Читать только.
client_customer	string Имя ресурса клиента-клиента, которое связано с данным клиентом. Читать только.
hidden	bool Указывает, является ли это скрытой учетной записью. Читать только.
level	int64 Расстояние между данным клиентом и клиентом. Для самооценки значение уровня будет 0. Только для чтения.
time_zone	string Обычное представление строки данных общего локали (CLDR) часового пояса клиента, например, America/Los_angeles. Читать только.
test_account	bool Определяет, является ли клиент тестовой учетной записью. Читать только.
manager	bool Определяет, является ли клиент менеджером. Читать только.
descriptive_name	string Описательное имя для клиента. Читать только.
currency_code	string Валютный код (например, «USD», «EUR») для клиента. Читать только.
id	int64 Идентификатор клиента клиента. Читать только.

Customer ManagerLink

Представляет отношения клиента и менеджера.

Поля
resource_name	string Название ресурса. Имена ресурсов Customer ManAgerLink Имеет форму: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus Статус связи между клиентом и менеджером.
manager_customer	string Клиент менеджера связан с клиентом.
manager_link_id	int64 ID ссылки клиента-менеджер. Это поле читается только.
start_time	string The TimeStamp, когда Customer ManagerLink была создана. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS».

DoubleClickCampaignmanagersetting

Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера.

Поля
advertiser_id	int64 Удостоверение личности рекламодателя менеджера кампании, связанного с этим клиентом.
network_id	int64 Удостоверение личности сети менеджера кампании, связанная с этим клиентом.
time_zone	string Часовой пояс сети менеджера кампании, связанная с этим клиентом в формате базы данных IANA TOMES, таких как America/New_york.

DynamicSearchAdsSearchVermView

Динамический поисковый поисковый просмотр.

Поля
resource_name	string Имя ресурса просмотра поиска динамического поиска. Динамический поиск объявлений об поиске термин «Просмотр имен ресурсов» есть форма: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string Динамически выбранная URL -адрес -страницы впечатления. Это поле только для чтения.

Genderview

Гендерный вид. Ресурс Gender_view отражает эффективное состояние обслуживания, а не то, что были добавлены критерии. Группа AD без гендерных критериев по умолчанию показывает все полов, поэтому все половины появляются в Gender_view со статистикой.

Поля
resource_name	string Имя ресурса гендерного представления. Гендерное представление имена ресурсов имеют форму: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeotargetConstant

Гео -целевая постоянная.

Поля
resource_name	string Название ресурса константы GEO Target. Имена ресурсов GEO Target имеют форму: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus Гео целевой постоянный статус.
id	int64 Идентификатор константы Geo Target.
name	string Geo Target Constant English Name.
country_code	string Код страны ISO-3166-1 alpha-2, связанный с целью.
target_type	string Гео целевой постоянный тип цели.
canonical_name	string Полностью квалифицированное английское название, состоящее из имени цели и имени его родителя и страны.
parent_geo_target	string Имя ресурса родительской целевой константы GEO. Имена ресурсов GEO Target имеют форму: geoTargetConstants/{parent_geo_target_constant_id}

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

Представление ключевого слова.

Поля
resource_name	string Имя ресурса представления ключевого слова. Ключевое слово имена ресурсов имеют форму: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Этикетка

Ярлык.

Поля
resource_name	string Название ресурса. Имена ресурсов метки имеют форму: customers/{customer_id}/labels/{label_id}
status	LabelStatus Статус ярлыка. Читать только.
text_label	TextLabel Тип метки, отображающего текст на цветном фоне.
id	int64 Удостоверение личности этикетки. Читать только.
name	string Имя этикетки. Это поле требуется и не должно быть пустым при создании нового ярлыка. Длина этой строки должна составлять от 1 до 80, включительно.

LanguageConstant

Язык.

Поля
resource_name	string Название ресурса постоянной языка. Имена ресурсов с постоянными языками имеют форму: languageConstants/{criterion_id}
id	int64 Идентификатор языковой постоянной.
code	string Языковой код, например, "en_us", "en_au", "es", "Fr" и т. Д.
name	string Полное имя языка на английском, например, «английский (США)», «Испанский» и т. Д.
targetable	bool Является ли язык нацеленным.

ListingGroupFilterDimension

Листинг измерений для группового фильтра группы Acset Group.

Поля
Объединенное dimension . Размер одного из приведенных ниже типов всегда присутствует. dimension может быть только одним из следующих:
product_bidding_category	ProductBiddingCategory Категория ставок предложения о продукте.
product_brand	ProductBrand Бренд предложения продукта.
product_channel	ProductChannel Местность предложения продукта.
product_condition	ProductCondition Состояние предложения продукта.
product_custom_attribute	ProductCustomAttribute Пользовательский атрибут предложения продукта.
product_item_id	ProductItemId Идентификатор предложения предложения продукта.
product_type	ProductType Тип предложения продукта.

ProductBiddingCategory

Один элемент категории торгов на определенном уровне. Категории высшего уровня находятся на уровне 1, их дети на уровне 2 и так далее. В настоящее время мы поддерживаем до 5 уровней. Пользователь должен указать тип измерения, который указывает уровень категории. Все случаи одного и того же подразделения должны иметь одинаковый тип измерения (уровень категории).

Поля
level	ListingGroupFilterBiddingCategoryLevel Указывает уровень категории в таксономии.
id	int64 Удостоверение личности категории ставок продукта. Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436

Продукт

Бренд продукта.

Поля
value	string Строковое значение бренда продукта.

ProductChannel

Местность предложения продукта.

Поля
channel	ListingGroupFilterProductChannel Ценность местности.

Состояние продукта

Состояние предложения продукта.

Поля
condition	ListingGroupFilterProductCondition Значение условия.

ProductCustomattribute

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

Поля
index	ListingGroupFilterCustomAttributeIndex Указывает индекс пользовательского атрибута.
value	string Строковое значение продукта пользовательское атрибут.

ProductItemId

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

Поля
value	string Значение идентификатора.

ТипПродукта

Тип предложения продукта.

Поля
level	ListingGroupFilterProductTypeLevel Уровень типа.
value	string Значение типа.

ListingGroupFilterDimensionPath

Путь, определяющий измерения, определяющие фильтр группы листинга.

Поля
dimensions[]	ListingGroupFilterDimension Полный путь измерений через иерархию фильтра группы листинга (исключая корневой узел) к этому фильтру группы листинга.

LocationView

В просмотре местоположения суммируется выполнение кампаний по критерию местоположения.

Поля
resource_name	string Название ресурса представления местоположения. Расположение имена ресурсов имеют форму: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Категория ставок продукта.

Поля
resource_name	string Название ресурса категории ставок продукта. Имена ресурсов категории категории продукта имеют форму: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Уровень категории ставок продукта.
status	ProductBiddingCategoryStatus Статус категории торгов.
id	int64 Удостоверение личности категории ставок продукта. Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436 .
country_code	string Двухбуктный код страны в верхнем случае категории ставок продукта.
product_bidding_category_constant_parent	string Название ресурса категории ставок родительского продукта.
language_code	string Языковой код категории ставок продукта.
localized_name	string Значение отображения категории ставок на продукт локализован в соответствии с Language_Code.

ProductGroupView

Просмотр группы продуктов.

Поля
resource_name	string Название ресурса представления группы продуктов. Группа продукта Просмотр Имен ресурсов имеет форму: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Поле или ресурс (артефакт), используемый SearchAds360service.

Поля
resource_name	string Название ресурса артефакта. Имена ресурсов артефакта имеют форму: SearchAds360Fields/{name}
category	SearchAds360FieldCategory Категория артефакта.
selectable_with[]	string Названия всех ресурсов, сегментов и метрик, которые выбираются с описанным артефактом.
attribute_resources[]	string Названия всех ресурсов, которые выбираются с описанным артефактом. Поля из этих ресурсов не сегментируют метрики при включении в поисковые запросы. Это поле подходит только для артефактов, категория которых является ресурсом.
metrics[]	string В этом поле перечислены имена всех метрик, которые выбираются с описанным артефактом, когда он используется в предложении FAR. Он настроен только для артефактов, категория которых является ресурсом.
segments[]	string В этом поле перечислены имена всех артефактов, будь то сегмент или другой ресурс, этот сегмент метрики при включении в поисковые запросы и когда описанный артефакт используется в пункте From. Он настроен только для артефактов, категория которых является ресурсом.
enum_values[]	string Значения артефакта могут предположить, если это поле enum типа. Это поле установлено только для артефактов сегмента категории или атрибута.
data_type	SearchAds360FieldDataType Это поле определяет операторов, которые можно использовать с артефактом, где есть положения.
name	string Название артефакта.
selectable	bool Можно ли использовать артефакт в предложении Select в поисковых запросах.
filterable	bool Можно ли использовать артефакт в предложении, где в поисковых запросах.
sortable	bool Можно ли использовать артефакт в пункте «Заказ в поисках».
type_url	string URL -адрес прото, описывающий тип данных артефакта.
is_repeated	bool Повторяется ли полевой артефакт.

ShoppingPerformanceView

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

Поля
resource_name	string Название ресурса представления о производительности покупок. Производительность покупок имена ресурсов есть форма: customers/{customer_id}/shoppingPerformanceView

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

Список пользователей. Это список пользователей, на которые клиент может нацелиться.

Поля
resource_name	string Имя ресурса списка пользователей. Имена ресурсов в списке пользователей имеют форму: customers/{customer_id}/userLists/{user_list_id}
type	UserListType Тип этого списка. Это поле только для чтения.
id	int64 Идентификатор списка пользователей.
name	string Имя этого списка пользователей. В зависимости от его access_reess, имя списка пользователей не может быть уникальным (например, если access_reason = shared)

UserLocationView

Представление о местоположении пользователя.

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

Поля
resource_name	string Имя ресурса представления местоположения пользователя. UserLocation View имена ресурсов имеют форму: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 Критерий идентификатор для страны.
targeting_location	bool Указывает, было ли местоположение целевым или нет.

Посещать

Визит.

Поля
resource_name	string Название ресурса визита. Посетите имена ресурсов имеют форму: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 Идентификатор визита.
criterion_id	int64 Поиск объявлений 360 идентификатор ключевого слова. Значение 0 указывает на то, что ключевое слово не привлечено.
merchant_id	int64 Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360.
ad_id	int64 Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено.
click_id	string Уникальная строка для каждого посещения, которое передается на целевую страницу в качестве параметра URL -адреса Click.
visit_date_time	string TimeStamp of the Visit Event. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS».
product_id	string Идентификатор продукта нажал на.
product_channel	ProductChannel Канал продаж продукта, который был нажат на: онлайн или локальный.
product_language_code	string Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте.
product_store_id	string Магазин в локальном инвентарном объявлении, на который нажимались. Это должно соответствовать идентификаторам магазина, используемым в вашей местной продукции.
product_country_code	string Страна (формат ISO-3166), зарегистрированная для подачи инвентаризации, которая содержит нажатый продукт.
asset_id	int64 Удостоверение личности актива, с которым взаимодействовали во время визита.
asset_field_type	AssetFieldType Активы поля типа посещения.

WebPageView

Представление веб -страницы.

Поля
resource_name	string Имя ресурса представления веб -страницы. Имена ресурсов на веб -странице есть форма: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}