商品目錄檢視畫面

總覽

在動作中心，商品目錄檢視器可讓您查看搜尋點 (POI) 店面商品目錄的擷取健康狀態、地點比對狀態和放送資格。

這個檢視器會顯示與個別擷取作業無關的問題，也就是代表各服務供應商有效服務狀態的有狀態問題，包括可能發生的任何故障模式 (政策、警告、錯誤等)。

只要使用這項工具，您就可以：

• 搜尋及檢查所有擷取的服務供應商及其即時服務狀態。
• 診斷資料驗證錯誤和違反內容政策的問題。
• 提交並追蹤違反政策的申訴。
• 檢查服務供應商比對診斷資料，並提交手動比對提案。
• 查看最近一次動態饋給擷取的原始 JSON 酬載。

商品目錄資料表資料欄

清單檢視畫面會顯示從搜尋點 (POI) 動態饋給上傳的所有服務供應商，並依實體階層排列。您可以依當地搜尋點 ID、比對狀態、整合和平台進行篩選。

摘要表格資料欄	說明
當地搜尋點 ID	動態饋給中提供的當地房源專屬 ID (poi_id)。
當地搜尋點名稱	從動態饋給擷取的本地化當地房源名稱。
比對狀態	指出搜尋點是否已與 Google 地圖商家資訊比對成功： • 是 (綠色徽章)：已成功與 Google 地圖地點比對。 • 否 (紅色徽章)：不相符，需要審查或提出比對建議。
整合	這是本地集結網站單元整合。
Surface	目標服務平台 (例如 Google 搜尋)。
放送狀態	即時放送資格狀態： • 已啟用 (綠色指標)：符合資格，且可在 Google 平台上放送。 • 已停用 (紅色指標)：因驗證錯誤、違反政策或狀態不符而無法放送。
錯誤	嚴重程度為「錯誤」的未解決問題數量。如果房源有任何錯誤，就無法在任何平台上顯示。
警告	嚴重性為「警告」的未解決問題數量。有警告的房源仍可放送。
賽事資訊	包含「編輯比對」按鈕，可開啟互動式比對修正面板。

注意： 資料透過擷取管道傳播通常需要 24 至 48 小時。新擷取或更新的搜尋點可能需要較長時間，才能反映完整比對和服務狀態。

POI 詳細資料檢視畫面

在清單檢視中點選任何「POI ID」，即可前往該實體的專屬詳細資料頁面。

詳細資料檢視畫面包含四個可展開的部分：

1. 基本資訊

摘要說明高階實體中繼資料：

• POI Name：從 data[].name.localizations 剖析出的商家名稱。
• POI ID：不重複的合作夥伴實體 ID (poi_id)。
• 資料來源：擷取這個實體的確切動態饋給檔案名稱。

2. 服務狀態

依整合項目和目標平台，細分放送資格：

• 整合與平台：產業和目標平台 (例如 Search 上的 Local Aggregator Unit)。
• 放送狀態：目前的Enabled或Disabled狀態。
• 問題：顯示所有有效錯誤或警告的問題徽章 (例如 Unmatched entity、Policy Violation)。按一下問題徽章會開啟「Issue Details Panel」。
• 申訴：顯示覆寫或申訴狀態 (Under review、Approved 或 Rejected)。

3. 比對資訊

顯示地點比對診斷資訊：

• 比對輸入內容：從動態饋給剖析的格式化實際地址 (street_address、locality、region、postal_code、country)。
• 比對類型：比對解析機制 (例如 Location)。
• 比對命名空間：比對變更會套用至哪個產業 (例如 Local Aggregator Unit)。
• 比對狀態：Yes (綠色) 或 No (紅色)。
• 比對輸出：解析出的 Google 地圖地點名稱、地址和地點 ID。
• 「編輯比對」：點選這個按鈕，即可開啟比對提案對話方塊。

4. 原始 JSON

