Ctrl+K

Other education group#

In addition to creating groups for classes and courses, schools can create groups for other purposes. These groups can be used for any purpose and there is no set structure for the groups. For example, these can be created for a group of students working together on a project.

Availability#

Attribute group

To retrieve these groups, the application needs access to the groups-edu attribute group / scope.

Organization type

This group type is available for primary, lower secondary and upper secondary schools.

Member list

Example#

{
  "id": "fc:gogroup:eksempel.kommune.no:a:NO987654321:grp_5738:2000-07-01:2100-06-30",
  "type": "fc:gogroup",
  "displayName": "Example group",
  "membership": {
    "basic": "member",
    "displayName": "Elev",
    "affiliation": "student"
  },
  "notBefore": "2000-06-30T22:00:00Z",
  "notAfter": "2100-06-30T22:00:00Z",
  "go_type": "a",
  "parent": "fc:gogroup:eksempel.kommune.no:unit:NO987654321",
  "go_type_displayName": "andre grupper"
}

Group object#

The group objects has the following fields:

id (required, string)

Unique identifier of the group. Has the format fc:gogroup:<realm>:a:<organization-number>:<local-group-id>:<start-date>:<end-date>. <realm> is the domain name of the school owner. <organization-number> is the organization number of the school or the organization number of the school owner. In both cases it is prefixed with NO. <local-group-id> is the local identifier of the group at the school owner. <start-date> and <end-date> contain the first and last date the group the group is active.

type (required, string)

The group type. Always fc:gogroup for other groups.

Note

There are multiple groups with the type fc:gogroup. To recognize an other education group, check for both "type": "fc:gogroup" and "go_type": "a".

displayName (required, string)

A human readable name for the group. E.g. Example group.

membership (optional, object)

The role of the current user in the group. This field is only present when requesting groups for a specific user.

notBefore (required, string)

The timestamp when the group became active / valid. This is typically before the school year.

notAfter (required, string)

The timestamp when the group is no longer active / valid. This is typically after the end of the school year.

go_type (required, string)

The group type code. Always a for other education groups.

parent (required, string)

The group identifier of the school or school owner this group belongs to. This is usually a school, but it is possible to have basis groups that are not part of a specific school. In that case the parent is the school owner.

go_type_displayName (required, string)

A human readable name for the group type. Always andre grupper for other education groups.

Membership object#

The membership object contains information about the user’s role in the group.

{
  "basic": "member",
  "displayName": "Elev",
  "affiliation": "student"
}

It has the following fields:

basic (required, string)

The basic membership role of the user. This field is a string with one of the following values:

  • admin: For teachers in the group.

  • member: For students in the group.

affiliation (required, string)

The user’s affiliation to this group. Common values are:

  • student: For students in the group.

  • faculty: For teachers in the group.

displayName (required, string/object)

A human-readable version of the affiliation field.

This field is either a plain string or a JSON object with different translations. The JSON object contains the language code as key and the translation as value.

It will be returned as a plain string in most cases, but will be returned as a JSON object when retrieving group member lists.

On this page