Google Business Profile
Google Business Profile · 64 endpoints
Business Profile accounts
- List your Business Profile accountsList the Google Business Profile accounts you manage
- Business Profile account details by account idaccounts.get — Gets the specified account. Returns `NOT_FOUND` if the account does not exist or if the caller does not have access rights to it.
- List place action links on your business listingplaceActionLinks.list — Lists the place action links for the specified location.
- Attributes set on your business listinglocations.getAttributes — Retrieves attributes for a location as last set by the merchant. It may not reflect updates from Google or user-generated content that are live on Google Maps.
- Available listing attributes by category and countryattributes.list — Returns the list of attributes that would be available for a location with the given primary category and country.
Business categories
- Business Profile categories by GConcept idscategories.batchGet — Returns a list of business categories for the provided language and GConcept ids.
- Search Business Profile categories by namecategories.list — Returns a list of business categories. Search will match the category name but not the category ID. Search only matches the front of a category name (that is, 'food' may return 'Food Court' but not 'Fast Food Restaurant').
Business chains
- Business chain details by chain idchains.get — Gets the specified chain. Returns `NOT_FOUND` if the chain does not exist.
- Search business chains by namechains.search — Searches the chain based on chain name.
Location metrics
- Daily metrics time series for your business listinglocations.fetchMultiDailyMetricsTimeSeries — Returns the values for each date from a given time range that are associated with the specific daily metrics. Note: Only daily data is available. Hourly metrics are not supported. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICK
- Daily time series of one metric for your listinglocations.getDailyMetricsTimeSeries — Returns the values for each date from a given time range that are associated with the specific daily metric. Note: Only daily data is available. Hourly metrics are not supported. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_
- Monthly search keywords, impressions for your listingmonthly.list — Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.yea
Business locations
- List your business listings — address, hours, categoryList your business's listings with their addresses, hours and categories
- Your business listing as last set by the merchantlocations.get — Returns the specified location as last set by the merchant. It may not reflect updates from Google or user-generated content that are live on Google Maps.
- Your business listing as it appears live on Googlelocations.getGoogleUpdated — Returns the specified location as it appears live on Google Maps and Search. This consumer-facing view may have been updated by Google or user-generated content and may differ from the merchant's version. The returned GoogleUpdatedLocation contains masks that indicate which fields differ from the merchant's information.
- Match your business to Google location recordsgoogleLocations.search — Search all of the possible locations that are a match to the specified request.
- List photos and videos on your business listingmedia.list — List the photos and videos on one of your listings
- Add a photo or video to your business listingmedia.create — Add a photo or video to one of your listings
- List local posts on your business listinglocalPosts.list — List the local posts (offers, updates, events) on one of your listings
- Publish a local post on your business listinglocalPosts.create — Publish a local post (offer, update or event) to one of your listings
- List customer questions on your business listingquestions.list — Returns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.
- Post or update your answer to a listing questionanswers.upsert — Creates an answer or updates the existing answer written by the user for the specified question. A user can only create one answer per question.
- Reply to a customer review as the businessReply publicly to a customer review as the business
Customer reviews
- List customer reviews on your business listingRead the reviews customers left on your Google Business Profile listing
- Customer reviews across several of your listingsreviews.batchGetReviews — Read reviews across several of your listings in one call
- Read one customer review by review idreviews.get — Read a single review left on one of your listings
- Voice of Merchant state of your business listinglocations.getVoiceOfMerchantState — Gets the VoiceOfMerchant state.
Account and utility endpoints
- Accept a Business Profile admin invitationinvitations.accept — Accepts the specified invitation.
- Change an admin's role on your Business Profile accountadmins.patch — Updates the Admin for the specified Account Admin.
- Change an admin's role on your business listingadmins.patch — Updates the Admin for the specified location. Only the AdminRole of the Admin can be updated.
- Complete a pending business listing verificationverifications.complete — Completes a `PENDING` verification. It is only necessary for non `AUTO` verification methods. `AUTO` verification request is instantly `VERIFIED` upon creation.
- Create a Business Profile accountaccounts.create — Creates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be created with a Personal account as primary owner. - Location Groups cannot be created with a primary owner of a Personal account if the Personal account is in an Organization. - Location Groups cannot own Location Groups.
- Create a business listing on your Business Profilelocations.create — Creates a new Location that will be owned by the logged in user.
- Create a place action link on your business listingplaceActionLinks.create — Creates a place action link associated with the specified location, and returns it. The request is considered duplicate if the `parent`, `place_action_link.uri` and `place_action_link.place_action_type` are the same as a previous request.
- Decline a Business Profile admin invitationinvitations.decline — Declines the specified invitation.
- Delete a listing from your Business Profilelocations.delete — Deletes a location. If this location cannot be deleted using the API and it is marked so in the `google.mybusiness.businessinformation.v1.LocationState`, use the [Google Business Profile](https://business.google.com/manage/) website.
- Delete a place action link from your business listingplaceActionLinks.delete — Deletes a place action link from the specified location.
- Delete your answer to a business listing questionanswers.delete — Deletes the answer written by the current user to a question.
- Delete your public reply to a customer reviewreviews.deleteReply — Delete the business's public reply to a review
- Delete your question on a business listingquestions.delete — Deletes a specific question written by the current user.
- Edit your question on a business listingquestions.patch — Updates a specific question written by the current user.
- Eligible verification options for your listinglocations.fetchVerificationOptions — Reports all eligible verification options for a location in a specific language.
- Generate a verification token for your listingverificationTokens.generate — Generate a token for the provided location data to verify the location.
- Google-updated attributes of your business listingattributes.getGoogleUpdated — Retrieves attributes for a location as they appear live on Google Maps and Search. This consumer-facing view may have been updated by Google or user-generated content and may differ from the merchant's version.
- Invite an admin to your Business Profile accountadmins.create — Invites the specified user to become an administrator for the specified account. The invitee must accept the invitation in order to be granted access to the account. See AcceptInvitation to programmatically accept an invitation.
- Invite an admin to your business listingadmins.create — Invites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the location. See AcceptInvitation to programmatically accept an invitation.
- List admins of your Business Profile accountadmins.list — Lists the admins for the specified account.
- List admins of your business listingadmins.list — Lists all of the admins for the specified location.
- List answers to a business listing questionanswers.list — Returns the paginated list of answers for a specified question.
- List available place action typesplaceActionTypeMetadata.list — Returns the list of available place action types for a location or country.
- List pending invitations to your Business Profileinvitations.list — Lists pending invitations for the specified account.
- List verification attempts for your business listingverifications.list — List verifications of a location, ordered by create time.
- Place action link details by link idplaceActionLinks.get — Gets the specified place action link.
- Post a question on a business listingquestions.create — Adds a question for the specified location.
- Remove an admin from your Business Profile accountadmins.delete — Removes the specified admin from the specified account.
- Remove an admin from your business listingadmins.delete — Removes the specified admin as a manager of the specified location.
- Start verification of your business listinglocations.verify — Starts the verification process for a location.
- Transfer a business listing to another accountlocations.transfer — Moves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account.
- Update a Business Profile accountaccounts.patch — Updates the specified business account. Personal accounts cannot be updated using this method.
- Update a place action link on your business listingplaceActionLinks.patch — Updates the specified place action link and returns it.
- Update attributes on your business listinglocations.updateAttributes — Update attributes for a given location.
- Update your Business Profile pubsub notificationsaccounts.updateNotificationSetting — Sets the pubsub notification setting for the account informing Google which topic to send pubsub notifications for. Use the notification_types field within notification_setting to manipulate the events an account wants to subscribe to. An account will only have one notification setting resource, and only one pubsub topic can be set. To delete the setting, updat
- Update your business listing detailslocations.patch — Updates the specified location.
- Your Business Profile pubsub notification settingsaccounts.getNotificationSetting — Returns the pubsub notification settings for the account.
These endpoints are callable but not part of the catalog's browse surface.