提供互動式程式碼檢視器，其中包含行號和語法醒目顯示，可顯示完整剖析的 JSON 酬載 (item_proto)，以便快速偵錯及驗證結構定義。這裡顯示的資料值會反映從 POI 動態饋給收到的值。

問題與分類工作流程

標記為有問題的實體會停用 (如果標記為「錯誤」) 或降級 (如果標記為「警告」)。如果實體問題屬於警告，則無法提出申訴，但只要修正根本問題，即可解決警告。

問題類型：可申訴與不可申訴

1. 無法申訴的問題 (技術、資料品質和警告驗證)：
   • 原因包括結構定義錯誤、缺少必填欄位、座標無效、網址無效、ID 重複，或非封鎖性內容警告 (例如非預設語言代碼的商家名稱，或說明、顯示地址和商家類別的任何語言代碼)。
   • 解決方法：合作夥伴必須修正來源動態饋給中的基礎資料，並上傳更新後的動態饋給檔案。
2. 可申訴的問題 (封鎖內容和違反政策)：
   • 當必要的房源文字或圖片素材資源，未通過自動化內容安全篩選器，且嚴重程度為「錯誤」時，就會觸發這項事件。
   • 解決方法：如果內容符合平台政策，合作夥伴可以點選動作中心問題旁的「申訴」按鈕，提出申訴。合作夥伴必須提供理由和依據，我們的申訴團隊會審查並核准或拒絕要求。我們會透過工具和電子郵件通知你裁決結果。

本地集結網站單元問題目錄

下表列出本地集結網站單元整合的完整驗證錯誤和政策問題代碼：

