위치 및 속성의 수정 상태 확인하기

My Business Business Information API 또는 비즈니스 프로필 UI를 통해 비즈니스 정보를 업데이트하면 수정사항이 검토 및 인증 파이프라인을 거친 후 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

응답

응답은 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 enum은 수정사항이 수명 주기의 어느 단계에 있는지 나타냅니다.

값 설명 권장 조치
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 검색 및 지도에 게시되지 않습니다. 위치 인증을 완료하여 비즈니스 정보를 게시하세요.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED 수정 수명 주기 단계를 알 수 없거나 지정되지 않았습니다. 없음

소스 수정

Source enum은 판매자가 수정을 제출한 채널을 식별합니다.

  • SOURCE_API: My Business Business Information API를 통해 수정사항이 제출되었습니다.
  • SOURCE_UI: 비즈니스 프로필 웹 UI 또는 모바일 앱을 통해 수정사항이 제출되었습니다.
  • SOURCE_UNSPECIFIED: 수정 소스가 지정되지 않았습니다.

정책 위반

lastEditLifecycleStage가 EDIT_LIFECYCLE_STAGE_REJECTED인 경우 rejectionReason 필드는 수정이 거부된 이유를 설명하는 PolicyViolation enum 값을 제공합니다. 거부 사유는 다음 영역을 포함합니다(예시).

  • 프로필 및 계정 상태: 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.

enum 값 및 설명의 전체 목록은 PolicyViolation 참고 문서를 참조하세요.