Get Started with the Google Partners API

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 Developers Console. If you already have an account, then you're all set.

You may also want a separate Google Account for testing purposes.

Try out Google Partners

This API documentation assumes that you've used Google Partners, and that you're familiar with web programming concepts and web data formats.

If you haven't used Google Partners, then try out the user interface before starting to code.

Create a project for your client

Before you can send requests to Google Partners, you need to tell Google about your client and activate access to the API. You do this by using the Google Developers Console to create a project, which is a named collection of settings and API access information, and register your application.

To get started using Google Partners API, you need to first create or select a project in the Google Developers Console and enable the API. Using this link guides you through the process and activates the Google Partners API automatically.

Alternatively, you can activate the Google Partners API yourself in the Developers Console by doing the following:

  1. Open the Credentials page.

In either case, you end up on the Credentials page and can create your project's credentials from here.

If you haven't done so already, create your application's API key by clicking Add credentials > API key. Next, look for your API key in the API keys section.

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.

For more information about REST, you may find the following third-party documents useful:

REST in the Google Partners API

The Google Partners API operations map directly to REST HTTP verbs.

The specific formats for Google Partners API URIs are:

https://partners.googleapis.com/v2/resourcePath?parameters

The full set of URIs used for each supported operation in the API is summarized in the Google Partners API Reference document.

Learn JSON basics

The Google Partners 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.