SearchAds360Row

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}

string

广告组的资源名称。广告组资源名称采用以下格式：

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

广告组的状态。

enum (AdGroupType)

广告组的类型。

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。

string

创建此 adGroup 时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。

object (TargetingSetting)

用于定位相关功能的设置。

string

附加到此广告组的标签的资源名称。

string

外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请使用“adGroup.id”。

string

此广告组开始投放广告的日期。默认情况下，广告组会立即或在广告组的开始日期（以较早者为准）开始投放广告。如果设置了此字段，则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。

格式：YYYY-MM-DD 示例：2019-03-14

string

广告组停止投放广告的日期。默认情况下，广告组的结束日期为广告组的结束日期。如果设置了此字段，则广告组将在指定日期（以客户所在时区为准）结束投放。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。

格式：YYYY-MM-DD 示例：2019-03-14

string

广告组中广告和关键字的语言。此字段仅适用于 Microsoft Advertising 账号。更多详情：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

上次修改此广告组的日期时间。日期时间采用客户所在时区，格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

string (int64 format)

广告组的 ID。

string

广告组的名称。

此字段是必填字段，创建新广告组时不应为空。

其包含的 UTF-8 全角字符必须少于 255 个。

并且不得包含任何 null（码位 0x0）、NL 换行符（码位 0xA）或回车符（码位 0xD）。

string (int64 format)

每次点击费用 (cost-per-click) 出价上限。

enum (AdGroupEngineStatus)

广告组的引擎状态。

{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}

object (TargetRestriction)

用于限制广告系列或广告组覆盖面的每个定位维度的设置。

{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}

enum (TargetingDimension)

这些设置适用的定位维度。

boolean

指明是将您的广告限制为仅针对您为此 targetingDimension 选择的条件展示，还是定位此 targetingDimension 的所有值，并根据您在其他 TargetingDimensions 中的定位条件展示广告。如果值为 true，则表示这些条件只会应用出价调节系数，而不会影响定位。值 false 表示这些条件会限制定位以及应用出价调节系数。

{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}

string

广告的资源名称。广告组的广告资源名称采用以下格式：

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

enum (AdGroupAdStatus)

广告的状态。

object (Ad)

广告。

string

创建此 adGroupAd 时的时间戳。日期时间采用客户所在时区，格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

string

附加到此广告组广告的标签的资源名称。

string

外部引擎账号中的广告 ID。此字段仅适用于 Search Ads 360 账号，例如 Yahoo Japan、Microsoft、百度账号。对于非 Search Ads 360 实体，请使用“adGroupAd.ad.id”。

enum (AdGroupAdEngineStatus)

外部引擎账号中广告的其他状态。可能的状态（取决于外部账号的类型）包括“活跃”、“有效”、“待审核”等。

string

