Python 3.9 is now generally available.


Retrieves one or more entities from the datastore.

Retrieves the entity or entities with the given key(s) from the datastore and returns them as fully populated Entity objects, as defined below. If there is an error, raises a subclass of datastore_errors.Error.

If keys is a single key or string, an Entity will be returned, or EntityNotFoundError will be raised if no existing entity matches the key.

However, if keys is a list or tuple, a list of entities will be returned that corresponds to the sequence of keys. It will include entities for keys that were found and None placeholders for keys that were not found.

keys Key or string or list of Keys or strings
config Optional Configuration to use for this request, must be specified as a keyword argument.

Entity or list of Entity objects