Google 업데이트 관리

비즈니스 프로필을 최대한 정확하게 유지하기 위해 Google에서는 사용자 신고, 라이선스 콘텐츠와 같은 출처로부터 얻은 정보를 사용합니다. 비즈니스 소유자가 제공한 정보가 잘못되었다는 신고가 접수될 경우 Google에서는 비즈니스 정보 소유자에게 이를 알립니다. 그러면 비즈니스 정보 소유자는 해당 업데이트를 수락하거나 거부할 수 있습니다.

비즈니스 정보 소유자는 My Business Business Information API를 통해 이러한 업데이트를 검토하여 비즈니스 정보가 정확한지 검토할 수 있습니다. 이 가이드는 업데이트를 수락 또는 거부하는 방법을 설명합니다.

Google 업데이트를 관리하려면 다음 단계를 완료하세요.

  1. 업데이트 대기 중인 위치 찾기
  2. 업데이트된 필드 검토
  3. 업데이트 수락 또는 거부
  4. 결과 검토

업데이트 대기 중인 위치 찾기

업데이트를 수락하거나 거부하려면 먼저 Google 업데이트를 사용할 수 있는 위치를 확인해야 합니다. 위치에 맞춰 Google 업데이트를 받는 가장 좋은 방법은 Cloud Pub/Sub로 실시간 알림을 관리하는 것입니다. Pub/Sub 주제에 관한 GOOGLE_UPDATE 알림을 받는 경우 변경사항을 검토할 수 있습니다. 알림의 locationName 필드에서 Google 업데이트가 있는 위치의 리소스 이름을 확인할 수 있습니다.

또는 locations.get 호출을 확인하고 hasGoogleUpdated 플래그가 있는지 Metadata를 검사할 수 있습니다. "isGoogleUpdated": true인 경우, 이 위치와 연결된 장소 ID에 업데이트가 있는 것입니다.

요청

다음은 locations.get 요청의 예입니다.

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

요청

다음은 locations.get 응답의 예입니다.

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

업데이트 필드 검토

Google 업데이트가 있는 특정 필드를 검토하려면 locations.getGoogleUpdated를 호출합니다. Google에서 업데이트한 필드를 자세히 설명하는 diffMask는 응답 본문에 있습니다.

요청

다음은 locations.getGoogleUpdated 요청의 예입니다.

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

응답

다음은 locations.getGoogleUpdated 응답의 예입니다. phoneNumbers.primaryPhone 필드에 사용 가능한 업데이트가 표시됩니다. 이 응답의 값은 권장 업데이트 값입니다.

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

업데이트 수락 또는 거부

업데이트를 수락하거나 거부하려면 앞서 가져온 diffMask와 동일하게 설정된 updateMask 필드로 locations.patch를 실행합니다. 또한 각 필드의 선호 값도 일치시킵니다.

요청 수락

다음은 locations.patch 요청의 예입니다.

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

응답

다음은 locations.patch 응답의 예입니다.

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

요청 거부

다음은 locations.patch 요청의 예입니다.

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

응답

다음은 locations.patch 응답의 예입니다.

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

결과 검토

위치가 성공적으로 패치되면 locations.getGoogleUpdated 응답의 diffMask 필드 값이 "diffMask": ""로 표시됩니다. 또한 Metadata 내의 "hasGoogleUpdated" 플래그 값은 false로 표시되거나 값이 없습니다.

필드 값이 명확하지 않은 경우 getGoogleUpdated의 요청 및 응답에 관해 Google 지원팀에 문의하세요. 요청에는 반드시 locations.patch 호출, 패치 호출, getGoogleUpdated 호출 이전의 응답이 포함되어야 합니다.