库存概览

概览

Actions Center 中的商品目录查看器可让您了解地图注点 (POI) 本地商品目录的提取运行状况、地点匹配状态和投放资格。

此查看器显示的问题与个别提取无关，这些问题是有状态的问题，代表每个服务提供商的有效服务状态，其中包含可能发生的任何可能的故障模式（政策、警告、错误等）。

使用此工具可实现以下目的：

• 搜索和检查所有已提取的服务提供商及其直播服务状态。
• 诊断数据验证错误和内容违规问题。
• 针对任何违规行为提交和跟踪申诉。
• 检查服务提供商匹配诊断信息并提交人工匹配建议。
• 查看最新 Feed 提取中的原始 JSON 载荷。

“目录”表列

列表视图会显示兴趣点 (POI) Feed 中的所有已上传服务提供商，并按实体分层整理。您可以按本地地图注点 ID、匹配状态、集成和平台进行过滤。

地图注点详情视图

点击列表视图中的任意 POI ID 即可前往相应实体的专用详情页面。

详情视图包含四个可展开的部分：

1. 基本信息

总结了高级别实体元数据：

• POI 名称：从 data[].name.localizations 解析的场所名称。
• POI ID：唯一的合作伙伴实体标识符 (poi_id)。
• 数据源：提取此实体时所用的确切 Feed 文件名。

2. 服务状态

按集成方式和目标平台细分投放资格：

• 集成和界面：垂直和目标界面（例如 Search 上的 Local Aggregator Unit）。
• 投放状态：当前的 Enabled 或 Disabled 状态。
• 问题：显示所有有效错误或警告的问题徽章（例如 Unmatched entity、Policy Violation）。点击问题徽章会打开问题详情面板。
• 申诉：显示覆盖或申诉状态（Under review、Approved 或 Rejected）。

3. 匹配信息

显示地点匹配诊断信息：

• 匹配输入：从 Feed 中解析出的格式化实际地址（street_address、locality、region、postal_code、country）。
• 匹配类型：匹配解析机制（例如 Location）。
• 匹配命名空间：匹配更改将应用到的行业（例如 Local Aggregator Unit）。
• 匹配状态：Yes（绿色）或 No（红色）。
• 匹配输出：解析后的 Google 地图地点名称、地址和地点 ID。
• 修改匹配项：用于打开匹配项建议对话框的按钮。

4. 原始 JSON

提供一个交互式代码视图，其中包含行号和语法突出显示，可显示完整的已解析 JSON 载荷 (item_proto)，以便快速进行架构调试和验证。此处显示的数据值将反映从地图注点 Feed 接收的值。

问题和分类工作流

被标记为存在问题的实体会被停用（如果标记为存在错误）或降级（如果标记为存在警告）。目前，您无法针对带有警告的实体问题提出申诉，但可以通过解决根本问题来消除警告。

问题类型：可申诉与不可申诉

1. 不可申诉的问题（技术和数据质量验证）：
   • 由架构错误、缺少必填字段、坐标无效、网址损坏或 ID 重复引起。
   • 解决方法：合作伙伴必须更正源 Feed 中的基础数据，并上传更新后的 Feed 文件。
2. 可申诉的问题（内容和政策违规）：
   • 当房源文字（名称）或图片素材资源未通过自动内容安全过滤时触发。
   • 解决方法：如果内容符合平台政策，合作伙伴可以点击 Actions Center 中相应问题旁边的申诉按钮，提交申诉。合作伙伴必须提供理由和正当理由，我们的申诉团队将审核并批准或拒绝相应请求。我们会通过该工具和电子邮件通知您审核结果。

本地聚合信息网站单元问题目录

下表列出了本地聚合信息网站单元集成的完整验证错误和政策问题代码：

问题代码

以下部分提供了每个问题代码的详细原因和修复步骤。

缺少必填字段

问题代码： MISSING_REQUIRED_FIELD
严重程度：错误（导致无法投放）
可申诉：否（请通过更新地图注点 Feed 来解决）

当提取的实体缺少地图注点 Feed 规范要求的一个或多个必需属性时，会发生此错误。

查看“问题详情”面板，确定具体缺少哪个属性，然后应用相应的修正措施：

1. 缺少地图注点 ID (poi_id)

• 原因：poi_id 字段为空、为 null 或在根实体对象中缺失。
• 修复方法：为属性提供一个永久性的唯一字符串标识符。

{
  "poi_id": "test_restaurant_1"
}

2. 缺少默认语言区域或本地化名称 (name)

