The Google Surveys REST API will be deprecated effective April 19th, 2019. After this time, the API end point will be disabled, resulting in errors to all Surveys API calls. Please contact your Surveys account manager or if you have any questions.

Question Configuration Guide


This guide is intended to help you make use of all the question types available though the Google Surveys API. Before you begin, you'll want to check out the minimal survey base that will help you get started creating questions, especially if you are using the OAuth 2.0 Playground as described in the Get Started Guide.

Minimal Survey Base

Before detailing the different types of questions, it's helpful to have a barebones template for creating a survey. You'll need at least the following to create a survey using the POST method to the REST API. Note that audience country and at least one language specified in the languages list are required. You'll also need to specify a wantedResponseCount of at least 100. Also important here is to specify at least one email address in the owners list, and that email must be the one associated with the account that is making the calls to the API. Last, while not strictly necessary, we recommend that you include a title for your survey, to make it easier to reference later.

For details on how to get started using the REST API, refer to the getting started guide.


  // Title is optional, but very helpful for later reference
  "title": "API Test Survey"

  // Owners email must match the account making calls to the API.
  "owners": [""],
  "wantedResponseCount": 100,
  "audience": {
    "country": "US",
    "languages": ["en-US"]
  "questions": [

  // Your questions go can cut and paste the samples from this guide.


Send feedback about...

Google Surveys
Google Surveys