Prerequisites

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

You need a Google Account in order to create a project in the Google API Console. If you already have an account, then you're all set.

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 project in the Google Developers Console

Before 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 API

You must complete the following steps to enable your project and access the API.
  1. Go to the Google API Console and select the project you created for use with Google My Business to find the Project ID.
  2. To determine your project ID, do the following:

    1. Go to the Google API Console.
    2. Find your project in the table on the list-of-projects page.
    3. The project ID appears in the Project ID column.
  3. Complete and submit the access request form.
  4. You will receive a follow-up email after your request has been reviewed.
  5. After approval, return to the Google API Console and enable the Google My Business API for your project.

Activate the API

To enable an API for your project, do the following:

  1. 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.
  2. If the API you want to enable isn't visible in the list, use search to find it.
  3. Select the API you want to enable, then click the Enable button.
  4. If prompted, enable billing.
  5. If prompted, accept the API's Terms of Service.

Get an OAuth 2.0 client ID

Because 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.
  1. Open the Credentials page in the API Console.
  2. If you haven't done so already, create your OAuth 2.0 credentials by clicking Create credentials > OAuth client ID. After you've created the credentials, you can see your client ID on the Credentials page. Click the client ID for details, such as client secret, redirect URIs, JavaScript origins address, and email address.

Learn REST basics

There are two ways to invoke the API:

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 POST, GET, PUT, or DELETE. It specifies a resource by a globally-unique URI of the following form:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

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 GET, POST, PUT, and DELETE.

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:

https://mybusiness.googleapis.com/v3/resourcePath?parameters

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: accounts/account_name/locations/locationId
where account_name and locationId represent the numeric portions of the ID.

For example, the resource path to an account looks like this:

accounts/0123456789

The resource path for a location appears in this form:

accounts/0123456789/locations/9876543210

Learn JSON basics

The Google My Business API returns data in JSON format.

JSON (JavaScript Object Notation) is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information, see json.org.

Send feedback about...

Google My Business API
Google My Business API
Need help? Visit our support page.