Scheduled Task - Create Actions On Players In Segment Task
Create an ActionsOnPlayersInSegment task, which iterates through all players in a segment to execute action.
POST https://titleId.playfabapi.com/Admin/CreateActionsOnPlayersInSegmentTask
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 |
---|---|---|---|
IsActive | True |
boolean |
Whether the schedule is active. Inactive schedule will not trigger task execution. |
Name | True |
string |
Name of the task. This is a unique identifier for tasks in the title. |
Parameter | True |
Task details related to segment and action |
|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
|
Description |
string |
Description the task |
|
Schedule |
string |
Cron expression for the run schedule of the task. The expression should be in UTC. |
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 |
|
Add |
|
Api |
The basic wrapper around every failed API response |
Ban |
|
Create |
Task name is unique within a title. Using a task name that's already taken will cause a name conflict error. Too many create-task requests within a short time will cause a create conflict error. |
Create |
|
Delete |
|
Delete |
|
Execute |
|
Execute |
|
Grant |
|
Grant |
|
Increment |
|
Push |
|
Send |
|
Subtract |
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. |
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 |
CreateActionsOnPlayerSegmentTaskRequest
Task name is unique within a title. Using a task name that's already taken will cause a name conflict error. Too many create-task requests within a short time will cause a create conflict error.
Name | Type | Description |
---|---|---|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
Description |
string |
Description the task |
IsActive |
boolean |
Whether the schedule is active. Inactive schedule will not trigger task execution. |
Name |
string |
Name of the task. This is a unique identifier for tasks in the title. |
Parameter |
Task details related to segment and action |
|
Schedule |
string |
Cron expression for the run schedule of the task. The expression should be in UTC. |
CreateTaskResult
Name | Type | Description |
---|---|---|
TaskId |
string |
ID of the task |
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 |
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 |
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 |
Error Codes
Name | Code |
---|---|
CloudScriptAzureFunctionsArgumentSizeExceeded | 1471 |
InvalidParams | 1000 |
InvalidScheduledTaskName | 1256 |
InvalidTaskSchedule | 1257 |
InvalidVirtualCurrencyCode | 1236 |
OverLimit | 1214 |
PushNotEnabledForAccount | 1094 |
PushNotificationTemplateInvalidSyntax | 1419 |
PushNotificationTemplateNotFound | 1417 |
ScheduledTaskCreateConflict | 1255 |
ScheduledTaskNameConflict | 1254 |
StatisticNotFound | 1195 |