playfab-sdk/Scripts/typings/PlayFab/PlayFabEvents.d.ts

Playfab SDK for node.js applications

declare module PlayFabEventsModule {
    export interface IPlayFabEvents {
        settings: PlayFabModule.IPlayFabSettings;
        // Creates a new telemetry key for the title.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/createtelemetrykey
        CreateTelemetryKey(
            request: PlayFabEventsModels.CreateTelemetryKeyRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.CreateTelemetryKeyResponse> | null,
        ): void;
        // Deletes a telemetry key configured for the title.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/deletetelemetrykey
        DeleteTelemetryKey(
            request: PlayFabEventsModels.DeleteTelemetryKeyRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.DeleteTelemetryKeyResponse> | null,
        ): void;
        // Gets information about a telemetry key configured for the title.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/gettelemetrykey
        GetTelemetryKey(
            request: PlayFabEventsModels.GetTelemetryKeyRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.GetTelemetryKeyResponse> | null,
        ): void;
        // Lists all telemetry keys configured for the title.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/listtelemetrykeys
        ListTelemetryKeys(
            request: PlayFabEventsModels.ListTelemetryKeysRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.ListTelemetryKeysResponse> | null,
        ): void;
        // Sets a telemetry key to the active or deactivated state.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/settelemetrykeyactive
        SetTelemetryKeyActive(
            request: PlayFabEventsModels.SetTelemetryKeyActiveRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.SetTelemetryKeyActiveResponse> | null,
        ): void;
        // Write batches of entity based events to PlayStream. The namespace of the Event must be 'custom' or start with 'custom.'.
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/writeevents
        WriteEvents(
            request: PlayFabEventsModels.WriteEventsRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.WriteEventsResponse> | null,
        ): void;
        // Write batches of entity based events to as Telemetry events (bypass PlayStream). The namespace must be 'custom' or start
        // with 'custom.'
        // https://docs.microsoft.com/rest/api/playfab/events/playstream-events/writetelemetryevents
        WriteTelemetryEvents(
            request: PlayFabEventsModels.WriteEventsRequest | null,
            callback: PlayFabModule.ApiCallback<PlayFabEventsModels.WriteEventsResponse> | null,
        ): void;


    }
}

declare module PlayFabEventsModels {
    export interface CreateTelemetryKeyRequest extends PlayFabModule.IPlayFabRequestCommon {
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The optional entity to perform this action on. Defaults to the currently logged in entity.
        Entity?: EntityKey;
        // The name of the new key. Telemetry key names must be unique within the scope of the title.
        KeyName: string;
    }

    export interface CreateTelemetryKeyResponse extends PlayFabModule.IPlayFabResultCommon {
        // Details about the newly created telemetry key.
        NewKeyDetails?: TelemetryKeyDetails;
    }

    export interface DeleteTelemetryKeyRequest extends PlayFabModule.IPlayFabRequestCommon {
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The optional entity to perform this action on. Defaults to the currently logged in entity.
        Entity?: EntityKey;
        // The name of the key to delete.
        KeyName: string;
    }

    export interface DeleteTelemetryKeyResponse extends PlayFabModule.IPlayFabResultCommon {
        // Indicates whether or not the key was deleted. If false, no key with that name existed.
        WasKeyDeleted: boolean;
    }

    export interface EntityKey {
        // Unique ID of the entity.
        Id: string;
        // Entity type. See https://docs.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types
        Type?: string;
    }

    export interface EventContents {
        // The optional custom tags associated with the event (e.g. build number, external trace identifiers, etc.). Before an
        // event is written, this collection and the base request custom tags will be merged, but not overriden. This enables the
        // caller to specify static tags and per event tags.
        CustomTags?: { [key: string]: string | null };
        // Entity associated with the event. If null, the event will apply to the calling entity.
        Entity?: EntityKey;
        // The namespace in which the event is defined. Allowed namespaces can vary by API.
        EventNamespace: string;
        // The name of this event.
        Name: string;
        // The original unique identifier associated with this event before it was posted to PlayFab. The value might differ from
        // the EventId value, which is assigned when the event is received by the server.
        OriginalId?: string;
        // The time (in UTC) associated with this event when it occurred. If specified, this value is stored in the
        // OriginalTimestamp property of the PlayStream event.
        OriginalTimestamp?: string;
        // Arbitrary data associated with the event. Only one of Payload or PayloadJSON is allowed.
        Payload?: any;
        // Arbitrary data associated with the event, represented as a JSON serialized string. Only one of Payload or PayloadJSON is
        // allowed.
        PayloadJSON?: string;
    }

    export interface GetTelemetryKeyRequest extends PlayFabModule.IPlayFabRequestCommon {
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The optional entity to perform this action on. Defaults to the currently logged in entity.
        Entity?: EntityKey;
        // The name of the key to retrieve.
        KeyName: string;
    }

    export interface GetTelemetryKeyResponse extends PlayFabModule.IPlayFabResultCommon {
        // Details about the requested telemetry key.
        KeyDetails?: TelemetryKeyDetails;
    }

    export interface ListTelemetryKeysRequest extends PlayFabModule.IPlayFabRequestCommon {
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The optional entity to perform this action on. Defaults to the currently logged in entity.
        Entity?: EntityKey;
    }

    export interface ListTelemetryKeysResponse extends PlayFabModule.IPlayFabResultCommon {
        // The telemetry keys configured for the title.
        KeyDetails?: TelemetryKeyDetails[];
    }

    export interface SetTelemetryKeyActiveRequest extends PlayFabModule.IPlayFabRequestCommon {
        // Whether to set the key to active (true) or deactivated (false).
        Active: boolean;
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The optional entity to perform this action on. Defaults to the currently logged in entity.
        Entity?: EntityKey;
        // The name of the key to update.
        KeyName: string;
    }

    export interface SetTelemetryKeyActiveResponse extends PlayFabModule.IPlayFabResultCommon {
        // The most current details about the telemetry key that was to be updated.
        KeyDetails?: TelemetryKeyDetails;
        // Indicates whether or not the key was updated. If false, the key was already in the desired state.
        WasKeyUpdated: boolean;
    }

    export interface TelemetryKeyDetails {
        // When the key was created.
        CreateTime: string;
        // Whether or not the key is currently active. Deactivated keys cannot be used for telemetry ingestion.
        IsActive: boolean;
        // The key that can be distributed to clients for use during telemetry ingestion.
        KeyValue?: string;
        // When the key was last updated.
        LastUpdateTime: string;
        // The name of the key. Telemetry key names are unique within the scope of the title.
        Name?: string;
    }

    export interface WriteEventsRequest extends PlayFabModule.IPlayFabRequestCommon {
        // The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
        CustomTags?: { [key: string]: string | null };
        // The collection of events to write. Up to 200 events can be written per request.
        Events: EventContents[];
    }

    export interface WriteEventsResponse extends PlayFabModule.IPlayFabResultCommon {
        // The unique identifiers assigned by the server to the events, in the same order as the events in the request. Only
        // returned if FlushToPlayStream option is true.
        AssignedEventIds?: string[];
    }

}