ページ ツリー

比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

...

  • 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)の形式の文字を含む可能性があります。

...