The Review object represents a Google Business Profile review as returned by GMBapi review endpoints.

Fields

account_id

A unique identifier for the account associated with the review.

review_name

The full Google review resource name, for example accounts/{account_id}/locations/{location_id}/reviews/{review_id}.

location_id

A unique identifier for the specific location of the business being reviewed.

created_date

The timestamp indicating when the review was created.

update_date

The timestamp indicating when the review was last updated.

rating

The rating given by the reviewer, typically on a scale from 1 to 5.

comment_native

The review comment in the reviewer’s original language, when available.

comment_en

The review comment translated to English, when available.

has_comment

Indicates whether the review includes written text. 1 means a comment is present, and 0 means it is rating-only.

has_media

Indicates whether the review includes media such as photos or videos. 1 means media is present, and 0 means no media is present.

reply

Indicates whether the business has replied to the review. 1 means a reply exists, and 0 means there is no reply.

reply_date

The timestamp indicating when the business reply was posted.

reply_comment

The text of the business reply to the review.

reviewReplyState

The current reply state for the review. Values are PENDING, ACTIVE, and REJECTED.

response_time

The time between the review and the business reply.

reply_after_review

Indicates whether the business reply was posted after the latest review update. 1 means the reply timestamp is later than the review update timestamp. 0 means there is no reply, no reply comment, or the reply timestamp is not later than the review update timestamp.

profilePhotoUrl

The URL to the profile photo of the reviewer.

reviewerName

The display name of the person who wrote the review.

reviewMediaItems

Media attached to the review, such as photos or videos.

reviewMediaItems.thumbnailUrl

The thumbnail URL for a media item.

reviewMediaItems.thumbnailLabel

The label or alt text for a media item thumbnail, when provided by Google.

reviewMediaItems.videoUrl

The video URL for a review media item, when the media item is a video.

is_deleted

Indicates whether the review has been deleted or is no longer available.

Example

{
  "review": {
    "account_id": "12345678900987654321",
    "review_name": "accounts/12345678900987654321/locations/987654321/reviews/ABCDEF",
    "location_id": "987654321",
    "created_date": 1719474756704521,
    "update_date": 1719474756704521,
    "rating": 5,
    "comment_native": "Great service!",
    "comment_en": "Great service!",
    "has_comment": 1,
    "has_media": 1,
    "reply": 1,
    "reply_date": 1719561156704521,
    "reply_comment": "Thank you for your feedback. We appreciate your review!",
    "reviewReplyState": "ACTIVE",
    "response_time": 24.0,
    "reply_after_review": 1,
    "profilePhotoUrl": "https://lh3.googleusercontent.com/a/example-profile-photo=s120-c-rp-mo-br100",
    "reviewerName": "Michel van Luijtelaar",
    "reviewMediaItems": [
      {
        "thumbnailUrl": "https://lh3.googleusercontent.com/p/example-thumbnail",
        "thumbnailLabel": "Photo from customer",
        "videoUrl": null
      }
    ],
    "is_deleted": 0
  }
}