Batch Get Reviews

google_business_profile.batch_get_reviews
ActionBusiness appsconnection required

Calls the Google Business Profile API with the connection's credentials.

Fetch reviews for up to fifty locations of one account in a single call.

Connection

Required
Yes — the node will not save without one
Auth type
OAuth 2.0
Providers
Google Business Profile
Secret shape
{"client_id", "client_secret", "refresh_token"}
Config it needs
account_id, token_uri
Resolved by
config.connection_id, else node.connection_id

Configuration

5 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
location_ids
Locations to read, as a JSON array or a comma-separated list; Google accepts at most 50 per call.
arrayYes—≥ 1 characters; array of string["12345678901234567890"]
account_id
Business Profile account, as accounts/12345 or just 12345. Overrides the account id stored on the connection.
stringNo———
order_by
Sort order Google accepts for reviews.
stringNo—one of "rating", "rating desc", "updateTime desc"—
page_size
How many reviews to return per page (Google's default is 50).
numberNo—≥ 1—
page_token
Token from a previous call's next_page_token; blank starts at the first page.
stringNo———

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "location_ids": [
    "12345678901234567890"
  ]
}

Output

One shape.

result

FieldTypeExample
items
The page of records exactly as Google returned them.
array—
count
How many records this page carried.
number—
next_page_token
Pass back as page_token to fetch the next page.
string—
locations
The location resource names that were requested.
array—
{
  "count": 0,
  "items": [],
  "locations": [],
  "next_page_token": ""
}

Notes

  • Each entry of items is a LocationReview: one location and one of its reviews.

See Batch Get Reviews run in a workflow.

In a technical demo we add the Google Business Profile connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.