Method: projects.lookup

Looks up entities by key.

HTTP request

POST https://datastore.googleapis.com/v1beta3/projects/{projectId}:lookup

(This URI uses URI Template syntax.)

Path parameters

Parameters
projectId

string

The ID of the project against which to make the request.

Request body

The request body contains data with the following structure:

JSON representation
{
  "readOptions": {
    object(ReadOptions)
  },
  "keys": [
    {
      object(Key)
    }
  ],
}
Fields
readOptions

object(ReadOptions)

The options for this lookup request.

keys[]

object(Key)

Keys of entities to look up.

Response body

If successful, the response body contains data with the following structure:

The response for Datastore.Lookup.

JSON representation
{
  "found": [
    {
      object(EntityResult)
    }
  ],
  "missing": [
    {
      object(EntityResult)
    }
  ],
  "deferred": [
    {
      object(Key)
    }
  ],
}
Fields
found[]

object(EntityResult)

Entities found as ResultType.FULL entities. The order of results in this field is undefined and has no relation to the order of the keys in the input.

missing[]

object(EntityResult)

Entities not found as ResultType.KEY_ONLY entities. The order of results in this field is undefined and has no relation to the order of the keys in the input.

deferred[]

object(Key)

A list of keys that were not looked up due to resource constraints. The order of results in this field is undefined and has no relation to the order of the keys in the input.

Authorization

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Auth Guide.

Try it!

Send feedback about...

Cloud Datastore