Server-Side Cloud Script - Post Function Result For Player Triggered Action
Generate a player PlayStream event for the provided function result.
POST https://titleId.playfabapi.com/CloudScript/PostFunctionResultForPlayerTriggeredAction
Request Header
Name | Required | Type | Description |
---|---|---|---|
X-EntityToken | True |
string |
This API requires an Entity Session Token, available from the Entity GetEntityToken method. |
Request Body
Name | Required | Type | Description |
---|---|---|---|
FunctionResult | True |
The result of the function execution. |
|
PlayerProfile | True |
The player profile the function was invoked with. |
|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
|
PlayStreamEventEnvelope |
The triggering PlayStream event, if any, that caused the function to be invoked. |
Responses
Name | Type | Description |
---|---|---|
200 OK | ||
400 Bad Request |
This is the outer wrapper for all responses with errors |
Security
X-EntityToken
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Type:
apiKey
In:
header
Definitions
AdCampaignAttributionModel
Name | Type | Description |
---|---|---|
AttributedAt |
string |
UTC time stamp of attribution |
CampaignId |
string |
Attribution campaign identifier |
Platform |
string |
Attribution network name |
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 |
ContactEmailInfoModel
Name | Type | Description |
---|---|---|
EmailAddress |
string |
The email address |
Name |
string |
The name of the email info data |
VerificationStatus |
The verification status of the email |
ContinentCode
Name | Type | Description |
---|---|---|
AF |
string |
|
AN |
string |
|
AS |
string |
|
EU |
string |
|
NA |
string |
|
OC |
string |
|
SA |
string |
|
Unknown |
string |
CountryCode
Name | Type | Description |
---|---|---|
AD |
string |
|
AE |
string |
|
AF |
string |
|
AG |
string |
|
AI |
string |
|
AL |
string |
|
AM |
string |
|
AO |
string |
|
AQ |
string |
|
AR |
string |
|
AS |
string |
|
AT |
string |
|
AU |
string |
|
AW |
string |
|
AX |
string |
|
AZ |
string |
|
BA |
string |
|
BB |
string |
|
BD |
string |
|
BE |
string |
|
BF |
string |
|
BG |
string |
|
BH |
string |
|
BI |
string |
|
BJ |
string |
|
BL |
string |
|
BM |
string |
|
BN |
string |
|
BO |
string |
|
BQ |
string |
|
BR |
string |
|
BS |
string |
|
BT |
string |
|
BV |
string |
|
BW |
string |
|
BY |
string |
|
BZ |
string |
|
CA |
string |
|
CC |
string |
|
CD |
string |
|
CF |
string |
|
CG |
string |
|
CH |
string |
|
CI |
string |
|
CK |
string |
|
CL |
string |
|
CM |
string |
|
CN |
string |
|
CO |
string |
|
CR |
string |
|
CU |
string |
|
CV |
string |
|
CW |
string |
|
CX |
string |
|
CY |
string |
|
CZ |
string |
|
DE |
string |
|
DJ |
string |
|
DK |
string |
|
DM |
string |
|
DO |
string |
|
DZ |
string |
|
EC |
string |
|
EE |
string |
|
EG |
string |
|
EH |
string |
|
ER |
string |
|
ES |
string |
|
ET |
string |
|
FI |
string |
|
FJ |
string |
|
FK |
string |
|
FM |
string |
|
FO |
string |
|
FR |
string |
|
GA |
string |
|
GB |
string |
|
GD |
string |
|
GE |
string |
|
GF |
string |
|
GG |
string |
|
GH |
string |
|
GI |
string |
|
GL |
string |
|
GM |
string |
|
GN |
string |
|
GP |
string |
|
GQ |
string |
|
GR |
string |
|
GS |
string |
|
GT |
string |
|
GU |
string |
|
GW |
string |
|
GY |
string |
|
HK |
string |
|
HM |
string |
|
HN |
string |
|
HR |
string |
|
HT |
string |
|
HU |
string |
|
ID |
string |
|
IE |
string |
|
IL |
string |
|
IM |
string |
|
IN |
string |
|
IO |
string |
|
IQ |
string |
|
IR |
string |
|
IS |
string |
|
IT |
string |
|
JE |
string |
|
JM |
string |
|
JO |
string |
|
JP |
string |
|
KE |
string |
|
KG |
string |
|
KH |
string |
|
KI |
string |
|
KM |
string |
|
KN |
string |
|
KP |
string |
|
KR |
string |
|
KW |
string |
|
KY |
string |
|
KZ |
string |
|
LA |
string |
|
LB |
string |
|
LC |
string |
|
LI |
string |
|
LK |
string |
|
LR |
string |
|
LS |
string |
|
LT |
string |
|
LU |
string |
|
LV |
string |
|
LY |
string |
|
MA |
string |
|
MC |
string |
|
MD |
string |
|
ME |
string |
|
MF |
string |
|
MG |
string |
|
MH |
string |
|
MK |
string |
|
ML |
string |
|
MM |
string |
|
MN |
string |
|
MO |
string |
|
MP |
string |
|
MQ |
string |
|
MR |
string |
|
MS |
string |
|
MT |
string |
|
MU |
string |
|
MV |
string |
|
MW |
string |
|
MX |
string |
|
MY |
string |
|
MZ |
string |
|
NA |
string |
|
NC |
string |
|
NE |
string |
|
NF |
string |
|
NG |
string |
|
NI |
string |
|
NL |
string |
|
NO |
string |
|
NP |
string |
|
NR |
string |
|
NU |
string |
|
NZ |
string |
|
OM |
string |
|
PA |
string |
|
PE |
string |
|
PF |
string |
|
PG |
string |
|
PH |
string |
|
PK |
string |
|
PL |
string |
|
PM |
string |
|
PN |
string |
|
PR |
string |
|
PS |
string |
|
PT |
string |
|
PW |
string |
|
PY |
string |
|
QA |
string |
|
RE |
string |
|
RO |
string |
|
RS |
string |
|
RU |
string |
|
RW |
string |
|
SA |
string |
|
SB |
string |
|
SC |
string |
|
SD |
string |
|
SE |
string |
|
SG |
string |
|
SH |
string |
|
SI |
string |
|
SJ |
string |
|
SK |
string |
|
SL |
string |
|
SM |
string |
|
SN |
string |
|
SO |
string |
|
SR |
string |
|
SS |
string |
|
ST |
string |
|
SV |
string |
|
SX |
string |
|
SY |
string |
|
SZ |
string |
|
TC |
string |
|
TD |
string |
|
TF |
string |
|
TG |
string |
|
TH |
string |
|
TJ |
string |
|
TK |
string |
|
TL |
string |
|
TM |
string |
|
TN |
string |
|
TO |
string |
|
TR |
string |
|
TT |
string |
|
TV |
string |
|
TW |
string |
|
TZ |
string |
|
UA |
string |
|
UG |
string |
|
UM |
string |
|
US |
string |
|
UY |
string |
|
UZ |
string |
|
Unknown |
string |
|
VA |
string |
|
VC |
string |
|
VE |
string |
|
VG |
string |
|
VI |
string |
|
VN |
string |
|
VU |
string |
|
WF |
string |
|
WS |
string |
|
YE |
string |
|
YT |
string |
|
ZA |
string |
|
ZM |
string |
|
ZW |
string |
EmailVerificationStatus
Name | Type | Description |
---|---|---|
Confirmed |
string |
|
Pending |
string |
|
Unverified |
string |
EmptyResult
ExecuteFunctionResult
Name | Type | Description |
---|---|---|
Error |
Error from the CloudScript Azure Function. |
|
ExecutionTimeMilliseconds |
number |
The amount of time the function took to execute |
FunctionName |
string |
The name of the function that executed |
FunctionResult |
object |
The object returned from the function, if any |
FunctionResultTooLarge |
boolean |
Flag indicating if the FunctionResult was too large and was subsequently dropped from this event. |
FunctionExecutionError
Name | Type | Description |
---|---|---|
Error |
string |
Error code, such as CloudScriptAzureFunctionsExecutionTimeLimitExceeded, CloudScriptAzureFunctionsArgumentSizeExceeded, CloudScriptAzureFunctionsReturnSizeExceeded or CloudScriptAzureFunctionsHTTPRequestError |
Message |
string |
Details about the error |
StackTrace |
string |
Point during the execution of the function at which the error occurred, if any |
LinkedPlatformAccountModel
Name | Type | Description |
---|---|---|
string |
Linked account email of the user on the platform, if available |
|
Platform |
Authentication platform |
|
PlatformUserId |
string |
Unique account identifier of the user on the platform |
Username |
string |
Linked account username of the user on the platform, if available |
LocationModel
Name | Type | Description |
---|---|---|
City |
string |
City name. |
ContinentCode |
The two-character continent code for this location |
|
CountryCode |
The two-character ISO 3166-1 country code for the country associated with the location |
|
Latitude |
number |
Latitude coordinate of the geographic location. |
Longitude |
number |
Longitude coordinate of the geographic location. |
LoginIdentityProvider
Name | Type | Description |
---|---|---|
AndroidDevice |
string |
|
Apple |
string |
|
Custom |
string |
|
CustomServer |
string |
|
string |
||
FacebookInstantGames |
string |
|
GameCenter |
string |
|
GameServer |
string |
|
GooglePlay |
string |
|
GooglePlayGames |
string |
|
IOSDevice |
string |
|
King |
string |
|
Kongregate |
string |
|
NintendoSwitch |
string |
|
NintendoSwitchAccount |
string |
|
OpenIdConnect |
string |
|
PSN |
string |
|
PlayFab |
string |
|
Steam |
string |
|
Twitch |
string |
|
Unknown |
string |
|
WindowsHello |
string |
|
XBoxLive |
string |
|
XboxMobileStore |
string |
MembershipModel
Name | Type | Description |
---|---|---|
IsActive |
boolean |
Whether this membership is active. That is, whether the MembershipExpiration time has been reached. |
MembershipExpiration |
string |
The time this membership expires |
MembershipId |
string |
The id of the membership |
OverrideExpiration |
string |
Membership expirations can be explicitly overridden (via game manager or the admin api). If this membership has been overridden, this will be the new expiration time. |
OverrideIsSet |
boolean |
Whether the override expiration is set. |
Subscriptions |
The list of subscriptions that this player has for this membership |
PlayerProfileModel
Name | Type | Description |
---|---|---|
AdCampaignAttributions |
List of advertising campaigns the player has been attributed to |
|
AvatarUrl |
string |
URL of the player's avatar image |
BannedUntil |
string |
If the player is currently banned, the UTC Date when the ban expires |
ContactEmailAddresses |
List of all contact email info associated with the player account |
|
Created |
string |
Player record created |
DisplayName |
string |
Player display name |
ExperimentVariants |
string[] |
List of experiment variants for the player. Note that these variants are not guaranteed to be up-to-date when returned during login because the player profile is updated only after login. Instead, use the LoginResult.TreatmentAssignment property during login to get the correct variants and variables. |
LastLogin |
string |
UTC time when the player most recently logged in to the title |
LinkedAccounts |
List of all authentication systems linked to this player account |
|
Locations |
List of geographic locations from which the player has logged in to the title |
|
Memberships |
List of memberships for the player, along with whether are expired. |
|
Origination |
Player account origination |
|
PlayerId |
string |
PlayFab player account unique identifier |
PublisherId |
string |
Publisher this player belongs to |
PushNotificationRegistrations |
List of configured end points registered for sending the player push notifications |
|
Statistics |
List of leaderboard statistic values for the player |
|
Tags |
Tag |
List of player's tags for segmentation |
TitleId |
string |
Title ID this player profile applies to |
TotalValueToDateInUSD |
number |
Sum of the player's purchases made with real-money currencies, converted to US dollars equivalent and represented as a whole number of cents (1/100 USD). For example, 999 indicates nine dollars and ninety-nine cents. |
ValuesToDate |
List of the player's lifetime purchase totals, summed by real-money currency |
PlayStreamEventEnvelopeModel
Name | Type | Description |
---|---|---|
EntityId |
string |
The ID of the entity the event is about. |
EntityType |
string |
The type of the entity the event is about. |
EventData |
string |
Data specific to this event. |
EventName |
string |
The name of the event. |
EventNamespace |
string |
The namespace of the event. |
EventSettings |
string |
Settings for the event. |
PostFunctionResultForPlayerTriggeredActionRequest
Name | Type | Description |
---|---|---|
CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
FunctionResult |
The result of the function execution. |
|
PlayStreamEventEnvelope |
The triggering PlayStream event, if any, that caused the function to be invoked. |
|
PlayerProfile |
The player profile the function was invoked with. |
PushNotificationPlatform
Name | Type | Description |
---|---|---|
ApplePushNotificationService |
string |
|
GoogleCloudMessaging |
string |
PushNotificationRegistrationModel
Name | Type | Description |
---|---|---|
NotificationEndpointARN |
string |
Notification configured endpoint |
Platform |
Push notification platform |
StatisticModel
Name | Type | Description |
---|---|---|
Name |
string |
Statistic name |
Value |
number |
Statistic value |
Version |
number |
Statistic version (0 if not a versioned statistic) |
SubscriptionModel
Name | Type | Description |
---|---|---|
Expiration |
string |
When this subscription expires. |
InitialSubscriptionTime |
string |
The time the subscription was orignially purchased |
IsActive |
boolean |
Whether this subscription is currently active. That is, if Expiration > now. |
Status |
The status of this subscription, according to the subscription provider. |
|
SubscriptionId |
string |
The id for this subscription |
SubscriptionItemId |
string |
The item id for this subscription from the primary catalog |
SubscriptionProvider |
string |
The provider for this subscription. Apple or Google Play are supported today. |
SubscriptionProviderStatus
Name | Type | Description |
---|---|---|
BillingError |
string |
|
Cancelled |
string |
|
CustomerDidNotAcceptPriceChange |
string |
|
FreeTrial |
string |
|
NoError |
string |
|
PaymentPending |
string |
|
ProductUnavailable |
string |
|
UnknownError |
string |
TagModel
Name | Type | Description |
---|---|---|
TagValue |
string |
Full value of the tag, including namespace |
ValueToDateModel
Name | Type | Description |
---|---|---|
Currency |
string |
ISO 4217 code of the currency used in the purchases |
TotalValue |
number |
Total value of the purchases in a whole number of 1/100 monetary units. For example, 999 indicates nine dollars and ninety-nine cents when Currency is 'USD') |
TotalValueAsDecimal |
string |
Total value of the purchases in a string representation of decimal monetary units. For example, '9.99' indicates nine dollars and ninety-nine cents when Currency is 'USD'. |