グループメンバー一覧（CSV形式）
すでに作成されているグループに対して、メンバーを追加するための CSVフォーマットについて解説します。
- グループ一覧 ：グループの追加や削除、名称変更ができます。メンバー情報などは含みません。
- サービスグループ一覧 ：サービスプロバイダーにグループをプロビジョニング連携している場合に使用します。サービスプロバイダー側のグループIDを登録、または削除できます。
- グループメンバー一覧 ：既存のグループへメンバーを追加、または削除できます。
ダウンロード時と一括処理のためのアップロード時で CSVフォーマットは共通です。
ここでは、グループメンバー一覧の CSVファイルのフォーマットについて解説します。
CSVファイル作成時の注意点
-
文字コードは「UTF-8」形式、「BOMなし」に設定し作成してください。
-
ファイルの１行目に CSV項目を記載し、2行目以降に値を記載します。１行で１メンバー分のデータが設定できますので、複数のメンバーを設定する場合は１メンバー分ずつ複数行に分けて記載してください。
-
CSV項目や値はカンマ区切りで作成してください。カンマ以外の区切り文字はサポートしていません。
-
CSV項目は大文字・小文字を区別しません。
-
データの操作（作成・更新・削除）により必須項目は異なります。必須項目はもれなく含めてください。
グループメンバー情報の CSVファイル作成例
- 1行目に CSV項目、2行目以降に各項目の値を記載した作成例です。
- グループのメンバー追加は、すでに存在するグループにのみ行うことができます。
| operation | groupId | memberType | memberId | memberPermission |
|---|---|---|---|---|
| CREATE | group1@example.com | USER | member_011@example.com | MEMBER |
| CREATE | group1@example.com | USER | member_012@example.com | MEMBER |
| CREATE | group2@example.com | USER | member_021@example.com | MEMBER |
テキストエディターでは以下のように確認できます。
| "operation","groupId","memberType","memberId","memberPermission" "CREATE","group1@example.com","USER","member_011@example.com","MEMBER" "CREATE","group1@example.com","USER","member_012@example.com","MEMBER" "CREATE","group2@example.com","USER","member_021@example.com","MEMBER" |
グループメンバー情報の項目一覧
グループメンバー一覧の更新処理は、メンバータイプ、メンバーID、メンバー権限のいずれの変更も可能です。
| CSV項目 | 画面表示項目 | 入力値 | 必須 | ||
|---|---|---|---|---|---|
| 作成 | 更新 | 削除 | |||
| operation | - | グループにメンバーを 作成する場合は"CREATE" 更新する場合は"UPDATE" 削除する場合は"DELETE"と記載します。 大文字・小文字は区別されません。 空欄にした場合は、処理は行われません。 |
● | ● | ● |
| groupId | グループID | CloudGate UNO の既存のグループIDを記載します。 必須項目ですので空欄にすることはできません。 |
● | ● | ● |
| memberType | メンバータイプ | メンバーのタイプを記載します。 メンバーが CloudGate UNO の ユーザーアカウントの場合は"USER" グループの場合は"GROUP" 存在しない場合は"OTHER"を記載します。 大文字・小文字は区別されません。 OTHERの場合は、Microsoft 365連携でプロビジョニング対象外となります。
Note: ここでの設定値が
CloudGate UNO の実際の登録状態と異なる場合は、エラーとなります。例えば、「USER」の場合に 該当メンバーがユーザーとして存在しなかったり、 「GROUP」の場合に該当アドレスがグループとして登録されていないときはエラーとなります。
|
● | ● | ● |
| memberId | メンバーID | CloudGate UNO のユーザーIDまたはグループIDを指定します。 メンバータイプが OTHERの場合はメールアドレスとなります。 |
● | ● | ● |
| memberPermission | メンバー権限 | メンバーの権限を記載します。 メンバーの権限を オーナーにする場合は"OWNER" マネージャーにする場合は"MANAGER" メンバーにする場合は"MEMBER"を記載します。 大文字・小文字は区別されません。
Note: こちらは、Google Workspace、cybozu.com、Boxがプロビジョニングの対象となります。
|
● | ● | |
