ビジネス情報と属性の編集ステータスを確認する

My Business Business Information API またはビジネス プロフィールの管理画面でビジネス情報を更新すると、編集内容はモデレーションと検証のパイプラインを通過してから、Google 検索と Google マップに公開されます。また、ユーザーからの報告やライセンス付きのデータソースに基づいて、ビジネスの詳細が更新されることもあります。

v1alpha Edit Status エンドポイントを使用すると、1 つのリクエストでビジネス情報またはその属性の統合ビューを取得できます。

  • 販売者が提供したデータ: 販売者が最後に送信した値。
  • 一般ユーザー向けのデータ: Google 検索と 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

レスポンス

レスポンスには、次の 3 つの最上位フィールドが含まれます。

  • locationProvidedByMerchant: 販売者が管理する Location データ。
  • locationSeenByConsumers: Google 検索と 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

レスポンス

レスポンスは、ExtendedAttribute エントリのリストを含む ExtendedAttributes リソースを返します。各エントリは、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 販売者の編集内容が承認されませんでした。特定の PolicyViolation 値については、rejectionReason を確認してください。 根本的なポリシー違反を修正し、locations.patch または locations.updateAttributes を使用して新しいアップデートを送信します。
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE 消費者向けの値を Google が更新したため（ユーザー レポートや外部ソースなどから）、販売者が提供した値と異なっています。 locationSeenByConsumers または attributeSeenByConsumers の値を確認し、承認またはオーバーライドします。Google による変更を管理するをご覧ください。
EDIT_LIFECYCLE_STAGE_DRAFT 編集内容が下書きとして保存され（オーナー確認が完了していないビジネス情報など）、Google 検索と 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 のリファレンス ドキュメントをご覧ください。