Cloud Datastore V1 Client - Class PathElement (1.24.4)

Reference documentation and code samples for the Cloud Datastore V1 Client class PathElement.

A (kind, ID/name) pair used to construct a key path.

If either name or ID is set, the element is complete.If neither is set, the element is incomplete.

Generated from protobuf messagegoogle.datastore.v1.Key.PathElement

Namespace

Google \ Cloud \ Datastore \ V1 \ Key

Methods

__construct

Constructor.

Parameters
NameDescription
dataarray

Optional. Data for populating the Message object.

↳ kindstring

The kind of the entity. A kind matching regex__.*__ is reserved/read-only. A kind must not contain more than 1500 bytes when UTF-8 encoded. Cannot be"". Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 are encoded as__bytes<X>__ where<X> is the base-64 encoding of the bytes.

↳ idint|string

The auto-allocated ID of the entity. Never equal to zero. Values less than zero are discouraged and may not be supported in the future.

↳ namestring

The name of the entity. A name matching regex__.*__ is reserved/read-only. A name must not be more than 1500 bytes when UTF-8 encoded. Cannot be"". Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 are encoded as__bytes<X>__ where<X> is the base-64 encoding of the bytes.

getKind

The kind of the entity.

A kind matching regex__.*__ is reserved/read-only.A kind must not contain more than 1500 bytes when UTF-8 encoded.Cannot be"".Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 areencoded as__bytes<X>__ where<X> is the base-64 encoding of thebytes.

Returns
TypeDescription
string

setKind

The kind of the entity.

A kind matching regex__.*__ is reserved/read-only.A kind must not contain more than 1500 bytes when UTF-8 encoded.Cannot be"".Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 areencoded as__bytes<X>__ where<X> is the base-64 encoding of thebytes.

Parameter
NameDescription
varstring
Returns
TypeDescription
$this

getId

The auto-allocated ID of the entity.

Never equal to zero. Values less than zero are discouraged and may notbe supported in the future.

Returns
TypeDescription
int|string

hasId

setId

The auto-allocated ID of the entity.

Never equal to zero. Values less than zero are discouraged and may notbe supported in the future.

Parameter
NameDescription
varint|string
Returns
TypeDescription
$this

getName

The name of the entity.

A name matching regex__.*__ is reserved/read-only.A name must not be more than 1500 bytes when UTF-8 encoded.Cannot be"".Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 areencoded as__bytes<X>__ where<X> is the base-64 encoding of thebytes.

Returns
TypeDescription
string

hasName

setName

The name of the entity.

A name matching regex__.*__ is reserved/read-only.A name must not be more than 1500 bytes when UTF-8 encoded.Cannot be"".Must be valid UTF-8 bytes. Legacy values that are not valid UTF-8 areencoded as__bytes<X>__ where<X> is the base-64 encoding of thebytes.

Parameter
NameDescription
varstring
Returns
TypeDescription
$this

getIdType

Returns
TypeDescription
string

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-24 UTC.