CSV ファイルを使用したユーザーの一括インポート

管理画面から CSV ファイルをインポートして、新しい管理画面ユーザーや Shopify POS 用の Point of Sale (POS) ユーザーを作成し、ストアへのアクセス権を一括で管理できます。

CSV のインポートを使用すると、ユーザーアカウントに対して以下の変更を加えることができます。

• 新しい管理画面ユーザーを作成する
• 割り当てられた PIN を使用して、Shopify POS の新しい POS ユーザーを作成する
• 既存の管理画面および POS ユーザーアカウントを一時停止または再有効化する

ユーザー管理 CSV ファイルの考慮事項

ユーザーアカウントの変更の中には、CSV のインポートでサポートされていないものがあります。CSV のインポートで完了できない更新については、管理画面で手動でユーザーアカウントを管理するか、Shopify POS アプリで管理してください。CSV ファイルを使用してユーザーをインポートする際は、以下の考慮事項を確認してください。

• CSV ファイルのインポートでは、ユーザーの一括削除はサポートされていません。
• ユーザーに対する 2要素認証の要件を設定したり更新したりすることはできません。
• 既存ユーザーの Shopify POS 用 PIN を変更することはできません。
• CSV インポートから新しい役割、グループ、ロケーションを作成することはできません。ファイル内の役割名、グループ名、ロケーション名は、管理画面にすでに存在するものと一致している必要があります。
• CSV インポートでは、既存ユーザーの一時停止または再有効化のみが可能です。既存ユーザーの役割、割り当てられたグループ、ロケーション、ストアへのアクセス権を変更することはできません。
• POS 専用ユーザーを管理画面ユーザーに変更するなど、ユーザーのタイプを変更することはできません。

ユーザー管理 CSV ファイルのサンプルをダウンロードする

サンプルファイルには、必須の列ヘッダーと各列のサンプル値が含まれています。独自のユーザーを追加する前の開始点として使用できます。

このページからユーザー管理 CSV ファイルのサンプルをダウンロードして表示するか、管理画面の [インポート] ページからサンプルをダウンロードできます。

スプレッドシートアプリで CSV ファイルを保存および編集する方法については、CSV ファイルを開いて編集するを参照してください。

ユーザー管理 CSV ファイルの列の定義

以下の表は、ユーザー管理のサンプル CSV ファイルに含まれるすべての列のリストです。各定義では、管理者ユーザーと POS 専用ユーザーの違いを含め、ユーザーを作成する場合や既存のユーザーを一時停止または再有効化する場合における列の使用方法を説明しています。

CSV ファイルで新しいユーザーを作成する

新しいユーザーを作成するには、その行の id を空白のままにします。ユーザーが作成された後、インポートによって自動的に id に値が割り当てられます。

ユーザーに複数のロケーション、役割、またはストアへのアクセスを許可するには、ユーザーに複数の役割、ロケーション、ストアを割り当てるを参照してください。

POS ユーザーを作成する

POS ユーザーを作成するには、以下のフィールドに値を入力します。

• user_type に Point of sale と入力します。
• given_name と family_name を入力します。
• ユーザー権限を設定するには、以下のいずれかのフィールドに値を入力します。
  • role_name および store_name：組織に複数のストアがある場合、両方のフィールドが必須となります。
  • group_name: Shopify Plus プランでのみ利用できます。グループを割り当てる方法については、「CSV ファイルでユーザーにグループを割り当てる」を参照してください。
• ロケーションへのアクセスを設定するには、以下のフィールドに値を入力します。
  • 特定のロケーションへのアクセスを設定するには、pos_location_name を入力し、all_current_and_future_locations を FALSE に設定します。
  • すべてのロケーションへのアクセスを設定するには、all_current_and_future_locations を TRUE に設定し、pos_location_name を空白のままにします。
• オプション：email、phone、または pin を入力します。PIN は、ストア内で一意となる 4〜6 桁の数字である必要があります。

管理者ユーザーを作成する

管理者ユーザーを作成するには、以下のフィールドに値を入力します。

