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

GetActionsOnPlayersInSegmentTaskInstanceResult

400 Bad Request

ApiErrorWrapper

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.

ActionsOnPlayersInSegmentTaskParameter
ActionsOnPlayersInSegmentTaskSummary
AddInventoryItemV2Content
ApiErrorWrapper

The basic wrapper around every failed API response

BanPlayerContent
DeleteInventoryItemV2Content
DeletePlayerContent
ExecuteCloudScriptContent
ExecuteFunctionContent
GetActionsOnPlayersInSegmentTaskInstanceResult
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.

GrantItemContent
GrantVirtualCurrencyContent
IncrementPlayerStatisticContent
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.

PushNotificationContent
SendEmailContent
SubtractInventoryItemV2Content
TaskInstanceStatus

Action

The work to be performed on each entity which can only be of one type.

Name Type Description
AddInventoryItemV2Content

AddInventoryItemV2Content

Action content to add inventory item v2

BanPlayerContent

BanPlayerContent

Action content to ban player

DeleteInventoryItemV2Content

DeleteInventoryItemV2Content

Action content to delete inventory item v2

DeletePlayerContent

DeletePlayerContent

Action content to delete player

ExecuteCloudScriptContent

ExecuteCloudScriptContent

Action content to execute cloud script

ExecuteFunctionContent

ExecuteFunctionContent

Action content to execute azure function

GrantItemContent

GrantItemContent

Action content to grant item

GrantVirtualCurrencyContent

GrantVirtualCurrencyContent

Action content to grant virtual currency

IncrementPlayerStatisticContent

IncrementPlayerStatisticContent

Action content to increment player statistic

PushNotificationContent

PushNotificationContent

Action content to send push notification

SendEmailContent

SendEmailContent

Action content to send email

SubtractInventoryItemV2Content

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

TaskInstanceStatus

Current status of the task instance.

TaskIdentifier

NameIdentifier

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

ActionsOnPlayersInSegmentTaskParameter

Parameter of this task instance

Summary

ActionsOnPlayersInSegmentTaskSummary

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