組織情報を取得する
組織数を取得する
Garoonに存在する組織数をレスポンスとして返すAPIです。
API名
AdminCountOrgs
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
なし
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| number_orgs/text() | xsd:integer | 1 | 組織数 |
例
|
|
組織IDを取得する
Garoonに存在する組織のIDを返すAPIです。
API名
AdminGetOrgIds
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| offset/text() | xsd:integer | 0~1 | オフセット |
| limit/text() | xsd:integer | 0~1 | 取得数上限 |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| number_orgs/text() | xsd:integer | 1 | 取得した組織数 |
| orgId/text() | xsd:integer | 0~ 無制限 | 取得した組織のID |
例
|
|
組織を取得する
組織IDをリクエストのパラメーターとして受け取り、組織の詳細情報をレスポンスとして返すAPIです。 存在しない組織IDを指定した場合、エラーは発生せず、そのIDに対する処理は行いません。 組織情報のその他の項目値を取得する場合は、ベースAPIの BaseGetOrganizationsById を使用します。
API名
AdminGetOrgDetailByIds
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| orgId/text() | xsd:integer | 1~ 無制限 | 組織ID |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| number_orgs/text() | xsd:integer | 1 | 取得した組織数 |
| OrgDetail | admin:OrgDetail | 0~ 無制限
|
取得した組織の情報 |
例
|
|
子組織の数を取得する
組織IDをリクエストのパラメーターとして受け取り、子組織の個数をレスポンスとして返すAPIです。
API名
AdminCountChildOrgs
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| parent_orgId/text() | xsd:integer | 1 | 子組織の数を取得する組織のID |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| parent_orgId/text() | xsd:integer | 1 | 子組織の数を取得する組織のID |
| number_child_orgs/text() | xsd:integer | 1 | parent_orgIdの子組織の数 |
例
|
|
子組織のIDを取得する
組織IDをリクエストのパラメーターとして受け取り、子組織のIDをレスポンスとして返すAPIです。
API名
AdminGetChildOrgs
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| parent_orgId/text() | xsd:integer | 1 | 子組織のIDを取得する組織のID |
| offset/text() | xsd:integer | 0~1 | オフセット |
| limit/text() | xsd:intger | 0~1 | 取得する子組織の上限数 |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| parent_orgId/text() | xsd:integer | 1 | 子組織のIDを取得する組織のID |
| number_child_orgs/text() | xsd:integer | 1 | 取得した子組織の数 |
| orgId/text() | xsd:integer | 0~ 無制限
|
子組織ID |
例
|
|
親組織のIDを取得する
組織IDをリクエストのパラメーターとして受け取り、その組織の親組織のIDをレスポンスとして返すAPIです。
API名
AdminGetParentOrgId
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| child_orgId/text() | xsd:integer | 1 | 親組織IDを取得する組織ID |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| child_orgId/text() | xsd:integer | 1 | 親組織IDを取得する組織ID |
| parent_orgId/text() | xsd:integer | 1 | 取得した親組織ID |
例
|
|
組織コードから組織IDを取得する
組織コードをリクエストのパラメーターとして受け取り、組織IDをレスポンスとして返すAPIです。 存在しない組織IDを指定した場合、-1が返されます。
API名
AdminGetOrgIdByOrgCode
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| org_code/text() | xsd:string | 1 | 組織コード |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| org_code/text() | xsd:string | 1 | 指定した組織コード |
| orgId/text() | xsd:integer | 1 | 取得した組織ID |
例
|
|
組織内のユーザー数を取得する
組織IDをリクエストのパラメーターとして受け取り、組織内に存在するユーザーの人数をレスポンスとして返すAPIです。 存在しない組織IDを指定した場合、レスポンスのorgIdには-1が入り、number_usersは0が入ります。
API名
AdminCountUsersInOrg
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| orgId/text() | xsd:integer | 1 | 組織ID |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| orgId/text() | xsd:integer | 1 | 組織ID |
| number_users/text() | xsd:integer | 1 | 組織内に存在するユーザー数 |
例
|
|
組織内のGaroonユーザーIDを取得する
組織IDをリクエストのパラメーターとして受け取り、組織内に存在するGaroonユーザーIDをレスポンスとして返すAPIです。 存在しない組織IDを指定した場合、レスポンスのorgIdには-1が入り、number_usersは0が入ります。
API名
AdminGetUserIdsInOrg
使用可能なGaroonのバージョン
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
リクエスト
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| orgId/text() | xsd:integer | 1 | 組織ID |
| offset/text() | xsd:integer | 0~1 | オフセット |
| limit/text() | xsd:integer | 0~1 | 取得するユーザーの上限数 |
例
|
|
レスポンス
API名とレスポンスの要素名が異なります。
| パラメーター名 | 型 | パラメーター数 | 説明 |
|---|---|---|---|
| orgId/text() | xsd:integer | 1 | 組織ID |
| number_users/text() | xsd:integer | 1 | 取得したユーザー数 |
| userId/text() | xsd:integer | 0~ 無制限 | 取得したGaroonユーザーID |
例
|
|