• user_type に Admin と入力します。
• email を入力します。
• ユーザー権限を設定するには、以下のフィールドに値を入力します。
  • role_name および store_name：組織にストアが 1 つしかない場合、store_name は不要です。役割が組織レベルの役割である場合は、store_name を空白のままにします。
  • group_name: Shopify Plus プランでのみ利用できます。グループを割り当てる方法については、「CSV ファイルでユーザーにグループを割り当てる」を参照してください。
• オプション：role_name が POS カテゴリーの役割である場合、その行の pin に値を入力できます。PIN を指定しない場合、インポートによってユーザーの PIN が生成されます。
• 指定した role_name が POS カテゴリーの役割である場合、ユーザーのロケーションへのアクセスを設定する必要があります。以下のフィールドに値を入力します。
  • 特定のロケーションへのアクセスを設定するには、pos_location_name を入力し、all_current_and_future_locations を FALSE に設定します。
  • すべてのロケーションへのアクセスを設定するには、all_current_and_future_locations を TRUE に設定し、pos_location_name を空白のままにします。

CSV ファイルで既存のユーザーを一時停止または再有効化する

ユーザー管理の CSV ファイルにユーザーごとに 1 行追加することで、既存のユーザーを一時停止または再有効化できます。ユーザーは id によって識別されます。

既存のユーザーを一時停止または再有効化するには、以下のフィールドに値を入力します。

• ユーザーの id を入力します。
• ユーザーの user_type を入力します。
• ユーザーが管理者ユーザーである場合、以下のフィールドに値を入力します。
  • email：必須です。
  • given_name：オプションです。値を入力する場合、管理画面にあるユーザーの名と一致している必要があります。
  • family_name：オプションです。値を入力する場合、管理画面にあるユーザーの姓と一致している必要があります。
  • phone：オプションです。値を入力する場合、管理画面にあるユーザーの電話番号と一致している必要があります。
• ユーザーが POS ユーザーである場合、以下のフィールドに値を入力します。
  • given_name：必須です。
  • family_name：必須です。
  • email：ユーザーがアカウントにメールアドレスを登録している場合、このフィールドは必須です。
  • phone：ユーザーがアカウントに電話番号を登録している場合、このフィールドは必須です。
• status：ユーザーを一時停止するには Suspended を入力し、ユーザーを再有効化するには Active を入力します。ユーザーを一時停止できるのは、管理画面での現在のステータスが Active または Inactive である場合のみです。ユーザーを再有効化できるのは、現在のステータスが Suspended である場合のみです。

ユーザーに複数の役割、ロケーション、ストアを割り当てる

新しいユーザーを作成する際、1 回の CSV ファイルのインポートで複数の役割、POSロケーション、およびストアをそのユーザーに割り当てることができます。役割、ロケーション、ストアの各組み合わせには、ファイル内に専用の行が必要です。

同じユーザーに割り当てる値ごとに 1 行追加します。インポートですべての行が 1 つのユーザーアカウントに適用されるように、そのユーザーのすべての行に同じ識別値を入力します。すべての行で id を空白のままにします。ユーザーの作成後、インポートによって id が割り当てられます。

すべての行で必要となる識別値

インポートによって同じユーザーを識別できるようにするには、そのユーザーに対する CSV ファイルのすべての行に次の値を入力します。

• 管理画面ユーザーの場合、そのユーザーに対するすべての行に同じ email と user_type を入力する必要があります。
• POS ユーザーの場合、そのユーザーのすべての行に、同じ user_type、given_name、family_name、email、および phone を入力する必要があります。

同じストアのユーザーに複数の役割を割り当てる

各役割を CSV ファイル内の別々の行に記述することで、1 人のユーザーが同じストアで複数の役割を持つことができます。

ユーザーに同じストアで複数の役割を割り当てるには、CSV ファイルに役割ごとに 1 行を追加する必要があります。すべての行で、そのユーザーの同じ識別値を入力し、Shopify 管理画面に表示されているとおりの store_name と role_name を正確に入力します。

同じストアで複数の POSロケーションを割り当てる

