Api-roll 42: 2016-11-08

discovery/googleapis/surveys__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
-                "https://www.googleapis.com/auth/consumersurveys": {
-                    "description": "View and edit your surveys and results"
+                "https://www.googleapis.com/auth/surveys": {
+                    "description": "View and manage your surveys and results"
                 },
-                "https://www.googleapis.com/auth/consumersurveys.readonly": {
-                    "description": "View the results for your surveys"
+                "https://www.googleapis.com/auth/surveys.readonly": {
+                    "description": "View your surveys and survey results"
                 },
                 "https://www.googleapis.com/auth/userinfo.email": {
                     "description": "View your email address"
                 }
             }
         }
     },
-    "basePath": "/consumersurveys/v2/",
-    "baseUrl": "https://www.googleapis.com/consumersurveys/v2/",
+    "basePath": "/surveys/v2/",
+    "baseUrl": "https://www.googleapis.com/surveys/v2/",
     "batchPath": "batch",
-    "canonicalName": "Consumer Surveys",
+    "canonicalName": "Surveys",
     "description": "Creates and conducts surveys, lists the surveys that an authenticated user owns, and retrieves survey results and information about specified surveys.",
     "discoveryVersion": "v1",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/r9HedtrzUW2pbu5XQ5oErnzKmxQ\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/6fZP85KIl1fykMUO-HK10xFnDKI\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
-    "id": "consumersurveys:v2",
+    "id": "surveys:v2",
     "kind": "discovery#restDescription",
