查看地點和屬性的編輯狀態

透過 My Business Business Information API 或商家檔案使用者介面更新商家資訊時，編輯內容會經過審核和驗證，才會在 Google 搜尋和 Google 地圖上顯示。此外，Google 也可能根據使用者回報或授權資料來源，更新商家詳細資料。

v1alpha 編輯狀態端點可讓您在單一要求中，擷取地點或其屬性的統一檢視畫面：

  • 商家提供的資料：商家上次提交的值。
  • 消費者看到的資料：Google 搜尋和地圖上顯示的值。
  • 擴充欄位中繼資料：每個欄位或屬性的編輯狀態，包括最新編輯的生命週期階段、原始來源 (API 或 UI)、上次編輯的時間戳記，以及編輯遭拒時的任何違反政策原因。

事前準備

使用 My Business Business Information API 前，請先註冊應用程式並取得 OAuth 2.0 憑證。如要進一步瞭解如何開始使用，請參閱「基本設定」。

擷取擴充位置資料

如要檢查商家提供的地點資料、消費者看到的地點資料，以及地點的各欄位編輯狀態，請呼叫 locations.getExtended。

與 locations.get 不同，locations.getExtended 不需要 readMask 參數，並會傳回完整的 ExtendedLocation 資源。

要求

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

回應

回應包含三個頂層欄位：

  • locationProvidedByMerchant：由商家管理的 Location 資料。
  • locationSeenByConsumers：消費者在 Google 搜尋和地圖上看到的Location資料。
  • extendedFieldData：snake_case 中頂層 Location 欄位名稱 (例如 title、phone_numbers、website_uri、storefront_address 或 regular_hours) 與 ExtendedFieldData 物件的對應關係。鍵一律是純文字頂層欄位名稱，絕非巢狀子欄位。
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

擷取擴充屬性資料

如要檢查商家提供的值、消費者看到的值，以及地點屬性的編輯狀態，請呼叫 locations.attributes.getExtended。

要求

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

回應

回應會傳回 ExtendedAttributes 資源，其中包含 ExtendedAttribute 項目清單。每個項目都會將 attributeProvidedByMerchant 和 attributeSeenByConsumers 與該屬性的 extendedFieldData 物件配對：

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

瞭解擴充欄位中繼資料

每個 ExtendedFieldData 物件都包含下列欄位：

欄位 類型 說明
lastEditLifecycleStage EditLifecycleStage 這個欄位或屬性最近一次編輯的審核或放送狀態。
rejectionReason PolicyViolation 導致編輯內容遭拒的政策違規問題。lastEditLifecycleStage 為 EDIT_LIFECYCLE_STAGE_REJECTED 時填入。
updateTime string (Timestamp) 上次提交這個欄位或屬性編輯內容的時間戳記 (RFC 3339 格式)。
source Source 商家提交編輯內容的原始平台 (SOURCE_API 或 SOURCE_UI)。

編輯生命週期階段

EditLifecycleStage 列舉會指出編輯內容在生命週期中的位置：

值 說明 建議做法
EDIT_LIFECYCLE_STAGE_ACCEPTED 商家的編輯內容已獲核准，可以放送。 無須採取任何行動。
EDIT_LIFECYCLE_STAGE_PENDING 商家的編輯內容正在審核中，尚未套用至消費者看到的商家資訊。 等待審核完成。如果編輯內容仍在審核中，請勿重複提交相同的編輯內容。
EDIT_LIFECYCLE_STAGE_REJECTED 商家的編輯內容未獲核准。請查看 rejectionReason，瞭解特定 PolicyViolation 值。 修正根本的政策違規問題，並使用 locations.patch 或 locations.updateAttributes 提交新的更新。
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Google 已更新消費者看到的資訊 (例如根據使用者回報或外部來源)，與商家提供的資訊不同。 查看 locationSeenByConsumers 或 attributeSeenByConsumers 值，然後接受或覆寫。請參閱「管理 Google 資訊更新」。
EDIT_LIFECYCLE_STAGE_DRAFT 編輯內容已儲存為草稿 (例如未經驗證的地點)，且尚未在 Google 搜尋和地圖上發布。 完成地點驗證，商家資訊才能上線。
EDIT_LIFECYCLE_STAGE_UNSPECIFIED 編輯生命週期階段不明或未指定。 無。

編輯來源

Source 列舉會識別商家提交編輯內容的管道：

  • SOURCE_API：透過 My Business Business Information API 提交編輯內容。
  • SOURCE_UI：透過商家檔案網頁 UI 或行動應用程式提交編輯內容。
  • SOURCE_UNSPECIFIED：未指定編輯來源。

違反政策

當 lastEditLifecycleStage 為 EDIT_LIFECYCLE_STAGE_REJECTED 時，rejectionReason 欄位會提供 PolicyViolation 列舉值，說明編輯遭拒的原因。拒絕原因涵蓋以下方面 (範例)：

  • 個人資料和帳戶狀態：ACCOUNT_RESTRICTED_AND_SUSPENDED、ACCOUNT_RESTRICTED_AND_EDIT_REJECTED、ASSOCIATED_ACCOUNT_SUSPENDED、BUSINESS_INELIGIBLE、LOCATION_SUSPENDED、LOCATION_VERIFICATION_REQUIRED、OWNERSHIP_REVOKED、PO_BOX。
  • 編輯限制：EDITING_RESTRICTION、ILLEGAL_BUSINESS_HOURS_EDIT、IDENTITY_CHANGE、GEOGRAPHIC_LOCATION_CHANGE。
  • 內容政策：MISREPRESENTATION、OFF_TOPIC、PERSONAL_INFO、GIBBERISH_AND_REPETITIVE、OBSCENITY_AND_PROFANITY、GENERIC_QUALITY。

如需列舉值和說明的完整清單，請參閱 PolicyViolation 參考文件。