profiles

package
v0.0.0-...-aefa400 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 19, 2023 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type EffectType 

type EffectType string

EffectType 

const (
	EffectTypeAllow EffectType = "Allow"
	EffectTypeDeny  EffectType = "Deny"
)

type EntityDataObjectModel 

type EntityDataObjectModel struct {
	// DataObject un-escaped JSON object, if DataAsObject is true.
	DataObject interface{} `json:"DataObject,omitempty"`
	// EscapedDataObject escaped string JSON body of the object, if DataAsObject is default or false.
	EscapedDataObject string `json:"EscapedDataObject,omitempty"`
	// ObjectName name of this object.
	ObjectName string `json:"ObjectName,omitempty"`
}

EntityDataObject an entity object and its associated meta data.

type EntityKeyModel 

type EntityKeyModel struct {
	// Id unique ID of the entity.
	Id string `json:"Id,omitempty"`
	// Type entity type. See https://docs.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types
	Type string `json:"Type,omitempty"`
}

EntityKey combined entity type and ID structure which uniquely identifies a single entity.

type EntityLineageModel 

type EntityLineageModel struct {
	// CharacterId the Character Id of the associated entity.
	CharacterId string `json:"CharacterId,omitempty"`
	// GroupId the Group Id of the associated entity.
	GroupId string `json:"GroupId,omitempty"`
	// MasterPlayerAccountId the Master Player Account Id of the associated entity.
	MasterPlayerAccountId string `json:"MasterPlayerAccountId,omitempty"`
	// NamespaceId the Namespace Id of the associated entity.
	NamespaceId string `json:"NamespaceId,omitempty"`
	// TitleId the Title Id of the associated entity.
	TitleId string `json:"TitleId,omitempty"`
	// TitlePlayerAccountId the Title Player Account Id of the associated entity.
	TitlePlayerAccountId string `json:"TitlePlayerAccountId,omitempty"`
}

EntityLineage

type EntityPermissionStatementModel 

type EntityPermissionStatementModel struct {
	// Action the action this statement effects. May be 'Read', 'Write' or '*' for both read and write.
	Action string `json:"Action,omitempty"`
	// Comment a comment about the statement. Intended solely for bookkeeping and debugging.
	Comment string `json:"Comment,omitempty"`
	// Condition additional conditions to be applied for entity resources.
	Condition interface{} `json:"Condition,omitempty"`
	// Effect the effect this statement will have. It may be either Allow or Deny
	Effect EffectType `json:"Effect,omitempty"`
	// Principal the principal this statement will effect.
	Principal interface{} `json:"Principal,omitempty"`
	// Resource the resource this statements effects. Similar to 'pfrn:data--title![Title ID]/Profile/*'
	Resource string `json:"Resource,omitempty"`
}

EntityPermissionStatement

type EntityProfileBodyModel 

type EntityProfileBodyModel struct {
	// AvatarUrl avatar URL for the entity.
	AvatarUrl string `json:"AvatarUrl,omitempty"`
	// Created the creation time of this profile in UTC.
	Created time.Time `json:"Created,omitempty"`
	// DisplayName the display name of the entity. This field may serve different purposes for different entity types. i.e.: for a title
	// player account it could represent the display name of the player, whereas on a character it could be character's name.
	DisplayName string `json:"DisplayName,omitempty"`
	// Entity the entity id and type.
	Entity *EntityKeyModel `json:"Entity,omitempty"`
	// EntityChain the chain of responsibility for this entity. Use Lineage.
	EntityChain string `json:"EntityChain,omitempty"`
	// ExperimentVariants the experiment variants of this profile.
	ExperimentVariants []string `json:"ExperimentVariants,omitempty"`
	// Files the files on this profile.
	Files map[string]EntityProfileFileMetadataModel `json:"Files,omitempty"`
	// Language the language on this profile.
	Language string `json:"Language,omitempty"`
	// LeaderboardMetadata leaderboard metadata for the entity.
	LeaderboardMetadata string `json:"LeaderboardMetadata,omitempty"`
	// Lineage the lineage of this profile.
	Lineage *EntityLineageModel `json:"Lineage,omitempty"`
	// Objects the objects on this profile.
	Objects map[string]EntityDataObjectModel `json:"Objects,omitempty"`
	// Permissions the permissions that govern access to this entity profile and its properties. Only includes permissions set on this
	// profile, not global statements from titles and namespaces.
	Permissions []EntityPermissionStatementModel `json:"Permissions,omitempty"`
	// Statistics the statistics on this profile.
	Statistics map[string]EntityStatisticValueModel `json:"Statistics,omitempty"`
	// VersionNumber the version number of the profile in persistent storage at the time of the read. Used for optional optimistic
	// concurrency during update.
	VersionNumber int32 `json:"VersionNumber,omitempty"`
}

EntityProfileBody

type EntityProfileFileMetadataModel 

type EntityProfileFileMetadataModel struct {
	// Checksum checksum value for the file, can be used to check if the file on the server has changed.
	Checksum string `json:"Checksum,omitempty"`
	// FileName name of the file
	FileName string `json:"FileName,omitempty"`
	// LastModified last UTC time the file was modified
	LastModified time.Time `json:"LastModified,omitempty"`
	// Size storage service's reported byte count
	Size int32 `json:"Size,omitempty"`
}

