- JSON 表示法
- FeedItemAttributeValue
- GeoTargetingRestriction
- FeedItemPlaceholderPolicyInfo
- FeedItemValidationStatus
- FeedItemValidationError
- FeedItemValidationError
- FeedItemQualityApprovalStatus
- FeedItemQualityDisapprovalReason
Feed 项。
JSON 表示法 |
---|
{ "resourceName": string, "attributeValues": [ { object ( |
字段 | |
---|---|
resourceName |
不可变。Feed 项的资源名称。Feed 项资源名称采用以下形式:
|
attributeValues[] |
Feed 项的属性值。 |
geoTargetingRestriction |
地理位置定位限制用于指定可用于定位的地理位置类型。 |
urlCustomParameters[] |
用于替换 |
status |
仅供输出。Feed 项的状态。此字段为只读字段。 |
policyInfos[] |
仅供输出。关于 Feed 项有效 Feed 映射的验证和审批状态的信息列表。对于与该 Feed 关联的每种类型的 Feed 映射,列表中都会有一个对应的条目。例如,如果 Feed 具有站内链接和来电 Feed 映射,则会导致与该 Feed 关联的每个 Feed 项在此列表中同时具有附加链接和附加电话信息的条目。此字段为只读字段。 |
feed |
不可变。此 Feed 项所属的 Feed。 |
id |
仅供输出。此 Feed 项的 ID。 |
startDateTime |
此 Feed 项生效并可开始投放的开始时间。该时间采用客户所在的时区。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
endDateTime |
此 Feed 项不再生效并将停止投放的结束时间。该时间采用客户所在的时区。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
FeedItemAttributeValue
Feed 项属性值。
JSON 表示法 |
---|
{
"priceValue": {
object ( |
字段 | |
---|---|
priceValue |
价格值。如果 feedAttributeId 引用 PRICE 类型的 Feed 属性,则应设置此字段。 |
integerValues[] |
重复的 int64 值。如果 feedAttributeId 引用 INT64_LIST 类型的 Feed 属性,则应设置此字段。 |
booleanValues[] |
重复的 Bool 值。如果 feedAttributeId 引用 BOOLEAN_LIST 类型的 Feed 属性,则应该设置此字段。 |
stringValues[] |
字符串值重复。如果 feedAttributeId 引用 STRING_LIST、网址_LIST 或 DATE_TIME_LIST 类型的 Feed 属性,则应设置此字段。对于 STRING_LIST 和 网址_LIST,列表的总大小(以字节为单位)不能超过 3000。对于 DATE_TIME_LIST,元素数量不得超过 200。 对于 STRING_LIST,每个字符串元素的长度上限为 1500 个字符。对于 网址_LIST,长度上限为 2076 个字符。对于 DATE_TIME,字符串的格式必须与 Feed 项的开始和结束时间相同。 |
doubleValues[] |
重复的双精度值。如果 feedAttributeId 引用 DOUBLE_LIST 类型的 Feed 属性,则应设置此字段。 |
feedAttributeId |
与该值相关联的 Feed 属性的 ID。 |
integerValue |
Int64 值。如果 feedAttributeId 引用 INT64 类型的 Feed 属性,则应设置值。 |
booleanValue |
布尔值。如果 feedAttributeId 引用 BOOLEAN 类型的 Feed 属性,则应该设置此字段。 |
stringValue |
字符串值。如果 feedAttributeId 引用 STRING、网址 或 DATE_TIME 类型的 Feed 属性,则应设置此字段。对于 STRING,长度上限为 1500 个字符。网址的长度上限为 2076 个字符。对于 DATE_TIME,字符串必须采用“YYYYMMDD HHMMSS”格式。 |
doubleValue |
双精度值。如果 feedAttributeId 引用 DOUBLE 类型的 Feed 属性,则应设置该属性。 |
GeoTargetingRestriction
一种限制,用于确定是否应匹配请求上下文的地理位置。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
LOCATION_OF_PRESENCE |
指示请求上下文应与用户的实际位置相匹配。 |
FeedItemPlaceholderPolicyInfo
指定占位符类型的 Feed 项的政策、验证和质量审批信息。
JSON 表示法 |
---|
{ "placeholderTypeEnum": enum ( |
字段 | |
---|---|
placeholderTypeEnum |
仅供输出。占位符类型。 |
reviewStatus |
仅供输出。占位符类型处于审核流程中的什么位置。 |
approvalStatus |
仅供输出。占位符类型的整体审批状态,根据其各个政策主题条目的状态计算得出。 |
policyTopicEntries[] |
仅供输出。占位符类型的政策发现结果列表。 |
validationStatus |
仅供输出。占位符类型的验证状态。 |
validationErrors[] |
仅供输出。占位符类型验证错误列表。 |
qualityApprovalStatus |
仅供输出。占位符类型质量评估审批状态。 |
qualityDisapprovalReasons[] |
仅供输出。占位符类型质量评估拒批原因列表。 |
feedMappingResourceName |
仅供输出。包含占位符类型的 FeedMapping。 |
FeedItemValidationStatus
Feed 项可能的验证状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PENDING |
正在等待验证。 |
INVALID |
发现错误。 |
VALID |
Feed 项在语义上非常规范。 |
FeedItemValidationError
存储验证错误和一组违规的 Feed 属性,它们共同导致 Feed 项验证错误。
JSON 表示法 |
---|
{
"validationError": enum ( |
字段 | |
---|---|
validationError |
仅供输出。指明触发了什么验证错误的错误代码。可在“description”字段中找到对错误的说明。 |
feedAttributeIds[] |
仅供输出。Feed 项中在验证过程中标记的一组 Feed 属性。如果为空,则表示没有特定 Feed 属性与错误相关联(例如,整个 Feed 项存在错误)。 |
description |
仅供输出。对验证错误的说明。 |
extraInfo |
仅供输出。与此错误相关且没有被 VerificationError 和 feedAttributeId 捕获的任何额外信息(例如,未映射 feedAttributeId 时的占位符字段 ID)。请注意,extraInfo 未本地化。 |
FeedItemValidationError
Feed 项可能出现的验证错误。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
STRING_TOO_SHORT |
字符串过短。 |
STRING_TOO_LONG |
字符串过长。 |
VALUE_NOT_SPECIFIED |
未提供值。 |
INVALID_DOMESTIC_PHONE_NUMBER_FORMAT |
电话号码格式对于区域无效。 |
INVALID_PHONE_NUMBER |
字符串不表示电话号码。 |
PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY |
电话号码格式与国家/地区代码不兼容。 |
PREMIUM_RATE_NUMBER_NOT_ALLOWED |
不允许使用收费特服电话号码。 |
DISALLOWED_NUMBER_TYPE |
不允许使用此电话号码类型。 |
VALUE_OUT_OF_RANGE |
指定的值不在有效范围内。 |
CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY |
所选国家/地区不支持来电跟踪。 |
CUSTOMER_NOT_IN_ALLOWLIST_FOR_CALLTRACKING |
客户未列入通话跟踪的许可名单。 |
INVALID_COUNTRY_CODE |
国家/地区代码无效。 |
INVALID_APP_ID |
指定的移动应用 ID 无效。 |
MISSING_ATTRIBUTES_FOR_FIELDS |
缺少某些必填字段属性。 |
INVALID_TYPE_ID |
附加电子邮件信息的电子邮件按钮类型无效。 |
INVALID_EMAIL_ADDRESS |
电子邮件地址无效。 |
INVALID_HTTPS_URL |
附加电子邮件信息中的 HTTPS 网址无效。 |
MISSING_DELIVERY_ADDRESS |
附加电子邮件信息中缺少递送地址。 |
START_DATE_AFTER_END_DATE |
Feed 项的投放时间设置开始日期晚于结束日期。 |
MISSING_FEED_ITEM_START_TIME |
缺少 FeedItem 投放时间设置开始时间。 |
MISSING_FEED_ITEM_END_TIME |
缺少 FeedItem 投放时间设置结束时间。 |
MISSING_FEED_ITEM_ID |
无法计算不含 FeedItemId 的 FeedItem 的系统属性。 |
VANITY_PHONE_NUMBER_NOT_ALLOWED |
不支持附加电话信息的个性化电话号码。 |
INVALID_REVIEW_EXTENSION_SNIPPET |
评价文字无效。 |
INVALID_NUMBER_FORMAT |
广告参数中数值的格式无效。 |
INVALID_DATE_FORMAT |
广告参数中的日期值无效。 |
INVALID_PRICE_FORMAT |
广告参数中价格值的格式无效。 |
UNKNOWN_PLACEHOLDER_FIELD |
为广告参数的值指定了无法识别的类型。 |
MISSING_ENHANCED_SITELINK_DESCRIPTION_LINE |
增强型附加链接必须指定两行广告内容描述。 |
REVIEW_EXTENSION_SOURCE_INELIGIBLE |
评价来源不符合条件。 |
HYPHENS_IN_REVIEW_EXTENSION_SNIPPET |
评价文字不能包含连字符和破折号。 |
DOUBLE_QUOTES_IN_REVIEW_EXTENSION_SNIPPET |
评价文字不能包含双引号。 |
QUOTES_IN_REVIEW_EXTENSION_SNIPPET |
评价文字不能包含引号。 |
INVALID_FORM_ENCODED_PARAMS |
参数的编码格式有误。 |
INVALID_URL_PARAMETER_NAME |
网址参数名称只能包含字母、数字、下划线和短划线。 |
NO_GEOCODING_RESULT |
无法找到该地址对应的位置。 |
SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT |
附加评价信息的文字有来源名称。 |
CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED |
有些电话号码可能会比平常短。其中一些短号码是运营商独有的,我们不允许在广告附加信息中使用此类短号码,因为它们并非所有用户都可以使用。 |
INVALID_PLACEHOLDER_FIELD_ID |
当请求引用的占位符字段 ID 不存在时触发。 |
INVALID_URL_TAG |
网址包含无效的 ValueTrack 标记或格式。 |
LIST_TOO_LONG |
提供的列表大小超出了可接受的范围。 |
INVALID_ATTRIBUTES_COMBINATION |
某些属性组合无法在同一个 Feed 项中指定。 |
DUPLICATE_VALUES |
属性反复使用相同的值。 |
INVALID_CALL_CONVERSION_ACTION_ID |
广告客户可以将转化操作与电话号码相关联,以表明转接到该电话号码且时长足够长的来电应计为指定类型的转化。这是一条错误消息,表示指定的转化操作无效(例如,相应的 Google Ads 账号中不存在转化操作,或转化操作类型不适合来电转化)。 |
CANNOT_SET_WITHOUT_FINAL_URLS |
跟踪模板需要设置最终到达网址。 |
APP_ID_DOESNT_EXIST_IN_APP_STORE |
提供的应用 ID 在指定应用商店中不存在。 |
INVALID_FINAL_URL |
U2 最终到达网址无效。 |
INVALID_TRACKING_URL |
U2 跟踪网址无效。 |
INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL |
最终到达网址应以应用下载网址作为开头。 |
LIST_TOO_SHORT |
提供的列表过短。 |
INVALID_USER_ACTION |
“用户操作”字段的值无效。 |
INVALID_TYPE_NAME |
类型字段包含无效值。 |
INVALID_EVENT_CHANGE_STATUS |
对活动的更改状态无效。 |
INVALID_SNIPPETS_HEADER |
附加结构化摘要信息的标题不是有效标题之一。 |
INVALID_ANDROID_APP_LINK |
Android 应用链接的格式不正确 |
NUMBER_TYPE_WITH_CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY |
电话号码与国家/地区的来电跟踪功能不兼容。 |
RESERVED_KEYWORD_OTHER |
输入内容与预留关键字完全相同 |
DUPLICATE_OPTION_LABELS |
附加短信信息中的每个选项标签都必须是唯一的。 |
DUPLICATE_OPTION_PREFILLS |
附加短信信息中的每个预填充选项都必须是唯一的。 |
UNEQUAL_LIST_LENGTHS |
在附加短信信息中,可选标签和可选预填充的数量必须相同。 |
INCONSISTENT_CURRENCY_CODES |
广告附加信息中的所有货币代码必须相同。 |
PRICE_EXTENSION_HAS_DUPLICATED_HEADERS |
附加价格信息中的标题不是唯一的。 |
ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION |
商品的标题和说明相同。 |
PRICE_EXTENSION_HAS_TOO_FEW_ITEMS |
附加价格信息中的商品过少。 |
UNSUPPORTED_VALUE |
不支持指定的值。 |
INVALID_FINAL_MOBILE_URL |
最终到达移动网址无效。 |
INVALID_KEYWORDLESS_AD_RULE_LABEL |
Label 的指定字符串值包含无效字符 |
VALUE_TRACK_PARAMETER_NOT_SUPPORTED |
给定的网址包含 ValueTrack 参数。 |
UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE |
扩展程序的所选语言不支持指定的值。 |
INVALID_IOS_APP_LINK |
iOS 应用链接的格式不正确。 |
MISSING_IOS_APP_LINK_OR_IOS_APP_STORE_ID |
缺少 iOS 应用链接或 iOS App Store ID。 |
PROMOTION_INVALID_TIME |
促销时间无效。 |
PROMOTION_CANNOT_SET_PERCENT_OFF_AND_MONEY_AMOUNT_OFF |
折扣百分比和折扣金额字段均已设置。 |
PROMOTION_CANNOT_SET_PROMOTION_CODE_AND_ORDERS_OVER_AMOUNT |
促销代码和“订单金额须超过”字段均已设置。 |
TOO_MANY_DECIMAL_PLACES_SPECIFIED |
指定的小数点后位数过多。 |
AD_CUSTOMIZERS_NOT_ALLOWED |
存在广告定制工具,但不允许使用。 |
INVALID_LANGUAGE_CODE |
语言代码无效。 |
UNSUPPORTED_LANGUAGE |
语言不受支持。 |
IF_FUNCTION_NOT_ALLOWED |
IF 函数存在但不允许使用。 |
INVALID_FINAL_URL_SUFFIX |
最终到达网址后缀无效。 |
INVALID_TAG_IN_FINAL_URL_SUFFIX |
最终到达网址后缀包含无效的标记。 |
INVALID_FINAL_URL_SUFFIX_FORMAT |
最终到达网址后缀的格式不正确。 |
CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED |
广告客户未就使用附加电话信息时的通话录音征求用户意见。请参阅 https://support.google.com/google-ads/answer/7412639。 |
ONLY_ONE_DELIVERY_OPTION_IS_ALLOWED |
设置了多个邮件递送选项。 |
NO_DELIVERY_OPTION_IS_SET |
未设置邮件递送选项。 |
INVALID_CONVERSION_REPORTING_STATE |
转化报告状态字段的字符串值无效。 |
IMAGE_SIZE_WRONG |
图片大小不正确。 |
EMAIL_DELIVERY_NOT_AVAILABLE_IN_COUNTRY |
国家/地区代码字段中指定的国家/地区不支持电子邮件递送。 |
AUTO_REPLY_NOT_AVAILABLE_IN_COUNTRY |
国家/地区代码字段中指定的国家/地区不支持自动回复。 |
INVALID_LATITUDE_VALUE |
为纬度指定的值无效。 |
INVALID_LONGITUDE_VALUE |
为经度指定的值无效。 |
TOO_MANY_LABELS |
提供的标签字段过多。 |
INVALID_IMAGE_URL |
图片网址无效。 |
MISSING_LATITUDE_VALUE |
缺少纬度值。 |
MISSING_LONGITUDE_VALUE |
缺少经度值。 |
ADDRESS_NOT_FOUND |
找不到地址。 |
ADDRESS_NOT_TARGETABLE |
无法定位到所提供的地址。 |
INVALID_ASSET_ID |
指定的资产 ID 不存在。 |
INCOMPATIBLE_ASSET_TYPE |
无法为该字段设置资产类型。 |
IMAGE_ERROR_UNEXPECTED_SIZE |
图片大小不符合预期。 |
IMAGE_ERROR_ASPECT_RATIO_NOT_ALLOWED |
不支持此图片宽高比。 |
IMAGE_ERROR_FILE_TOO_LARGE |
该图片文件过大。 |
IMAGE_ERROR_FORMAT_NOT_ALLOWED |
图片格式不受支持。 |
IMAGE_ERROR_CONSTRAINTS_VIOLATED |
图片违反了限制条件,但没有提供更多详细信息。 |
IMAGE_ERROR_SERVER_ERROR |
验证图片时出错。 |
FeedItemQualityApprovalStatus
Feed 项可能的质量评估审批状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
APPROVED |
符合所有质量预期。 |
DISAPPROVED |
未达到某些质量预期。具体原因可在“qualityDisapprovalReasons”字段中找到。 |
FeedItemQualityDisapprovalReason
Feed 项可能的质量评估拒批原因。
枚举 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PRICE_TABLE_REPETITIVE_HEADERS |
价格信息包含重复标题。 |
PRICE_TABLE_REPETITIVE_DESCRIPTION |
价格信息包含重复说明。 |
PRICE_TABLE_INCONSISTENT_ROWS |
价格信息包含不一致的商品。 |
PRICE_DESCRIPTION_HAS_PRICE_QUALIFIERS |
价格说明中包含限定词。 |
PRICE_UNSUPPORTED_LANGUAGE |
价格包含不受支持的语言。 |
PRICE_TABLE_ROW_HEADER_TABLE_TYPE_MISMATCH |
价格信息中的商品标题与价格类型不相关。 |
PRICE_TABLE_ROW_HEADER_HAS_PROMOTIONAL_TEXT |
价格信息中的商品标题包含促销文字。 |
PRICE_TABLE_ROW_DESCRIPTION_NOT_RELEVANT |
价格信息中的商品说明与商品标题不相关。 |
PRICE_TABLE_ROW_DESCRIPTION_HAS_PROMOTIONAL_TEXT |
价格信息中的商品说明包含促销文字。 |
PRICE_TABLE_ROW_HEADER_DESCRIPTION_REPETITIVE |
价格信息中的商品标题和说明重复。 |
PRICE_TABLE_ROW_UNRATEABLE |
价格信息中的商品以外语书写、无意义或者无法进行评分。 |
PRICE_TABLE_ROW_PRICE_INVALID |
价格信息中的商品价格无效或不准确。 |
PRICE_TABLE_ROW_URL_INVALID |
价格信息中的商品网址无效或不相关。 |
PRICE_HEADER_OR_DESCRIPTION_HAS_PRICE |
价格信息中的商品标题或说明中含有价格。 |
STRUCTURED_SNIPPETS_HEADER_POLICY_VIOLATED |
结构化摘要值与标题不一致。 |
STRUCTURED_SNIPPETS_REPEATED_VALUES |
结构化摘要值重复。 |
STRUCTURED_SNIPPETS_EDITORIAL_GUIDELINES |
结构化摘要值违反了标点符号等编辑指南。 |
STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT |
结构化摘要包含促销文字。 |