Before you can start coding your first client application, there are a few things you need to do, if you haven't done them already.
Get a Google Account
Try out Google My Business
This API documentation assumes that you've used Google My Business, and that you're familiar with web programming concepts and web data formats.
If you haven't used Google My Business, then try out the user interface before starting to code.
Create a business account
After you have a Google Account, it is a best practice to create a top level Google My Business business account. To create a business acount go to Google My Business. Click the upper left menu, then click Create business account. You can use the tools in the Google My Business UI to manually manage account and location data for your company.
If you already have a top level business account, then you're all set.
Create a project in the Google Developers ConsoleBefore you can send requests to the Google My Business API, you need to use the Google API Console to create a project, and activate the Google My Business API. To create a new project, do the following: -
Go to the Google API Console. Click Create project, enter a name, and click Create.
Request access to the APIYou must complete the following steps to enable your project and access the API.
- Go to the Google API Console and select the project you created for use with Google My Business.
- Note the project ID of your project.
- Complete and submit the access request form.
- You will receive a follow-up email after your request has been reviewed.
- After approval, return to the Google API Console and enable the Google My Business API for your project.
To determine your project ID, do the following:
- Go to the Google API Console.
- Find your project in the table on the list-of-projects page.
- The project ID appears in the Project ID column.
Activate the APINote: The Google My Business API will not appear in the following steps until your project has been whitelisted. The API will only be visible in Google API Console to the users whose Google Accounts were submitted in the access request form.
To enable an API for your project, do the following:
- Open the API Library in the Google API Console. If prompted, select a project or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
- If the API you want to enable isn't visible in the list, use search to find it.
- Select the API you want to enable, then click the Enable button.
- If prompted, enable billing.
- If prompted, accept the API's Terms of Service.
Get an OAuth 2.0 client IDBecause your app will access protected (non-public) data, you will need an OAuth 2.0 client ID. This lets your app request authorization to access your organization's location data on behalf of your app's users.
- Open the Credentials page in the API Console.
Learn REST basics
There are two ways to invoke the API:
- Sending HTTP requests and parsing the responses.
- Using client libraries.
If you decide not to use client libraries, you'll need to understand the basics of REST.
REST is a style of software architecture that provides a convenient and consistent approach to requesting and modifying data.
The term REST is short for "Representational State Transfer." In the context of Google APIs, it refers to using HTTP verbs to retrieve and modify representations of data stored by Google.
In a RESTful system, resources are stored in a data store; a client sends a request that the server perform a particular action (such as creating, retrieving, updating, or deleting a resource), and the server performs the action and sends a response, often in the form of a representation of the specified resource.
In Google's RESTful APIs, the client specifies an action using an HTTP verb such as
DELETE. It specifies a resource by a globally-unique URI of the following form:
Because all API resources have unique HTTP-accessible URIs, REST enables data caching and is optimized to work with the web's distributed infrastructure.
You may find the method definitions in the HTTP 1.1 standards documentation useful; they include specifications for
REST in the Google My Business API
The Google My Business API operations map directly to REST HTTP verbs.
The specific formats for Google My Business API URIs are:
The full set of URIs used for each supported operation in the API is summarized in the Google My Business API Reference document.Resource IDs are defined using a resource path of the following form:
locationIdrepresent the numeric portions of the ID.
For example, the resource path to an account looks like this:
The resource path for a location appears in this form:
Learn JSON basics
The Google My Business API returns data in JSON format.