顧客の検索
Shopifyの顧客プロフィールを検索します。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| Result Set（結果セット） | 検索がFirst Matching RecordまたはAll Matching Recordsのどちらを返すかを選択します。 | ドロップダウン | TRUE |
検索結果は[Last Order ID (最終注文ID)]フィールドに関連付けられた日付順で表示されます。
入力
| フィールド | 定義 | タイプ | FALSE |
|---|---|---|---|
| 顧客 | |||
| First Name（名） | 顧客の名。 | 文字列 | FALSE |
| Last Name（姓） | 顧客の姓。 | 文字列 | FALSE |
| Email（メール） | 顧客のメールアドレス。 | 文字列 | FALSE |
| Phone（電話番号） | 顧客の電話番号。 | 文字列 | FALSE |
| State (状態) | 店舗における顧客アカウントの状態。オプションは以下のとおり。
| ドロップダウン | FALSE |
| Accepts Marketing?（マーケティングに同意？） | メールでマーケティング資料を受け取ることに顧客が同意したかどうかを示します。 | ブーリアン | FALSE |
| Tag（タグ） | 顧客に追加されたタグ。 | 文字列 | FALSE |
| Verified Email?（確認されたメール？） | 顧客がメールアドレスを確認済みかどうかを示します。 | ブーリアン | FALSE |
| Multipass Identifier（マルチパス識別子） | マルチパスログインで使用される、顧客の一意な識別子。 | 文字列 | FALSE |
| 住所 | |||
| First Name（名） | 顧客の名。 | 文字列 | FALSE |
| Last Name（姓） | 顧客の姓。 | 文字列 | FALSE |
| Company（会社） | 顧客の会社名。 | 文字列 | FALSE |
| Address1（住所1） | 顧客住所の最初の行。 | 文字列 | FALSE |
| Address2（住所2） | 顧客住所の2番目の行。 | 文字列 | FALSE |
| City（市） | 顧客の市。 | 文字列 | FALSE |
| Province（都道府県） | 顧客の都道府県。 | 文字列 | FALSE |
| Country（国） | 顧客の国。 | 文字列 | FALSE |
| カスタムフィルター | |||
| カスタムフィルター | クエリー構文を使った、Shopifyプラットフォーム全体に適用されるカスタム検索フィルター。フィルターには接続語、用語、修飾子、比較演算子を使用できます。フィルターでは用語、フィールド値、ブール演算子、範囲、除外を使った検索も実行できます。 たとえば、クエリ「 Shopify APIの検索構文を参照してください。 | 文字列 | FALSE |
検索結果で返せるのは1ページあたり最大250レコード、および最大550ページです。
出力
| フィールド | 定義 | タイプ |
|---|---|---|
| ID | 顧客のグローバルな一意の識別子。 | 数値 |
| Email（メール） | 顧客のメールアドレス。 | 文字列 |
| Accepts Marketing?（マーケティングに同意？） | メールでマーケティング資料を受け取ることに顧客が同意したかどうかを示します。 | ブーリアン |
| Created At（作成日時） | オブジェクトが作成された日時。 | 日付&時刻 |
| Updated At（更新日時） | 顧客プロファイルが最後に更新された日時。 | 日付&時刻 |
| First Name（名） | 顧客の名。 | 文字列 |
| Last Name（姓） | 顧客の姓。 | 文字列 |
| Orders Count（注文数） | 顧客がこれまでにストアで注文した回数。 | 数値 |
| State (状態) | 店舗における顧客アカウントの状態。オプションは以下のとおり。
| 文字列 |
| Total Spent（合計支出） | 顧客がこれまでに注文に支払った合計金額。 | 数値 |
| Last Order ID（最終注文ID） | 顧客が最後に行った注文のグローバルな一意の識別子。 | 数値 |
| 注 | 顧客に関するメモ。 | 文字列 |
| Verified Email?（確認されたメール？） | 顧客がメールアドレスを確認済みかどうかを示します。 | ブーリアン |
| Multipass Identifier（マルチパス識別子） | マルチパスログインで使用される、顧客の一意な識別子。 | 文字列 |
| Tax Exempt?（非課税？） | 顧客からの注文が非課税かどうかを示します。 | ブーリアン |
| Phone（電話番号） | 顧客の電話番号。 | 文字列 |
| Tags（タグ） | 顧客に追加されたタグをカンマで区切ったリスト。 | 文字列 |
| Last Order Name (最終注文名) | 注文に表示される注文の一意な識別子。(#1000や_Store1001など)。この値は複数の店舗間で一意ではありません。 | 文字列 |
| Currency（通貨） | ストアで使用している通貨。 | 文字列 |
| Addresses（住所） | ||
| ID | 住所オブジェクトの一意の識別子。 | 数値 |
| Customer ID（顧客ID） | 顧客のグローバルな一意の識別子。 | 数値 |
| First Name（名） | 顧客の名。 | 文字列 |
| Last Name（姓） | 顧客の姓。 | 文字列 |
| Company（会社） | 顧客の会社名。 | 文字列 |
| Address1（住所1） | 顧客住所の最初の行。 | 文字列 |
| Address2（住所2） | 顧客住所の2番目の行。 | 文字列 |
| City（市） | 顧客の市。 | 文字列 |
| Province（都道府県） | 顧客の都道府県。 | 文字列 |
| Country（国） | 顧客の国。 | 文字列 |
| ZIP（郵便番号） | 顧客の郵便番号。 | 文字列 |
| Phone（電話番号） | 顧客の電話番号。 | 文字列 |
| Name（名前） | 顧客のフルネーム。 | 文字列 |
| Province Code（都道府県コード） | 顧客の都道府県コードまたは都道府県の略称。 | 文字列 |
| Country Code（国コード） | 顧客の国コード。 | 文字列 |
| Country Name（国名） | 顧客の標準化された国名。 | 文字列 |
| Default?（デフォルト？） | この住所が、顧客のデフォルト住所かどうかを示します。 | ブーリアン |
| Accepts Marketing Updated At (マーケティングの同意の更新日時) | メールによるマーケティング資料の受け取りを顧客が同意または拒否した日時(マーケティング資料の同意または拒否を顧客が行うと必ず設定)。 | 日付&時刻 |
| Marketing Opt in Level（マーケティングのオプトインレベル） | メールによるマーケティング資料の受け取りに顧客が同意した際に有効化された、マーケティングサブスクリプションのオプトインレベル (M3AAWGベストプラクティスガイドラインに準拠)。 | 文字列 |
| Tax Exemptions（免税） | 顧客に適用される免税のリスト。 | テキストのリスト |
| GraphicQL API ID | パターン//shopify/Customer/{customer_id}に基づく、顧客の一意な識別子。 | 文字列 |
| Default Address (デフォルトの住所) | ||
| ID | 住所オブジェクトの一意の識別子。 | 数値 |
| Customer ID（顧客ID） | 顧客のグローバルな一意の識別子。 | 数値 |
| First Name（名） | 顧客の名。 | 文字列 |
| Last Name（姓） | 顧客の姓。 | 文字列 |
| Company（会社） | 顧客の会社名。 | 文字列 |
| Address1（住所1） | 顧客住所の最初の行。 | 文字列 |
| Address2（住所2） | 顧客住所の2番目の行。 | 文字列 |
| City（市） | 顧客の市。 | 文字列 |
| Province（都道府県） | 顧客の都道府県。 | 文字列 |
| Country（国） | 顧客の国。 | 文字列 |
| ZIP（郵便番号） | 顧客の郵便番号。 | 文字列 |
| Phone（電話番号） | 顧客の電話番号。 | 文字列 |
| Name（名前） | 顧客のフルネーム。 | 文字列 |
| Province Code（都道府県コード） | 顧客の都道府県コードまたは都道府県の略称。 | 文字列 |
| Country Code（国コード） | 顧客の国コード。 | 文字列 |
| Country Name（国名） | 顧客の標準化された国名。 | 文字列 |
| Default?（デフォルト？） | この住所が、顧客のデフォルト住所かどうかを示します。 | ブーリアン |