To keep your business profile as accurate as possible, Google uses information from sources like user reports and licensed content. If the information provided by business owners is reported as incorrect, Google notifies the listing owners. Listing owners can then accept or reject the updates.
As a listing owner, the My Business Business Information API lets you review these updates to make sure that your business information is accurate. This guide describes how to accept or reject updates.
To manage your Google Updates, complete the following steps:
- Find locations with pending updates
- Review updated fields
- Accept or reject updates
- Review the results
Find locations with pending updates
Before you can accept or reject updates, you must find out which locations have Google Updates
available. The best way to get Google Updates for locations is to
Manage real-time notifications with
Cloud Pub/Sub. If you receive a
GOOGLE_UPDATE
notification on your
Pub/Sub topic,
a change is ready for your review. The locationName
field on the notification
provides the resource name of the location with Google Updates.
Alternatively, you can see the call
locations.get
and inspect the
Metadata
for the presence of the hasGoogleUpdated
flag. If "isGoogleUpdated": true
,
the place ID associated with this location has updates.
Request
The following is an
locations.get
request example:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}
Request
The following is an
locations.get
response example:
{ "name": "locations/{locationId}", "title": "Test Business", "phoneNumbers": { "primaryPhone": "02 9374 4000" }, ... "metadata": { "hasGoogleUpdated": true, ... } ... }
Review updates fields
To review the specific fields that have Google Updates, call
locations.getGoogleUpdated
.
A diffMask
that details the fields Google updated is in the
response body.
Request
The following is an
locations.getGoogleUpdated
request example:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated
Response
The following is an
locations.getGoogleUpdated
response example. It shows an available update in the phoneNumbers.primaryPhone field. The value in
this response is the suggested update value:
{ "location": { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }, "diffMask": "phoneNumbers.primaryPhone" }
Accept or reject updates
To accept or reject an update, perform an
locations.patch
with the updateMask fields set the same as in the diffMask
that you
obtained earlier. Also, match the preferred values for each field as well.
Accept a request
The following is an locations.patch
request example:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, }
Response
The following is an
locations.patch
response example:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }
Reject a request
The following is an
locations.patch
request example:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
Response
The following is an
locations.patch
response example:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
Review the results
If your location is patched successfully, the diffMask
field in the
locations.getGoogleUpdated
response shows the values as "diffMask": ""
. Also, the flag
"hasGoogleUpdated"
within Metadata
shows the value as
false
, or no value is present.
If the field values aren't clear,
reach out to
our support team with the request and response for getGoogleUpdated
. The
request must include the response before the
locations.patch
call, the patch call, and the getGoogleUpdated
call.