指定したグループの情報を取得します。

基本情報

認証 必要
HTTPメソッド GET

リソースURL

https://www.co-meeting.com/api/v1/groups/show

パラメータ

network_id ネットワークに紐づくアプリケーションの場合、必須
id グループのID(英数字24桁)。
idまたはgroup_idのどちらかが必須です。
group_id グループのID(15桁の整数)またはグループエイリアス(グループ設定でユーザが指定)。
idまたはgroup_idのどちらかが必須です。
include_meetings 結果に最近更新のあったミーティング情報を10件含める。
0: 含めない(デフォルト)
1: 含める
自分が所属していないグループの場合は、1にしても取得できません。
include_public_meetings 結果に最近更新のあった公開ミーティング情報を10件含める。
0: 含めない(デフォルト)
1: 含める
非公開グループの場合は、1にしても取得できません。

サンプルリクエスト

GET https://www.co-meeting.com/api/v1/groups/show?group_alias=test-group
{
  "status": "success",
  "result": {
    "id": "518217b94cfad12cb3000615",
    "group_id": "639432519924924",
    "group_alias": "test-group",
    "name": "Test Group",
    "icon_url": null,
    "description": null,
    "privacy_status": 0,
    "require_approval": true,
    "network_id": null,
    "created_at": "2013-05-02 07:37:29 UTC",
    "updated_at": "2013-05-02T07:37:29+00:00",
    "url": "http://www.co-meeting.com/g/test-group",
    "members": [
      {
        "id": "518217b94cfad12cb3000614",
        "name": "Test User 74",
        "screen_name": "test_user_74",
        "icon_url": "http://www.co-meeting.com/images/mtg/unknown.jpg",
        "last_accessed_at": null,
        "role": 100
      }
    ]
  }
}

レスポンス

result/members/role メンバーの権限
100:オーナー、80:管理者、60:一般ユーザ