GetGuildMemberListV3

public BackendReturnObject GetGuildMemberListV3(string guildIndate);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, int limit);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, string firstKey);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, int limit, string firstKey);

Parameters

Value	Type	Description	default
guildIndate	string	inDate of the guild to load the guild member list	-
limit	int	(Optional) Number of guild member lists to be loaded	100
firstKey	string	(Optional) Starting point of guild member list to be loaded (offset)	-

Description

Looks up the guild member list that has the guildIndate.

• If 'limit' is 0 or below, it is called as 100.

Example

Synchronous

Backend.Guild.GetGuildMemberListV3("guildIndate");
Backend.Guild.GetGuildMemberListV3("guildIndate", 5);

// When reading the first list, stores the firstkey value,
BackendReturnObject bro = Backend.Guild.GetGuildMemberListV3();
String firstKey = bro.FirstKeyString();
// and reads it again when moving to the next page by setting firstKey as an offset.
Backend.Guild.GetGuildMemberListV3("guildIndate", firstKey);
Backend.Guild.GetGuildMemberListV3("guildIndate", 5, firstKey);

Asynchronous

Backend.Guild.GetGuildMemberListV3("guildIndate", (callback) => {
  // Post-process
});

Backend.Guild.GetGuildMemberListV3("guildIndate", 5, (callback) => {
  // Post-process
});

// Stores firstKey the same way as the synchronous method, and loads the next list
Backend.Guild.GetGuildMemberListV3("guildIndate", firstKey, (callback) => {
  // Post-process
});

Backend.Guild.GetGuildMemberListV3("guildIndate", 20, firstKey, (callback) => {
  // Post-process
});

SendQueue

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", (callback) => {
    // Post-process
});

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", 5, (callback) => {
    // Post-process
});

// Stores firstKey the same way as the synchronous method, and loads the next list
SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", firstKey, (callback) => {
    // Post-process
});

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", 20, firstKey, (callback) => {
    // Post-process
});

ReturnCase

Success cases

When the lookup is successful
statusCode : 200
message : Success
returnValue : refer to GetReturnValuetoJSON

Error cases

When the guildIndate does not exist
statusCode : 404
errorCode : NotFoundException
message : guild not found, guild cannot be found

GetReturnValuetoJSON

{
    rows:
    [
        // Guild member 1
        {
            // Total amount of guild member 1's contribution (+use) of goods 2
            totalGoods2Amount:{ N:"21" },
            // Total amount of guild member 1's contribution (+use) of goods 3
            totalGoods3Amount:{ N:"8" },
            // Nickname of guild member 1
            nickname:{ S:"id2" },
            // Guild indate of guild member 1 (time when the member joined the guild)
            inDate:{ S:"2018-11-21T05:42:24.511Z" },
            // indate of guild member 1
            gamerInDate:{ S:"2018-11-08T03:32:18.210Z" },
            // Guild privilege of guild member 1 (master/viceMaster/member)
            position:{ S:"master" },
            //Last access date
            lastLogin:{S:"2021-07-23T07:42:01.019Z"}
        },
        // Guild member 2
        {
            totalGoods2Amount:{ N:"0" },
            totalGoods3Amount:{ N:"0" },
            inDate:{ S:"2018-11-22T05:45:11.638Z" },
            gamerInDate:{ S:"2018-11-13T01:46:25.323Z" },
            totalGoods1Amount:{ N:"0" },
            position:{ S:"member" },
            lastLogin:{S:"2021-07-22T01:49:01.019Z"}
        },
    ],
   //When firstKey exists
   firstKey:{"inDate":{"S":"2021-07-15T01:18:02.841Z"}}
   //When firstKey does not exist
   firstKey:null
}

Sample Code

public class GuildMemberItem
{
    public string nickname;
    public string inDate;
    public string gamerInDate;
    public string position;
    public string lastLogin;
    public Dictionary<string, int> totalGoodsAmount = new Dictionary<string, int>();
    public override string ToString()
    {
        string goodsString = string.Empty;
        foreach(var dic in totalGoodsAmount)
        {
            goodsString += $"{dic.Key} : {dic.Value}\n";
        }
        return $"nickname : {nickname}\n" +
        $"inDate : {inDate}\n" +
        $"gamerInDate : {gamerInDate}\n" +
        $"position : {position}\n" +
        $"lastLogin : {lastLogin}\n" +
        goodsString;
    }
};

public void GetGuildMemberListV3()
{
    var bro = Backend.Guild.GetGuildMemberListV3("2021-10-29T06:32:10.147Z");

    if(!bro.IsSuccess())
        return;

    LitJson.JsonData guildMemberJson = bro.FlattenRows();

    List<GuildMemberItem> guildMemberList = new List<GuildMemberItem>();

    for(int i = 0; i < guildMemberJson.Count; i++)
    {
        GuildMemberItem member = new GuildMemberItem();

        member.nickname = guildMemberJson[i]["nickname"].ToString();
        member.inDate = guildMemberJson[i]["inDate"].ToString();
        member.gamerInDate = guildMemberJson[i]["gamerInDate"].ToString();
        member.lastLogin = guildMemberJson[i]["lastLogin"].ToString();
        member.position = guildMemberJson[i]["position"].ToString();
        foreach(var goods in guildMemberJson[i].Keys)
        {
            if(goods.Contains("totalGoods"))
            {
                member.totalGoodsAmount.Add(goods, int.Parse(guildMemberJson[i][goods].ToString()));
            }
        }

        guildMemberList.Add(member);
        Debug.Log(member.ToString());
    }
}