EntityProfileFileMetadata an entity file's meta data. To get a download URL call File/GetFiles API.

type EntityStatisticChildValueModel 

type EntityStatisticChildValueModel struct {
	// ChildName child name value, if child statistic
	ChildName string `json:"ChildName,omitempty"`
	// Metadata child statistic metadata
	Metadata string `json:"Metadata,omitempty"`
	// Value child statistic value
	Value int32 `json:"Value,omitempty"`
}

EntityStatisticChildValue

type EntityStatisticValueModel 

type EntityStatisticValueModel struct {
	// ChildStatistics child statistic values
	ChildStatistics map[string]EntityStatisticChildValueModel `json:"ChildStatistics,omitempty"`
	// Metadata statistic metadata
	Metadata string `json:"Metadata,omitempty"`
	// Name statistic name
	Name string `json:"Name,omitempty"`
	// Value statistic value
	Value int32 `json:"Value,omitempty"`
	// Version statistic version
	Version int32 `json:"Version,omitempty"`
}

EntityStatisticValue

type GetEntityProfileRequestModel 

type GetEntityProfileRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// DataAsObject determines whether the objects will be returned as an escaped JSON string or as a un-escaped JSON object. Default is
	// JSON string.
	DataAsObject bool `json:"DataAsObject"`
	// Entity the optional entity to perform this action on. Defaults to the currently logged in entity.
	Entity *EntityKeyModel `json:"Entity,omitempty"`
}

GetEntityProfileRequest given an entity type and entity identifier will retrieve the profile from the entity store. If the profile being retrieved is the caller's, then the read operation is consistent, if not it is an inconsistent read. An inconsistent read means that we do not guarantee all committed writes have occurred before reading the profile, allowing for a stale read. If consistency is important the Version Number on the result can be used to compare which version of the profile any reader has.

type GetEntityProfileResponseModel 

type GetEntityProfileResponseModel struct {
	// Profile entity profile
	Profile *EntityProfileBodyModel `json:"Profile,omitempty"`
}

GetEntityProfileResponse

func GetProfile 

func GetProfile(settings *playfab.Settings, postData *GetEntityProfileRequestModel, entityToken string) (*GetEntityProfileResponseModel, error)

GetProfile retrieves the entity's profile. https://api.playfab.com/Documentation/Profiles/method/GetProfile

type GetEntityProfilesRequestModel 

type GetEntityProfilesRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// DataAsObject determines whether the objects will be returned as an escaped JSON string or as a un-escaped JSON object. Default is
	// JSON string.
	DataAsObject bool `json:"DataAsObject"`
	// Entities entity keys of the profiles to load. Must be between 1 and 25
	Entities []EntityKeyModel `json:"Entities,omitempty"`
}

GetEntityProfilesRequest given a set of entity types and entity identifiers will retrieve all readable profiles properties for the caller. Profiles that the caller is not allowed to read will silently not be included in the results.

type GetEntityProfilesResponseModel 

type GetEntityProfilesResponseModel struct {
	// Profiles entity profiles
	Profiles []EntityProfileBodyModel `json:"Profiles,omitempty"`
}

GetEntityProfilesResponse

func GetProfiles 

func GetProfiles(settings *playfab.Settings, postData *GetEntityProfilesRequestModel, entityToken string) (*GetEntityProfilesResponseModel, error)

GetProfiles retrieves the entity's profile. https://api.playfab.com/Documentation/Profiles/method/GetProfiles

type GetGlobalPolicyRequestModel 

type GetGlobalPolicyRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// Entity the optional entity to perform this action on. Defaults to the currently logged in entity.
	Entity *EntityKeyModel `json:"Entity,omitempty"`
}

GetGlobalPolicyRequest retrieves the title access policy that is used before the profile's policy is inspected during a request. If never customized this will return the default starter policy built by PlayFab.

type GetGlobalPolicyResponseModel 

type GetGlobalPolicyResponseModel struct {
	// Permissions the permissions that govern access to all entities under this title or namespace.
	Permissions []EntityPermissionStatementModel `json:"Permissions,omitempty"`
}

GetGlobalPolicyResponse

func GetGlobalPolicy 

func GetGlobalPolicy(settings *playfab.Settings, postData *GetGlobalPolicyRequestModel, entityToken string) (*GetGlobalPolicyResponseModel, error)

GetGlobalPolicy gets the global title access policy https://api.playfab.com/Documentation/Profiles/method/GetGlobalPolicy

type GetTitlePlayersFromMasterPlayerAccountIdsRequestModel 

type GetTitlePlayersFromMasterPlayerAccountIdsRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// MasterPlayerAccountIds master player account ids.
	MasterPlayerAccountIds []string `json:"MasterPlayerAccountIds,omitempty"`
	// TitleId id of title to get players from.
	TitleId string `json:"TitleId,omitempty"`
}

GetTitlePlayersFromMasterPlayerAccountIdsRequest given a master player account id (PlayFab ID), returns all title player accounts associated with it.

