2.0 Course object extends Drillable

A course is a collection of drills that can be practiced. Course is a subclass of 2.0 Drillable.

Example

{
  "id" : "vGjy2yRUR-aMrUKAt_eAuw",
  "name" : "Spelling Bee 2012 practice words",
  "subject" : "English",
  "type" : "COURSE",
  "size" : 150,
  "description" : "This course contains three drills with a total of 150 practice words for the 2012 Spelling Bee.",
  "practice" : {
    "proficiency" : {
      "overall" : 31
    },
    "expectedDuration" : 27495,
    "icon" : {
      "url" : "https://www.drillster.com/bin/drillable-icon/vGjy2yRUR-aMrUKAt_eAuw"
    }
  },
  "drills" : [ {
    "id" : "aD1yumG1SUyhyr3_SspN8w",
    "name" : "Spelling Bee 2012 practice words (1/3)",
    "subject" : "English",
    "type" : "DRILL",
    "size" : 50,
    "description" : "A list of 150 practice words for the 2012 spelling bee. This is part 1 out of 3.",
    "practice" : {
      "proficiency" : {
        "overall" : 51
      },
      "highestProficiency" : {
        "overall" : 100
      },
      "expectedDuration" : 2369,
      "icon" : {
        "url" : "https://www.drillster.com/bin/drillable-icon/aD1yumG1SUyhyr3_SspN8w"
      }
    }
  }, {
    "id" : "Eny-DpBlR4GlmzMVc3aV7Q",
    "name" : "Spelling Bee 2012 practice words (2/3)",
    "subject" : "English",
    "type" : "DRILL",
    "size" : 50,
    "description" : "A list of 150 practice words for the 2012 spelling bee. This is part 2 out of 3.",
    "practice" : {
      "proficiency" : {
        "overall" : 47
      },
      "highestProficiency" : {
        "overall" : 100
      },
      "expectedDuration" : 1206,
      "icon" : {
        "url" : "https://www.drillster.com/bin/drillable-icon/Eny-DpBlR4GlmzMVc3aV7Q"
      }
    }
  }, {
    "id" : "2xT5S_O_SvO31YLC1ra3hw",
    "name" : "Spelling Bee 2012 practice words (3/3)",
    "subject" : "English",
    "type" : "DRILL",
    "size" : 50,
    "description" : "A list of 150 practice words for the 2012 spelling bee. This is part 3 out of 3.",
    "practice" : {
      "proficiency" : {
        "overall" : 28
      },
      "highestProficiency" : {
        "overall" : 55
      },
      "expectedDuration" : 1342,
      "icon" : {
        "url" : "https://www.drillster.com/bin/drillable-icon/2xT5S_O_SvO31YLC1ra3hw"
      }
    }
  } ]
}

Fields

Field Type Description
type
required
String constant

The type of this drillable. For courses this always COURSE.

drills
required
List of 2.0 Drill objects

The list of drills contained in this course.

id
required
String

The unique ID of this drill or course.

Example value: gDCIpKnSSA-JIFiQxPq31g

name
required
String

The name of the drill or course.

Example value: European capitals

subject
required
Strings

The subject of the drill or course.

Example value: Geography

description
required
String

A description of the drill or course.

Example value: This drill will teach you the capitals of all European countries.

size
required
Integer

The number of entries in this drill or course.

practice
optional
2.0 Practice object

Information about the user's current status of this drill or course. It is only included if the user calling this API endpoint has the drill or course in his repertoire.

icon
required
2.0 Media object

The MIME type and location of the icon that represents this drill or course.

cover
optional
2.0 Media object

The MIME type and location of an optional cover image for this drill or course.

license
optional
2.0 License object

An optional copyright license that applies to this drill or course.

creator
required
2.0 Actor object

The creator of the drillable. This can either be the organization of the creating user, or the creating user.

owner
optional
2.0 Actor object

The owner of the drillable. The owner by default is the creator of the drillable. Optionally can either be the organization of the creating user, the co-author of the playable or a customized owner name.

compatibility
optional
2.0 Compatibility object

The compatibility indicates whether the client application calling this API endpoint is capable of serving this drill or course to the end user. If it is not capable, the client application should decide what to do with this drill, e.g. hide it from the end user.

A client application is compatible with the drill or course if it has implemented all optional Drillster features that the drill or course is using. These features can be specific media types used in the drill (such as audio), or question types like sequence questions. If your client application supports practicing drills, you can (and should) configure the Drillster features it supports to see correct the compatibility for each drill or course.

This object is only included if the drill or course is not compatible. A list of features that are not supported by the client application, but are required by this drill or course is included.

Example value:

{
  "compatible" : false,
  "unsupportedFeatures" : [ "IMAGE_MEDIA", "AUDIO_MEDIA" ]
}

columns
optional
2.0 Columns object

Information about the configured columns and their names. A drill always has exactly one known column, and one or more unknown columns.

Example value:

{
  "knownColumn" : {
    "name" : "Listen"
  },
  "unknownColumns" : [ {
    "name" : "Spell"
  } ]
}

restrictions
optional
2.0 Restrictions object

Information about the practice restrictions imposed on this drill by the author. Features not specified here are not restricted.

Example value:

{
  "direction" : "PRODUCTIVE",
  "unknownStyle" : "OPEN_ENDED"
}

affordances
optional
List of strings

A list of affordances expressed as strings. An affordance represents a possible action that the requesting user might undertake on a drillable object.

Example value:

[ "REMOVING", "PLAYING" ]