顧客の検索
Shopifyの顧客プロフィールを検索します。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| Result Set（結果セット） | 検索がFirst Matching RecordまたはAll Matching Recordsのどちらを返すかを選択します。 |
ドロップダウン |
TRUE |
検索結果は［Last Order ID（最終注文ID）］フィールドに関連付けられた日付順で表示されます。
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
顧客 |
|||
| First Name（名） |
顧客の名。 |
テキスト |
FALSE |
| Last Name（姓） |
顧客の姓。 |
テキスト |
FALSE |
| Email（メール） |
顧客のメールアドレス。 |
テキスト |
FALSE |
| Phone（電話） |
顧客の電話番号。 |
テキスト |
FALSE |
| State（状態） | 店舗における顧客アカウントの状態。オプションは以下のとおり。
|
ドロップダウン |
誤 |
| Accepts Marketing?（マーケティングに同意？） | メールでマーケティング資料を受け取ることに顧客が同意したかどうかを示します。 |
True/False |
FALSE |
| Tag（タグ） |
顧客に追加されたタグ。 |
テキスト |
FALSE |
| Verified Email?（確認されたメール？） | 顧客がメールアドレスを確認済みかどうかを示します。 |
True/False |
FALSE |
| Multipass Identifier（マルチパス識別子） |
マルチパスログインで使用される、顧客の一意な識別子。 |
テキスト |
FALSE |
|
Address（アドレス） |
|||
| First Name（名） |
顧客の名。 |
テキスト |
FALSE |
| Last Name（姓） |
顧客の姓。 |
テキスト |
FALSE |
| Company（会社） |
顧客の会社名。 |
テキスト |
FALSE |
| Address1（住所1） |
顧客住所の最初の行。 |
テキスト |
FALSE |
| Address2（住所2） |
顧客住所の2番目の行。 |
テキスト |
FALSE |
| City（市区町村） |
顧客の市。 |
テキスト |
FALSE |
| Province（都道府県） |
顧客の都道府県。 |
テキスト |
FALSE |
| Country（国） |
顧客の国。 |
テキスト |
FALSE |
|
カスタムフィルター |
|||
| Custom Filter（カスタムフィルター） | クエリ構文を使った、Shopifyプラットフォーム全体に適用されるカスタム検索フィルター。フィルターには接続語、用語、修飾子、比較演算子を使用できます。フィルターでは用語、フィールド値、ブール演算子、範囲、除外を使った検索も実行できます。
たとえば、「 query=-first_name:Bob AND orders_count:>1 orders_count:<=6」というクエリーは、これまでの注文数が6回以下（ただし1回より多い）で、Bobという名の顧客を検索します。 「Shopify APIの検索構文」を参照してください。 |
テキスト |
FALSE |
検索結果で返せるのは1ページあたり最大250レコード、および最大550ページです。
出力
| フィールド | 定義 | タイプ |
|---|---|---|
| ID |
顧客のグローバルな一意の識別子。 |
数値 |
| Email（メール） |
顧客のメールアドレス。 |
テキスト |
| Created At（作成日時） |
オブジェクトが作成された日時。 |
日時 |
| Updated At（最終更新日） |
顧客プロファイルが最後に更新された日時。 |
日時 |
| First Name（名） |
顧客の名。 |
テキスト |
| Last Name（姓） |
顧客の姓。 |
テキスト |
| Orders Count（注文数） |
顧客がこれまでにストアで注文した回数。 |
数値 |
| State（状態） | 店舗における顧客アカウントの状態。オプションは以下のとおり。
|
テキスト |
| Total Spent（合計支出） |
顧客がこれまでに注文に支払った合計金額。 |
テキスト |
| Last Order ID（最終注文ID） |
顧客が最後に行った注文のグローバルな一意の識別子。 |
数値 |
| Note（注） |
顧客に関するメモ。 |
テキスト |
| Verified Email?（確認されたメール？） | 顧客がメールアドレスを確認済みかどうかを示します。 |
True/False |
| Multipass Identifier（マルチパス識別子） |
マルチパスログインで使用される、顧客の一意な識別子。 |
テキスト |
| Tax Exempt?（非課税？） | 顧客からの注文が非課税かどうかを示します。 |
True/False |
| 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?（デフォルト？） | この住所が、顧客のデフォルト住所かどうかを示します。 |
True/False |
| 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?（デフォルト？） | この住所が、顧客のデフォルト住所かどうかを示します。 |
True/False |
|
Email Marketing Consent（メールマーケティング同意） |
||
| State（状態） |
顧客の現在のメールマーケティング状態。 |
テキスト |
| Opt In Level（オプトインレベル） | 「M3AAWG送信者の共通ベストプラクティス」で説明されているマーケティングサブスクリプションのオプトインレベル。メールによるマーケティング資料の受け取りに顧客が同意したレベル。 |
テキスト |
| Updated At（更新日時） | メールによるマーケティング資料の受け取りに顧客が同意した日時。値を指定しない場合、顧客情報が送信された日時が使用されます。 |
日時 |
|
SMS Marketing Consent（SMSマーケティング同意） |
||
|
State（状態） |
顧客の現在のSMSマーケティング状態。 |
テキスト |
| Opt In Level（オプトインレベル） | 「M3AAWG送信者の共通ベストプラクティス」で説明されているマーケティングサブスクリプションのオプトインレベル。マーケティング情報の受け取りに顧客が同意した時点で設定されます。 |
テキスト |
| Updated At（更新日時） | SMSによるマーケティング資料の受け取りに顧客が同意した日時。値を指定しない場合、顧客情報が送信された日時が使用されます。 |
日時 |
| Collected From（収集元） |
顧客のマーケティング情報が収集されたソース。 |
テキスト |