type GetTitlePlayersFromMasterPlayerAccountIdsResponseModel 

type GetTitlePlayersFromMasterPlayerAccountIdsResponseModel struct {
	// TitleId optional id of title to get players from, required if calling using a master_player_account.
	TitleId string `json:"TitleId,omitempty"`
	// TitlePlayerAccounts dictionary of master player ids mapped to title player entity keys and id pairs
	TitlePlayerAccounts map[string]EntityKeyModel `json:"TitlePlayerAccounts,omitempty"`
}

GetTitlePlayersFromMasterPlayerAccountIdsResponse

func GetTitlePlayersFromMasterPlayerAccountIds 

func GetTitlePlayersFromMasterPlayerAccountIds(settings *playfab.Settings, postData *GetTitlePlayersFromMasterPlayerAccountIdsRequestModel, entityToken string) (*GetTitlePlayersFromMasterPlayerAccountIdsResponseModel, error)

GetTitlePlayersFromMasterPlayerAccountIds retrieves the title player accounts associated with the given master player account. https://api.playfab.com/Documentation/Profiles/method/GetTitlePlayersFromMasterPlayerAccountIds

type OperationTypes 

type OperationTypes string

OperationTypes 

const (
	OperationTypesCreated OperationTypes = "Created"
	OperationTypesUpdated OperationTypes = "Updated"
	OperationTypesDeleted OperationTypes = "Deleted"
	OperationTypesNone    OperationTypes = "None"
)

type SetEntityProfilePolicyRequestModel 

type SetEntityProfilePolicyRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// Entity the entity to perform this action on.
	Entity *EntityKeyModel `json:"Entity,omitempty"`
	// Statements the statements to include in the access policy.
	Statements []EntityPermissionStatementModel `json:"Statements,omitempty"`
}

SetEntityProfilePolicyRequest this will set the access policy statements on the given entity profile. This is not additive, any existing statements will be replaced with the statements in this request.

type SetEntityProfilePolicyResponseModel 

type SetEntityProfilePolicyResponseModel struct {
	// Permissions the permissions that govern access to this entity profile and its properties. Only includes permissions set on this
	// profile, not global statements from titles and namespaces.
	Permissions []EntityPermissionStatementModel `json:"Permissions,omitempty"`
}

SetEntityProfilePolicyResponse

func SetProfilePolicy 

func SetProfilePolicy(settings *playfab.Settings, postData *SetEntityProfilePolicyRequestModel, entityToken string) (*SetEntityProfilePolicyResponseModel, error)

SetProfilePolicy sets the profiles access policy https://api.playfab.com/Documentation/Profiles/method/SetProfilePolicy

type SetGlobalPolicyRequestModel 

type SetGlobalPolicyRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// Permissions the permissions that govern access to all entities under this title or namespace.
	Permissions []EntityPermissionStatementModel `json:"Permissions,omitempty"`
}

SetGlobalPolicyRequest updates the title access policy that is used before the profile's policy is inspected during a request. Policies are compiled and cached for several minutes so an update here may not be reflected in behavior for a short time.

type SetGlobalPolicyResponseModel 

type SetGlobalPolicyResponseModel struct {
}

SetGlobalPolicyResponse

func SetGlobalPolicy 

func SetGlobalPolicy(settings *playfab.Settings, postData *SetGlobalPolicyRequestModel, entityToken string) (*SetGlobalPolicyResponseModel, error)

SetGlobalPolicy sets the global title access policy https://api.playfab.com/Documentation/Profiles/method/SetGlobalPolicy

type SetProfileLanguageRequestModel 

type SetProfileLanguageRequestModel struct {
	// CustomTags the optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
	CustomTags map[string]string `json:"CustomTags,omitempty"`
	// Entity the optional entity to perform this action on. Defaults to the currently logged in entity.
	Entity *EntityKeyModel `json:"Entity,omitempty"`
	// ExpectedVersion the expected version of a profile to perform this update on
	ExpectedVersion int32 `json:"ExpectedVersion,omitempty"`
	// Language the language to set on the given entity. Deletes the profile's language if passed in a null string.
	Language string `json:"Language,omitempty"`
}

SetProfileLanguageRequest given an entity profile, will update its language to the one passed in if the profile's version is equal to the one passed in.

type SetProfileLanguageResponseModel 

type SetProfileLanguageResponseModel struct {
	// OperationResult the type of operation that occured on the profile's language
	OperationResult OperationTypes `json:"OperationResult,omitempty"`
	// VersionNumber the updated version of the profile after the language update
	VersionNumber int32 `json:"VersionNumber,omitempty"`
}

SetProfileLanguageResponse

func SetProfileLanguage 

func SetProfileLanguage(settings *playfab.Settings, postData *SetProfileLanguageRequestModel, entityToken string) (*SetProfileLanguageResponseModel, error)

SetProfileLanguage updates the entity's language. The precedence hierarchy for communication to the player is Title Player Account language, Master Player Account language, and then title default language if the first two aren't set or supported. https://api.playfab.com/Documentation/Profiles/method/SetProfileLanguage

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.