ユーザーがストア内の特定の POSロケーションにのみアクセスできるようにする場合は、各ロケーションを別々の行に記載します。

ユーザーに複数の特定の POS ロケーションへのアクセスを割り当てるには、CSV ファイルにロケーションごとに 1 行を追加する必要があります。各行にそのユーザーの同じ識別値を入力し、管理画面に記載されている pos_location_name を入力して、それぞれの行で all_current_and_future_locations を FALSE に設定します。

たとえば、1 つのストアにある 2 つの特定のロケーションで、ユーザーに同じ役割を与えるには、ロケーションごとに 1 行を追加します。

または、現在および将来のすべてのロケーションへのアクセスを許可するには、all_current_and_future_locations を TRUE に設定し、pos_location_name を空白にした単一の行を使用します。そのストアのそのユーザーのすべての行で、同一の TRUE または FALSE の値を使用してください。行ごとに異なる値を混在させることはできません。

複数のストア間でのユーザーアクセスの割り当て

複数のストアを持つ組織では、同じユーザーに対して、必要な各ストアへのアクセスを許可できます。

同じユーザーが複数のストアでアクセスを必要とする場合は、役割、ストア、ロケーションの組み合わせごとに 1 つの行を使用します。各行には、そのユーザーの同じ 識別値 と、Shopify の管理画面にリストされている正確な store_name を入力する必要があります。

各ストアで、同じユーザーに 複数の役割 と 複数の POS ロケーション を割り当てることができます。

作成行の all_current_and_future_locations および pos_location_name については、同じストア内の複数の POS ロケーションを割り当てる場合と同じ行パターンを使用します。その行の pos_location_name に値が入力されている場合、all_current_and_future_locations を TRUE に設定することはできません。

以下の例では、同じ POS ユーザーに 2 つの異なるストアにわたって異なるロケーションへのアクセス権を割り当てます。

ユーザーのいずれかの行でエラーが発生した場合、そのユーザーのすべての行が拒否されます。エラーを修正した後、次回のインポートにはそのユーザーのすべての行を含めてください。

CSV ファイルでユーザーにグループを割り当てる

グループは、Shopify Plus プランの組織でのみ利用できます。グループには 1 つまたは複数の役割がまとめられているため、グループを割り当てることで、ユーザーに複数の役割を同時に許可できます。

グループまたは単一の役割を割り当てる

CSV ファイルの各行では、グループまたは単一の役割のいずれかを割り当てることができますが、両方を割り当てることはできません。

• グループを割り当てるには、group_name にグループを入力し、role_name を空白のままにします。
• 単一の役割を割り当てるには、role_name に役割を入力し、group_name を空白のままにします。

要件を満たすユーザーにグループを割り当てる

グループ内の少なくとも 1 つの役割がユーザーのタイプに適用される場合、そのユーザーにグループを割り当てることができます。グループ内の役割のうち、ユーザーのタイプに適用されないものは許可されませんが、エラーにはなりません。適用される役割に基づいて、グループは正常に割り当てられます。

役割が含まれていないグループを割り当てることはできません。

複数のストアおよびロケーションにわたってグループを割り当てる

グループが POS の役割を許可するストアごとに、CSV ファイルに行を含める必要があります。これらの各行で、ロケーションへのアクセス権も設定する必要があります。

• 特定のロケーションへのアクセスについては、pos_location_name を入力し、all_current_and_future_locations を FALSE に設定します。1 つのストアで複数の特定のロケーションへのアクセス権を許可するには、ロケーションごとに 1 行追加し、各行に同じグループとストアを指定します。
• すべてのロケーションへのアクセスを設定するには、all_current_and_future_locations を TRUE に設定し、pos_location_name を空白のままにします。

グループのロケーションへのアクセス権は、別の行で同じユーザーに許可されたロケーションへのアクセス権と競合してはならないなど、グループを通じて割り当てられていない POS の役割と同じ方法で検証されます。

グループを割り当てる際の PIN の設定

PIN は、複数の役割を持つユーザーに適用されるのと同じルールに従います。

