Api roll 1: 2014-09-23

discovery/googleapis_beta/datastore__v1beta2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
+                "https://www.googleapis.com/auth/cloud-platform": {
+                    "description": "View and manage your data across Google Cloud Platform services"
+                },
                 "https://www.googleapis.com/auth/datastore": {
                     "description": "View and manage your Google Cloud Datastore data"
                 },
                 "https://www.googleapis.com/auth/userinfo.email": {
                     "description": "View your email address"
                 }
             }
         }
     },
     "basePath": "/datastore/v1beta2/datasets/",
     "baseUrl": "https://www.googleapis.com/datastore/v1beta2/datasets/",
     "batchPath": "batch",
     "description": "API for accessing Google Cloud Datastore.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/datastore/",
-    "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/2BYNDaZqMjLdfTtg3EL0oL8j6oI\"",
+    "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/LDhSkY4UxrCPhfQmh9G4U2uaRlU\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "datastore:v1beta2",
     "kind": "discovery#restDescription",
     "name": "datastore",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 63 matching lines @@
                         }
                     },
                     "path": "{datasetId}/allocateIds",
                     "request": {
                         "$ref": "AllocateIdsRequest"
                     },
                     "response": {
                         "$ref": "AllocateIdsResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "beginTransaction": {
                     "description": "Begin a new transaction.",
                     "httpMethod": "POST",
                     "id": "datastore.datasets.beginTransaction",
                     "parameterOrder": [
                         "datasetId"
                     ],
                     "parameters": {
                         "datasetId": {
                             "description": "Identifies the dataset.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{datasetId}/beginTransaction",
                     "request": {
                         "$ref": "BeginTransactionRequest"
                     },
                     "response": {
                         "$ref": "BeginTransactionResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "commit": {
                     "description": "Commit a transaction, optionally creating, deleting or modifying some entities.",
                     "httpMethod": "POST",
                     "id": "datastore.datasets.commit",
                     "parameterOrder": [
                         "datasetId"
                     ],
                     "parameters": {
                         "datasetId": {
                             "description": "Identifies the dataset.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{datasetId}/commit",
                     "request": {
                         "$ref": "CommitRequest"
                     },
                     "response": {
                         "$ref": "CommitResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "lookup": {
                     "description": "Look up some entities by key.",
                     "httpMethod": "POST",
                     "id": "datastore.datasets.lookup",
                     "parameterOrder": [
                         "datasetId"
                     ],
                     "parameters": {
                         "datasetId": {
                             "description": "Identifies the dataset.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{datasetId}/lookup",
                     "request": {
                         "$ref": "LookupRequest"
                     },
                     "response": {
                         "$ref": "LookupResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "rollback": {
                     "description": "Roll back a transaction.",
                     "httpMethod": "POST",
                     "id": "datastore.datasets.rollback",
                     "parameterOrder": [
                         "datasetId"
                     ],
                     "parameters": {
                         "datasetId": {
                             "description": "Identifies the dataset.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{datasetId}/rollback",
                     "request": {
                         "$ref": "RollbackRequest"
                     },
                     "response": {
                         "$ref": "RollbackResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 },
                 "runQuery": {
                     "description": "Query for entities.",
                     "httpMethod": "POST",
                     "id": "datastore.datasets.runQuery",
                     "parameterOrder": [
                         "datasetId"
                     ],
                     "parameters": {
                         "datasetId": {
                             "description": "Identifies the dataset.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{datasetId}/runQuery",
                     "request": {
                         "$ref": "RunQueryRequest"
                     },
                     "response": {
                         "$ref": "RunQueryResponse"
                     },
                     "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/datastore",
                         "https://www.googleapis.com/auth/userinfo.email"
                     ]
                 }
             }
         }
     },
-    "revision": "20140613",
+    "revision": "20140916",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AllocateIdsRequest": {
             "id": "AllocateIdsRequest",
             "properties": {
                 "keys": {
                     "description": "A list of keys with incomplete key paths to allocate IDs for. No key may be reserved/read-only.",
                     "items": {
                         "$ref": "Key"
                     },
@@ skipping 87 matching lines @@
                     "$ref": "ResponseHeader"
                 },
                 "mutationResult": {
                     "$ref": "MutationResult",
                     "description": "The result of performing the mutation (if any)."
                 }
             },
             "type": "object"
         },
         "CompositeFilter": {
+            "description": "A filter that merges the multiple other filters using the given operation.",
             "id": "CompositeFilter",
             "properties": {
                 "filters": {
                     "description": "The list of filters to combine. Must contain at least one filter.",
                     "items": {
                         "$ref": "Filter"
                     },
                     "type": "array"
                 },
                 "operator": {
                     "description": "The operator for combining multiple filters. Only \"and\" is currently supported.",
                     "enum": [
                         "AND"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Entity": {
+            "description": "An entity.",
             "id": "Entity",
             "properties": {
                 "key": {
                     "$ref": "Key",
                     "description": "The entity's key.\n\nAn entity must have a key, unless otherwise documented (for example, an entity in Value.entityValue may have no key). An entity's kind is its key's path's last element's kind, or null if it has no key."
                 },
                 "properties": {
                     "additionalProperties": {
                         "$ref": "Property",
                         "description": "The name of the property. A property name matching regex \"__.*__\" is reserved. A reserved property name is forbidden in certain documented contexts. The name must not contain more than 500 characters. Cannot be \"\"."
                     },
                     "description": "The entity's properties.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "EntityResult": {
+            "description": "The result of fetching an entity from the datastore.",
             "id": "EntityResult",
             "properties": {
                 "entity": {
                     "$ref": "Entity",
                     "description": "The resulting entity."
                 }
             },
             "type": "object"
         },
         "Filter": {
+            "description": "A holder for any type of filter. Exactly one field should be specified.",
             "id": "Filter",
             "properties": {
                 "compositeFilter": {
                     "$ref": "CompositeFilter",
                     "description": "A composite filter."
                 },
                 "propertyFilter": {
                     "$ref": "PropertyFilter",
                     "description": "A filter on a property."
                 }
             },
             "type": "object"
         },
         "GqlQuery": {
+            "description": "A GQL query.",
             "id": "GqlQuery",
             "properties": {
                 "allowLiteral": {
                     "description": "When false, the query string must not contain a literal.",
                     "type": "boolean"
                 },
                 "nameArgs": {
                     "description": "A named argument must set field GqlQueryArg.name. No two named arguments may have the same name. For each non-reserved named binding site in the query string, there must be a named argument with that name, but not necessarily the inverse.",
                     "items": {
                         "$ref": "GqlQueryArg"
                     },
                     "type": "array"
                 },
                 "numberArgs": {
                     "description": "Numbered binding site @1 references the first numbered argument, effectively using 1-based indexing, rather than the usual 0. A numbered argument must NOT set field GqlQueryArg.name. For each binding site numbered i in query_string, there must be an ith numbered argument. The inverse must also be true.",
                     "items": {
                         "$ref": "GqlQueryArg"
                     },
                     "type": "array"
                 },
                 "queryString": {
+                    "description": "The query string.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "GqlQueryArg": {
+            "description": "A binding argument for a GQL query.",
             "id": "GqlQueryArg",
             "properties": {
                 "cursor": {
                     "format": "byte",
                     "type": "string"
                 },
                 "name": {
                     "description": "Must match regex \"[A-Za-z_$][A-Za-z_$0-9]*\". Must not match regex \"__.*__\". Must not be \"\".",
                     "type": "string"
                 },
                 "value": {
                     "$ref": "Value"
                 }
             },
             "type": "object"
         },
         "Key": {
+            "description": "A unique identifier for an entity.",
             "id": "Key",
             "properties": {
                 "partitionId": {
                     "$ref": "PartitionId",
                     "description": "Entities are partitioned into subsets, currently identified by a dataset (usually implicitly specified by the project) and namespace ID. Queries are scoped to a single partition."
                 },
                 "path": {
                     "description": "The entity path. An entity path consists of one or more elements composed of a kind and a string or numerical identifier, which identify entities. The first element identifies a root entity, the second element identifies a child of the root entity, the third element a child of the second entity, and so forth. The entities identified by all prefixes of the path are called the element's ancestors. An entity path is always fully complete: ALL of the entity's ancestors are required to be in the path along with the entity identifier itself. The only exception is that in some documented cases, the identifier in the last path element (for the entity) itself may be omitted. A path can never be empty. The path can have at most 100 elements.",
                     "items": {
                         "$ref": "KeyPathElement"
@@ skipping 17 matching lines @@
                     "type": "string"
                 },
                 "name": {
                     "description": "The name of the entity. A name matching regex \"__.*__\" is reserved/read-only. A name must not be more than 500 characters. Cannot be \"\".",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "KindExpression": {
+            "description": "A representation of a kind.",
             "id": "KindExpression",
             "properties": {
                 "name": {
                     "description": "The name of the kind.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "LookupRequest": {
@@ skipping 37 matching lines @@
                     "description": "Entities not found, with only the key populated.",
                     "items": {
                         "$ref": "EntityResult"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "Mutation": {
+            "description": "A set of changes to apply.",
             "id": "Mutation",
             "properties": {
                 "delete": {
                     "description": "Keys of entities to delete. Each key must have a complete key path and must not be reserved/read-only.",
                     "items": {
                         "$ref": "Key"
                     },
                     "type": "array"
                 },
                 "force": {
@@ skipping 43 matching lines @@
                     "description": "Keys for insertAutoId entities. One per entity from the request, in the same order.",
                     "items": {
                         "$ref": "Key"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "PartitionId": {
+            "description": "An identifier for a particular subset of entities.\n\nEntities are partitioned into various subsets, each used by different datasets and different namespaces within a dataset and so forth.",
             "id": "PartitionId",
             "properties": {
                 "datasetId": {
                     "description": "The dataset ID.",
                     "type": "string"
                 },
                 "namespace": {
                     "description": "The namespace.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Property": {
+            "description": "An entity property.",
             "id": "Property",
             "properties": {
                 "blobKeyValue": {
                     "description": "A blob key value.",
                     "type": "string"
                 },
                 "blobValue": {
                     "description": "A blob value. May be a maximum of 1,000,000 bytes.",
                     "format": "byte",
                     "type": "string"
@@ skipping 42 matching lines @@
                     "type": "integer"
                 },
                 "stringValue": {
                     "description": "A UTF-8 encoded string value.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "PropertyExpression": {
+            "description": "A representation of a property in a projection.",
             "id": "PropertyExpression",
             "properties": {
                 "aggregationFunction": {
                     "description": "The aggregation function to apply to the property. Optional. Can only be used when grouping by at least one property. Must then be set on all properties in the projection that are not being grouped by. Aggregation functions: first selects the first result as determined by the query's order.",
                     "enum": [
                         "FIRST"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 },
                 "property": {
                     "$ref": "PropertyReference",
                     "description": "The property to project."
                 }
             },
             "type": "object"
         },
         "PropertyFilter": {
+            "description": "A filter on a specific property.",
             "id": "PropertyFilter",
             "properties": {
                 "operator": {
                     "description": "The operator to filter by. One of lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, equal, or hasAncestor.",
                     "enum": [
                         "EQUAL",
                         "GREATER_THAN",
                         "GREATER_THAN_OR_EQUAL",
                         "HAS_ANCESTOR",
                         "LESS_THAN",
@@ skipping 14 matching lines @@
                     "description": "The property to filter by."
                 },
                 "value": {
                     "$ref": "Value",
                     "description": "The value to compare the property to."
                 }
             },
             "type": "object"
         },
         "PropertyOrder": {
+            "description": "The desired order for a specific property.",
             "id": "PropertyOrder",
             "properties": {
                 "direction": {
                     "description": "The direction to order by. One of ascending or descending. Optional, defaults to ascending.",
                     "enum": [
                         "ASCENDING",
                         "DESCENDING"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "property": {
                     "$ref": "PropertyReference",
                     "description": "The property to order by."
                 }
             },
             "type": "object"
         },
         "PropertyReference": {
+            "description": "A reference to a property relative to the kind expressions.",
             "id": "PropertyReference",
             "properties": {
                 "name": {
                     "description": "The name of the property.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Query": {
+            "description": "A query.",
             "id": "Query",
             "properties": {
                 "endCursor": {
                     "description": "An ending point for the query results. Optional. Query cursors are returned in query result batches.",
                     "format": "byte",
                     "type": "string"
                 },
                 "filter": {
                     "$ref": "Filter",
                     "description": "The filter to apply (optional)."
@@ skipping 38 matching lines @@
                 },
                 "startCursor": {
                     "description": "A starting point for the query results. Optional. Query cursors are returned in query result batches.",
                     "format": "byte",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "QueryResultBatch": {
+            "description": "A batch of results produced by a query.",
             "id": "QueryResultBatch",
             "properties": {
                 "endCursor": {
-                    "description": "A cursor that points to the position after the last result in the batch. May be absent.",
+                    "description": "A cursor that points to the position after the last result in the batch. May be absent. TODO(arfuller): Once all plans produce cursors update documentation here.",
                     "format": "byte",
                     "type": "string"
                 },
                 "entityResultType": {
                     "description": "The result type for every entity in entityResults. full for full entities, projection for entities with only projected properties, keyOnly for entities with only a key.",
                     "enum": [
                         "FULL",
                         "KEY_ONLY",
                         "PROJECTION"
                     ],
@@ skipping 118 matching lines @@
                     "$ref": "QueryResultBatch",
                     "description": "A batch of query results (always present)."
                 },
                 "header": {
                     "$ref": "ResponseHeader"
                 }
             },
             "type": "object"
         },
         "Value": {
+            "description": "A message that can hold any of the supported value types and associated metadata.",
             "id": "Value",
             "properties": {
                 "blobKeyValue": {
                     "description": "A blob key value.",
                     "type": "string"
                 },
                 "blobValue": {
                     "description": "A blob value. May be a maximum of 1,000,000 bytes.",
                     "format": "byte",
                     "type": "string"
@@ skipping 46 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "datastore/v1beta2/datasets/",
     "title": "Google Cloud Datastore API",
     "version": "v1beta2"
 }