問題說明	嚴重性	問題代碼	受影響的欄位 / 引數	是否可申訴？	Action / Relevant Policy
缺少 POI ID	ERROR	MISSING_REQUIRED_FIELD	poi_id	否	提供不重複的 poi_id。請參閱搜尋點動態饋給規格。
「name」欄位缺少預設語言代碼	ERROR	MISSING_REQUIRED_FIELD	name.default_locale	否	請為預設語言代碼指定有效的 BCP 47 語言代碼。請參閱「多語言支援」。
找不到「name」欄位的預設本地化設定	ERROR	MISSING_REQUIRED_FIELD	name.localizations	否	請提供與宣告 default_locale 語言相符的搜尋點本地化名稱值。
「description」欄位缺少預設語言代碼	ERROR	MISSING_REQUIRED_FIELD	description.default_locale	否	請為屬性說明指定有效的 BCP 47 預設語言代碼。
找不到「description」欄位的預設本地化設定	ERROR	MISSING_REQUIRED_FIELD	description.localizations	否	提供與宣告的 default_locale 語言相符的說明文字。
「display_address」欄位缺少預設語言代碼	ERROR	MISSING_REQUIRED_FIELD	display_address.default_locale	否	請為顯示地址指定有效的 BCP 47 預設語言代碼。
找不到「display_address」欄位的預設本地化設定	ERROR	MISSING_REQUIRED_FIELD	display_address.localizations	否	提供與宣告的 default_locale 語言相符的格式化地址文字。
超過圖片數量上限	警告	EXCEEDED_MAX_COUNT	images	否	每個搜尋點最多只能有 5 張圖片。多餘的圖片會遭到捨棄。
緯度座標無效	ERROR	INVALID_LATLNG	location.latitude	否	請輸入有效的緯度，介於 -90.0 和 +90.0 之間。請參閱「地理座標定義」。
經度座標無效	ERROR	INVALID_LATLNG	location.longitude	否	請輸入有效的經度，介於 -180.0 和 +180.0 之間。請參閱「地理座標定義」。
缺少緯度座標	ERROR	MISSING_REQUIRED_FIELD	location.latitude	否	請提供緯度值，完成座標組合。請參閱「地理座標定義」。
缺少經度座標	ERROR	MISSING_REQUIRED_FIELD	location.longitude	否	請提供經度值，完成座標組合。請參閱「地理座標定義」。
缺少地址或地址非結構化	ERROR	MISSING_REQUIRED_FIELD	location.address	否	提供結構化郵寄地址，包括街道、地區、郵遞區號和國家/地區。
網址格式錯誤或無效	ERROR	INVALID_ATTRIBUTE_VALUE	url	否	確認到達網頁網址使用支援的 HTTP/HTTPS 通訊協定和有效語法。
圖片無效或無法存取	警告	INVALID_IMAGE	image.url	否	確認圖片網址可公開存取，且不需要驗證或傳回 4xx/5xx 錯誤。
重複的搜尋點 ID	ERROR	DUPLICATE_ENTITY	poi_id	否	請確認動態饋給酬載中的每個 poi_id 都不重複。移除重複項目。
重複的比對實體	ERROR	DUPLICATE_MATCHED_ENTITY	POI	否	請從動態饋給中移除重複項目，或使用搜尋點實體比對工具，將不同商家與其獨立的 Google 地圖商家資訊進行比對。
不相符的實體	ERROR	UNMATCHED_ENTITY	POI	否	使用搜尋點實體比對工具，將搜尋點與 Google 地圖地點資訊進行比對。
違反圖片政策	ERROR	SAFE_SEARCH_POLICY_VIOLATION_IMAGE	image	是	請移除或更換遭標記的圖片，或點選「申訴」提交理由。請參閱 Google 搜尋內容圖片政策。
Text policy violation - Default Name	ERROR	SAFE_SEARCH_POLICY_VIOLATION_TEXT	name.localizations.*.text	是	移除或更換標記的名稱文字，或按一下「申訴」。請參閱 Google 搜尋內容文字政策。
Text policy violation - Non-Default Name	警告	SAFE_SEARCH_POLICY_VIOLATION_TEXT	name.localizations.*.text	否	請移除或更換遭標記的名稱文字。請參閱 Google 搜尋內容文字政策。
文字政策違規 - 說明	警告	SAFE_SEARCH_POLICY_VIOLATION_TEXT	description.localizations.*.text	否	移除或更換遭標記的說明文字。請參閱 Google 搜尋內容文字政策。
文字政策違規 - 顯示地址	警告	SAFE_SEARCH_POLICY_VIOLATION_TEXT	display_address.localizations.*.text	否	請移除或更換遭標記的顯示網址文字。請參閱 Google 搜尋內容文字政策。
缺少商家類別的預設語言代碼	ERROR	MISSING_REQUIRED_FIELD	local_data.establishment_category.default_locale	否	為與宣告的 default_locale 語言相符的搜尋點，提供本地化商家類別的值。
缺少營業時間的營業日	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.open_day	否	請提供有效的營業時間。
缺少營業時間的開始時間	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.open_time	否	提供有效的營業時間。
缺少營業時間 公休日	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.close_day	否	提供有效的營業時間結束日期。
缺少營業時間結束時間	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.close_time	否	提供有效的營業時間結束時間。
營業時間的開始時間晚於結束時間	ERROR	NOT_LESS_THAN_FIELD	local_data.business_hours.time_ranges.open_time，local_data.business_hours.time_ranges.close_time	否	請提供有效的營業時間和打烊時間，並確保營業時間早於打烊時間。
價格範圍下限值大於上限值	ERROR	INVALID_PRICE_RANGE	local_data.price_range.min_price、local_data.price_range.max_price	否	請提供有效的價格範圍，最低價格應低於最高價格。
Missing Brand Id	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.brand_id	否	請提供有效的品牌 ID。
POI 內有重複的品牌 ID	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.brand_id	否	請確認 POI 酬載中的每個 brand_id 都不重複。移除重複項目。
缺少品牌預設網址	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.default_url	否	提供有效的品牌預設網址。
品牌網址格式錯誤或無效	ERROR	INVALID_ATTRIBUTE_VALUE	local_data.brand_landing_pages.default_url	否	請確認品牌預設網址採用支援的 HTTP/HTTPS 通訊協定，且語法有效。
缺少品牌本地化到達網頁網址	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.localized_landing_pages.url	否	請為本地化到達網頁提供有效網址。
品牌本地化到達網頁網址格式錯誤或無效	ERROR	INVALID_ATTRIBUTE_VALUE	local_data.brand_landing_pages.localized_landing_pages.url	否	確認本地化到達網頁網址採用支援的 HTTP/HTTPS 通訊協定和有效語法。
重複的品牌本地化到達網頁網址	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.localized_landing_pages.url	否	請確保每個 url 在 POI 本地化到達網頁中都是不重複的。移除重複項目。
缺少品牌本地化到達網頁語言代碼	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.localized_landing_pages.locales	否	為本地化到達網頁提供一組有效的語言代碼。
品牌本地化到達網頁語言代碼重複	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.localized_landing_pages.locales	否	請確保每個 locale 在 POI 本地化到達網頁中都是不重複的。移除重複項目。
文字政策違規 - 商家類別	警告	SAFE_SEARCH_POLICY_VIOLATION_TEXT	local_data.establishment_category.localizations.*.text	否	請移除或更換標記的商家類別文字。請參閱 Google 搜尋內容文字政策。