最后一次修改此广告组广告的日期时间。日期时间采用客户所在时区，格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "type": enum (AdType),
  "id": string,
  "displayUrl": string,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (SearchAds360TextAdInfo)
  },
  "expandedTextAd": {
    object (SearchAds360ExpandedTextAdInfo)
  },
  "responsiveSearchAd": {
    object (SearchAds360ResponsiveSearchAdInfo)
  },
  "productAd": {
    object (SearchAds360ProductAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (SearchAds360ExpandedDynamicSearchAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

广告的资源名称。广告资源名称采用以下格式：

customers/{customerId}/ads/{adId}

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。

enum (AdType)

广告的类型。

string (int64 format)

广告的 ID。

string

在某些广告格式的广告说明中显示的网址。

string

广告的名称。此名称仅用于识别广告。它不必是唯一的，也不会影响投放的广告。name 字段目前仅支持 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。

object (SearchAds360TextAdInfo)

与文字广告有关的详细信息。

object (SearchAds360ExpandedTextAdInfo)

与加大型文字广告相关的详情。

object (SearchAds360ResponsiveSearchAdInfo)

与自适应搜索广告相关的详细信息。

object (SearchAds360ProductAdInfo)

与产品广告相关的详细信息。

object (SearchAds360ExpandedDynamicSearchAdInfo)

与加大型动态搜索广告相关的详细信息。

{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}

string

广告的标题。

string

广告内容描述的第一行。

string

广告内容描述的第二行。

string

广告的显示网址。

string

广告的移动网址。

string (int64 format)

广告的跟踪 ID。

{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

string

广告的标题。

string

广告的第二个标题。

string

广告的第三个标题。

string

广告内容描述的第一行。

string

广告内容描述的第二行。

string

附加到自动生成的可见网址（包含分隔符）的文本。

string

使用分隔符附加到路径 1 的文本。

string (int64 format)

广告的跟踪 ID。

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

object (AdTextAsset)

标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。

object (AdTextAsset)

说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。

string

附加到自动生成的可见网址（包含分隔符）的文本。

string

使用分隔符附加到路径 1 的文本。

string (int64 format)

广告的跟踪 ID。

{
  "text": string
}

string

素材资源文字。

{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}

string

广告内容描述的第一行。

string

广告内容描述的第二行。

string (int64 format)

广告的跟踪 ID。

{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}

string

广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式：customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

string

标签附加到的广告组广告。

string

分配给广告组广告的标签。

{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}

string

广告组素材资源的资源名称。AdGroupAsset 资源名称采用以下格式：

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

string

必需。与素材资源相关联的广告组。

string

必需。与广告组相关联的素材资源。

enum (AssetLinkStatus)

广告组素材资源的状态。

{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}

string

广告组素材资源组的资源名称。广告组素材资源组资源名称采用以下格式：

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

string

此素材资源组所关联的广告组。

string

与广告组相关联的素材资源集。

enum (AssetSetLinkStatus)

广告组素材资源集的状态。只读。

{
  "resourceName": string
}

string

广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式：

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}

string

广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式：

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent，该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。

object (DeviceInfo)

设备标准。

{
  "type": enum (Device)
}

enum (Device)

设备类型。

{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}

string

广告组条件的资源名称。广告组条件资源名称采用以下格式：

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

string

创建此广告组条件时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。

enum (AdGroupCriterionStatus)

条件的状态。

这是由客户设置的广告组条件实体的状态。注意：界面报告可能包含其他信息，这些信息会影响条件是否能够运行。在某些情况下，在 API 中已移除的标准仍可在界面中显示为已启用。例如，默认情况下，广告系列会面向所有年龄段的用户展示（已被排除的除外）。该界面会将各个年龄段显示为“已启用”，因为它们有资格观看广告；但 AdGroupCriterion.status 会显示为“已移除”，因为系统未添加任何肯定条件。

object (QualityInfo)

关于标准质量的信息。

enum (CriterionType)

标准的类型。

string

广告组条件所附标签的资源名称。

object (PositionEstimates)

不同排名的定位标准出价估算值。

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。

string

外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请使用“adGroupCriterion.criterion_id”。

string

上次修改此广告组条件时的日期时间。日期时间采用客户所在时区，格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

string (int64 format)

条件的 ID。

string

条件所属的广告组。

boolean

是定位 (false) 还是排除 (true) 条件。

该字段不可更改。 如需将条件从正切换为负，请先移除再重新添加。

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。

string (int64 format)

每次点击费用出价。

string (int64 format)

有效每次点击费用 (cost-per-click) 出价。

enum (AdGroupCriterionEngineStatus)

广告组条件的引擎状态。

string

用于将参数附加到最终到达网址的网址模板。

string

用于构建跟踪网址的网址模板。

object (KeywordInfo)

关键字。

object (ListingGroupInfo)

产品信息组。

object (AgeRangeInfo)

年龄段。

object (GenderInfo)

性别。

object (UserListInfo)

用户列表。

object (WebpageInfo)

网页

object (LocationInfo)

位置信息。

{
  "qualityScore": integer
}

integer

质量得分。

如果 Google 没有足够的信息来确定值，则系统可能不会填充该字段。

{
  "topOfPageCpcMicros": string
}

string (int64 format)

要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。

{
  "matchType": enum (KeywordMatchType),
  "text": string
}

enum (KeywordMatchType)

关键字的匹配类型。

string

关键字文本（最多 80 个字符和 10 个字词）。

{
  "type": enum (ListingGroupType)
}

enum (ListingGroupType)

产品信息组的类型。

{
  "type": enum (AgeRangeType)
}

enum (AgeRangeType)

年龄段的类型。

{
  "type": enum (GenderType)
}

enum (GenderType)

性别的类型。

{
  "userList": string
}

string

用户列表资源名称。

{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}

object (WebpageConditionInfo)

用于网页定位的条件或逻辑表达式。在为定位进行评估时，网页定位条件列表会连接在一起。条件列表为空表示广告系列网站的所有网页均已定位。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

number

网站条件覆盖率百分比。这是根据广告组和广告系列中的网站定位条件、排除网站定位条件和否定关键字计算出的网站覆盖率百分比。例如，如果覆盖率返回为 1，则表示覆盖率为 100%。此字段为只读字段。

string

由此参数定义的条件的名称。名称值将用于对此类参数进行标识、排序和过滤。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}

enum (WebpageConditionOperand)

网页定位条件的操作数。

enum (WebpageConditionOperator)

网页定位条件的运算符。

string

网页定位条件的参数。

{
  "geoTargetConstant": string
}

string

地理位置定位常量资源名称。

{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}

string

广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式：customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

string

标签附加到的广告组条件。

string

分配给广告组条件的标签。

{
  "resourceName": string,
  "adGroup": string,
  "label": string
}

string

广告组标签的资源名称。广告组标签资源名称采用以下格式：customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

string

标签附加到的广告组。

string

分配给广告组的标签。

{
  "resourceName": string
}

string

年龄段视图的资源名称。年龄段视图资源名称采用以下格式：

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}

string

资产的资源名称。资产资源名称采用以下格式：

customers/{customerId}/assets/{assetId}

enum (AssetType)

资产的类型。

string

所有跨网域重定向之后可能的最终到达网址的列表。

enum (AssetStatus)

素材资源的状态。

string

创建此素材资源时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。

string

上次修改此素材资源的日期时间。日期时间采用客户所在时区，格式为“yyyy-MM-dd HH:mm:ss.sssss”格式。

string (int64 format)

资产的 ID。

string

资产的可选名称。

string

用于构建跟踪网址的网址模板。

enum (AssetEngineStatus)

资产的引擎状态。

object (YoutubeVideoAsset)

YouTube 视频素材资源。

object (ImageAsset)

图片素材资源。

object (TextAsset)

文字素材资源。

object (UnifiedCalloutAsset)

统一的宣传信息素材资源。

object (UnifiedSitelinkAsset)

统一的站内链接素材资源。

object (UnifiedPageFeedAsset)

统一的页面 Feed 素材资源。

object (MobileAppAsset)

一项移动应用素材资源。

object (UnifiedCallAsset)

统一的电话素材资源。

object (CallToActionAsset)

号召性用语素材资源。

object (UnifiedLocationAsset)

统一的地址素材资源。

{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}

string

YouTube 视频标题。

string

YouTube 视频 ID。这是用于 YouTube 视频网址的字符串值，共 11 个。

{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}

enum (MimeType)

图片资源的 MIME 类型。

object (ImageDimension)

此图片原始大小的元数据。

string (int64 format)

图片资源的文件大小（以字节为单位）。

{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}

string (int64 format)

图片的高度。

string (int64 format)

图片的宽度。

string

可返回具有此高度和宽度的图片的网址。

{
  "text": string
}

string

文字素材资源的文字内容。

{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}

string

宣传信息文字。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。

string

此素材资源生效并且可以开始投放的开始日期，格式为 yyyy-MM-dd。

string

此素材资源有效并且仍在投放的最后日期，格式为 yyyy-MM-dd。

object (AdScheduleInfo)

不重叠的投放时间列表，用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表，总共 42 个。

boolean

是否按搜索用户的时区显示资源。适用于 Microsoft Ads。

{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}

enum (MinuteOfHour)

此时间表启动的那一小时之后的分钟数。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

enum (MinuteOfHour)

此投放时间结束小时后的分钟数。该时间表不包含结束分钟。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

enum (DayOfWeek)

投放时间是星期几。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

integer

24 小时制的整点启动时间。此字段必须介于 0 和 23 之间（含 0 和 23）。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

integer

24 小时制的整点结束时间；24 表示一天结束。此字段必须介于 0 和 24 之间（含 0 和 24）。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}