• グループが POS の役割を許可するストアについてのみ、CSV ファイルの行に pin を入力します。
• PIN はストア内で一意である必要がありますが、複数のストア間で異なる PIN にすることは可能です。
• グループが POS 以外の役割のみを許可するストアの行には、pin を入力しないでください。

組織の役割を含むグループを割り当てる

グループに POS の許可を持つ組織の役割が含まれている場合、その組織の役割は自動的にすべてのロケーションへのアクセス権を許可するため、ストアごとのロケーション要件は適用されません。このタイプのグループは、以下のいずれかの方法で割り当てることができます。

• グループのみの単一の行: group_name にグループを入力し、store_name、pos_location_name、all_current_and_future_locations、および pin を空白のままにします。組織の役割により、すべてのロケーションへのアクセス権が自動的に許可されます。
• 明示的なストアの行: グループが POS の役割を許可するストアごとに 1 行追加します。これらのすべての行で、all_current_and_future_locations を TRUE に設定します。組織の役割を持つユーザーを単一のロケーションに制限することはできません。

グループ割り当ての例

以下の例は、1 つのグループを異なるストアやロケーションにまたがって割り当てる方法を示しています。各行には、group_name、store_name、pos_location_name、all_current_and_future_locations の値が記載されています。

以下の例では、グループによりストア 1 でストアの役割と POS の役割が許可され、ストア 2 で POS の役割が許可されます。

• 例 1 では、2 つのストアのすべてのロケーションにアクセスできるグループを割り当てます。グループは各ストアで POS の役割を許可するため、CSV ファイルにはストアごとに 1 行を追加する必要があります。

• 例 2では、2つのストアにグループを割り当てますが、そのグループによってストア 1でのみPOSの役割が許可され、ストア 2ではストアのみの役割が許可されます。CSV ファイルには、POSの役割を持つストアの行のみを追加します。ストア 2のストアのみの役割は、行がなくても許可されます。

• 例 3では、2つのストアにある特定のロケーションへのアクセス権を持つグループを割り当てます。CSV ファイルには、ロケーションごとに 1行を追加する必要があります。

• 例 4では、ストアの役割とPOSの役割に加えて、POS の許可を持つ組織の役割を含むグループを割り当てます。このグループは、以下のいずれかの方法で割り当てることができます。

  • 1つ目のオプションは、グループのみの単一の行を使用する方法です。この場合、組織の役割によってすべてのロケーションへのアクセスが許可されます。
  • 2つ目のオプションは、グループによってPOSの役割が許可される各ストアに明示的な行を使用する方法です。組織の役割は単一のロケーションに限定できないため、各行で all_current_and_future_locations を TRUE にする必要があります。

管理画面からユーザー管理の CSV ファイルをインポートする

CSV ファイルを作成し、正しい形式で保存したら、組織の [ユーザー] ページからアップロードできます。インポートは Shopify の管理画面で実行され、処理できない行が報告されます。

手順:

1. Shopify の管理画面から [設定] > [ユーザー] に移動します。

2. [インポート] をクリックします。

3. オプション: リンクをクリックしてサンプル CSV ファイルをダウンロードし、自分のファイルのテンプレートとして使用します。

4. [ファイルをアップロード] をクリックし、.csv ファイルを選択します。

インポートが完了したら、Shopify の管理画面で確認事項をレビューします。エラーのある行がある場合、詳細が記載されたメールが送信されるため、ファイルを修正して再度インポートできます。

ユーザー管理のインポートに関する一般的な問題の解決策

ユーザー管理 CSV ファイルのアップロードで問題が発生した場合は、その問題が以下の解決策に記載されているかどうかを確認してください。

特定のエラーメッセージのトラブルシューティングに関するサポートが必要な場合は、インポート時のエラーメッセージのトラブルシューティング を参照してください。

エラー修正後の再インポート

インポートが失敗すると、失敗した行が記載されたメールが届きます。重複するユーザーが作成されないように、ファイルを慎重に再インポートしてください。

