Scheduled Task - Get Actions On Players In Segment Task Instance
Get information about a ActionsOnPlayersInSegment task instance.
POST https://titleId.playfabapi.com/Admin/GetActionsOnPlayersInSegmentTaskInstance
Request Header
Name | Required | Type | Description |
---|---|---|---|
X-SecretKey | True |
string |
This API requires a title secret key, available to title admins, from PlayFab Game Manager. |
Request Body
Name | Required | Type | Description |
---|---|---|---|
TaskInstanceId | True |
string |
ID of the requested task instance. |
Responses
Name | Type | Description |
---|---|---|
200 OK | ||
400 Bad Request |
This is the outer wrapper for all responses with errors |
Security
X-SecretKey
This API requires a title secret key, available to title admins, from PlayFab Game Manager.
Type:
apiKey
In:
header
Definitions
Name | Description |
---|---|
Action |
The work to be performed on each entity which can only be of one type. |
Actions |
|
Actions |
|
Add |
|
Api |
The basic wrapper around every failed API response |
Ban |
|
Delete |
|
Delete |
|
Execute |
|
Execute |
|
Get |
|
Get |
The result includes detail information that's specific to a CloudScript task. Only CloudScript tasks configured as "Run Cloud Script function once" will be retrieved. To get a list of task instances by task, status, or time range, use GetTaskInstances. |
Grant |
|
Grant |
|
Increment |
|
Name |
Identifier by either name or ID. Note that a name may change due to renaming, or reused after being deleted. ID is immutable and unique. |
Push |
|
Send |
|
Subtract |
|
Task |
Action
The work to be performed on each entity which can only be of one type.
Name | Type | Description |
---|---|---|
AddInventoryItemV2Content |
Action content to add inventory item v2 |
|
BanPlayerContent |
Action content to ban player |
|
DeleteInventoryItemV2Content |
Action content to delete inventory item v2 |
|
DeletePlayerContent |
Action content to delete player |
|
ExecuteCloudScriptContent |
Action content to execute cloud script |
|
ExecuteFunctionContent |
Action content to execute azure function |
|
GrantItemContent |
Action content to grant item |
|
GrantVirtualCurrencyContent |
Action content to grant virtual currency |
|
IncrementPlayerStatisticContent |
Action content to increment player statistic |
|
PushNotificationContent |
Action content to send push notification |
|
SendEmailContent |
Action content to send email |
|
SubtractInventoryItemV2Content |
Action content to subtract inventory item v2 |
ActionsOnPlayersInSegmentTaskParameter
Name | Type | Description |
---|---|---|
Actions |
Action[] |
List of actions to perform on each player in a segment. Each action object can contain only one action type. |
SegmentId |
string |
ID of the segment to perform actions on. |
ActionsOnPlayersInSegmentTaskSummary
Name | Type | Description |
---|---|---|
CompletedAt |
string |
UTC timestamp when the task completed. |
ErrorMessage |
string |
Error message for last processing attempt, if an error occured. |
ErrorWasFatal |
boolean |
Flag indicating if the error was fatal, if false job will be retried. |
EstimatedSecondsRemaining |
number |
Estimated time remaining in seconds. |
PercentComplete |
number |
Progress represented as percentage. |
ScheduledByUserId |
string |
If manually scheduled, ID of user who scheduled the task. |
StartedAt |
string |
UTC timestamp when the task started. |
Status |
Current status of the task instance. |
|
TaskIdentifier |
Identifier of the task this instance belongs to. |
|
TaskInstanceId |
string |
ID of the task instance. |
TotalPlayersInSegment |
number |
Total players in segment when task was started. |
TotalPlayersProcessed |
number |
Total number of players that have had the actions applied to. |
AddInventoryItemV2Content
Name | Type | Description |
---|---|---|
Amount |
number |
Amount of the item to be granted to a player |
CollectionId |
string |
The collection id for where the item will be granted in the player inventory |
DurationInSeconds |
number |
The duration in seconds of the subscription to be granted to a player |
ItemId |
string |
The id of item to be granted to the player |
StackId |
string |
The stack id for where the item will be granted in the player inventory |
ApiErrorWrapper
The basic wrapper around every failed API response
Name | Type | Description |
---|---|---|
code |
integer |
Numerical HTTP code |
error |
string |
Playfab error code |
errorCode |
integer |
Numerical PlayFab error code |
errorDetails |
object |
Detailed description of individual issues with the request object |
errorMessage |
string |
Description for the PlayFab errorCode |
status |
string |
String HTTP code |
BanPlayerContent
Name | Type | Description |
---|---|---|
BanDurationHours |
number |
Duration(in hours) to ban a player. If not provided, the player will be banned permanently. |
BanReason |
string |
Reason to ban a player |
DeleteInventoryItemV2Content
Name | Type | Description |
---|---|---|
CollectionId |
string |
The collection id for where the item will be removed from the player inventory |
ItemId |
string |
The id of item to be removed from the player |
StackId |
string |
The stack id for where the item will be removed from the player inventory |
DeletePlayerContent
ExecuteCloudScriptContent
Name | Type | Description |
---|---|---|
CloudScriptMethodArguments |
string |
Arguments(JSON) to be passed into the cloudscript method |
CloudScriptMethodName |
string |
Cloudscript method name |
PublishResultsToPlayStream |
boolean |
Publish cloudscript results as playstream event |
ExecuteFunctionContent
Name | Type | Description |
---|---|---|
CloudScriptFunctionArguments |
string |
Arguments(JSON) to be passed into the cloudscript azure function |
CloudScriptFunctionName |
string |
Cloudscript azure function name |
PublishResultsToPlayStream |
boolean |
Publish results from executing the azure function as playstream event |
GetActionsOnPlayersInSegmentTaskInstanceResult
Name | Type | Description |
---|---|---|
Parameter |
Parameter of this task instance |
|
Summary |
Status summary of the actions-on-players-in-segment task instance |
GetTaskInstanceRequest
The result includes detail information that's specific to a CloudScript task. Only CloudScript tasks configured as "Run Cloud Script function once" will be retrieved. To get a list of task instances by task, status, or time range, use GetTaskInstances.
Name | Type | Description |
---|---|---|
TaskInstanceId |
string |
ID of the requested task instance. |
GrantItemContent
Name | Type | Description |
---|---|---|
CatalogVersion |
string |
The catalog version of the item to be granted to the player |
ItemId |
string |
The id of item to be granted to the player |
ItemQuantity |
number |
Quantity of the item to be granted to a player |
GrantVirtualCurrencyContent
Name | Type | Description |
---|---|---|
CurrencyAmount |
number |
Amount of currency to be granted to a player |
CurrencyCode |
string |
Code of the currency to be granted to a player |
IncrementPlayerStatisticContent
Name | Type | Description |
---|---|---|
StatisticChangeBy |
number |
Amount(in whole number) to increase the player statistic by |
StatisticName |
string |
Name of the player statistic to be incremented |
NameIdentifier
Identifier by either name or ID. Note that a name may change due to renaming, or reused after being deleted. ID is immutable and unique.
Name | Type | Description |
---|---|---|
Id |
string |
Id Identifier, if present |
Name |
string |
Name Identifier, if present |
PushNotificationContent
Name | Type | Description |
---|---|---|
Message |
string |
Text of message to send. |
PushNotificationTemplateId |
string |
Id of the push notification template. |
Subject |
string |
Subject of message to send (may not be displayed in all platforms) |
SendEmailContent
Name | Type | Description |
---|---|---|
EmailTemplateId |
string |
The email template id of the email template to send. |
SubtractInventoryItemV2Content
Name | Type | Description |
---|---|---|
Amount |
number |
Amount of the item to removed from the player |
CollectionId |
string |
The collection id for where the item will be removed from the player inventory |
DurationInSeconds |
number |
The duration in seconds to be removed from the subscription in the players inventory |
ItemId |
string |
The id of item to be removed from the player |
StackId |
string |
The stack id for where the item will be removed from the player inventory |
TaskInstanceStatus
Name | Type | Description |
---|---|---|
Aborted |
string |
|
Failed |
string |
|
InProgress |
string |
|
Stalled |
string |
|
Starting |
string |
|
Succeeded |
string |
Error Codes
Name | Code |
---|---|
TaskInstanceNotFound | 1262 |