string

附加链接的网址显示文字。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。

string

站内链接的说明的第一行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description2。

string

附加链接说明的第二行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description1。

string

此素材资源生效并且可以开始投放的开始日期，格式为 yyyy-MM-dd。

string

此素材资源有效并且仍在投放的最后日期，格式为 yyyy-MM-dd。

object (AdScheduleInfo)

不重叠的投放时间列表，用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表，总共 42 个。

string (int64 format)

用于跟踪站内链接素材资源的点击次数的 ID。这是一个 Yahoo!Japan 字段。

boolean

是否按搜索用户所在的时区显示站内链接素材资源。适用于 Microsoft Ads。

boolean

是否偏好设置设为在移动设备上展示站内链接素材资源。适用于 Microsoft Ads。

{
  "pageUrl": string,
  "labels": [
    string
  ]
}

string

广告客户要定位的网页。

string

用于对页面网址进行分组的标签。

{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}

string

必需。唯一标识移动应用的字符串。它应该只包含平台原生 ID，例如“com.android.ebay”对于 Android 或“12345689”。

enum (MobileAppVendor)

必需。分发此特定应用的应用商店。

{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}

string

电话号码的双字母国家/地区代码。示例：“US”、“us”。

string

广告客户的原始电话号码。示例：“1234567890”“(123)456-7890”

