【Shopify.dev和訳】Storefront API/Reference/Checktouts②
この記事について
この記事は、Storefront API/Reference/Checktoutsの記事を和訳したものです。
記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。
Checkout APIs (MUTATIONS)
MUTATIONS
checkoutAttributesUpdate
(mutation
)
allowPartialAddresses
がtrue
の場合、チェックアウトの属性を更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutAttributesUpdate($checkoutId: ID!, $input: CheckoutAttributesUpdateInput!) {
checkoutAttributesUpdate(checkoutId: $checkoutId, input: $input) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"input": {}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
input ( CheckoutAttributesUpdateInput! ) required
|
チェックアウトの属性を更新するために使用されるフィールド。 |
CheckoutAttributesUpdateInput fields
allowPartialAddresses
(Boolean
)
属性の完全な検証をスキップして、チェックアウトで部分的なアドレスを設定できます。必要な属性は、都市、州、および国です。アドレスの完全な検証は、完了時に引き続き実行されます。各操作のデフォルトはfalse
です。
customAttributes
([AttributeInput!]
)
チェックアウトに追加される追加情報のリスト。
note
(String
)
ショップのオーナーがチェックアウトに添付できるオプションのメモのテキスト。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutAttributesUpdateV2
(mutation
)
allowPartialAddresses
がtrue
の場合、チェックアウトの属性を更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutAttributesUpdateV2($checkoutId: ID!, $input: CheckoutAttributesUpdateV2Input!) {
checkoutAttributesUpdateV2(checkoutId: $checkoutId, input: $input) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"input": {}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
input ( CheckoutAttributesUpdateV2Input! ) required
|
更新するチェックアウト属性。 |
CheckoutAttributesUpdateV2Input fields
allowPartialAddresses
(Boolean
)
属性の完全な検証をスキップして、チェックアウトで部分的なアドレスを設定できます。 必要な属性は、都市、州、および国です。アドレスの完全な検証は、完了時に引き続き実行されます。各操作のデフォルトはfalse
です。
customAttributes
([AttributeInput!]
)
チェックアウトに追加される追加情報のリスト。
note
(String
)
ショップのオーナーがチェックアウトに添付できるオプションのメモのテキスト。
Return fields
checkout
(Checkout
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCompleteFree
(mutation
)
支払い情報を提供せずにチェックアウトを完了します。この mutation は、無料のアイテムまたは購入価格がギフトカードでカバーされているアイテムに使用できます。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCompleteFree($checkoutId: ID!) {
checkoutCompleteFree(checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCompleteWithCreditCard
(mutation
)
Shopify の Vault のクレジットカードトークンを使用してチェックアウトを完了します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCompleteWithCreditCard($checkoutId: ID!, $payment: CreditCardPaymentInput!) {
checkoutCompleteWithCreditCard(checkoutId: $checkoutId, payment: $payment) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
payment {
id
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"payment": {
"amount": "placeholder",
"idempotencyKey": "placeholder",
"billingAddress": {},
"vaultId": "placeholder"
}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
payment ( CreditCardPaymentInput! ) required
|
支払いとして適用するクレジットカード情報。 |
CreditCardPaymentInput fields
amount
(Money!
) required
お支払い金額。
billingAddress
(MailingAddressInput!
) required
支払いの請求先住所。
idempotencyKey
(String!
) required
重複請求を回避するために使用される、クライアントが生成した一意のキー。重複した支払いが見つかった場合、新しい支払いを作成する代わりに元の支払いが返されます。詳細については、べき等リクエストを参照してください。
test
(Boolean
)
可能であれば、テストモードで支払いを実行します。デフォルトはfalse
。
vaultId
(String!
) required
Shopify の Card Vault から返された ID。
Return fields
checkout
(Checkout!
)
支払いが適用されたチェックアウト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
payment
(Payment
)
試みられた支払いの表現。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCompleteWithTokenizedPayment
(mutation
)
トークン化された支払いでチェックアウトを完了します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCompleteWithTokenizedPayment($checkoutId: ID!, $payment: TokenizedPaymentInput!) {
checkoutCompleteWithTokenizedPayment(checkoutId: $checkoutId, payment: $payment) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
payment {
id
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"payment": {
"amount": "placeholder",
"idempotencyKey": "placeholder",
"billingAddress": {},
"type": "placeholder",
"paymentData": "placeholder"
}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
payment ( TokenizedPaymentInput! ) required
|
トークン化された支払いとして適用する情報。 |
TokenizedPaymentInput fields
amount
(Money!
) required
お支払い金額。
billingAddress
(MailingAddressInput!
) required
支払いの請求先住所。
idempotencyKey
(String!
) required
重複請求を回避するために使用される、クライアントが生成した一意のキー。重複した支払いが見つかった場合、新しい支払いを作成する代わりに元の支払いが返されます。詳細については、べき等リクエストを参照してください。
identifier
(String
)
AndroidPay の支払いにのみ使用されるパブリックハッシュキー。
paymentData
(String!
) required
トークン化された支払いに必要な支払いデータを含む単純な文字列または JSON。
test
(Boolean
)
可能であれば、テストモードで支払いを実行します。デフォルトはfalse
。
type
(String!
) required
支払いトークンのタイプ。
Return fields
checkout
(Checkout!
)
支払いが適用されたチェックアウト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
payment
(Payment
)
試みられた支払いの表現。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCompleteWithTokenizedPaymentV2
(mutation
)
トークン化された支払いでチェックアウトを完了します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCompleteWithTokenizedPaymentV2($checkoutId: ID!, $payment: TokenizedPaymentInputV2!) {
checkoutCompleteWithTokenizedPaymentV2(
checkoutId: $checkoutId
payment: $payment
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
payment {
id
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"payment": {
"paymentAmount": {
"amount": "placeholder",
"currencyCode": "placeholder"
},
"idempotencyKey": "placeholder",
"billingAddress": {},
"paymentData": "placeholder",
"type": "placeholder"
}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
payment ( TokenizedPaymentInputV2! ) required
|
トークン化された支払いとして適用する情報。 |
TokenizedPaymentInputV2 fields
billingAddress
(MailingAddressInput!
) required
支払いの請求先住所。
idempotencyKey
(String!
) required
重複請求を回避するために使用される、クライアントが生成した一意のキー。重複した支払いが見つかった場合、新しい支払いを作成する代わりに元の支払いが返されます。詳細については、べき等リクエストを参照してください。
identifier
(String
)
AndroidPay の支払いにのみ使用されるパブリックハッシュキー。
paymentAmount
(MoneyInput!
) required
支払いの金額と通貨。
paymentData
(String!
) required
トークン化された支払いに必要な支払いデータを含む単純な文字列または JSON。
test
(Boolean
)
可能であれば、テストモードで支払いを実行します。デフォルトはfalse
。
type
(String!
) required
支払いトークンのタイプ。
Return fields
checkout
(Checkout!
)
支払いが適用されたチェックアウト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
payment
(Payment
)
試みられた支払いの表現。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCompleteWithTokenizedPaymentV3
(mutation
)
トークン化された支払いでチェックアウトを完了します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCompleteWithTokenizedPaymentV3($checkoutId: ID!, $payment: TokenizedPaymentInputV3!) {
checkoutCompleteWithTokenizedPaymentV3(
checkoutId: $checkoutId
payment: $payment
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
payment {
id
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"payment": {
"paymentAmount": {
"amount": "placeholder",
"currencyCode": "placeholder"
},
"idempotencyKey": "placeholder",
"billingAddress": {},
"paymentData": "placeholder",
"type": "placeholder"
}
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
payment ( TokenizedPaymentInputV3! ) required
|
トークン化された支払いとして適用する情報。 |
TokenizedPaymentInputV2 fields
billingAddress
(MailingAddressInput!
) required
支払いの請求先住所。
idempotencyKey
(String!
) required
重複請求を回避するために使用される、クライアントが生成した一意のキー。重複した支払いが見つかった場合、新しい支払いを作成する代わりに元の支払いが返されます。詳細については、べき等リクエストを参照してください。
identifier
(String
)
AndroidPay の支払いにのみ使用されるパブリックハッシュキー。
paymentAmount
(MoneyInput!
) required
支払いの金額と通貨。
paymentData
(String!
) required
トークン化された支払いに必要な支払いデータを含む単純な文字列または JSON。
test
(Boolean
)
可能であれば、テストモードで支払いを実行します。デフォルトはfalse
。
type
(PaymentTokenType!
) required
支払いトークンのタイプ。
Return fields
checkout
(Checkout!
)
支払いが適用されたチェックアウト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
payment
(Payment
)
試みられた支払いの表現。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCreate
(mutation
)
新しいチェックアウトを作成します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCreate($input: CheckoutCreateInput!) {
checkoutCreate(input: $input) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
queueToken
}
}
変数
{
"input": {}
}
引数
引数 | 説明 |
---|---|
input ( CheckoutCreateInput! ) required
|
チェックアウトの作成に使用されるフィールド。 |
queueToken ( String ) |
チェックアウトキュートークン。一部の店舗でのみご利用いただけます。 |
CheckoutCreateInput fields
allowPartialAddresses
(Boolean
)
属性の完全な検証をスキップして、チェックアウトで部分的なアドレスを設定できます。必要な属性は、都市、州、および国です。アドレスの完全な検証は、完了時に引き続き実行されます。デフォルトはnull
です。
buyerIdentity
(CheckoutBuyerIdentityInput
)
チェックアウトに関連付けられた顧客の ID。
customAttributes
([AttributeInput!]
)
チェックアウトに追加される追加情報のリスト。
email
(String
)
顧客がチェックアウトしたい電子メール。
lineItems
([CheckoutLineItemInput!]
)
ラインアイテムオブジェクトのリスト。各オブジェクトには、チェックアウトのアイテムに関する情報が含まれています。
note
(String
)
ショップのオーナーがチェックアウトに添付できるオプションのメモのテキスト。
presentmentCurrencyCode
(CurrencyCode
)
ショップで有効になっている提示通貨の 1 つの 3 文字の通貨コード。このフィールドを含めると、指定した通貨でチェックアウトが作成されます。デフォルトでは、新しいチェックアウトはショップの主要通貨で作成されます。この引数は非推奨です。代わりにcountry
フィールドを使用してください。
shippingAddress
(MailingAddressInput
)
広告申込情報の配送先住所。
Return fields
checkout
(Checkout
)
新しいチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
queueToken
(String
)
チェックアウトキュートークン。一部の店舗でのみご利用いただけます。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCustomerAssociate
(mutation
)
顧客をチェックアウトに関連付けます。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCustomerAssociate($checkoutId: ID!, $customerAccessToken: String!) {
checkoutCustomerAssociate(
checkoutId: $checkoutId
customerAccessToken: $customerAccessToken
) {
checkout {
id
}
customer {
id
}
userErrors {
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"customerAccessToken": "ae0f1d2e179c9571122a0595a6ac8125"
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
customerAccessToken ( String! ) required
|
関連付ける顧客の顧客アクセストークン。 |
Return fields
checkout
(Checkout
)
更新されたチェックアウトオブジェクト。
customer
(Customer
)
関連する顧客オブジェクト。
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
checkoutCustomerAssociateV2
(mutation
)
顧客をチェックアウトに関連付けます。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCustomerAssociateV2($checkoutId: ID!, $customerAccessToken: String!) {
checkoutCustomerAssociateV2(
checkoutId: $checkoutId
customerAccessToken: $customerAccessToken
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
customer {
id
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"customerAccessToken": "ae0f1d2e179c9571122a0595a6ac8125"
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
customerAccessToken ( String! ) required
|
関連付ける顧客の顧客アクセストークン。 |
Return fields
checkout
(Checkout
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
customer
(Customer
)
関連する顧客オブジェクト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCustomerDisassociate
(mutation
)
現在のチェックアウト顧客とチェックアウトの関連付けを解除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCustomerDisassociate($checkoutId: ID!) {
checkoutCustomerDisassociate(checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutCustomerDisassociateV2
(mutation
)
現在のチェックアウト顧客とチェックアウトの関連付けを解除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutCustomerDisassociateV2($checkoutId: ID!) {
checkoutCustomerDisassociateV2(checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutDiscountCodeApply
(mutation
)
割引コードを使用して、既存のチェックアウトに割引を適用します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutDiscountCodeApply($discountCode: String!, $checkoutId: ID!) {
checkoutDiscountCodeApply(discountCode: $discountCode, checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"discountCode": "placeholder",
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
discountCode ( String! ) required
|
チェックアウトに適用する割引コード。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutDiscountCodeApplyV2
(mutation
)
割引コードを使用して、既存のチェックアウトに割引を適用します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutDiscountCodeApplyV2($discountCode: String!, $checkoutId: ID!) {
checkoutDiscountCodeApplyV2(
discountCode: $discountCode
checkoutId: $checkoutId
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"discountCode": "placeholder",
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
discountCode ( String! ) required
|
チェックアウトに適用する割引コード。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutDiscountCodeRemove
(mutation
)
適用された割引を既存のチェックアウトから削除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutDiscountCodeRemove($checkoutId: ID!) {
checkoutDiscountCodeRemove(checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutEmailUpdate
(mutation
)
既存のチェックアウトの電子メールを更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutEmailUpdate($checkoutId: ID!, $email: String!) {
checkoutEmailUpdate(checkoutId: $checkoutId, email: $email) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"email": "user@example.com"
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
email ( String! ) |
チェックアウトを更新するための電子メール。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutEmailUpdateV2
(mutation
)
既存のチェックアウトの電子メールを更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutEmailUpdateV2($checkoutId: ID!, $email: String!) {
checkoutEmailUpdateV2(checkoutId: $checkoutId, email: $email) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"email": "user@example.com"
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
email ( String! ) |
チェックアウトを更新するための電子メール。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutGiftCardApply
(mutation
)
ギフトカードコードを使用して、既存のチェックアウトにギフトカードを適用します。これにより、現在適用されているすべてのギフトカードが置き換えられます。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutGiftCardApply($giftCardCode: String!, $checkoutId: ID!) {
checkoutGiftCardApply(giftCardCode: $giftCardCode, checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"giftCardCode": "placeholder",
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
giftCardCode ( String! ) |
チェックアウト時に適用するギフトカードのコード。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutGiftCardRemove
(mutation
)
適用されたギフトカードをチェックアウトから削除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutGiftCardRemove($appliedGiftCardId: ID!, $checkoutId: ID!) {
checkoutGiftCardRemove(
appliedGiftCardId: $appliedGiftCardId
checkoutId: $checkoutId
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"appliedGiftCardId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
appliedGiftCardId ( ID! ) required
|
チェックアウトから削除する適用済みギフトカードの ID。 |
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutGiftCardRemoveV2
(mutation
)
適用されたギフトカードをチェックアウトから削除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutGiftCardRemoveV2($appliedGiftCardId: ID!, $checkoutId: ID!) {
checkoutGiftCardRemoveV2(
appliedGiftCardId: $appliedGiftCardId
checkoutId: $checkoutId
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"appliedGiftCardId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
appliedGiftCardId ( ID! ) required
|
チェックアウトから削除する適用済みギフトカードの ID。 |
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutGiftCardsAppend
(mutation
)
既存のチェックアウトにギフトカードを追加します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutGiftCardsAppend($giftCardCodes: [String!]!, $checkoutId: ID!) {
checkoutGiftCardsAppend(giftCardCodes: $giftCardCodes, checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"giftCardCodes": ["placeholder"],
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
giftCardCodes ( [String!]! ) required
|
チェックアウトに追加するギフトカードコードのリスト。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutLineItemsAdd
(mutation
)
ラインアイテムのリストをチェックアウトに追加します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutLineItemsAdd($lineItems: [CheckoutLineItemInput!]!, $checkoutId: ID!) {
checkoutLineItemsAdd(lineItems: $lineItems, checkoutId: $checkoutId) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"lineItems": [
{
"quantity": 1,
"variantId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
],
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
lineItems ( [CheckoutLineItemInput!]! ) required
|
チェックアウトに追加するラインアイテムオブジェクトのリスト。 |
CheckoutLineItemInput fields
customAttributes
([AttributeInput!]
)
ラインアイテムに関する Key-Value ペアの配列形式の追加情報。
quantity
(Int!
) required
広告申込情報の数量。
variantId
(ID!
) required
ラインアイテムの製品バリアントの識別子。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutLineItemsRemove
(mutation
)
既存のチェックアウトからラインアイテムを削除します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutLineItemsRemove($checkoutId: ID!, $lineItemIds: [ID!]!) {
checkoutLineItemsRemove(checkoutId: $checkoutId, lineItemIds: $lineItemIds) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"lineItemIds": ["Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="]
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
lineItemIds ( [ID!]! ) required
|
削除するラインアイテム ID。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutLineItemsReplace
(mutation
)
ラインアイテムのリストをチェックアウトに設定します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutLineItemsReplace($lineItems: [CheckoutLineItemInput!]!, $checkoutId: ID!) {
checkoutLineItemsReplace(lineItems: $lineItems, checkoutId: $checkoutId) {
checkout {
id
}
userErrors {
code
field
message
}
}
}
変数
{
"lineItems": [
{
"quantity": 1,
"variantId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
],
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
lineItemIds ( [CheckoutLineItemInput!]! ) required
|
チェックアウト時に設定するラインアイテムオブジェクトのリスト。 |
CheckoutLineItemInput fields
customAttributes
([AttributeInput!]
)
ラインアイテムに関する Key-Value ペアの配列形式の追加情報。
quantity
(Int!
) required
広告申込情報の数量。
variantId
(ID!
) required
ラインアイテムの製品バリアントの識別子。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
checkoutLineItemsUpdate
(mutation
)
チェックアウト時にラインアイテムを更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutLineItemsUpdate($checkoutId: ID!, $lineItems: [CheckoutLineItemUpdateInput!]!) {
checkoutLineItemsUpdate(checkoutId: $checkoutId, lineItems: $lineItems) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"lineItems": [{}]
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
広告申込情報を更新するチェックアウト。 |
lineItemIds ( [CheckoutLineItemUpdateInput!]! ) required
|
更新するラインアイテム。 |
CheckoutLineItemInput fields
customAttributes
([AttributeInput!]
)
ラインアイテムに関する Key-Value ペアの配列形式の追加情報。
id
(ID
) required
広告申込情報の識別子。
quantity
(Int
) required
広告申込情報の数量。
variantId
(ID!
) required
広告申込情報のバリアント ID。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutShippingAddressUpdate
(mutation
)
既存のチェックアウトの配送先住所を更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutShippingAddressUpdate($shippingAddress: MailingAddressInput!, $checkoutId: ID!) {
checkoutShippingAddressUpdate(
shippingAddress: $shippingAddress
checkoutId: $checkoutId
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"shippingAddress": {},
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
shippingAddress ( MailingAddressInput! ) required
|
広告申込情報の配送先住所。 |
MailingAddressInput fields
address1
(String
)
アドレスの最初の行。通常、住所または私書箱番号。
address2
(String
)
アドレスの 2 行目。通常、アパート、スイート、またはユニットの番号。
city
(String
)
都市、地区、村、または町の名前。
company
(String
)
顧客の会社または組織の名前。
country
(String
)
国の名前。
firstName
(String
)
顧客の名。
lastName
(String
)
顧客の姓。
phone
(String
)
顧客の一意の電話番号。
E.164 標準を使用してフォーマットされています。たとえば、+ 16135551111 です。
province
(String
)
州、州、地区など、住所の地域。
zip
(String
)
住所の郵便番号。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutShippingAddressUpdateV2
(mutation
)
既存のチェックアウトの配送先住所を更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutShippingAddressUpdateV2($shippingAddress: MailingAddressInput!, $checkoutId: ID!) {
checkoutShippingAddressUpdateV2(
shippingAddress: $shippingAddress
checkoutId: $checkoutId
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"shippingAddress": {},
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE="
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
shippingAddress ( MailingAddressInput! ) required
|
広告申込情報の配送先住所。 |
MailingAddressInput fields
address1
(String
)
アドレスの最初の行。通常、住所または私書箱番号。
address2
(String
)
アドレスの 2 行目。通常、アパート、スイート、またはユニットの番号。
city
(String
)
都市、地区、村、または町の名前。
company
(String
)
顧客の会社または組織の名前。
country
(String
)
国の名前。
firstName
(String
)
顧客の名。
lastName
(String
)
顧客の姓。
phone
(String
)
顧客の一意の電話番号。
E.164 標準を使用してフォーマットされています。たとえば、+ 16135551111 です。
province
(String
)
州、州、地区など、住所の地域。
zip
(String
)
住所の郵便番号。
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
checkoutShippingLineUpdate
(mutation
)
既存のチェックアウトの出荷ラインを更新します。
このパートで
Interactive の例
これは mutation クエリの例です。以下の埋め込みインタラクティブツールを使用して、クエリを編集します。
ヒント:フィールドの自動入力にはCtrl
+Space
を使用してください。
mutation checkoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: String!) {
checkoutShippingLineUpdate(
checkoutId: $checkoutId
shippingRateHandle: $shippingRateHandle
) {
checkout {
id
}
checkoutUserErrors {
code
field
message
}
}
}
変数
{
"checkoutId": "Z2lkOi8vU2hvcGlmeS9FeGFtcGxlLzE=",
"shippingRateHandle": "placeholder"
}
引数
引数 | 説明 |
---|---|
checkoutId ( ID! ) required
|
チェックアウトの ID。 |
shippingRateHandle ( String! ) required
|
Checkout の配送プロバイダー、価格、およびタイトルの組み合わせに対する一意の識別子。これにより、顧客はavailableShippingRates を選択できます。 |
Return fields
checkout
(Checkout!
)
更新されたチェックアウトオブジェクト。
checkoutUserErrors
([CheckoutUserError!]!
)
mutation の実行によって発生したエラーのリスト。
Deprecated return fields
-
userErrors
([UserError!]!
)
mutation の実行によって発生したエラーのリスト。
非推奨の警告
代わりにcheckoutUserErrors
を使用してください
:::
Discussion