bggGames: API for Games and Things

In JakubBujnowicz/bggAnalytics: BoardGameGeek's Board Game Data Analysis Tools

API for Games and Things

Description

This class provides an interface for games, expansions, accessories and other things listed on BoardGameGeek. The official documentation describes things as every physical, tangible item.See bggAPI() for more details on inherited slots and methods.

Details

Although this class is named bggGames, it inherits it's functionality from the BoardGameGeek XML API2 Things (see References). The name is motivated by the fact that the whole BoardGameGeek's site as well as this package is mainly focused on board games.

Super class

bggAnalytics::bggAPI -> bggGames

Methods

Public methods

• bggGames$new()

• bggGames$print()

• bggGames$clone()

Inherited methods

• bggAnalytics::bggAPI$expand()
• bggAnalytics::bggAPI$fetch()
• bggAnalytics::bggAPI$switch_namestyle()

---

Method new()

Object initialization.

Usage

bggGames$new(ids, chunk_size = 20, params = NULL)

Arguments

ids

a numeric vector of positive integers, IDs of games/things to include in the object.

chunk_size

a positive integer, the maximum length of a chunk that ids are split into. All chunks connect to BoardGameGeek's API separately, so lowering this number increases computation time. On the other hand if a chunk is too long, URL might be too long to fetch. The API caps the number of ids per URL at 20, which is the default value.

params

a list of object parameters. If not all the parameters are included in the list, default values are used (NULL instead of the list is possible for all the default parameters).
Following parameters are allowed for the bggGames class with default values in brackets:

• pretty_names [FALSE] — a boolean value, should the object should use pretty names,

• stats [TRUE] — a boolean value, should the ranking and rating stats be included for every item. Note that some variables require that stats is TRUE.

---

Method print()

Print object information.

Usage

bggGames$print()

---

Method clone()

The objects of this class are cloneable with this method.

Usage

bggGames$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

References

BoardGameGeek XML API2

JakubBujnowicz/bggAnalytics documentation built on April 13, 2025, 7:27 a.m.