問題代碼

以下各節將詳細說明每個問題代碼的原因和修正步驟。

缺少必要欄位

問題代碼： MISSING_REQUIRED_FIELD
嚴重程度：錯誤 (無法放送)
可否申訴：否 (請更新搜尋點動態饋給來解決問題)

如果擷取的實體缺少搜尋點動態饋給規格規定的一或多項必要屬性，就會發生這項錯誤。

查看「Issue Details」(問題詳細資料) 面板，找出缺少的特定屬性，然後套用相應的修正方式：

1. 缺少搜尋點 ID (poi_id)

• 原因：根實體物件中的 poi_id 欄位空白、為空值或遺漏。
• 修復方式：為屬性提供永久的專屬字串 ID。

{
  "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 物件。
• 修復：使用 hours (0 至 23) 和 minutes (0 至 59) 指定 open_time。

{
  "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 物件。
• 修復：使用 hours (0 至 23) 和 minutes (0 至 59) 指定 close_time。

{
  "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 中的項目含有空白、空值或缺少的 brand_id。
• 補救措施：提供與註冊合作夥伴品牌設定相符的非空白字串 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
嚴重程度：警告
可申訴：否 (請更新動態饋給酬載來解決問題)

如果 POI 實體酬載的 images 陣列中包含超過 5 個圖片物件，就會發生這項錯誤。

修復：

• 修剪 images 陣列，最多只保留 5 張當地房源的高畫質代表性相片。
• 超過 5 張的圖片會遭到捨棄。

地理座標無效

問題代碼： INVALID_LATLNG
嚴重程度：錯誤 (無法放送)
可申訴：否 (請更新動態饋給酬載來解決問題)

如果 location.latitude 或 location.longitude 中提供的地理座標超出有效球體範圍，或代表無人居住的空座標，就會發生這項錯誤。

常見原因和修復方式：

• 緯度超出範圍：緯度必須是介於 -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
嚴重程度：錯誤 (無法放送)
可申訴：否 (請更新動態饋給酬載來解決問題)

如果屬性值未通過結構定義驗證，就會發生這項錯誤，最常見的情況是合作夥伴到達網頁網址或圖片網址的語法無效。

需求條件：

• 通訊協定：網址必須明確指定 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
嚴重程度：警告
可申訴：否 (請更新動態饋給酬載來解決問題)

在非同步圖片擷取階段，如果 Google 檢索器無法從 image.url 下載、解碼或驗證媒體素材資源，就會出現這則警告。雖然系統會略過無效圖片，但房源仍符合放送資格。

常見原因和修復方式：

• HTTP 錯誤 (404 / 403 / 500)：圖片網址傳回非 200 的 HTTP 狀態碼。確認圖片可公開存取，不需驗證、Cookie 牆或 IP 許可清單限制。
• Robots.txt 封鎖：確認內容傳遞網路 (CDN) 允許 Googlebot 和 Googlebot-Image 使用者代理程式。
• 不支援的檔案格式：圖片必須採用標準光柵格式 (JPEG、PNG、WebP)。不支援 GIF 動畫、SVG 和原始相機格式。詳情請參閱圖片規範。
• SSL 憑證失敗：確認圖片主機伺服器具有有效的 SSL 憑證鏈結。

重複的搜尋點 ID

問題代碼： DUPLICATE_ENTITY
嚴重程度：錯誤 (無法放送)
可申訴：否 (請更新動態饋給酬載來解決問題)

如果同一個動態饋給檔案集中出現多個相同的 poi_id 字串，就會發生這項錯誤。

修復：

• 請確認動態饋給中的每個本地商家資訊都有專屬且確定的 poi_id。
• 如果當地房源有多種房型或房價，請將這些房型或房價合併到單一根 POI 實體下，而不是發布具有相同 ID 的重複實體記錄。

重複的比對實體

問題代碼： DUPLICATE_MATCHED_ENTITY
嚴重程度：錯誤 (無法放送)
可否申訴：否 (請更新動態饋給酬載，或使用搜尋點實體比對工具來解決問題)

如果動態饋給中有兩個以上不同的 poi_id 項目，與同一個標準 Google 地圖地點資訊相符，就會發生這項錯誤。如果有多個商家對應到同一個 Google 實體，所有衝突的項目都會遭到封鎖，直到重複問題解決為止。

解決方式：

1. 找出衝突的屬性：開啟攝入檢視器 (依序點選「攝入」>「記錄」)，選取最新的攝入執行作業，然後展開「驗證」面板。按一下共用相同「Issue Info」群組 ID 的 DUPLICATE_MATCHED_ENTITY 資料列，即可查看與相同 Google 實體相符的所有 poi_id 記錄。
2. 從動態饋給中移除重複的商家資訊：如果衝突的 poi_id 項目代表同一個實體商家地點，請從動態饋給中移除重複的項目，只為該商家提交一個 poi_id。
3. 調整獨立商家的錯誤比對結果：如果衝突的 poi_id 項目代表不同的獨立商家，但錯誤比對到同一個 Google 實體，請在「商品目錄檢視」中開啟錯誤比對的商家，然後按一下「編輯比對結果」，選取或提議專屬的 Google 地圖地點資訊。詳細操作說明請參閱搜尋點實體比對指南。

不相符的實體

問題代碼： UNMATCHED_ENTITY
嚴重程度：錯誤 (無法放送)
可申訴：否 (請使用搜尋點實體比對工具，或修正實體中繼資料)

這項問題表示 Google 的比對管道無法將您的本地商家資訊與 Google 地圖中的標準地點進行比對。

解決方式：

1. 驗證核心屬性：確認當地 name、display_address、location.address、url、telephone 和 location.latitude/location.longitude 精確反映實體房源位置。
2. 檢查比對資訊：查看「Inventory View」中的「Match Info」欄，找出候選地點。
3. 使用搜尋點比對修正工具：在 Actions Center 中按一下「編輯比對」，手動搜尋並確認正確的 Google 地點 ID。詳細操作說明請參閱搜尋點實體比對指南。

違反 Google 搜尋圖片政策

問題代碼： SAFE_SEARCH_POLICY_VIOLATION_IMAGE
嚴重程度：錯誤 (廣告無法放送)
可申訴：是

相關政策問題代碼如下：Google 搜尋內容圖片政策

如果您認為圖片誤遭標記 (偽陽性)，請在「Issue Details」(問題詳細資料) 面板中按一下「Create Appeal」(提出申訴)。

違反 Google 搜尋內容文字政策 - 名稱

問題代碼： SAFE_SEARCH_POLICY_VIOLATION_TEXT
嚴重性：嚴重性因欄位而異 (詳情請見下文)
受影響的欄位： name.localizations.*.text
可申訴：是 (僅限預設語言代碼錯誤)；否 (非預設語言代碼警告)

• 預設語言代碼 (name.default_locale)： 錯誤 (無法放送)。整個搜尋點都會遭到封鎖，無法放送。如果您認為預設語言代碼名稱文字遭到誤判 (偽陽性)，請在「Issue Details」面板中按一下「Create Appeal」。
• 非預設語言代碼： 警告 (不影響放送)。系統只會省略標記的本地化內容，而該搜尋點仍符合放送資格。非預設語言代碼的警告無法申訴，但可以透過更新動態饋給酬載來解決。

查看相關政策問題代碼：Google 搜尋內容文字政策

違反 Google 搜尋內容文字政策 - 說明

問題代碼： SAFE_SEARCH_POLICY_VIOLATION_TEXT
嚴重程度：警告 (不會阻擋放送)
受影響欄位： description.localizations.*.text
可申訴：否 (請更新動態饋給酬載來解決問題)

如果 description.localizations 中的文字副本因違反 Google 搜尋內容文字政策而遭標記，就會出現這則警告。雖然系統會省略標記的說明本地化 (如果標記預設語言代碼，則會省略整個 description 欄位)，但 POI 仍可放送。

查看相關政策問題代碼：Google 搜尋內容文字政策

違反 Google 搜尋內容文字政策 - 顯示地址

問題代碼： SAFE_SEARCH_POLICY_VIOLATION_TEXT
嚴重程度：警告 (不會阻擋放送)
受影響欄位： display_address.localizations.*.text
可申訴：否 (請更新動態饋給酬載來解決問題)

如果 display_address.localizations 中的格式化地址文字含有 Google 搜尋內容文字政策禁止的內容，就會出現這則警告。雖然系統會省略標記的地址本地化 (如果標記預設語言代碼，則會省略整個 display_address 欄位)，但 POI 仍符合放送資格。

查看相關政策問題代碼：Google 搜尋內容文字政策

營業時間的開始時間晚於結束時間

問題代碼： NOT_LESS_THAN_FIELD
嚴重程度：錯誤 (無法放送)
受影響的欄位： local_data.business_hours.time_ranges.open_time、local_data.business_hours.time_ranges.close_time
可否申訴：否 (請更新動態饋給酬載來解決問題)

如果同一天時段的營業時間 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
可否申訴：否 (請更新動態饋給酬載來解決問題)

如果 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
嚴重程度：錯誤 (無法放送)
可申訴：否 (請更新動態饋給酬載來解決問題)

如果單一搜尋點實體中必須不重複的欄位或子元素包含重複項目，就會發生這項錯誤。

請查看「問題詳細資料」面板，找出違反唯一性原則的屬性：

1. 搜尋點內有重複的品牌 ID (local_data.brand_landing_pages.brand_id)

• 原因：單一搜尋點的多個 brand_landing_pages 項目中出現相同的 brand_id 字串。
• 修正方式：將該品牌的所有到達網頁合併為單一 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
嚴重程度：錯誤 (無法放送)
可否申訴：否 (請更新動態饋給酬載來解決問題)
受影響的欄位： 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

如果本地化商家類別文字未通過自動安全搜尋內容篩選器，就會出現這則警告。雖然系統會省略標記的設施類別本地化 (如果標記預設語言代碼，則會省略整個 establishment_category 欄位)，但 POI 仍可放送。

修復：

• 政策遵循：移除或替換標記的商家類別文字，改用符合 Google 搜尋內容文字政策的標準業務類別字詞

有效酬載範例：

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