enum (CallConversionReportingState)

指明此 CallAsset 是应该使用自己的致电转化设置、采用账号级设置，还是停用致电转化。

string

将来电转化归因于的转化操作。如果未设置此政策，系统将使用默认转化操作。此字段仅在 callConversionReportingState 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时才有效。

object (AdScheduleInfo)

不重叠的投放时间列表，用于指定素材资源可以投放的所有时间间隔。每天最多可以设置 6 个时间表，总共 42 个。

boolean

来电是否仅显示电话号码，而不显示网站链接。适用于 Microsoft Ads。

boolean

是否应在通话跟踪中启用通话。适用于 Microsoft Ads。

boolean

是否按照搜索用户的时区显示附加电话信息。适用于 Microsoft Ads。

string

此素材资源生效并且可以开始投放的开始日期，格式为 yyyy-MM-dd。

string

此素材资源有效并且仍在投放的最后日期，格式为 yyyy-MM-dd。

{
  "callToAction": enum (CallToActionType)
}

enum (CallToActionType)

号召性用语。

{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}

string

地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。此字段对于给定客户 ID 和素材资源类型而言是唯一的。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-id。

object (BusinessProfileLocation)

客户的营业地点列表。只有在将地址素材资源从商家资料账号同步时，系统才会返回该字符串。同一账号下可以有多个指向同一地点 ID 的商家资料商家信息。

enum (LocationOwnershipType)

营业地点所有权的类型。如果类型为 BUSINESS_OWNER，则将作为附加地址信息投放。如果类型为 AFFILIATE，则将作为关联商户地址提供。

{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}

string

广告客户为商家资料账号中的营业地点指定的标签。这些数据是从商家资料账号同步过来的。

string

此营业地点的商家资料商店代码。这些数据是从商家资料账号同步过来的。

string (int64 format)

此商家资料营业地点的商家信息 ID。这些数据是从关联的商家资料账号同步过来的。

{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}

string

素材资源组素材资源的资源名称。素材资源组的素材资源资源名称采用以下格式：

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

string

此素材资源组素材资源要关联的素材资源组。

string

此素材资源组素材资源要关联的素材资源。

enum (AssetFieldType)

素材资源在素材资源组中的展示位置说明。例如：HEADLINE、YOUTUBE_VIDEO 等

enum (AssetLinkStatus)

素材资源与素材资源组之间的关联状态。

{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}

string

素材资源组信号的资源名称。素材资源组信号资源名称采用以下格式：

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

string

此素材资源组信号所属的素材资源组。

object (AudienceInfo)

效果最大化广告系列要使用的受众群体信号。

{
  "audience": string
}

string

受众群体资源名称。

{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}

string

素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下格式：

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

string

此素材资源组产品信息组过滤条件所属的素材资源组。

string (int64 format)

ListingGroupFilter 的 ID。

enum (ListingGroupFilterType)

产品信息组过滤条件节点的类型。

enum (ListingGroupFilterVertical)

当前节点树代表的行业。同一树中的所有节点必须属于同一行业。

object (ListingGroupFilterDimension)

此产品信息组用于优化其父级的维度值。对于根组，未定义。

string

父级产品信息组细分的资源名称。对于根产品信息组过滤条件节点，值为 null。

object (ListingGroupFilterDimensionPath)

用于定义此产品信息组过滤条件的维度的路径。

{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}

object (ProductBiddingCategory)

商品报价的出价类别。

object (ProductBrand)

商品优惠的品牌。

object (ProductChannel)

产品优惠的地区。

object (ProductCondition)

商品优惠的条件。

object (ProductCustomAttribute)

商品优惠的自定义属性。

object (ProductItemId)

产品优惠的商品 ID。

object (ProductType)

商品优惠的类型。

{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}

enum (ListingGroupFilterBiddingCategoryLevel)

表示类目中的类别级别。

string (int64 format)

产品出价类别的 ID。

此 ID 相当于 google_product_category ID，如以下文章中所述：https://support.google.com/merchants/answer/6324436

{
  "value": string
}

string

产品品牌的字符串值。

{
  "channel": enum (ListingGroupFilterProductChannel)
}

enum (ListingGroupFilterProductChannel)

locality 的值。