Google

Google My Business API

The Google My Business API provides an interface for managing business location information on Google.

Developer tools#openapi#analytics#media#location

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Google My Business API provides an interface for managing business location information on Google.

Endpoints 50

accounts

  • GETmybusiness.accounts.list/v4/accounts?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&filter=string&name=string&pageSize=0&pageToken=stringLists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management…
  • POSTmybusiness.accounts.create/v4/accounts?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&primaryOwner=stringCreates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be…
  • PUTmybusiness.accounts.updateNotifications/v4/:name?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringSets the pubsub notification settings for the account informing Business Profile which topic to send pubsub notifications for: - New reviews for locations…
  • DELETEmybusiness.accounts.locations.questions.delete/v4/:name?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringDeletes a specific question written by the current user.
  • PATCHmybusiness.accounts.locations.questions.patch/v4/:name?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&updateMask=stringUpdates a specific question written by the current user.
  • POSTmybusiness.accounts.locations.localPosts.reportInsights/v4/:name/localPosts:reportInsights?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringReturns insights for a set of local posts associated with a single listing. Which metrics and how they are reported are options specified in the request…
  • POSTmybusiness.accounts.locations.batchGet/v4/:name/locations:batchGet?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringGets all of the specified locations in the given account.
  • POSTmybusiness.accounts.locations.batchGetReviews/v4/:name/locations:batchGetReviews?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringReturns the paginated list of reviews for all specified locations. This operation is only valid if the specified locations are verified. *Note:* Reviews are…
  • POSTmybusiness.accounts.locations.reportInsights/v4/:name/locations:reportInsights?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringReturns a report containing insights on one or more metrics by location. *Note:* Insight reports are limited to a batch size of 10 location_names per call.
  • PUTmybusiness.accounts.locations.reviews.updateReply/v4/:name/reply?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringUpdates the reply to the specified review. A reply is created if one does not exist. This operation is only valid if the specified location is verified.
  • DELETEmybusiness.accounts.locations.reviews.deleteReply/v4/:name/reply?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringDeletes the response to the specified review. This operation is only valid if the specified location is verified.
  • POSTmybusiness.accounts.invitations.accept/v4/:name:accept?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringAccepts the specified invitation.
  • POSTmybusiness.accounts.locations.associate/v4/:name:associate?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringAssociates a location to a place ID. Any previous association is overwritten. This operation is only valid if the location is unverified. The association must…
  • POSTmybusiness.accounts.locations.clearAssociation/v4/:name:clearAssociation?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringClears an association between a location and its place ID. This operation is only valid if the location is unverified.
  • POSTmybusiness.accounts.locations.verifications.complete/v4/:name:complete?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringCompletes a PENDING verification. It is only necessary for non AUTO verification methods. AUTO verification request is instantly VERIFIED upon creation.
  • POSTmybusiness.accounts.invitations.decline/v4/:name:decline?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringDeclines the specified invitation.
  • POSTmybusiness.accounts.locations.fetchVerificationOptions/v4/:name:fetchVerificationOptions?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringReports all eligible verification options for a location in a specific language.
  • POSTmybusiness.accounts.locations.findMatches/v4/:name:findMatches?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringFinds all of the possible locations that are a match to the specified location. This operation is only valid if the location is unverified.
  • POSTmybusiness.accounts.generateAccountNumber/v4/:name:generateAccountNumber?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringGenerates an account number for this account. The account number is not provisioned when an account is created. Use this request to create an account number…
  • GETmybusiness.accounts.locations.lodging.getGoogleUpdated/v4/:name:getGoogleUpdated?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&readMask=stringReturns the Google updated Lodging of a specific location.
  • GETmybusiness.accounts.locations.getGoogleUpdated/v4/:name:googleUpdated?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringGets the Google-updated version of the specified location. Returns NOT_FOUND if the location does not exist.
  • GETmybusiness.accounts.listRecommendGoogleLocations/v4/:name:recommendGoogleLocations?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&pageSize=0&pageToken=stringList all the GoogleLocations that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and…
  • POSTmybusiness.accounts.locations.transfer/v4/:name:transfer?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringMoves 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…
  • POSTmybusiness.accounts.locations.verify/v4/:name:verify?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringStarts the verification process for a location.
  • GETmybusiness.accounts.locations.admins.list/v4/:parent/admins?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringLists all of the admins for the specified location.
  • POSTmybusiness.accounts.locations.admins.create/v4/:parent/admins?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringInvites 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…
  • GETmybusiness.accounts.locations.questions.answers.list/v4/:parent/answers?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&orderBy=string&pageSize=0&pageToken=stringReturns the paginated list of answers for a specified question.
  • DELETEmybusiness.accounts.locations.questions.answers.delete/v4/:parent/answers:delete?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringDeletes the answer written by the current user to a question.
  • POSTmybusiness.accounts.locations.questions.answers.upsert/v4/:parent/answers:upsert?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringCreates an answer or updates the existing answer written by the user for the specified question. A user can only create one answer per question.
  • GETmybusiness.accounts.locations.insuranceNetworks.list/v4/:parent/insuranceNetworks?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&languageCode=string&pageSize=0&pageToken=stringReturns a list of all insurance networks supported by Google.
  • GETmybusiness.accounts.invitations.list/v4/:parent/invitations?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&targetType=ALLLists pending invitations for the specified account.
  • GETmybusiness.accounts.locations.localPosts.list/v4/:parent/localPosts?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&pageSize=0&pageToken=stringReturns a list of local posts associated with a location.
  • POSTmybusiness.accounts.locations.localPosts.create/v4/:parent/localPosts?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringCreates a new local post associated with the specified location, and returns it.
  • GETmybusiness.accounts.locations.list/v4/:parent/locations?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&filter=string&languageCode=string&orderBy=string&pageSize=0&pageToken=stringLists the locations for the specified account.
  • POSTmybusiness.accounts.locations.create/v4/:parent/locations?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&requestId=string&validateOnly=trueCreates a new location owned by the specified account, and returns it.
  • GETmybusiness.accounts.locations.media.list/v4/:parent/media?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&pageSize=0&pageToken=stringReturns a list of media items associated with a location.
  • POSTmybusiness.accounts.locations.media.create/v4/:parent/media?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringCreates a new media item for the location.
  • GETmybusiness.accounts.locations.media.customers.list/v4/:parent/media/customers?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&pageSize=0&pageToken=stringReturns a list of media items associated with a location that have been contributed by customers.
  • POSTmybusiness.accounts.locations.media.startUpload/v4/:parent/media:startUpload?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringGenerates a MediaItemDataRef for media item uploading.
  • GETmybusiness.accounts.locations.questions.list/v4/:parent/questions?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&answersPerQuestion=0&filter=string&orderBy=string&pageSize=0&pageToken=stringReturns the paginated list of questions and some of its answers for a specified location.
  • POSTmybusiness.accounts.locations.questions.create/v4/:parent/questions?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringAdds a question for the specified location.
  • GETmybusiness.accounts.locations.reviews.list/v4/:parent/reviews?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&orderBy=string&pageSize=0&pageToken=stringReturns the paginated list of reviews for the specified location. This operation is only valid if the specified location is verified.
  • GETmybusiness.accounts.locations.verifications.list/v4/:parent/verifications?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&pageSize=0&pageToken=stringList verifications of a location, ordered by create time.

