SearchAds360Row

string

广告组的资源名称。广告组资源名称的格式如下：

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

广告组的状态。

enum (AdGroupType)

广告组的类型。

enum (AdGroupAdRotationMode)

广告组的广告轮播模式。

string

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

object (TargetingSetting)

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

string

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

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.ssssss”格式。

string (int64 format)

广告组的 ID。

string

广告组的名称。

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

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

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

string (int64 format)

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

enum (AdGroupEngineStatus)

广告组的引擎状态。

object (TargetRestriction)

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

enum (TargetingDimension)

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

boolean

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

string

广告的资源名称。广告组广告资源名称的格式如下：

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

enum (AdGroupAdStatus)

广告的状态。

object (Ad)

广告。

string

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

string

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

string

附加到此广告的有效标签的资源名称。有效标签是指继承或直接分配给此广告的标签。

string

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

enum (AdGroupAdEngineStatus)

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

string

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

string

广告的资源名称。广告资源名称的格式为：

customers/{customerId}/ads/{adId}

string

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

enum (AdType)

广告的类型。

string (int64 format)

广告的 ID。

string

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

string

广告的名称。此名称仅用于能够标识广告。该名称不必是唯一的，也不会影响投放的广告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持名称字段。

object (SearchAds360TextAdInfo)

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

object (SearchAds360ExpandedTextAdInfo)

与加大型文字广告相关的详细信息。

object (SearchAds360ResponsiveSearchAdInfo)

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

object (SearchAds360ProductAdInfo)

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

object (SearchAds360ExpandedDynamicSearchAdInfo)

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

string

广告的标题。

string

广告说明的第一行。

string

广告说明的第二行。

string

广告的显示网址。

string

广告的显示移动网址。

string (int64 format)

广告的跟踪 ID。

string

广告的标题。

string

广告的第二个标题。

string

广告的第三个标题。

string

广告说明的第一行。

string

广告说明的第二行。

string

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

string

使用分隔符附加到 path1 的文本。

string (int64 format)

广告的跟踪 ID。

object (AdTextAsset)

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

object (AdTextAsset)

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

string

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

string

使用分隔符附加到 path1 的文本。

string (int64 format)

广告的跟踪 ID。

string

素材资源文字。

string

广告说明的第一行。

string

广告说明的第二行。

string (int64 format)

广告的跟踪 ID。

string

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

string

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

string

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

string (int64 format)

拥有有效标签的客户的 ID。

string

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

string

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

string

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

string (int64 format)

标签所属客户的 ID。

string

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

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

string

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

string

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

enum (AssetLinkStatus)

广告组素材资源的状态。

string

广告组素材资源组的资源名称。广告组素材资源组资源名称的格式为：

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

string

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

string

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

enum (AssetSetLinkStatus)

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

string

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

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

string

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

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

number

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

object (DeviceInfo)

设备条件。

enum (Device)

设备类型。

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

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

string

附加到此广告组条件的有效标签的资源名称。有效标签是指继承或直接分配给此广告组条件的标签。

object (PositionEstimates)

针对不同位置的条件出价的估算值。

string

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

string

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

string

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

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)

位置信息。

integer

质量得分。

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

string (int64 format)

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

enum (KeywordMatchType)

关键字的匹配类型。

string

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

enum (ListingGroupType)

产品信息组的类型。

enum (AgeRangeType)

年龄段的类型。

enum (GenderType)

性别的类型。

string

用户名单资源名称。

object (WebpageConditionInfo)

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

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

number

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

string

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

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

enum (WebpageConditionOperand)

网页定位条件的操作数。

enum (WebpageConditionOperator)

网页定位条件的运算符。

string

网页定位条件的参数。

string

目标地理位置常量资源名称。

string

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

string

附加了有效标签的广告组条件。

string

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

string (int64 format)

拥有有效标签的客户的 ID。

string

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

string

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

string

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

string (int64 format)

标签所属客户的 ID。

string

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

string

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

string

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

string (int64 format)

拥有有效标签的客户的 ID。

string

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

string

标签附加到的广告组。

string

分配给广告组的标签。

string (int64 format)

标签所属客户的 ID。

string

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

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

string

资源的资源名称。资产资源名称的格式为：

customers/{customerId}/assets/{assetId}

enum (AssetType)

资源的类型。

string

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

enum (AssetStatus)

素材资源的状态。

string

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

string

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

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)

统一的地址素材资源。

string

YouTube 视频标题。

string

YouTube 视频 ID。这是 YouTube 视频网址中使用的 11 个字符的字符串值。

enum (MimeType)

图片素材资源的 MIME 类型。

object (ImageDimension)

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

string (int64 format)

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

string (int64 format)

图片的高度。

string (int64 format)

图片的宽度。

string

用于返回此高度和宽度的图片的网址。

string

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

string

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

string

此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。

string

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

object (AdScheduleInfo)

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

boolean

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

enum (MinuteOfHour)

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

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

enum (MinuteOfHour)

此时间表结束的结束小时之后的分钟数。时间表不含结束分钟数。

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

enum (DayOfWeek)

投放时间是星期几。

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

integer

24 小时制的整点启动时间。此字段必须介于 0 到 23 之间（包括这两个数值）。

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

integer

结束时间（采用 24 小时制）；24 表示一天结束。此字段必须介于 0 到 24 之间（包括这两个数值）。

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

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!“仅限日本”字段。

boolean

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

boolean

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

string

广告客户要定位到的网页。

string

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

string

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

enum (MobileAppVendor)

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

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。

enum (CallToActionType)

号召性用语。

string

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

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

地点所有权类型。如果类型为 BUSINESS_OWNER，则会作为附加地址信息投放。如果类型为“AFFILIATE”（联属营业地点），则会作为联属营业地点投放。

string

广告客户为商家资料账号中的营业地点指定的标签。此信息会从商家资料账号同步。

string

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

string (int64 format)

此商家资料营业地点的商家信息 ID。此信息会从关联的商家资料账号同步过来。