ファイル全体ではなく、エラーが発生したユーザーのみを再インポートします。以下の方法を使用してください。

• 失敗した行を修正し、影響を受ける各ユーザーのすべての行を新しいファイルに含めます。1 人のユーザーに 3 つの行があり、1 つの行でエラーが発生した場合、そのユーザーの 3 つの行すべてが拒否されます。再インポートには、修正された 3 つの行すべてを含めます。
• 正常にインポートされたユーザーは含めないでください。これらのアカウントはすでに存在しています。再度インポートすると、user already exists エラーが返されたり、重複するユーザーが作成されたり、あるいはその両方が発生したりする可能性があります。

すでに正常に作成されたユーザーの行を含む元のファイル全体を再インポートすると、以下の結果になる可能性があります。

• 管理画面ユーザー: メールアドレスがすでに使用されている場合、user already exists または重複メールのエラーが表示されることがあります。
• POS ユーザー: システムによって重複する POS ユーザーのレコードが作成される可能性があります。POS ユーザーは、一意のメールアドレスではなく、名前と関連フィールドを使用して照合されるため、同じ名前と役割を持つ 2 人目のユーザーが作成される可能性があります。
• シート制限: すでに作成されたユーザーがインポートのカウントに含まれる場合、シート制限エラーが発生する可能性があります。詳細については、各料金プランの最大ユーザー数 を参照してください。

同じ名前の複数の POS ユーザーを作成する

1回のインポートで、POS ユーザーの 識別値 が複数の行 (連続していない行も含む) で一致する場合、インポート処理ではそれらの行が同じユーザーとして扱われます。

1回のインポートで、同じ given_name と family_name を持つ個別の POS ユーザーを作成するには、各ユーザーに対して以下のフィールドの少なくとも1つに異なる値を入力する必要があります。

• email
• phone

email や phone に異なる値を使用しても、同じ given_name と family_name を持つ複数のユーザーを区別できない場合は、各ユーザーを別々の CSV ファイルでインポートする必要があります。

ファイル形式とアップロードサイズ

以下の問題は、ユーザー行の値ではなく、CSV ファイルの形式またはサイズに関連しています。

• 間違ったファイル形式: ファイルは、CSV ファイルを開いて編集する で説明されているエンコーディングで保存された .csv ファイルである必要があります。
• ファイルが大きすぎる: ファイルに多数の行がある場合は、小さなファイルに分割して 1 つずつインポートしてください。

POS ユーザーが 1 人の複数役割ユーザーとしてではなく、複数のユーザーとして表示される

インポート時、対象者のすべての行で user_type、given_name、family_name、email、および phone が一致する場合に、それらの行が同一の POS ユーザーとして紐付けられます。これらの値のいずれかが行間で異なる場合、個別のユーザーが作成されます。

複数の役割を持つ 1 人のユーザーを想定していたにもかかわらず、POS ユーザーが重複してしまう原因として、以下の状況がよく見られます。

• 一方の行にはメールアドレスがあるが、他方の行にはない: POS ユーザーの最初の行に email を含め、別の行では空白にした場合、インポートによって別々のユーザーが作成されます。そのユーザーのすべての行に email を含めるか、すべての行で空白にしてください。
• 名前に誤字がある: 名前の行に誤字があると、別々のユーザーが作成される可能性があります。たとえば、大文字と小文字が区別される場合、ある行の Jane と別の行の jane は異なるユーザーとして扱われる可能性があります。すべての行でユーザーの名前を同じように入力してください。
• ある行には電話番号があり、別の行にはない場合：POS ユーザーの最初の行に phone を含め、別の行では空白のままにした場合、インポートによって個別のユーザーが作成されます。そのユーザーのすべての行に phone を含めるか、すべての行で空白のままにしてください。

ユーザーの重複を避けるため、CSV ファイル内の同一の POS ユーザーのすべての行で、user_type、given_name、family_name、email、および phone が完全に一致していることを確認してください。

シート制限のエラー

