Documentation ¶
Overview ¶
Package datastore provides access to the Google Cloud Datastore API.
See https://cloud.google.com/datastore/
Usage example:
import "google.golang.org/api/datastore/v1" ... datastoreService, err := datastore.New(oauthHttpClient)
Index ¶
- Constants
- type AllocateIdsRequest
- type AllocateIdsResponse
- type ArrayValue
- type BeginTransactionRequest
- type BeginTransactionResponse
- type CommitRequest
- type CommitResponse
- type CompositeFilter
- type Entity
- type EntityResult
- type Filter
- type GqlQuery
- type GqlQueryParameter
- type Key
- type KindExpression
- type LatLng
- type LookupRequest
- type LookupResponse
- type Mutation
- type MutationResult
- type PartitionId
- type PathElement
- type Projection
- type ProjectsAllocateIdsCall
- func (c *ProjectsAllocateIdsCall) Context(ctx context.Context) *ProjectsAllocateIdsCall
- func (c *ProjectsAllocateIdsCall) Do(opts ...googleapi.CallOption) (*AllocateIdsResponse, error)
- func (c *ProjectsAllocateIdsCall) Fields(s ...googleapi.Field) *ProjectsAllocateIdsCall
- func (c *ProjectsAllocateIdsCall) Header() http.Header
- type ProjectsBeginTransactionCall
- func (c *ProjectsBeginTransactionCall) Context(ctx context.Context) *ProjectsBeginTransactionCall
- func (c *ProjectsBeginTransactionCall) Do(opts ...googleapi.CallOption) (*BeginTransactionResponse, error)
- func (c *ProjectsBeginTransactionCall) Fields(s ...googleapi.Field) *ProjectsBeginTransactionCall
- func (c *ProjectsBeginTransactionCall) Header() http.Header
- type ProjectsCommitCall
- type ProjectsLookupCall
- type ProjectsRollbackCall
- func (c *ProjectsRollbackCall) Context(ctx context.Context) *ProjectsRollbackCall
- func (c *ProjectsRollbackCall) Do(opts ...googleapi.CallOption) (*RollbackResponse, error)
- func (c *ProjectsRollbackCall) Fields(s ...googleapi.Field) *ProjectsRollbackCall
- func (c *ProjectsRollbackCall) Header() http.Header
- type ProjectsRunQueryCall
- func (c *ProjectsRunQueryCall) Context(ctx context.Context) *ProjectsRunQueryCall
- func (c *ProjectsRunQueryCall) Do(opts ...googleapi.CallOption) (*RunQueryResponse, error)
- func (c *ProjectsRunQueryCall) Fields(s ...googleapi.Field) *ProjectsRunQueryCall
- func (c *ProjectsRunQueryCall) Header() http.Header
- type ProjectsService
- func (r *ProjectsService) AllocateIds(projectId string, allocateidsrequest *AllocateIdsRequest) *ProjectsAllocateIdsCall
- func (r *ProjectsService) BeginTransaction(projectId string, begintransactionrequest *BeginTransactionRequest) *ProjectsBeginTransactionCall
- func (r *ProjectsService) Commit(projectId string, commitrequest *CommitRequest) *ProjectsCommitCall
- func (r *ProjectsService) Lookup(projectId string, lookuprequest *LookupRequest) *ProjectsLookupCall
- func (r *ProjectsService) Rollback(projectId string, rollbackrequest *RollbackRequest) *ProjectsRollbackCall
- func (r *ProjectsService) RunQuery(projectId string, runqueryrequest *RunQueryRequest) *ProjectsRunQueryCall
- type PropertyFilter
- type PropertyOrder
- type PropertyReference
- type Query
- type QueryResultBatch
- type ReadOptions
- type RollbackRequest
- type RollbackResponse
- type RunQueryRequest
- type RunQueryResponse
- type Service
- type Value
Constants ¶
const ( // View and manage your data across Google Cloud Platform services CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" // View and manage your Google Cloud Datastore data DatastoreScope = "https://www.googleapis.com/auth/datastore" )
OAuth2 scopes used by this API.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AllocateIdsRequest ¶
type AllocateIdsRequest struct { // Keys: A list of keys with incomplete key paths for which to allocate // IDs. // No key may be reserved/read-only. Keys []*Key `json:"keys,omitempty"` // ForceSendFields is a list of field names (e.g. "Keys") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Keys") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
AllocateIdsRequest: The request for Datastore.AllocateIds.
func (*AllocateIdsRequest) MarshalJSON ¶
func (s *AllocateIdsRequest) MarshalJSON() ([]byte, error)
type AllocateIdsResponse ¶
type AllocateIdsResponse struct { // Keys: The keys specified in the request (in the same order), each // with // its key path completed with a newly allocated ID. Keys []*Key `json:"keys,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Keys") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Keys") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
AllocateIdsResponse: The response for Datastore.AllocateIds.
func (*AllocateIdsResponse) MarshalJSON ¶
func (s *AllocateIdsResponse) MarshalJSON() ([]byte, error)
type ArrayValue ¶
type ArrayValue struct { // Values: Values in the array. // The order of this array may not be preserved if it contains a mix // of // indexed and unindexed values. Values []*Value `json:"values,omitempty"` // ForceSendFields is a list of field names (e.g. "Values") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Values") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
ArrayValue: An array value.
func (*ArrayValue) MarshalJSON ¶
func (s *ArrayValue) MarshalJSON() ([]byte, error)
type BeginTransactionRequest ¶
type BeginTransactionRequest struct { }
BeginTransactionRequest: The request for Datastore.BeginTransaction.
type BeginTransactionResponse ¶
type BeginTransactionResponse struct { // Transaction: The transaction identifier (always present). Transaction string `json:"transaction,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Transaction") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Transaction") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
BeginTransactionResponse: The response for Datastore.BeginTransaction.
func (*BeginTransactionResponse) MarshalJSON ¶
func (s *BeginTransactionResponse) MarshalJSON() ([]byte, error)
type CommitRequest ¶
type CommitRequest struct { // Mode: The type of commit to perform. Defaults to `TRANSACTIONAL`. // // Possible values: // "MODE_UNSPECIFIED" - Unspecified. This value must not be used. // "TRANSACTIONAL" - Transactional: The mutations are either all // applied, or none are applied. // Learn about transactions // [here](https://cloud.google.com/datastore/docs/concepts/transactions). // "NON_TRANSACTIONAL" - Non-transactional: The mutations may not // apply as all or none. Mode string `json:"mode,omitempty"` // Mutations: The mutations to perform. // // When mode is `TRANSACTIONAL`, mutations affecting a single entity // are // applied in order. The following sequences of mutations affecting a // single // entity are not permitted in a single `Commit` request: // // - `insert` followed by `insert` // - `update` followed by `insert` // - `upsert` followed by `insert` // - `delete` followed by `update` // // When mode is `NON_TRANSACTIONAL`, no two mutations may affect a // single // entity. Mutations []*Mutation `json:"mutations,omitempty"` // Transaction: The identifier of the transaction associated with the // commit. A // transaction identifier is returned by a call // to // Datastore.BeginTransaction. Transaction string `json:"transaction,omitempty"` // ForceSendFields is a list of field names (e.g. "Mode") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Mode") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
CommitRequest: The request for Datastore.Commit.
func (*CommitRequest) MarshalJSON ¶
func (s *CommitRequest) MarshalJSON() ([]byte, error)
type CommitResponse ¶
type CommitResponse struct { // IndexUpdates: The number of index entries updated during the commit, // or zero if none were // updated. IndexUpdates int64 `json:"indexUpdates,omitempty"` // MutationResults: The result of performing the mutations. // The i-th mutation result corresponds to the i-th mutation in the // request. MutationResults []*MutationResult `json:"mutationResults,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "IndexUpdates") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "IndexUpdates") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
CommitResponse: The response for Datastore.Commit.
func (*CommitResponse) MarshalJSON ¶
func (s *CommitResponse) MarshalJSON() ([]byte, error)
type CompositeFilter ¶
type CompositeFilter struct { // Filters: The list of filters to combine. // Must contain at least one filter. Filters []*Filter `json:"filters,omitempty"` // Op: The operator for combining multiple filters. // // Possible values: // "OPERATOR_UNSPECIFIED" - Unspecified. This value must not be used. // "AND" - The results are required to satisfy each of the combined // filters. Op string `json:"op,omitempty"` // ForceSendFields is a list of field names (e.g. "Filters") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Filters") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
CompositeFilter: A filter that merges multiple other filters using the given operator.
func (*CompositeFilter) MarshalJSON ¶
func (s *CompositeFilter) MarshalJSON() ([]byte, error)
type Entity ¶
type Entity struct { // Key: The entity's key. // // An entity must have a key, unless otherwise documented (for // example, // an entity in `Value.entity_value` may have no key). // An entity's kind is its key path's last element's kind, // or null if it has no key. Key *Key `json:"key,omitempty"` // Properties: The entity's properties. // The map's keys are property names. // 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. // The name cannot be "". Properties map[string]Value `json:"properties,omitempty"` // ForceSendFields is a list of field names (e.g. "Key") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Key") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Entity: A Datastore data object.
An entity is limited to 1 megabyte when stored. That _roughly_ corresponds to a limit of 1 megabyte for the serialized form of this message.
func (*Entity) MarshalJSON ¶
type EntityResult ¶
type EntityResult struct { // Cursor: A cursor that points to the position after the result // entity. // Set only when the `EntityResult` is part of a `QueryResultBatch` // message. Cursor string `json:"cursor,omitempty"` // Entity: The resulting entity. Entity *Entity `json:"entity,omitempty"` // Version: The version of the entity, a strictly positive number that // monotonically // increases with changes to the entity. // // This field is set for `FULL` entity // results. // // For missing entities in `LookupResponse`, this // is the version of the snapshot that was used to look up the entity, // and it // is always set except for eventually consistent reads. Version int64 `json:"version,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Cursor") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Cursor") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
EntityResult: The result of fetching an entity from Datastore.
func (*EntityResult) MarshalJSON ¶
func (s *EntityResult) MarshalJSON() ([]byte, error)
type Filter ¶
type Filter struct { // CompositeFilter: A composite filter. CompositeFilter *CompositeFilter `json:"compositeFilter,omitempty"` // PropertyFilter: A filter on a property. PropertyFilter *PropertyFilter `json:"propertyFilter,omitempty"` // ForceSendFields is a list of field names (e.g. "CompositeFilter") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CompositeFilter") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
Filter: A holder for any type of filter.
func (*Filter) MarshalJSON ¶
type GqlQuery ¶
type GqlQuery struct { // AllowLiterals: When false, the query string must not contain any // literals and instead must // bind all values. For example, // `SELECT * FROM Kind WHERE a = 'string literal'` is not allowed, // while // `SELECT * FROM Kind WHERE a = @value` is. AllowLiterals bool `json:"allowLiterals,omitempty"` // NamedBindings: For each non-reserved named binding site in the query // string, there must be // a named parameter with that name, but not necessarily the // inverse. // // Key must match regex `A-Za-z_$*`, must not match regex // `__.*__`, and must not be "". NamedBindings map[string]GqlQueryParameter `json:"namedBindings,omitempty"` // PositionalBindings: Numbered binding site @1 references the first // numbered parameter, // effectively using 1-based indexing, rather than the usual 0. // // For each binding site numbered i in `query_string`, there must be an // i-th // numbered parameter. The inverse must also be true. PositionalBindings []*GqlQueryParameter `json:"positionalBindings,omitempty"` // QueryString: A string of the format // described // [here](https://cloud.google.com/datastore/docs/apis/gql/gql_ // reference). QueryString string `json:"queryString,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowLiterals") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AllowLiterals") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GqlQuery: A [GQL query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference) .
func (*GqlQuery) MarshalJSON ¶
type GqlQueryParameter ¶
type GqlQueryParameter struct { // Cursor: A query cursor. Query cursors are returned in query // result batches. Cursor string `json:"cursor,omitempty"` // Value: A value parameter. Value *Value `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Cursor") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Cursor") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GqlQueryParameter: A binding parameter for a GQL query.
func (*GqlQueryParameter) MarshalJSON ¶
func (s *GqlQueryParameter) MarshalJSON() ([]byte, error)
type Key ¶
type Key struct { // PartitionId: Entities are partitioned into subsets, currently // identified by a project // ID and namespace ID. // Queries are scoped to a single partition. PartitionId *PartitionId `json:"partitionId,omitempty"` // Path: 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 identifies 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. For // example, // the last path element of the key of `Mutation.insert` may have // no // identifier. // // A path can never be empty, and a path can have at most 100 elements. Path []*PathElement `json:"path,omitempty"` // ForceSendFields is a list of field names (e.g. "PartitionId") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "PartitionId") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Key: A unique identifier for an entity. If a key's partition ID or any of its path kinds or names are reserved/read-only, the key is reserved/read-only. A reserved/read-only key is forbidden in certain documented contexts.
func (*Key) MarshalJSON ¶
type KindExpression ¶
type KindExpression struct { // Name: The name of the kind. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Name") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
KindExpression: A representation of a kind.
func (*KindExpression) MarshalJSON ¶
func (s *KindExpression) MarshalJSON() ([]byte, error)
type LatLng ¶
type LatLng struct { // Latitude: The latitude in degrees. It must be in the range [-90.0, // +90.0]. Latitude float64 `json:"latitude,omitempty"` // Longitude: The longitude in degrees. It must be in the range [-180.0, // +180.0]. Longitude float64 `json:"longitude,omitempty"` // ForceSendFields is a list of field names (e.g. "Latitude") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Latitude") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
LatLng: An object representing a latitude/longitude pair. This is expressed as a pair of doubles representing degrees latitude and degrees longitude. Unless specified otherwise, this must conform to the <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84 st andard</a>. Values must be within normalized ranges.
Example of normalization code in Python:
def NormalizeLongitude(longitude): """Wraps decimal degrees longitude to [-180.0, 180.0].""" q, r = divmod(longitude, 360.0) if r > 180.0 or (r == 180.0 and q <= -1.0): return r - 360.0 return r def NormalizeLatLng(latitude, longitude): """Wraps decimal degrees latitude and longitude to [-90.0, 90.0] and [-180.0, 180.0], respectively.""" r = latitude % 360.0 if r <= 90.0: return r, NormalizeLongitude(longitude) elif r >= 270.0: return r - 360, NormalizeLongitude(longitude) else: return 180 - r, NormalizeLongitude(longitude + 180.0) assert 180.0 == NormalizeLongitude(180.0) assert -180.0 == NormalizeLongitude(-180.0) assert -179.0 == NormalizeLongitude(181.0) assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0) assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0) assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0) assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0) assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0) assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0) assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0) assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0) assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0) assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
The code in logs/storage/validator/logs_validator_traits.cc treats this type as if it were annotated as ST_LOCATION.
func (*LatLng) MarshalJSON ¶
func (*LatLng) UnmarshalJSON ¶
type LookupRequest ¶
type LookupRequest struct { // Keys: Keys of entities to look up. Keys []*Key `json:"keys,omitempty"` // ReadOptions: The options for this lookup request. ReadOptions *ReadOptions `json:"readOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "Keys") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Keys") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
LookupRequest: The request for Datastore.Lookup.
func (*LookupRequest) MarshalJSON ¶
func (s *LookupRequest) MarshalJSON() ([]byte, error)
type LookupResponse ¶
type LookupResponse struct { // 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. Deferred []*Key `json:"deferred,omitempty"` // Found: 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. Found []*EntityResult `json:"found,omitempty"` // Missing: 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. Missing []*EntityResult `json:"missing,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Deferred") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Deferred") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
LookupResponse: The response for Datastore.Lookup.
func (*LookupResponse) MarshalJSON ¶
func (s *LookupResponse) MarshalJSON() ([]byte, error)
type Mutation ¶
type Mutation struct { // BaseVersion: The version of the entity that this mutation is being // applied to. If this // does not match the current version on the server, the mutation // conflicts. BaseVersion int64 `json:"baseVersion,omitempty,string"` // Delete: The key of the entity to delete. The entity may or may not // already exist. // Must have a complete key path and must not be reserved/read-only. Delete *Key `json:"delete,omitempty"` // Insert: The entity to insert. The entity must not already exist. // The entity key's final path element may be incomplete. Insert *Entity `json:"insert,omitempty"` // Update: The entity to update. The entity must already exist. // Must have a complete key path. Update *Entity `json:"update,omitempty"` // Upsert: The entity to upsert. The entity may or may not already // exist. // The entity key's final path element may be incomplete. Upsert *Entity `json:"upsert,omitempty"` // ForceSendFields is a list of field names (e.g. "BaseVersion") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "BaseVersion") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Mutation: A mutation to apply to an entity.
func (*Mutation) MarshalJSON ¶
type MutationResult ¶
type MutationResult struct { // ConflictDetected: Whether a conflict was detected for this mutation. // Always false when a // conflict detection strategy field is not set in the mutation. ConflictDetected bool `json:"conflictDetected,omitempty"` // Key: The automatically allocated key. // Set only when the mutation allocated a key. Key *Key `json:"key,omitempty"` // Version: The version of the entity on the server after processing the // mutation. If // the mutation doesn't change anything on the server, then the version // will // be the version of the current entity or, if no entity is present, a // version // that is strictly greater than the version of any previous entity and // less // than the version of any possible future entity. Version int64 `json:"version,omitempty,string"` // ForceSendFields is a list of field names (e.g. "ConflictDetected") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ConflictDetected") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
MutationResult: The result of applying a mutation.
func (*MutationResult) MarshalJSON ¶
func (s *MutationResult) MarshalJSON() ([]byte, error)
type PartitionId ¶
type PartitionId struct { // NamespaceId: If not empty, the ID of the namespace to which the // entities belong. NamespaceId string `json:"namespaceId,omitempty"` // ProjectId: The ID of the project to which the entities belong. ProjectId string `json:"projectId,omitempty"` // ForceSendFields is a list of field names (e.g. "NamespaceId") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NamespaceId") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
PartitionId: A partition ID identifies a grouping of entities. The grouping is always by project and namespace, however the namespace ID may be empty.
A partition ID contains several dimensions: project ID and namespace ID.
Partition dimensions:
- May be "". - Must be valid UTF-8 bytes. - Must have values that match regex `[A-Za-z\d\.\-_]{1,100}` If the value of any dimension matches regex `__.*__`, the partition is reserved/read-only. A reserved/read-only partition ID is forbidden in certain documented contexts.
Foreign partition IDs (in which the project ID does not match the context project ID ) are discouraged. Reads and writes of foreign partition IDs may fail if the project is not in an active state.
func (*PartitionId) MarshalJSON ¶
func (s *PartitionId) MarshalJSON() ([]byte, error)
type PathElement ¶
type PathElement struct { // Id: 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. Id int64 `json:"id,omitempty,string"` // Kind: 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 "". Kind string `json:"kind,omitempty"` // Name: 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 "". Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Id") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Id") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
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.
func (*PathElement) MarshalJSON ¶
func (s *PathElement) MarshalJSON() ([]byte, error)
type Projection ¶
type Projection struct { // Property: The property to project. Property *PropertyReference `json:"property,omitempty"` // ForceSendFields is a list of field names (e.g. "Property") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Property") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Projection: A representation of a property in a projection.
func (*Projection) MarshalJSON ¶
func (s *Projection) MarshalJSON() ([]byte, error)
type ProjectsAllocateIdsCall ¶
type ProjectsAllocateIdsCall struct {
// contains filtered or unexported fields
}
func (*ProjectsAllocateIdsCall) Context ¶
func (c *ProjectsAllocateIdsCall) Context(ctx context.Context) *ProjectsAllocateIdsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsAllocateIdsCall) Do ¶
func (c *ProjectsAllocateIdsCall) Do(opts ...googleapi.CallOption) (*AllocateIdsResponse, error)
Do executes the "datastore.projects.allocateIds" call. Exactly one of *AllocateIdsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AllocateIdsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsAllocateIdsCall) Fields ¶
func (c *ProjectsAllocateIdsCall) Fields(s ...googleapi.Field) *ProjectsAllocateIdsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsAllocateIdsCall) Header ¶
func (c *ProjectsAllocateIdsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsBeginTransactionCall ¶
type ProjectsBeginTransactionCall struct {
// contains filtered or unexported fields
}
func (*ProjectsBeginTransactionCall) Context ¶
func (c *ProjectsBeginTransactionCall) Context(ctx context.Context) *ProjectsBeginTransactionCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsBeginTransactionCall) Do ¶
func (c *ProjectsBeginTransactionCall) Do(opts ...googleapi.CallOption) (*BeginTransactionResponse, error)
Do executes the "datastore.projects.beginTransaction" call. Exactly one of *BeginTransactionResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BeginTransactionResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsBeginTransactionCall) Fields ¶
func (c *ProjectsBeginTransactionCall) Fields(s ...googleapi.Field) *ProjectsBeginTransactionCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsBeginTransactionCall) Header ¶
func (c *ProjectsBeginTransactionCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsCommitCall ¶
type ProjectsCommitCall struct {
// contains filtered or unexported fields
}
func (*ProjectsCommitCall) Context ¶
func (c *ProjectsCommitCall) Context(ctx context.Context) *ProjectsCommitCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsCommitCall) Do ¶
func (c *ProjectsCommitCall) Do(opts ...googleapi.CallOption) (*CommitResponse, error)
Do executes the "datastore.projects.commit" call. Exactly one of *CommitResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *CommitResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsCommitCall) Fields ¶
func (c *ProjectsCommitCall) Fields(s ...googleapi.Field) *ProjectsCommitCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsCommitCall) Header ¶
func (c *ProjectsCommitCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsLookupCall ¶
type ProjectsLookupCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLookupCall) Context ¶
func (c *ProjectsLookupCall) Context(ctx context.Context) *ProjectsLookupCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsLookupCall) Do ¶
func (c *ProjectsLookupCall) Do(opts ...googleapi.CallOption) (*LookupResponse, error)
Do executes the "datastore.projects.lookup" call. Exactly one of *LookupResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LookupResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsLookupCall) Fields ¶
func (c *ProjectsLookupCall) Fields(s ...googleapi.Field) *ProjectsLookupCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLookupCall) Header ¶
func (c *ProjectsLookupCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsRollbackCall ¶
type ProjectsRollbackCall struct {
// contains filtered or unexported fields
}
func (*ProjectsRollbackCall) Context ¶
func (c *ProjectsRollbackCall) Context(ctx context.Context) *ProjectsRollbackCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsRollbackCall) Do ¶
func (c *ProjectsRollbackCall) Do(opts ...googleapi.CallOption) (*RollbackResponse, error)
Do executes the "datastore.projects.rollback" call. Exactly one of *RollbackResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RollbackResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsRollbackCall) Fields ¶
func (c *ProjectsRollbackCall) Fields(s ...googleapi.Field) *ProjectsRollbackCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsRollbackCall) Header ¶
func (c *ProjectsRollbackCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsRunQueryCall ¶
type ProjectsRunQueryCall struct {
// contains filtered or unexported fields
}
func (*ProjectsRunQueryCall) Context ¶
func (c *ProjectsRunQueryCall) Context(ctx context.Context) *ProjectsRunQueryCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsRunQueryCall) Do ¶
func (c *ProjectsRunQueryCall) Do(opts ...googleapi.CallOption) (*RunQueryResponse, error)
Do executes the "datastore.projects.runQuery" call. Exactly one of *RunQueryResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RunQueryResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsRunQueryCall) Fields ¶
func (c *ProjectsRunQueryCall) Fields(s ...googleapi.Field) *ProjectsRunQueryCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsRunQueryCall) Header ¶
func (c *ProjectsRunQueryCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsService ¶
type ProjectsService struct {
// contains filtered or unexported fields
}
func NewProjectsService ¶
func NewProjectsService(s *Service) *ProjectsService
func (*ProjectsService) AllocateIds ¶
func (r *ProjectsService) AllocateIds(projectId string, allocateidsrequest *AllocateIdsRequest) *ProjectsAllocateIdsCall
AllocateIds: Allocates IDs for the given keys, which is useful for referencing an entity before it is inserted.
func (*ProjectsService) BeginTransaction ¶
func (r *ProjectsService) BeginTransaction(projectId string, begintransactionrequest *BeginTransactionRequest) *ProjectsBeginTransactionCall
BeginTransaction: Begins a new transaction.
func (*ProjectsService) Commit ¶
func (r *ProjectsService) Commit(projectId string, commitrequest *CommitRequest) *ProjectsCommitCall
Commit: Commits a transaction, optionally creating, deleting or modifying some entities.
func (*ProjectsService) Lookup ¶
func (r *ProjectsService) Lookup(projectId string, lookuprequest *LookupRequest) *ProjectsLookupCall
Lookup: Looks up entities by key.
func (*ProjectsService) Rollback ¶
func (r *ProjectsService) Rollback(projectId string, rollbackrequest *RollbackRequest) *ProjectsRollbackCall
Rollback: Rolls back a transaction.
func (*ProjectsService) RunQuery ¶
func (r *ProjectsService) RunQuery(projectId string, runqueryrequest *RunQueryRequest) *ProjectsRunQueryCall
RunQuery: Queries for entities.
type PropertyFilter ¶
type PropertyFilter struct { // Op: The operator to filter by. // // Possible values: // "OPERATOR_UNSPECIFIED" - Unspecified. This value must not be used. // "LESS_THAN" - Less than. // "LESS_THAN_OR_EQUAL" - Less than or equal. // "GREATER_THAN" - Greater than. // "GREATER_THAN_OR_EQUAL" - Greater than or equal. // "EQUAL" - Equal. // "HAS_ANCESTOR" - Has ancestor. Op string `json:"op,omitempty"` // Property: The property to filter by. Property *PropertyReference `json:"property,omitempty"` // Value: The value to compare the property to. Value *Value `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Op") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Op") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
PropertyFilter: A filter on a specific property.
func (*PropertyFilter) MarshalJSON ¶
func (s *PropertyFilter) MarshalJSON() ([]byte, error)
type PropertyOrder ¶
type PropertyOrder struct { // Direction: The direction to order by. Defaults to `ASCENDING`. // // Possible values: // "DIRECTION_UNSPECIFIED" - Unspecified. This value must not be used. // "ASCENDING" - Ascending. // "DESCENDING" - Descending. Direction string `json:"direction,omitempty"` // Property: The property to order by. Property *PropertyReference `json:"property,omitempty"` // ForceSendFields is a list of field names (e.g. "Direction") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Direction") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
PropertyOrder: The desired order for a specific property.
func (*PropertyOrder) MarshalJSON ¶
func (s *PropertyOrder) MarshalJSON() ([]byte, error)
type PropertyReference ¶
type PropertyReference struct { // Name: The name of the property. // If name includes "."s, it may be interpreted as a property name path. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Name") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
PropertyReference: A reference to a property relative to the kind expressions.
func (*PropertyReference) MarshalJSON ¶
func (s *PropertyReference) MarshalJSON() ([]byte, error)
type Query ¶
type Query struct { // DistinctOn: The properties to make distinct. The query results will // contain the first // result for each distinct combination of values for the given // properties // (if empty, all results are returned). DistinctOn []*PropertyReference `json:"distinctOn,omitempty"` // EndCursor: An ending point for the query results. Query cursors // are // returned in query result batches and // [can only be used to limit the same // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor // s_limits_and_offsets). EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. Filter *Filter `json:"filter,omitempty"` // Kind: The kinds to query (if empty, returns entities of all // kinds). // Currently at most 1 kind may be specified. Kind []*KindExpression `json:"kind,omitempty"` // Limit: The maximum number of results to return. Applies after all // other // constraints. Optional. // Unspecified is interpreted as no limit. // Must be >= 0 if specified. Limit int64 `json:"limit,omitempty"` // Offset: The number of results to skip. Applies before limit, but // after all other // constraints. Optional. Must be >= 0 if specified. Offset int64 `json:"offset,omitempty"` // Order: The order to apply to the query results (if empty, order is // unspecified). Order []*PropertyOrder `json:"order,omitempty"` // Projection: The projection to return. Defaults to returning all // properties. Projection []*Projection `json:"projection,omitempty"` // StartCursor: A starting point for the query results. Query cursors // are // returned in query result batches and // [can only be used to continue the same // query](https://cloud.google.com/datastore/docs/concepts/queries#cursor // s_limits_and_offsets). StartCursor string `json:"startCursor,omitempty"` // ForceSendFields is a list of field names (e.g. "DistinctOn") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "DistinctOn") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Query: A query for entities.
func (*Query) MarshalJSON ¶
type QueryResultBatch ¶
type QueryResultBatch struct { // EndCursor: A cursor that points to the position after the last result // in the batch. EndCursor string `json:"endCursor,omitempty"` // EntityResultType: The result type for every entity in // `entity_results`. // // Possible values: // "RESULT_TYPE_UNSPECIFIED" - Unspecified. This value is never used. // "FULL" - The key and properties. // "PROJECTION" - A projected subset of properties. The entity may // have no key. // "KEY_ONLY" - Only the key. EntityResultType string `json:"entityResultType,omitempty"` // EntityResults: The results for this batch. EntityResults []*EntityResult `json:"entityResults,omitempty"` // MoreResults: The state of the query after the current batch. // // Possible values: // "MORE_RESULTS_TYPE_UNSPECIFIED" - Unspecified. This value is never // used. // "NOT_FINISHED" - There may be additional batches to fetch from this // query. // "MORE_RESULTS_AFTER_LIMIT" - The query is finished, but there may // be more results after the limit. // "MORE_RESULTS_AFTER_CURSOR" - The query is finished, but there may // be more results after the end // cursor. // "NO_MORE_RESULTS" - The query has been exhausted. MoreResults string `json:"moreResults,omitempty"` // SkippedCursor: A cursor that points to the position after the last // skipped result. // Will be set when `skipped_results` != 0. SkippedCursor string `json:"skippedCursor,omitempty"` // SkippedResults: The number of results skipped, typically because of // an offset. SkippedResults int64 `json:"skippedResults,omitempty"` // SnapshotVersion: The version number of the snapshot this batch was // returned from. // This applies to the range of results from the query's `start_cursor` // (or // the beginning of the query if no cursor was given) to this // batch's // `end_cursor` (not the query's `end_cursor`). // // In a single transaction, subsequent query result batches for the same // query // can have a greater snapshot version number. Each batch's snapshot // version // is valid for all preceding batches. // The value will be zero for eventually consistent queries. SnapshotVersion int64 `json:"snapshotVersion,omitempty,string"` // ForceSendFields is a list of field names (e.g. "EndCursor") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "EndCursor") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
QueryResultBatch: A batch of results produced by a query.
func (*QueryResultBatch) MarshalJSON ¶
func (s *QueryResultBatch) MarshalJSON() ([]byte, error)
type ReadOptions ¶
type ReadOptions struct { // ReadConsistency: The non-transactional read consistency to // use. // Cannot be set to `STRONG` for global queries. // // Possible values: // "READ_CONSISTENCY_UNSPECIFIED" - Unspecified. This value must not // be used. // "STRONG" - Strong consistency. // "EVENTUAL" - Eventual consistency. ReadConsistency string `json:"readConsistency,omitempty"` // Transaction: The identifier of the transaction in which to read. // A // transaction identifier is returned by a call // to // Datastore.BeginTransaction. Transaction string `json:"transaction,omitempty"` // ForceSendFields is a list of field names (e.g. "ReadConsistency") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ReadConsistency") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
ReadOptions: The options shared by read requests.
func (*ReadOptions) MarshalJSON ¶
func (s *ReadOptions) MarshalJSON() ([]byte, error)
type RollbackRequest ¶
type RollbackRequest struct { // Transaction: The transaction identifier, returned by a call // to // Datastore.BeginTransaction. Transaction string `json:"transaction,omitempty"` // ForceSendFields is a list of field names (e.g. "Transaction") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Transaction") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RollbackRequest: The request for Datastore.Rollback.
func (*RollbackRequest) MarshalJSON ¶
func (s *RollbackRequest) MarshalJSON() ([]byte, error)
type RollbackResponse ¶
type RollbackResponse struct { // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` }
RollbackResponse: The response for Datastore.Rollback. (an empty message).
type RunQueryRequest ¶
type RunQueryRequest struct { // GqlQuery: The GQL query to run. GqlQuery *GqlQuery `json:"gqlQuery,omitempty"` // PartitionId: Entities are partitioned into subsets, identified by a // partition ID. // Queries are scoped to a single partition. // This partition ID is normalized with the standard default // context // partition ID. PartitionId *PartitionId `json:"partitionId,omitempty"` // Query: The query to run. Query *Query `json:"query,omitempty"` // ReadOptions: The options for this query. ReadOptions *ReadOptions `json:"readOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "GqlQuery") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "GqlQuery") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RunQueryRequest: The request for Datastore.RunQuery.
func (*RunQueryRequest) MarshalJSON ¶
func (s *RunQueryRequest) MarshalJSON() ([]byte, error)
type RunQueryResponse ¶
type RunQueryResponse struct { // Batch: A batch of query results (always present). Batch *QueryResultBatch `json:"batch,omitempty"` // Query: The parsed form of the `GqlQuery` from the request, if it was // set. Query *Query `json:"query,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Batch") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Batch") to include in API // requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
RunQueryResponse: The response for Datastore.RunQuery.
func (*RunQueryResponse) MarshalJSON ¶
func (s *RunQueryResponse) MarshalJSON() ([]byte, error)
type Service ¶
type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment GoogleClientHeaderElement string // client header fragment, for Google use only Projects *ProjectsService // contains filtered or unexported fields }
type Value ¶
type Value struct { // ArrayValue: An array value. // Cannot contain another array value. // A `Value` instance that sets field `array_value` must not set // fields // `meaning` or `exclude_from_indexes`. ArrayValue *ArrayValue `json:"arrayValue,omitempty"` // BlobValue: A blob value. // May have at most 1,000,000 bytes. // When `exclude_from_indexes` is false, may have at most 1500 bytes. // In JSON requests, must be base64-encoded. BlobValue string `json:"blobValue,omitempty"` // BooleanValue: A boolean value. BooleanValue bool `json:"booleanValue,omitempty"` // DoubleValue: A double value. DoubleValue float64 `json:"doubleValue,omitempty"` // EntityValue: An entity value. // // - May have no key. // - May have a key with an incomplete key path. // - May have a reserved/read-only key. EntityValue *Entity `json:"entityValue,omitempty"` // ExcludeFromIndexes: If the value should be excluded from all indexes // including those defined // explicitly. ExcludeFromIndexes bool `json:"excludeFromIndexes,omitempty"` // GeoPointValue: A geo point value representing a point on the surface // of Earth. GeoPointValue *LatLng `json:"geoPointValue,omitempty"` // IntegerValue: An integer value. IntegerValue int64 `json:"integerValue,omitempty,string"` // KeyValue: A key value. KeyValue *Key `json:"keyValue,omitempty"` // Meaning: The `meaning` field should only be populated for backwards // compatibility. Meaning int64 `json:"meaning,omitempty"` // NullValue: A null value. // // Possible values: // "NULL_VALUE" - Null value. NullValue string `json:"nullValue,omitempty"` // StringValue: A UTF-8 encoded string value. // When `exclude_from_indexes` is false (it is indexed) , may have at // most 1500 bytes. // Otherwise, may be set to at least 1,000,000 bytes. StringValue string `json:"stringValue,omitempty"` // TimestampValue: A timestamp value. // When stored in the Datastore, precise only to microseconds; // any additional precision is rounded down. TimestampValue string `json:"timestampValue,omitempty"` // ForceSendFields is a list of field names (e.g. "ArrayValue") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the // server regardless of whether the field is empty or not. This may be // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "ArrayValue") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
Value: A message that can hold any of the supported value types and associated metadata.