• 原因：name 对象缺少 default_locale 字符串或具有匹配语言区域的 localizations 数组。
• 修复方法：同时提供 default_locale 和至少一个与该语言区域匹配的本地化条目。

{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. 缺少默认语言区域或本地化地址 (display_address)

• 原因：display_address 对象缺少 default_locale 字符串或 localizations 数组。
• 解决方法：同时提供 default_locale 和至少一个与该语言区域匹配的本地化条目，以提供格式化街道地址。

{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. 缺少默认语言区域或本地化说明 (description)

• 原因：包含 description 对象时，缺少 default_locale 或匹配的本地化。
• 解决方法：同时提供 default_locale 和至少一个与该语言区域匹配的本地化条目，以作为说明。

{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. 缺少地理位置坐标 (location.latitude / location.longitude)

• 原因：location 对象缺少 latitude 或 longitude 数值。
• 解决方法：以标准 WGS84 十进制度数的形式提供 latitude 和 longitude（浮点数）。

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. 缺少结构化邮政地址 (location.address)

• 原因：location.address 对象缺少强制性地址组成部分（country、locality 或 postal_code）。
• 补救措施：根据 ISO 标准填充结构化邮政地址对象。

{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. 缺少场所类别的默认语言区域 (local_data.establishment_category.default_locale)

• 原因：存在 local_data.establishment_category 对象，但缺少 default_locale，或者 为空，或者 与 localizations 数组中的任何条目都不匹配。
• 补救措施：为 default_locale 指定有效的 BCP 47 语言标记，并提供至少一个与该语言区域匹配的本地化字符串。

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. 缺少营业时间中的营业日 (local_data.business_hours.time_ranges.open_day)

• 原因：local_data.business_hours.time_ranges 中的条目缺少 open_day，或者该条目设置为 DAY_OF_WEEK_UNSPECIFIED。
• 修复方法：提供有效的星期几字符串（例如 "MONDAY"、"TUESDAY" 等）。

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. 缺少营业时间开放时间 (local_data.business_hours.time_ranges.open_time)

• 原因：local_data.business_hours.time_ranges 中的条目缺少 open_time 对象。
• 补救措施：指定 open_time，其中 hours 为 0 到 23，minutes 为 0 到 59。

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. 缺少营业时间结束日期 (local_data.business_hours.time_ranges.close_day)

• 原因：local_data.business_hours.time_ranges 中的条目缺少 close_day，或者该条目设置为 DAY_OF_WEEK_UNSPECIFIED。
• 修复方法：提供有效的星期几字符串（例如 "MONDAY"、"TUESDAY" 等）。

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. 缺少营业时间结束时间 (local_data.business_hours.time_ranges.close_time)

• 原因：local_data.business_hours.time_ranges 中的条目缺少 close_time 对象。
• 补救措施：指定 close_time，其中 hours 为 0 到 23，minutes 为 0 到 59。

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. 缺少品牌 ID (local_data.brand_landing_pages.brand_id)

• 原因：local_data.brand_landing_pages 中的某个条目具有空、null 或缺失的 brand_id。
• 补救措施：提供与您注册的合作伙伴品牌配置相符的非空字符串标识符。

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. 缺少品牌默认网址 (local_data.brand_landing_pages.default_url)

• 原因：local_data.brand_landing_pages 中的某个条目缺少 default_url，或者该条目是空字符串。
• 解决方法：为语言区域与本地化网址不匹配的用户提供有效的后备 HTTP/HTTPS 着陆页网址。

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. 缺少品牌本地化着陆页网址 (local_data.brand_landing_pages.localized_landing_pages.url)

• 原因：localized_landing_pages 中的某个项缺少 url 字段或该字段为空。
• 解决方法：为本地化着陆页提供有效的、完全限定的 HTTP/HTTPS 网址。

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. 缺少品牌本地化着陆页语言区域 (local_data.brand_landing_pages.localized_landing_pages.locales)

• 原因：localized_landing_pages 中的某个商品缺少或包含空的 locales 数组。
• 修正措施：在 locales 数组中提供至少一个有效的 BCP 47 语言或语言区域代码（例如 ["en-US"]）。

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

超出图片数量上限

问题代码： EXCEEDED_MAX_COUNT
严重程度：警告
可申诉：否（通过更新 Feed 载荷来解决）

当 POI 实体载荷在 images 数组中包含超过 5 个图片对象时，就会发生此错误。

补救措施：

• 修剪 images 数组，使其最多包含 5 张高质量、具有代表性的本地房源照片。
• 超出 5 张上限的图片将被舍弃。

地理坐标无效

问题代码： INVALID_LATLNG
严重程度：错误（导致无法投放）
可申诉：否（通过更新 Feed 载荷解决）

如果 location.latitude 或 location.longitude 中提供的地理坐标超出有效球面边界或表示未填充的 null 坐标，就会出现此错误。

常见原因和补救措施：

• 纬度超出范围：纬度必须是介于 -90.0 到 90.0（含）之间的浮点数。
• 经度超出范围：经度必须是介于 -180.0 到 180.0（含）之间的浮点数。
• Null Island (0,0)：提交 0.0, 0.0 或占位整数（例如 999, 999）会导致坐标被拒。
• 坐标颠倒：验证序列化流水线中的纬度和经度是否颠倒。

有效载荷示例：

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

网址格式不正确或无效

问题代码： INVALID_ATTRIBUTE_VALUE
严重程度：错误（导致无法投放）
可申诉：否（通过更新 Feed 载荷解决）

当属性值未能通过架构验证时，会发生此错误，最常见的情况是合作伙伴着陆页网址或图片网址在语法上无效。

要求：

• 协议：网址必须明确指定 http:// 或 https://（强烈建议使用 HTTPS）。
• 编码：包含特殊字符、空格或非 ASCII 字符的网址必须经过适当的百分号编码 (RFC 3986)。
• 规范域名：确保域名是完全限定的（例如 https://example.com/local/123，而不是 example.com/local/123 或 www.example）。

有效载荷示例：

{
  "url": "https://www.tastybitestest.com/en"
}

图片无效或无法访问

问题代码： INVALID_IMAGE
严重程度：警告
可申诉：否（通过更新 Feed 载荷来解决）

当 Google 的抓取工具无法从 image.url 下载、解码或验证媒体素材资源时，就会在异步图片提取阶段出现此警告。 虽然系统会忽略无效图片，但房源仍符合投放条件。

常见原因和解决方法：

• HTTP 错误（404 / 403 / 500）：图片网址返回非 200 HTTP 状态代码。确保图片可公开访问，无需身份验证、Cookie 墙或 IP 许可清单限制。
• robots.txt 屏蔽：请确保您的内容分发网络 (CDN) 允许 Googlebot 和 Googlebot-Image 用户代理。
• 文件格式不受支持：图片必须采用标准光栅格式（JPEG、PNG、WebP）。不支持 GIF 动画、SVG 和原始相机格式。如需了解详情，请参阅我们的图片指南。
• SSL 证书失败：验证图片托管服务器是否具有有效的 SSL 证书链。

POI ID 重复

问题代码： DUPLICATE_ENTITY
严重程度：错误（导致无法投放）
可申诉：否（通过更新 Feed 载荷解决）

当同一 poi_id 字符串在单个 Feed 文件集中出现多次时，就会发生此错误。

修复：

• 确保 Feed 中的每个本地商家信息都具有唯一的确定性 poi_id。
• 如果某个本地房源有多种房型或房价，请将它们整合到单个根 POI 实体下，而不是发布具有相同 ID 的重复实体记录。

不匹配的实体

问题代码： UNMATCHED_ENTITY
严重程度：错误（导致无法投放）
可申诉：否（请使用地图注点实体匹配工具或更正实体元数据）

此问题表明 Google 的匹配流水线无法将您的本地商家信息与 Google 地图中的规范地点进行协调。

解决方法：

1. 验证核心属性：确保本地房源的 name、display_address、location.address、url、telephone 和 location.latitude/location.longitude 准确反映了房源的实际位置。
2. 检查匹配信息：查看“资源目录视图”中的匹配信息列，了解候选地点。
3. 使用“地图注点匹配修正”工具：点击 Actions Center 中的修改匹配项，手动搜索并确认正确的 Google 地点 ID。如需了解详细说明，请参阅 POI 实体匹配指南。

违反 Google 搜索图片政策

问题代码： SAFE_SEARCH_POLICY_VIOLATION_IMAGE
严重程度：错误（阻止投放）
可申诉：是

请参阅相关政策问题代码：Google 搜索内容图片政策

如果您认为图片被错误标记（假正例），请点击“问题详情”面板中的创建申诉。

违反 Google 搜索内容文字政策 - 名称

问题代码： SAFE_SEARCH_POLICY_VIOLATION_TEXT
严重程度：错误（导致无法投放）
受影响的字段： name.localizations.*.text
可申诉：是

请在此处查看相关违规问题代码：Google 搜索内容文本政策

如果您认为文本被错误标记（假正例），请点击“问题详情”面板中的创建申诉。

违反 Google 搜索内容文本政策 - 说明

问题代码： SAFE_SEARCH_POLICY_VIOLATION_TEXT
严重程度：警告
受影响的字段： description.localizations.*.text
可申诉：否（通过更新 Feed 载荷解决）

请在此处查看相关违规问题代码：Google 搜索内容文本政策

违反 Google 搜索内容文字政策 - 显示地址

问题代码： SAFE_SEARCH_POLICY_VIOLATION_TEXT
严重程度：警告
受影响的字段： display_address.localizations.*.text
可申诉：否（通过更新 Feed 载荷解决）

请参阅以下相关政策问题代码：Google 搜索内容文字政策

营业时间的开始时间晚于结束时间

问题代码： NOT_LESS_THAN_FIELD
严重级别：错误（导致无法投放）
受影响的字段： local_data.business_hours.time_ranges.open_time、local_data.business_hours.time_ranges.close_time
可申诉：否（通过更新 Feed 载荷来解决）

如果营业时间 open_time 晚于或等于同一天区间的 close_time，就会出现此错误。

常见原因和补救措施：

• 当天倒置：确保 open_time 早于 close_time（例如 09:00 至 17:00）。
• 通宵营业：如果商家在某一天开业，并在午夜过后到第二天凌晨关门（例如，21:00 至 02:00），请将 close_day 设置为第二天（例如，open_day："FRIDAY"，close_day："SATURDAY"）。

有效载荷示例：

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

价格范围的最小值大于最大值

问题代码： INVALID_PRICE_RANGE
严重级别：错误（导致无法投放）
受影响的字段： local_data.price_range.min_price、local_data.price_range.max_price
可申诉：否（通过更新 Feed 载荷来解决）

当 min_price 的值超过 max_price 时，或者如果 min_price 和 max_price 指定了不同的货币代码，则会发生此错误。

常见原因和解决方法：

• 值颠倒：确保 min_price 小于或等于 max_price。
• 币种不一致：请验证 min_price.currency_code 和 max_price.currency_code 是否都与同一个 ISO 4217 三字母货币代码（例如 "USD"）相匹配。

有效载荷示例：

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

地图注点内的唯一属性重复

问题代码： DUPLICATE_UNIQUE_PROPERTY
严重程度：错误（导致无法投放）
可申诉：否（通过更新 Feed 载荷解决）

如果需要在一个 POI 实体中保持唯一性的字段或子元素包含重复条目，就会发生此错误。

查看“问题详情”面板，确定哪个房源违反了唯一性要求：

1. POI (local_data.brand_landing_pages.brand_id) 内的品牌 ID 重复

• 原因：同一 brand_id 字符串出现在单个地图注点的多个 brand_landing_pages 条目中。
• 解决方法：将该品牌的所有着陆页整合到一个 brand_landing_pages 对象中。

有效载荷示例：

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. 品牌本地化着陆页网址 (local_data.brand_landing_pages.localized_landing_pages.url) 重复

• 原因：在 localized_landing_pages 下，为同一品牌多次定义了完全相同的着陆页网址。
• 解决方法：确保每个网址条目都是唯一的，或者在单个网址条目的 locales 数组下关联多个语言区域。

有效载荷示例：

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. 重复的品牌本地化着陆页语言区域 (local_data.brand_landing_pages.localized_landing_pages.locales)

• 原因：同一品牌在 localized_landing_pages 中的多个条目中重复使用相同的语言区域代码（例如 "en-US"）。
• 解决方法：将每个语言区域代码分配给一个本地化着陆页。

有效载荷示例：

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

品牌网址格式有误或无效

问题代码： INVALID_ATTRIBUTE_VALUE
严重程度：错误（阻止投放）
可申诉：否（通过更新 Feed 载荷来解决）
受影响的字段： local_data.brand_landing_pages.default_url、local_data.brand_landing_pages.localized_landing_pages.url

当品牌默认网址或本地化着陆页网址未通过 URI 语法验证时，就会发生此错误。

要求：

• 协议：必须明确指定 http:// 或 https://（https:// 是生产环境服务所必需的）。
• 语法：必须是有效的、经过百分号编码且符合 RFC 3986 标准的网址，并包含完全限定域名。

有效载荷示例：

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

违反 Google 搜索内容文本政策 - 场所类别

问题代码： SAFE_SEARCH_POLICY_VIOLATION_TEXT
严重程度：警告
可申诉：否
受影响的字段： local_data.establishment_category.localizations.*.text

如果非默认本地化场所类别文本未通过自动安全搜索内容过滤器，则会出现此警告。

补救措施：

• 政策合规性：请移除被标记的场所类别文字，或将其替换为符合 Google 搜索内容文字政策的标准业务类别字词

有效载荷示例：

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}