組織の料金プランでは、管理画面ユーザーにシート制限が適用されます。インポート中にシート制限エラーが発生した場合、インポート処理でファイルから作成される新しい管理画面ユーザーの数が計算され、プランのシート制限と照合されます。シート制限に達しているか、制限に近づいている場合は、再度インポートを行う前に、CSV ファイル内の新しい管理画面ユーザーの数を減らすか、料金プランのユーザー制限を確認してください。

ユーザーリストをエクスポートして重複する POS ユーザーを見つける

POS ユーザーが重複していると思われる場合、ユーザーリストを CSV ファイルにエクスポートして、スプレッドシートの行を比較できます。エクスポートには、どのアカウントが最初に作成されたかを示すタイムスタンプが含まれます。

エクスポートがどのように配信されるか、また誰がダウンロードできるかについては、ユーザー管理情報を CSV ファイルとしてエクスポートするを参照してください。

手順:

1. Shopify の管理画面から [設定] > [ユーザー] に移動します。

2. エクスポートをクリックします。

3. ユーザーをエクスポートダイアログで、エクスポートをクリックします。

4. メールを受信したら、ファイルをダウンロードをクリックして、CSV をデバイスに保存します。

5. スプレッドシートアプリでファイルを開き、GIVEN_NAME 列で並べ替えます。

6. エクスポートデータの中で、名 (given name)、姓 (family name)、メールアドレス (email)、電話番号 (phone) の値が一致しており、CREATED_AT の時刻が同じ、または非常に近い POS ユーザーを確認します。これらのアカウントは重複している可能性があります。

重複する POS ユーザーを手動で削除する

CSV ファイルを使用せずに、Shopify 管理画面で重複する POS ユーザーアカウントを手動で削除できます。

手順:

1. Shopify の管理画面から [設定] > [ユーザー] に移動します。

2. 重複するユーザーアカウントを選択します。

3. 削除をクリックします。

CSV ファイルを使用して重複する POS ユーザーを一括削除する

CSV のインポートによって重複するアカウントを一時停止し、Shopify 管理画面のユーザーページからそれらの一時停止中のアカウントを一括削除できます。最初にアカウントを一時停止することで、削除する前にどのアカウントを削除するのかを確認しやすくなります。

手順:

1. 現在のユーザーリストをエクスポートします。
2. ユーザーリストをエクスポートして重複する POS ユーザーを比較するで説明されている比較方法を使用して、重複するアカウントを特定します。
3. 重複する各アカウントについて、id、user_type、email、phone、given_name、および family_name の値を新しい CSV ファイルにコピーします。ユーザー管理 CSV ファイルのサンプルと同じ列構成を使用してください。
4. 重複する各行の status を Suspended に設定します。role_name、group_name、store_name、pos_location_name、all_current_and_future_locations、および pin は空白のままにします。
5. CSV ファイルをインポートして、これらのユーザーを一時停止します。
6. 設定 > ユーザーに移動します。
7. 利用できる場合は、ユーザーリストを絞り込んで一時停止中のアカウントを表示します。一時停止した重複アカウントを選択し、一括で削除します。

インポートのエラーメッセージのトラブルシューティング

ユーザー管理の CSV インポートが失敗すると、エラーメッセージと影響を受ける行が記載されたメールが届きます。以下のセクションでは、各メッセージの意味と、再度インポートを行う前に CSV ファイルで変更できる内容について説明します。

CSV のインポートに関する問題が解決しない場合は、Shopify サポートにお問い合わせください。

CSV ファイルのエラー

ユーザー識別のエラー

管理画面ユーザーまたは POS ユーザー作成のエラー

以下のトラブルシューティングは、新しいユーザーを作成するためにユーザーの id フィールドが空欄になっている場合に適用されます。

管理画面ユーザー作成のエラー

以下のトラブルシューティングは、id が空欄で、user_type が Admin に設定されている場合に適用されます。

POS ユーザーの作成エラー

id が空白で、user_type が Point of sale に設定されている場合は、以下のトラブルシューティングが適用されます。

ユーザーの停止エラー

以下のトラブルシューティングは、id に値が入力されており、既存のユーザーの status を変更する場合に適用されます。