FeedItem

JSON 表示法
FeedItemAttributeValue <ph type="x-smartling-placeholder">
- JSON 表示法
GeoTargetingRestriction
FeedItemPlaceholderPolicyInfo <ph type="x-smartling-placeholder">
- JSON 表示法
FeedItemValidationStatus
FeedItemValidationError <ph type="x-smartling-placeholder">
- JSON 表示法
FeedItemValidationError
FeedItemQualityApprovalStatus
FeedItemQualityDisapprovalReason

Feed 项。

JSON 表示法

JSON 表示法
{ "resourceName": string, "attributeValues": [ { object (`FeedItemAttributeValue`) } ], "geoTargetingRestriction": enum (`GeoTargetingRestriction`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "status": enum (`FeedItemStatus`), "policyInfos": [ { object (`FeedItemPlaceholderPolicyInfo`) } ], "feed": string, "id": string, "startDateTime": string, "endDateTime": string }

{
  "resourceName": string,
  "attributeValues": [
    {
      object (FeedItemAttributeValue)
    }
  ],
  "geoTargetingRestriction": enum (GeoTargetingRestriction),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (FeedItemStatus),
  "policyInfos": [
    {
      object (FeedItemPlaceholderPolicyInfo)
    }
  ],
  "feed": string,
  "id": string,
  "startDateTime": string,
  "endDateTime": string
}

字段
`resourceName`	`string` 不可变。Feed 项的资源名称。Feed 项资源名称采用以下格式： `customers/{customerId}/feedItems/{feedId}~{feed_item_id}`
`attributeValues[]`	`object (FeedItemAttributeValue)` Feed 项的属性值。
`geoTargetingRestriction`	`enum (GeoTargetingRestriction)` 地理位置定位限制用于指定可用于定位的地理位置类型。
`urlCustomParameters[]`	`object (CustomParameter)` 用于替换 `trackingUrlTemplate`、`finalUrls` 或 `mobile_final_urls` 中的自定义参数标记的映射列表。
`status`	`enum (FeedItemStatus)` 仅限输出。Feed 项的状态。此字段为只读字段。
`policyInfos[]`	`object (FeedItemPlaceholderPolicyInfo)` 仅限输出。有效 Feed 映射的 Feed 项验证和审批状态相关信息列表。与 Feed 相关联的每类 Feed 映射都会在列表中有一个条目。例如，如果 Feed 中包含附加链接和来电 Feed 映射，则与该 Feed 相关联的每个 Feed 项在此列表中针对附加链接和附加电话信息都有对应的条目。此字段为只读字段。
`feed`	`string` 不可变。此 Feed 项所属的 Feed。
`id`	`string (int64 format)` 仅限输出。此 Feed 项的 ID。
`startDateTime`	`string` 此 Feed 项生效且可开始投放的开始时间。时间采用客户所在的时区。格式为“YYYY-MM-DD HH:MM:SS”。例如：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
`endDateTime`	`string` 此 Feed 项失效并将停止投放的结束时间。时间采用客户所在的时区。格式为“YYYY-MM-DD HH:MM:SS”。例如：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”

FeedItemAttributeValue

Feed 项属性值。

JSON 表示法

JSON 表示法
{ "priceValue": { object (`Money`) }, "integerValues": [ string ], "booleanValues": [ boolean ], "stringValues": [ string ], "doubleValues": [ number ], "feedAttributeId": string, "integerValue": string, "booleanValue": boolean, "stringValue": string, "doubleValue": number }

{
  "priceValue": {
    object (Money)
  },
  "integerValues": [
    string
  ],
  "booleanValues": [
    boolean
  ],
  "stringValues": [
    string
  ],
  "doubleValues": [
    number
  ],
  "feedAttributeId": string,
  "integerValue": string,
  "booleanValue": boolean,
  "stringValue": string,
  "doubleValue": number
}

字段
`priceValue`	`object (Money)` 价格值。如果 feedAttributeId 引用 PRICE 类型的 Feed 属性，则应设置该值。
`integerValues[]`	`string (int64 format)` int64 值重复。如果 feedAttributeId 引用 INT64_LIST 类型的 Feed 属性，则应设置此字段。
`booleanValues[]`	`boolean` 重复的布尔值。如果 feedAttributeId 引用 BOOLEAN_LIST 类型的 Feed 属性，则应设置此字段。
`stringValues[]`	`string` 字符串值重复。如果 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[]`	`number` 重复的双精度值。如果 feedAttributeId 引用 DOUBLE_LIST 类型的 Feed 属性，则应设置此字段。
`feedAttributeId`	`string (int64 format)` 与该值相关联的 Feed 属性的 ID。
`integerValue`	`string (int64 format)` Int64 值。如果 feedAttributeId 引用 INT64 类型的 Feed 属性，则应设置此字段。
`booleanValue`	`boolean` 布尔值。如果 feedAttributeId 引用 BOOLEAN 类型的 Feed 属性，则应设置此字段。
`stringValue`	`string` 字符串值。如果 feedAttributeId 引用 STRING、网址或 DATE_TIME 类型的 Feed 属性，则应设置。对于 STRING，长度上限为 1500 个字符。网址的长度上限为 2076 个字符。对于 DATE_TIME，字符串必须采用“YYYYMMDD HHMMSS”格式。
`doubleValue`	`number` 双精度值。如果 feedAttributeId 引用 DOUBLE 类型的 Feed 属性，则应设置此字段。

GeoTargetingRestriction

用于确定是否应匹配请求上下文的地理位置的限制。

枚举
`UNSPECIFIED`	未指定。
`UNKNOWN`	仅用于返回值。表示此版本中未知的值。
`LOCATION_OF_PRESENCE`	指示请求上下文应与用户的实际位置相匹配。

FeedItemPlaceholderPolicyInfo

指定占位符类型的 Feed 项的政策、验证和质量审批信息。

JSON 表示法

JSON 表示法
{ "placeholderTypeEnum": enum (`PlaceholderType`), "reviewStatus": enum (`PolicyReviewStatus`), "approvalStatus": enum (`PolicyApprovalStatus`), "policyTopicEntries": [ { object (`PolicyTopicEntry`) } ], "validationStatus": enum (`FeedItemValidationStatus`), "validationErrors": [ { object (`FeedItemValidationError`) } ], "qualityApprovalStatus": enum (`FeedItemQualityApprovalStatus`), "qualityDisapprovalReasons": [ enum (`FeedItemQualityDisapprovalReason`) ], "feedMappingResourceName": string }

{
  "placeholderTypeEnum": enum (PlaceholderType),
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus),
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "validationStatus": enum (FeedItemValidationStatus),
  "validationErrors": [
    {
      object (FeedItemValidationError)
    }
  ],
  "qualityApprovalStatus": enum (FeedItemQualityApprovalStatus),
  "qualityDisapprovalReasons": [
    enum (FeedItemQualityDisapprovalReason)
  ],
  "feedMappingResourceName": string
}

字段
`placeholderTypeEnum`	`enum (PlaceholderType)` 仅限输出。占位符类型。
`reviewStatus`	`enum (PolicyReviewStatus)` 仅限输出。占位符类型处于审核流程中的哪个阶段。
`approvalStatus`	`enum (PolicyApprovalStatus)` 仅限输出。占位符类型的总体审批状态，根据其各个政策主题条目的状态计算得出。
`policyTopicEntries[]`	`object (PolicyTopicEntry)` 仅限输出。占位符类型的政策发现结果列表。
`validationStatus`	`enum (FeedItemValidationStatus)` 仅限输出。占位符类型的验证状态。
`validationErrors[]`	`object (FeedItemValidationError)` 仅限输出。占位符类型验证错误列表。
`qualityApprovalStatus`	`enum (FeedItemQualityApprovalStatus)` 仅限输出。占位符类型质量评估审批状态。
`qualityDisapprovalReasons[]`	`enum (FeedItemQualityDisapprovalReason)` 仅限输出。占位符类型质量评估未获批准的原因列表。
`feedMappingResourceName`	`string` 仅限输出。包含占位符类型的 FeedMapping。

FeedItemValidationStatus

Feed 项可能的验证状态。

枚举
`UNSPECIFIED`	未指定值。
`UNKNOWN`	仅用于返回值。表示此版本中未知的值。
`PENDING`	正在等待验证。
`INVALID`	发现错误。
`VALID`	Feed 项的语义格式正确。

FeedItemValidationError

存储验证错误和一组违规的 Feed 属性，两者共同导致 Feed 项验证错误。

JSON 表示法
{ "validationError": enum (`FeedItemValidationError`), "feedAttributeIds": [ string ], "description": string, "extraInfo": string }

字段
`validationError`	`enum (FeedItemValidationError)` 仅限输出。指明所触发的验证错误的错误代码。有关错误的说明，请参阅“说明”字段。
`feedAttributeIds[]`	`string (int64 format)` 仅限输出。Feed 项中标记了验证期间标记的一组 Feed 属性。如果为空，则表示没有任何具体的 Feed 属性与错误相关联（例如，整个 Feed 项中的错误）。
`description`	`string` 仅限输出。对验证错误的说明。
`extraInfo`	`string` 仅限输出。与此错误相关的任何额外信息，均未被 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`	FeedItem 投放时间设置的开始日期晚于结束日期。
`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`	结构化摘要包含促销文字。