...
Wiki マークアップ メンバーのみを取得 <span class="nolink">https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループURLorIDグループentityIDorID{+}*\[?lang=*{+}言語{+}*\]
Wiki マークアップ 管理者のみを取得 <span class="nolink">https://map.gakunin.nii.ac.jp/api/people/@me/</span>{*}{+}グループURLorIDグループentityIDorID{+}*%2Fadmin\[?lang=*{+}言語{+}*\]
グループURL グループentityID は、isMemberOfで取得することができる値をURLエンコードした値です。
例えば、isMemberOfで取得した値が下記の場合は、
(元の値)https://map.gakunin.nii.ac.jp/gr/GakuNinTF
URLエンコード変換後は、下記となります。 URLエンコード後は、下記となります。
(変換後の値)https%3A%2F%2Fmap.gakunin.nii.ac.jp%2Fgr%2FGakuNinTF
※ %3A、%2Fのアルファベットは小文字も許容します。
また、グループURLの短縮形の また、グループentityIDの短縮形の グループID を利用することも可能です。
isMemberOfが上記の(元の値)とした場合、短縮形のグループIDは、GakuNinTFとなります。
管理者を取得する場合は、グループURLもしくはグループIDに 管理者を取得する場合は、グループentityIDもしくはグループIDに %2Fadmin を付与します。
SPコネクタのグループURLもしくはグループIDに SPコネクタのグループentityIDもしくはグループIDに %2Fadmin を付与すると、SP管理者が取得できます。
設定値と取得できる値をまとめたものを以下に示します。
グループURL グループentityID/ID | %2Fadmin | 取得値 |
---|---|---|
グループを指定 | 無 | グループメンバー一覧 |
〃 | 有 | グループ管理者一覧 |
SPコネクタを指定 | 無 | SPコネクタに接続する全グループの全メンバー一覧 |
〃 | 有 | SP管理者一覧 |
※ グループURLグループentityID/IDとして指定できるのは、SPコネクタに直接接続しているグループのみです。
...
書式設定済み |
---|
{ "totalResults" : <グループ数>, "entry" : [ { "id" : "<グループURL><グループentityID>", "title" : "<グループ名>", "description" : "<グループの紹介>", "map_totalMembers" : <グループのメンバー数> }, ... ] } |
※ <グループURL> は、isMemberOfで取得することができるURL形式の値のJavaScriptでの表現<グループentityID> は、isMemberOfで取得することができるURL形式の値(のJavaScriptでの表現)
例: "https:\/\/map.gakunin.nii.ac.jp\/gr\/GakuNinTF"
※ このAPIで取得できるグループはSPコネクタに直接接続しているもののみです。上位グループ経由で接続している下位グループのグループ情報は含まれません。
※ <グループのメンバー数> には、管理者のみの人(管理者であるがメンバーでない人)は含まれません。また、属性送信に同意しているかどうかに関わらずカウントされますので、people APIを通して取得した数より大きい可能性があります。
※ 特に、文字列中にUnicodeのコード表記(例:\u3042)の形式の文字を含む可能性があります。
...