Scheduled Task - Get Actions On Players In Segment Task Instance
Get information about a ActionsOnPlayersInSegment task instance.
POST https://titleId.playfabapi.com/Admin/GetActionsOnPlayersInSegmentTaskInstanceRequest 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 |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for