attributes

  • GETmybusiness.attributes.list/v4/attributes?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&categoryId=string&country=string&languageCode=string&name=string&pageSize=0&pageToken=stringReturns the list of available attributes that would be available for a location with the given primary category and country.

categories

  • GETmybusiness.categories.list/v4/categories?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&languageCode=string&pageSize=0&pageToken=string&regionCode=string&searchTerm=string&view=CATEGORY_VIEW_UNSPECIFIEDReturns a list of business categories. Search will match the category name but not the category ID. *Note:* Search only matches the front of a category name…
  • GETmybusiness.categories.batchGet/v4/categories:batchGet?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&categoryIds=string&languageCode=string&regionCode=string&view=CATEGORY_VIEW_UNSPECIFIEDReturns a list of business categories for the provided language and GConcept ids.

chains

  • GETmybusiness.chains.search/v4/chains:search?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&chainDisplayName=string&resultCount=0Searches the chain based on chain name.
  • GETmybusiness.chains.get/v4/:name?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringGets the specified chain. Returns NOT_FOUND if the chain does not exist.

googleLocations

  • POSTmybusiness.googleLocations.search/v4/googleLocations:search?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringSearch all of the possible locations that are a match to the specified request.
  • POSTmybusiness.googleLocations.report/v4/:name:report?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=stringReport a GoogleLocation.

API details

Base URL
https://mybusiness.googleapis.com
Authentication
None declared in the description
Operations
50 operations on 40 pathsPOST 24GET 20DELETE 3PUT 2PATCH 1
Main resources
accounts 43categories 2chains 2googleLocations 2attributes 1
Response formats
application/json
Description format
OpenAPI 3.0.0, API version v4
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the Google My Business API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Google My Business API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “mybusiness.accounts.list” (GET /v4/accounts?$.xgafv=1&access_token=string&alt=json&callback=string&fields=string&key=string&oauth_token=string&prettyPrint=true&quotaUser=string&upload_protocol=string&uploadType=string&filter=string&name=string&pageSize=0&pageToken=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Google My Business API?

The Google My Business API provides an interface for managing business location information on Google. It is listed under Developer tools and has 50 endpoints.

Who publishes the Google My Business API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Google My Business API?

Requests go to https://mybusiness.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Google My Business API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Google My Business API have?

50 operations on 40 paths (24 POST, 20 GET, 3 DELETE, 2 PUT, 1 PATCH). The largest groups are accounts, categories, chains, googleLocations.

Is forking the Google My Business API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.