ListBulkJobsAdminRequest

Lists existing bulk jobs.

Request Parameters

Parameter	Required	Type	Description
bulkJobIds	No	string[]	The IDs of existing bulk jobs to get details for

Response Parameters

A response listing existing bulk jobs

Parameter	Type	Description
bulkJobs	BulkJob[]	A list of JSON objects containing bulk jobs
scriptData	ScriptData	A JSON Map of any data added either to the Request or the Response by your Cloud Code

Nested types

ScriptData

A collection of arbitrary data that can be added to a message via a Cloud Code script.

Parameter	Type	Description
myKey	string	An arbitrary data key
myValue	JSON	An arbitrary data value.

BulkJob

A nested object that represents the bulk job.

Parameter	Type	Description
actualCount	number	The actual count of players affected by the bulk job (calculated when the job started to run)
completed	date	The time at which the bulk job completed execution
created	date	The time at which the bulk job was created
data	DBObject	Data to be passed into the Module or Script
doneCount	number	The number of players processed by the bulk job so far
errorCount	number	The number of errors encountered whilst running the Module or Script for players
estimatedCount	number	The estimated count of players affected by the bulk job (estimated when the job was submitted)
id	string	The ID for the bulk job
moduleShortCode	string	The Cloud Code Module to run for each player
playerQuery	DBObject	The query to identify players to perform the bulk job on
scheduledTime	date	The time at which the job was scheduled to run
script	string	The Cloud Code script to run for each player
started	date	The time at which the bulk job started to execute
state	string	The current state of the bulk job

Code Samples

C#

    using GameSparks.Api;
    using GameSparks.Api.Requests;
    using GameSparks.Api.Responses;
    ...
    new ListBulkJobsAdminRequest()
        .SetBulkJobIds(bulkJobIds)
        .Send((response) => {
        GSEnumerable<ListBulkJobsAdminResponse._BulkJob> bulkJobs = response.BulkJobs;
        GSData scriptData = response.ScriptData;
        });

ActionScript 3

    import com.gamesparks.*;
    import com.gamesparks.api.requests.*;
    import com.gamesparks.api.responses.*;
    import com.gamesparks.api.types.*;
    ...

    gs.getRequestBuilder()
        .createListBulkJobsAdminRequest()
        .setBulkJobIds(bulkJobIds)
        .send(function(response:com.gamesparks.api.responses.ListBulkJobsAdminResponse):void {
        var bulkJobs:Vector.<BulkJob> = response.getBulkJobs(); 
        var scriptData:ScriptData = response.getScriptData(); 
        });

Objective-C

    #import "GS.h"
    #import "GSAPI.h"
    ...
    GSListBulkJobsAdminRequest* request = [[GSListBulkJobsAdminRequest alloc] init];
    [request setBulkJobIds:bulkJobIds;
    [request setCallback:^ (GSListBulkJobsAdminResponse* response) {
    NSArray* bulkJobs = [response getBulkJobs]; 
    NSDictionary* scriptData = [response getScriptData]; 
    }];
    [gs send:request];

C++


    #include <GameSparks/generated/GSRequests.h>
    using namespace GameSparks::Core;
    using namespace GameSparks::Api::Responses;
    using namespace GameSparks::Api::Requests;
    ...

    void ListBulkJobsAdminRequest_Response(GS& gsInstance, const ListBulkJobsAdminResponse& response) {
    gsstl:vector<Types::BulkJob*> bulkJobs = response.getBulkJobs(); 
    GSData scriptData = response.getScriptData(); 
    }
    ......

    ListBulkJobsAdminRequest request(gsInstance);
    request.SetBulkJobIds(bulkJobIds)
    request.Send(ListBulkJobsAdminRequest_Response);

Java

import com.gamesparks.sdk.api.autogen.GSRequestBuilder.ListBulkJobsAdminRequest;
import com.gamesparks.sdk.api.autogen.GSResponseBuilder.ListBulkJobsAdminResponse;
import com.gamesparks.sdk.api.autogen.GSTypes.*;
import com.gamesparks.sdk.api.GSEventListener;

...
gs.getRequestBuilder().createListBulkJobsAdminRequest()
    .setBulkJobIds(bulkJobIds)
    .send(new GSEventListener<ListBulkJobsAdminResponse>() {
        @Override
        public void onEvent(ListBulkJobsAdminResponse response) {
            List<BulkJob> bulkJobs = response.getBulkJobs(); 
        }
    });

Cloud Code


    var request = new SparkRequests.ListBulkJobsAdminRequest();
    request.bulkJobIds = ...;
    var response = request.Send();

var bulkJobs = response.bulkJobs; 
var scriptData = response.scriptData;