FeedItem

JSON 表示法
FeedItemAttributeValue
- JSON 表示法
GeoTargetingRestriction
FeedItemPlaceholderPolicyInfo
- JSON 表示法
FeedItemValidationStatus
FeedItemValidationError
- 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)` 仅供输出。指明触发了什么验证错误的错误代码。您可以在“description”字段中找到对错误的说明。
`feedAttributeIds[]`	`string (int64 format)` 仅供输出。验证期间标记的 Feed 项中的一组 Feed 属性。如果为空，则表示没有任何特定 Feed 属性与此错误相关联（例如，整个 Feed 项存在的错误）。
`description`	`string` 仅供输出。验证错误的说明。
`extraInfo`	`string` 仅供输出。与验证错误和 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`	标签的指定字符串值包含无效字符
`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`	结构化摘要包含促销文字。