I agree, the documentation is pretty lacking. GPermission is an abstract base class which isn't particularly useful by itself. You need something which actually implements GPermission, like polkit.
There are some examples in gnome-control-center, like the datetime panel.