Class CloudSaveDataAdminApi
Represents a collection of functions to interact with the API endpoints
Inherited Members
Namespace: Unity.Services.Apis.Admin.CloudSave
Assembly: Unity.Services.Apis.dll
Syntax
public class CloudSaveDataAdminApi : ICloudSaveDataAdminApi, IApiAccessor
Constructors
CloudSaveDataAdminApi(IApiClient)
Initializes a new instance of the Cloud
Declaration
public CloudSaveDataAdminApi(IApiClient apiClient)
Parameters
Type | Name | Description |
---|---|---|
IApi |
apiClient | The client interface for synchronous API access. |
CloudSaveDataAdminApi(IApiClient, IApiConfiguration)
Initializes a new instance of the Cloud
Declaration
public CloudSaveDataAdminApi(IApiClient apiClient, IApiConfiguration apiConfiguration)
Parameters
Type | Name | Description |
---|---|---|
IApi |
apiClient | The client interface for synchronous API access. |
IApi |
apiConfiguration | The configuration object. |
Properties
Client
The client for accessing this underlying API asynchronously.
Declaration
public IApiClient Client { get; }
Property Value
Type | Description |
---|---|
IApi |
Configuration
Gets the configuration object
Declaration
public IApiConfiguration Configuration { get; }
Property Value
Type | Description |
---|---|
IApi |
An instance of the Configuration |
Methods
CreateDefaultCustomIndex(string, string, CreateIndexBody, CancellationToken)
Create Default Custom Index Create an index for custom data with the default access class.
Declaration
public ApiOperation<CreateIndexResponse> CreateDefaultCustomIndex(string projectId, string environmentId, CreateIndexBody createIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Create |
createIndexBody | Configuration object for the index to be created. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
CreateDefaultPlayerIndex(string, string, CreateIndexBody, CancellationToken)
Create Default Player Index Create an index for player data with the default access class.
Declaration
public ApiOperation<CreateIndexResponse> CreateDefaultPlayerIndex(string projectId, string environmentId, CreateIndexBody createIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Create |
createIndexBody | Configuration object for the index to be created. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
CreatePrivateCustomIndex(string, string, CreateIndexBody, CancellationToken)
Create Private Custom Index Create an index for custom data with the private access class.
Declaration
public ApiOperation<CreateIndexResponse> CreatePrivateCustomIndex(string projectId, string environmentId, CreateIndexBody createIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Create |
createIndexBody | Configuration object for the index to be created. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
CreateProtectedPlayerIndex(string, string, CreateIndexBody, CancellationToken)
Create Protected Player Index Create an index for player data with the protected access class.
Declaration
public ApiOperation<CreateIndexResponse> CreateProtectedPlayerIndex(string projectId, string environmentId, CreateIndexBody createIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Create |
createIndexBody | Configuration object for the index to be created. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
CreatePublicPlayerIndex(string, string, CreateIndexBody, CancellationToken)
Create Public Player Index Create an index for player data with the public access class.
Declaration
public ApiOperation<CreateIndexResponse> CreatePublicPlayerIndex(string projectId, string environmentId, CreateIndexBody createIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Create |
createIndexBody | Configuration object for the index to be created. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteCustomItem(string, string, string, string, string, CancellationToken)
Delete Custom Item Deletes a data item by the specified key for the specified custom ID. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeleteCustomItem(string projectId, string environmentId, string customId, string key, string writeLock = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
string | key | Item key. |
string | writeLock | Enforces conflict checking when deleting an existing data item. Omitting this field ignores write conflicts. When present, an error response will be returned if the writeLock in the request does not match the stored writeLock. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteCustomItems(string, string, string, CancellationToken)
Delete Custom Items Deletes all default access level data associated with a given custom ID. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeleteCustomItems(string projectId, string environmentId, string customId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteDefaultCustomIndex(string, string, string, CancellationToken)
Delete Default Custom Index Delete an index for custom data with the default access class by its index ID.
Declaration
public ApiOperation DeleteDefaultCustomIndex(string projectId, string environmentId, string indexId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | indexId | The index ID supplied by the Cloud Save service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteDefaultPlayerIndex(string, string, string, CancellationToken)
Delete Default Player Index Delete an index for player data with the default access class by its index ID.
Declaration
public ApiOperation DeleteDefaultPlayerIndex(string projectId, string environmentId, string indexId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | indexId | The index ID supplied by the Cloud Save service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteItem(string, string, string, string, string, CancellationToken)
Delete Player Item Deletes a data item by the specified key for the given player.
Declaration
public ApiOperation DeleteItem(string projectId, string environmentId, string playerId, string key, string writeLock = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | key | Item key. |
string | writeLock | Enforces conflict checking when deleting an existing data item. Omitting this field ignores write conflicts. When present, an error response will be returned if the writeLock in the request does not match the stored writeLock. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteItems(string, string, string, CancellationToken)
Delete Player Items Deletes all default access level data associated with a given player.
Declaration
public ApiOperation DeleteItems(string projectId, string environmentId, string playerId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePrivateCustomIndex(string, string, string, CancellationToken)
Delete Private Custom Index Delete an index for custom data with the private access class by its index ID.
Declaration
public ApiOperation DeletePrivateCustomIndex(string projectId, string environmentId, string indexId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | indexId | The index ID supplied by the Cloud Save service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePrivateCustomItem(string, string, string, string, string, CancellationToken)
Delete Private Custom Item Deletes a private data item by the specified key for the specified custom ID. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeletePrivateCustomItem(string projectId, string environmentId, string customId, string key, string writeLock = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
string | key | Item key. |
string | writeLock | Enforces conflict checking when deleting an existing data item. Omitting this field ignores write conflicts. When present, an error response will be returned if the writeLock in the request does not match the stored writeLock. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePrivateCustomItems(string, string, string, CancellationToken)
Delete Private Custom Items Deletes all private data associated with a given custom ID. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeletePrivateCustomItems(string projectId, string environmentId, string customId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteProtectedItem(string, string, string, string, string, CancellationToken)
Delete Protected Player Item Deletes a protected data item by the specified key for the given player. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeleteProtectedItem(string projectId, string environmentId, string playerId, string key, string writeLock = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | key | Item key. |
string | writeLock | Enforces conflict checking when deleting an existing data item. Omitting this field ignores write conflicts. When present, an error response will be returned if the writeLock in the request does not match the stored writeLock. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteProtectedItems(string, string, string, CancellationToken)
Delete Protected Player Items Deletes all protected data associated with a given player. Only accessible via an authenticated server authority.
Declaration
public ApiOperation DeleteProtectedItems(string projectId, string environmentId, string playerId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeleteProtectedPlayerIndex(string, string, string, CancellationToken)
Delete Protected Player Index Delete an index for player data with the protected access class by its index ID.
Declaration
public ApiOperation DeleteProtectedPlayerIndex(string projectId, string environmentId, string indexId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | indexId | The index ID supplied by the Cloud Save service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePublicItem(string, string, string, string, string, CancellationToken)
Delete Public Player Item Deletes a public data item by the specified key for the given player.
Declaration
public ApiOperation DeletePublicItem(string projectId, string environmentId, string playerId, string key, string writeLock = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | key | Item key. |
string | writeLock | Enforces conflict checking when deleting an existing data item. Omitting this field ignores write conflicts. When present, an error response will be returned if the writeLock in the request does not match the stored writeLock. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePublicItems(string, string, string, CancellationToken)
Delete Public Player Items Deletes all public data associated with a given player.
Declaration
public ApiOperation DeletePublicItems(string projectId, string environmentId, string playerId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
DeletePublicPlayerIndex(string, string, string, CancellationToken)
Delete Public Player Index Delete an index for player data with the public access class by its index ID.
Declaration
public ApiOperation DeletePublicPlayerIndex(string projectId, string environmentId, string indexId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | indexId | The index ID supplied by the Cloud Save service. |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetBasePath()
Gets the base path of the API client.
Declaration
public string GetBasePath()
Returns
Type | Description |
---|---|
string | The base path |
GetCustomItems(string, string, string, List<string>, string, CancellationToken)
Get Custom Items Retrieves saved data values for all keys specified, ordered alphabetically in pages of 20. If no keys are supplied then returns all keys, ordered alphabetically in pages of 20.
Declaration
public ApiOperation<GetItemsResponse> GetCustomItems(string projectId, string environmentId, string customId, List<string> keys = null, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
List<string> | keys | The keys to retrieve, in exploded form style, e.g. |
string | after | The key after which to retrieve the next page of keys. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetCustomKeys(string, string, string, string, CancellationToken)
Get Custom Keys Gets a paged list of keys for the given custom ID, ordered alphabetically in pages of 100.
Declaration
public ApiOperation<GetKeysResponse> GetCustomKeys(string projectId, string environmentId, string customId, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
string | after | Returns the page of results after the key specified. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetItems(string, string, string, List<string>, string, CancellationToken)
Get Player Items Retrieves saved data values for all keys specified, ordered alphabetically in pages of 20. If no keys are supplied then returns all keys, ordered alphabetically in pages of 20.
Declaration
public ApiOperation<GetItemsResponse> GetItems(string projectId, string environmentId, string playerId, List<string> keys = null, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
List<string> | keys | The keys to retrieve, in exploded form style, e.g. |
string | after | The key after which to retrieve the next page of keys. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetKeys(string, string, string, string, CancellationToken)
Get Player Keys Gets a paged list of keys for the given player, ordered alphabetically in pages of 100.
Declaration
public ApiOperation<GetKeysResponse> GetKeys(string projectId, string environmentId, string playerId, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | after | Returns the page of results after the key specified. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetPrivateCustomItems(string, string, string, List<string>, string, CancellationToken)
Get Private Custom Items Retrieves private save data values for all keys specified, ordered alphabetically in pages of 20. If no keys are supplied then returns all keys, ordered alphabetically in pages of 20. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<GetItemsResponse> GetPrivateCustomItems(string projectId, string environmentId, string customId, List<string> keys = null, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
List<string> | keys | The keys to retrieve, in exploded form style, e.g. |
string | after | The key after which to retrieve the next page of keys. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetPrivateCustomKeys(string, string, string, string, CancellationToken)
Get Private Custom Keys Gets a paged list of private keys for the given custom ID, ordered alphabetically in pages of 100. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<GetKeysResponse> GetPrivateCustomKeys(string projectId, string environmentId, string customId, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
string | after | Returns the page of results after the key specified. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetProtectedItems(string, string, string, List<string>, string, CancellationToken)
Get Protected Player Items Retrieves protected save data values for all keys specified, ordered alphabetically in pages of 20. If no keys are supplied then returns all keys, ordered alphabetically in pages of 20.
Declaration
public ApiOperation<GetItemsResponse> GetProtectedItems(string projectId, string environmentId, string playerId, List<string> keys = null, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
List<string> | keys | The keys to retrieve, in exploded form style, e.g. |
string | after | The key after which to retrieve the next page of keys. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetProtectedKeys(string, string, string, string, CancellationToken)
Get Protected Player Keys Gets a paged list of protected keys for the given player, ordered alphabetically in pages of 100.
Declaration
public ApiOperation<GetKeysResponse> GetProtectedKeys(string projectId, string environmentId, string playerId, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | after | Returns the page of results after the key specified. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetPublicItems(string, string, string, List<string>, string, CancellationToken)
Get Public Player Items Retrieves saved data values for all keys specified, ordered alphabetically in pages of 20. If no keys are supplied then returns all keys, ordered alphabetically in pages of 20. Accessible by any player for any other player's data.
Declaration
public ApiOperation<GetItemsResponse> GetPublicItems(string projectId, string environmentId, string playerId, List<string> keys = null, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
List<string> | keys | The keys to retrieve, in exploded form style, e.g. |
string | after | The key after which to retrieve the next page of keys. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
GetPublicKeys(string, string, string, string, CancellationToken)
Get Public Player Keys Gets a paged list of public keys for the given player, ordered alphabetically in pages of 100. Accessible by any player for any other player's data.
Declaration
public ApiOperation<GetKeysResponse> GetPublicKeys(string projectId, string environmentId, string playerId, string after = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
string | after | Returns the page of results after the key specified. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
ListIndexes(string, string, CancellationToken)
List Indexes List all existing indexes for a given project and environment. Since the number of total indexes is limited to 20 this endpoint is not paginated.
Declaration
public ApiOperation<GetIndexIdsResponse> ListIndexes(string projectId, string environmentId, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
QueryDefaultCustomData(string, string, QueryIndexBody, CancellationToken)
Query Default Custom Data Query custom data with the default access class. If no index is available to fulfil the query then the query will fail.
Declaration
public ApiOperation<QueryIndexResponse> QueryDefaultCustomData(string projectId, string environmentId, QueryIndexBody queryIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Query |
queryIndexBody | Query object with an array of conditions to query the data with. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
QueryDefaultPlayerData(string, string, QueryIndexBody, CancellationToken)
Query Default Player Data Query player data with the default access class. If no index is available to fulfil the query then the query will fail.
Declaration
public ApiOperation<QueryIndexResponse> QueryDefaultPlayerData(string projectId, string environmentId, QueryIndexBody queryIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Query |
queryIndexBody | Query object with an array of conditions to query the data with. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
QueryPrivateCustomData(string, string, QueryIndexBody, CancellationToken)
Query Private Custom Data Query custom data with the private access class. If no index is available to fulfil the query then the query will fail.
Declaration
public ApiOperation<QueryIndexResponse> QueryPrivateCustomData(string projectId, string environmentId, QueryIndexBody queryIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Query |
queryIndexBody | Query object with an array of conditions to query the data with. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
QueryProtectedPlayerData(string, string, QueryIndexBody, CancellationToken)
Query Protected Player Data Query player data with the protected access class. If no index is available to fulfil the query then the query will fail.
Declaration
public ApiOperation<QueryIndexResponse> QueryProtectedPlayerData(string projectId, string environmentId, QueryIndexBody queryIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Query |
queryIndexBody | Query object with an array of conditions to query the data with. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
QueryPublicPlayerData(string, string, QueryIndexBody, CancellationToken)
Query Public Player Data Query player data with the public access class. If no index is available to fulfil the query then the query will fail.
Declaration
public ApiOperation<QueryIndexResponse> QueryPublicPlayerData(string projectId, string environmentId, QueryIndexBody queryIndexBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
Query |
queryIndexBody | Query object with an array of conditions to query the data with. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetCustomItem(string, string, string, SetItemBody, CancellationToken)
Set Custom Item Set a data item with a given key and value for the specified custom ID. The value is limited to a maximum size of 5 MB across all default access level slots. The entire default access level saved state for a custom ID is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemResponse> SetCustomItem(string projectId, string environmentId, string customId, SetItemBody setItemBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Set |
setItemBody | Add a data item to store for a custom ID. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetCustomItemBatch(string, string, string, SetItemBatchBody, CancellationToken)
Set Custom Item Batch Set up to 20 data items with key, value and optional writeLock against the custom ID. The values are limited to a maximum size of 5 MB across all default access level slots for the custom ID. The entire default access level saved state for a custom ID is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The batch set operation is considered atomic and if any of the set key operation fails, the entire operation is failed. Error responses should identify the affected key operations that failed. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemBatchResponse> SetCustomItemBatch(string projectId, string environmentId, string customId, SetItemBatchBody setItemBatchBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Set |
setItemBatchBody | Set batch data items for a custom ID. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetItem(string, string, string, SetItemBody, CancellationToken)
Set Player Item Set a data item with a given key and value for the specified player. The value is limited to a maximum size of 5 MB across all default access level slots. The entire default access level saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error.
Declaration
public ApiOperation<SetItemResponse> SetItem(string projectId, string environmentId, string playerId, SetItemBody setItemBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBody | Add a data item to store for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetItemBatch(string, string, string, SetItemBatchBody, CancellationToken)
Set Player Item Batch Set up to 20 data items with key, value and optional writeLock for the given player. The values are limited to a maximum size of 5 MB across all default access level slots for the player. The entire default access level saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The batch set operation is considered atomic and if any of the set key operation fails, the entire operation is failed. Error responses should identify the affected key operations that failed.
Declaration
public ApiOperation<SetItemBatchResponse> SetItemBatch(string projectId, string environmentId, string playerId, SetItemBatchBody setItemBatchBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBatchBody | Set batch data items for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetPrivateCustomItem(string, string, string, SetItemBody, CancellationToken)
Set Private Custom Item Set a private data item with a given key and value for the specified custom ID. The value is limited to a maximum size of 5 MB across all private access level slots. The entire private saved state for a custom ID is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemResponse> SetPrivateCustomItem(string projectId, string environmentId, string customId, SetItemBody setItemBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Set |
setItemBody | Add a data item to store for a custom ID. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetPrivateCustomItemBatch(string, string, string, SetItemBatchBody, CancellationToken)
Set Private Custom Item Batch Set up to 20 private data items with key, value and optional writeLock against the custom ID. The values are limited to a maximum size of 5 MB across all private access level slots for the custom ID. The entire private saved state for a custom ID is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The batch set operation is considered atomic and if any of the set key operation fails, the entire operation is failed. Error responses should identify the affected key operations that failed. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemBatchResponse> SetPrivateCustomItemBatch(string projectId, string environmentId, string customId, SetItemBatchBody setItemBatchBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | customId | The custom data ID specified by the user. Must be between 1 and 50 characters long and contain only alphanumeric characters, underscores, and hyphens. |
Set |
setItemBatchBody | Set batch data items for a custom ID. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetProtectedItem(string, string, string, SetItemBody, CancellationToken)
Set Protected Player Item Set a protected data item with a given key and value for the specified player. The value is limited to a maximum size of 5 MB across all protected access level slots. The entire protected saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemResponse> SetProtectedItem(string projectId, string environmentId, string playerId, SetItemBody setItemBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBody | Add a data item to store for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetProtectedItemBatch(string, string, string, SetItemBatchBody, CancellationToken)
Set Protected Player Item Batch Set up to 20 protected data items with key, value and optional writeLock for the given player. The values are limited to a maximum size of 5 MB across all slots for the player. The entire protected saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The batch set operation is considered atomic and if any of the set key operation fails, the entire operation is failed. Error responses should identify the affected key operations that failed. Only accessible via an authenticated server authority.
Declaration
public ApiOperation<SetItemBatchResponse> SetProtectedItemBatch(string projectId, string environmentId, string playerId, SetItemBatchBody setItemBatchBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBatchBody | Set batch data items for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetPublicItem(string, string, string, SetItemBody, CancellationToken)
Set Public Player Item Set a public data item with a given key and value for the specified player. The value is limited to a maximum size of 5 MB across all public access level slots. The entire public saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The value set will be publicly readable by any player.
Declaration
public ApiOperation<SetItemResponse> SetPublicItem(string projectId, string environmentId, string playerId, SetItemBody setItemBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBody | Add a data item to store for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |
SetPublicItemBatch(string, string, string, SetItemBatchBody, CancellationToken)
Set Public Player Item Batch Set up to 20 public data items with key, value and optional writeLock for the given player. The values are limited to a maximum size of 5 MB across all slots for the player. The entire public saved state for a player is limited to 2000 keys. Attempting to set a new key beyond this limit will result in an error. The batch set operation is considered atomic and if any of the set key operation fails, the entire operation is failed. Error responses should identify the affected key operations that failed.
Declaration
public ApiOperation<SetItemBatchResponse> SetPublicItemBatch(string projectId, string environmentId, string playerId, SetItemBatchBody setItemBatchBody = null, CancellationToken cancellationToken = default)
Parameters
Type | Name | Description |
---|---|---|
string | projectId | The project's Project ID |
string | environmentId | The Environment ID of a project |
string | playerId | The player ID supplied by the Authorization service. |
Set |
setItemBatchBody | Set batch data items for a player. (optional) |
Cancellation |
cancellationToken | Cancellation Token to cancel the request. |
Returns
Type | Description |
---|---|
Api |
The operation |