ユーザーの所属グループインポートAPI

ユーザーの所属グループインポートAPI（CSV）

ファイルアップロード API でアップロードした CSV ファイルをユーザーの所属グループ情報として取り込むための API です。

HTTP メソッド

POST

URI

https://{sub-domain}.cybozu.com/v1/csv/userGroups.json

リクエストヘッダ

// Sample
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

リクエストボディ

レスポンス

レスポンスには、結果確認 API で使用する処理の結果確認用 ID がセットされます。

CSVファイルのフォーマット

ユーザーの所属グループ情報 CSVをご参照ください。

アクセス権

cybozu.com共通管理者のみ実行できます。

注意事項

• CSV は差分取り込みです。ログイン名を CSV に記述されていないユーザーへの更新／削除処理は行われません。
• ログイン名を指定したユーザーの所属グループを全て削除するには、ログイン名のみ指定します。

ユーザーの所属グループインポートAPI（JSON）

ユーザーの所属グループの更新

JSON形式で指定したユーザーの所属グループの情報を更新します。

HTTP メソッド

PUT

URI

https://{sub-domain}.cybozu.com/v1/user/groups.json

リクエストヘッダ

// Sample
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

リクエストボディ

リクエストボディの例

レスポンス

成功した場合、以下のレスポンスが返ります。

アクセス権

cybozu.com 共通管理者のみ実行できます。

制限事項

• CSV の読み込みやユーザーの登録と処理が重なった場合、書き込まれた順番に登録されるものとします。
• 本 API と CSV の読み込みやユーザー編集画面での修正の実行順が重なる場合は、CSV の読み込みで上書きされたり、本 API のデータで上書きが発生したり、デッドロックエラーが発生する可能性があります。
• 本 API ではロックなどを行わないため、本 API、CSV 読み込み、通常画面からのユーザーの登録を並行して行うことは推奨しません。