Looks up entities by key.
HTTP request
POST https://datastore.googleapis.com/v1/projects/{projectId}:lookup
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
projectId |
Required. 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 ( |
Fields | |
---|---|
readOptions |
The options for this lookup request. |
keys[] |
Required. 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 ( |
Fields | |
---|---|
found[] |
Entities found as |
missing[] |
Entities not found as |
deferred[] |
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. |
transaction |
The identifier of the transaction that was started as part of this projects.lookup request. Set only when A base64-encoded string. |
Authorization Scopes
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 Authentication Overview.