-    "name": "consumersurveys",
+    "name": "surveys",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
         "alt": {
             "default": "json",
             "description": "Data format for the response.",
             "enum": [
                 "json"
             ],
             "enumDescriptions": [
@@ skipping 34 matching lines @@
             "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "mobileapppanels": {
             "methods": {
                 "get": {
                     "description": "Retrieves a MobileAppPanel that is available to the authenticated user.",
                     "httpMethod": "GET",
-                    "id": "consumersurveys.mobileapppanels.get",
+                    "id": "surveys.mobileapppanels.get",
                     "parameterOrder": [
                         "panelId"
                     ],
                     "parameters": {
                         "panelId": {
                             "description": "External URL ID for the panel.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "mobileAppPanels/{panelId}",
                     "response": {
                         "$ref": "MobileAppPanel"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
-                        "https://www.googleapis.com/auth/consumersurveys.readonly",
+                        "https://www.googleapis.com/auth/surveys",
+                        "https://www.googleapis.com/auth/surveys.readonly",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "list": {
                     "description": "Lists the MobileAppPanels available to the authenticated user.",
                     "httpMethod": "GET",
-                    "id": "consumersurveys.mobileapppanels.list",
+                    "id": "surveys.mobileapppanels.list",
                     "parameters": {
                         "maxResults": {
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "startIndex": {
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "token": {
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "mobileAppPanels",
                     "response": {
                         "$ref": "MobileAppPanelsListResponse"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
-                        "https://www.googleapis.com/auth/consumersurveys.readonly",
+                        "https://www.googleapis.com/auth/surveys",
+                        "https://www.googleapis.com/auth/surveys.readonly",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "update": {
                     "description": "Updates a MobileAppPanel. Currently the only property that can be updated is the owners property.",
                     "httpMethod": "PUT",
-                    "id": "consumersurveys.mobileapppanels.update",
+                    "id": "surveys.mobileapppanels.update",
                     "parameterOrder": [
                         "panelId"
                     ],
                     "parameters": {
                         "panelId": {
                             "description": "External URL ID for the panel.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "mobileAppPanels/{panelId}",
                     "request": {
                         "$ref": "MobileAppPanel"
                     },
                     "response": {
                         "$ref": "MobileAppPanel"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 }
             }
         },
         "results": {
             "methods": {
                 "get": {
-                    "description": "Retrieves any survey results that have been produced so far. Results are formatted as an Excel file.",
+                    "description": "Retrieves any survey results that have been produced so far. Results are formatted as an Excel file. You must add \"?alt=media\" to the URL as an argument to get results.",
                     "httpMethod": "GET",
-                    "id": "consumersurveys.results.get",
+                    "id": "surveys.results.get",
                     "parameterOrder": [
                         "surveyUrlId"
                     ],
                     "parameters": {
                         "surveyUrlId": {
                             "description": "External URL ID for the survey.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{surveyUrlId}/results",
                     "request": {
                         "$ref": "ResultsGetRequest"
                     },
                     "response": {
                         "$ref": "SurveyResults"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
-                        "https://www.googleapis.com/auth/consumersurveys.readonly",
+                        "https://www.googleapis.com/auth/surveys",
+                        "https://www.googleapis.com/auth/surveys.readonly",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ],
                     "supportsMediaDownload": true
                 }
             }
         },
         "surveys": {
             "methods": {
                 "delete": {
                     "description": "Removes a survey from view in all user GET requests.",
                     "httpMethod": "DELETE",
-                    "id": "consumersurveys.surveys.delete",
+                    "id": "surveys.surveys.delete",
                     "parameterOrder": [
                         "surveyUrlId"
                     ],
                     "parameters": {
                         "surveyUrlId": {
                             "description": "External URL ID for the survey.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{surveyUrlId}",
                     "response": {
                         "$ref": "SurveysDeleteResponse"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "get": {
                     "description": "Retrieves information about the specified survey.",
                     "httpMethod": "GET",
-                    "id": "consumersurveys.surveys.get",
+                    "id": "surveys.surveys.get",
                     "parameterOrder": [
                         "surveyUrlId"
                     ],
                     "parameters": {
                         "surveyUrlId": {
                             "description": "External URL ID for the survey.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{surveyUrlId}",
                     "response": {
                         "$ref": "Survey"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
-                        "https://www.googleapis.com/auth/consumersurveys.readonly",
+                        "https://www.googleapis.com/auth/surveys",
+                        "https://www.googleapis.com/auth/surveys.readonly",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "insert": {
                     "description": "Creates a survey.",
                     "httpMethod": "POST",
-                    "id": "consumersurveys.surveys.insert",
+                    "id": "surveys.surveys.insert",
                     "path": "surveys",
                     "request": {
                         "$ref": "Survey"
                     },
                     "response": {
                         "$ref": "Survey"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "list": {
                     "description": "Lists the surveys owned by the authenticated user.",
                     "httpMethod": "GET",
-                    "id": "consumersurveys.surveys.list",
+                    "id": "surveys.surveys.list",
                     "parameters": {
                         "maxResults": {
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "startIndex": {
                             "format": "uint32",
                             "location": "query",
                             "type": "integer"
                         },
                         "token": {
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "surveys",
                     "response": {
                         "$ref": "SurveysListResponse"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
-                        "https://www.googleapis.com/auth/consumersurveys.readonly",
+                        "https://www.googleapis.com/auth/surveys",
+                        "https://www.googleapis.com/auth/surveys.readonly",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "start": {
                     "description": "Begins running a survey.",
                     "httpMethod": "POST",
-                    "id": "consumersurveys.surveys.start",
+                    "id": "surveys.surveys.start",
                     "parameterOrder": [
                         "resourceId"
                     ],
                     "parameters": {
                         "resourceId": {
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{resourceId}/start",
                     "request": {
                         "$ref": "SurveysStartRequest"
                     },
                     "response": {
                         "$ref": "SurveysStartResponse"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "stop": {
                     "description": "Stops a running survey.",
                     "httpMethod": "POST",
-                    "id": "consumersurveys.surveys.stop",
+                    "id": "surveys.surveys.stop",
                     "parameterOrder": [
                         "resourceId"
                     ],
                     "parameters": {
                         "resourceId": {
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{resourceId}/stop",
                     "response": {
                         "$ref": "SurveysStopResponse"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "update": {
                     "description": "Updates a survey. Currently the only property that can be updated is the owners property.",
                     "httpMethod": "PUT",
-                    "id": "consumersurveys.surveys.update",
+                    "id": "surveys.surveys.update",
                     "parameterOrder": [
                         "surveyUrlId"
                     ],
                     "parameters": {
                         "surveyUrlId": {
                             "description": "External URL ID for the survey.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "surveys/{surveyUrlId}",
                     "request": {
                         "$ref": "Survey"
                     },
                     "response": {
                         "$ref": "Survey"
                     },
                     "scopes": [
-                        "https://www.googleapis.com/auth/consumersurveys",
+                        "https://www.googleapis.com/auth/surveys",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 }
             }
         }
     },
-    "revision": "20160718",
+    "revision": "20161103",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "FieldMask": {
             "id": "FieldMask",
             "properties": {
                 "fields": {
                     "items": {
                         "$ref": "FieldMask"
                     },
                     "type": "array"
@@ skipping 121 matching lines @@
                     "format": "byte",
                     "type": "string"
                 },
                 "description": {
                     "description": "Text description of the survey.",
                     "type": "string"
                 },
                 "owners": {
                     "annotations": {
                         "required": [
-                            "consumersurveys.surveys.insert"
+                            "surveys.surveys.insert"
                         ]
                     },
                     "description": "List of email addresses for survey owners. Must contain at least the address of the user making the API call.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "questions": {
                     "annotations": {
                         "required": [
-                            "consumersurveys.surveys.insert"
+                            "surveys.surveys.insert"
                         ]
                     },
                     "description": "List of questions defining the survey.",
                     "items": {
                         "$ref": "SurveyQuestion"
                     },
                     "type": "array"
                 },
+                "rejectionReason": {
+                    "$ref": "SurveyRejection",
+                    "description": "Reason for the survey being rejected. Only present if the survey state is rejected."
+                },
                 "state": {
                     "description": "State that the survey is in.",
                     "type": "string"
                 },
                 "surveyUrlId": {
                     "description": "Unique survey ID, that is viewable in the URL of the Survey Creator UI",
                     "type": "string"
                 },
                 "title": {
                     "description": "Optional name that will be given to the survey.",
@@ skipping 14 matching lines @@
                 "ages": {
                     "description": "Optional list of age buckets to target. Supported age buckets are: ['18-24', '25-34', '35-44', '45-54', '55-64', '65+']",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "country": {
                     "annotations": {
                         "required": [
-                            "consumersurveys.surveys.insert"
+                            "surveys.surveys.insert"
                         ]
                     },
                     "description": "Required country code that surveys should be targeted to. Accepts standard ISO 3166-1 2 character language codes. For instance, 'US' for the United States, and 'GB' for the United Kingdom.",
                     "type": "string"
                 },
                 "countrySubdivision": {
                     "description": "Country subdivision (states/provinces/etc) that surveys should be targeted to. For all countries except GB, ISO-3166-2 subdivision code is required (eg. 'US-OH' for Ohio, United States). For GB, NUTS 1 statistical region codes for the United Kingdom is required (eg. 'UK-UKC' for North East England).",
                     "type": "string"
                 },
                 "gender": {
                     "description": "Optional gender to target.",
                     "type": "string"
                 },
                 "languages": {
                     "annotations": {
                         "required": [
-                            "consumersurveys.surveys.insert"
+                            "surveys.surveys.insert"
                         ]
                     },
                     "description": "Language code that surveys should be targeted to. For instance, 'en-US'. Surveys may target bilingual users by specifying a list of language codes (for example, 'de' and 'en-US'). In that case, all languages will be used for targeting users but the survey content (which is displayed) must match the first language listed. Accepts standard BCP47 language codes. See specification.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "mobileAppPanelId": {
                     "description": "Key for predefined panel that causes survey to be sent to a predefined set of Opinion Rewards App users. You must set PopulationSource to ANDROID_APP_PANEL to use this field.",
@@ skipping 103 matching lines @@
                 "thresholdAnswers": {
                     "description": "The threshold/screener answer options, which will screen a user into the rest of the survey. These will be a subset of the answer option strings.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "type": {
                     "annotations": {
                         "required": [
-                            "consumersurveys.surveys.insert"
+                            "surveys.surveys.insert"
                         ]
                     },
                     "description": "Required field defining the question type. For details about configuring different type of questions, consult the question configuration guide.",
                     "type": "string"
                 },
                 "unitOfMeasurementLabel": {
                     "description": "Optional unit of measurement for display (for example: hours, people, miles).",
                     "type": "string"
                 },
                 "videoId": {
@@ skipping 16 matching lines @@
                     "format": "byte",
                     "type": "string"
                 },
                 "url": {
                     "description": "The read-only URL for the hosted images.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "SurveyRejection": {
+            "description": "Message representing why the survey was rejected from review, if it was.",
+            "id": "SurveyRejection",
+            "properties": {
+                "explanation": {
+                    "description": "A human-readable explanation of what was wrong with the survey.",
+                    "type": "string"
+                },
+                "type": {
+                    "description": "Which category of rejection this was. See the  Google Surveys Help Center for additional details on each category.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "SurveyResults": {
             "description": "Reference to the current results for a given survey.",
             "id": "SurveyResults",
             "properties": {
                 "status": {
                     "description": "Human readable string describing the status of the request.",
                     "type": "string"
                 },
                 "surveyUrlId": {
                     "description": "External survey ID as viewable by survey owners in the editor view.",
@@ skipping 80 matching lines @@
                 "nextPageToken": {
                     "type": "string"
                 },
                 "previousPageToken": {
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
-    "servicePath": "consumersurveys/v2/",
-    "title": "Consumer Surveys API",
+    "servicePath": "surveys/v2/",
+    "title": "Surveys API",
     "version": "v2"
 }