2月 21, 2026

AppSubscriptionDiscountInput.durationLimitInIntervalsが0を受け付けなくなります

2月 21, 2026

AppSubscriptionDiscountInput.durationLimitInIntervalsが0を許容しなくなる

Shopify開発者の皆様、Admin API 2024-01がリリースされると、AppSubscriptionDiscountInput.durationLimitInIntervalsは0を許容しなくなります。無制限の期間を持つ割引を作成する場合、durationLimitInIntervalsは指定しないでください。今回はこの変更内容を詳しく解説し、実装例を提供します。

技術的課題の定義と現状分析

Admin APIの2024-01バージョンからは、AppSubscriptionDiscountInput.durationLimitInIntervalsの値として0を設定することが許可されなくなります。現行のバージョンでは、durationLimitInIntervalsに0を指定することで割引が無制限に適用されるように設定できましたが、新たなバージョンではこれが変更されます。

具体的な技術的ソリューションの提案

無制限の期間を持つ割引を作成する場合、durationLimitInIntervalsは指定しないでください。もしdurationLimitInIntervalsを指定しなければ、Shopifyは自動的にそれを無制限の期間と解釈します。

実装手順とコード例

以下に具体的なコード例を示します。

mutation {
  appSubscriptionCreate(
    name: "Super Duper Plan"
    returnUrl: "http://super-duper.shopifyapps.com"
    test: true
    lineItems: [
      {
        plan: {
          appRecurringPricingDetails: {
            price: { amount: 10.0, currencyCode: USD }
            interval: EVERY_30_DAYS
            usagePricingDetails: {
              meteredFee: {
                price: { amount: 0.05, currencyCode: USD }
              }
              cappedPlan: { cap: { amount: 20.0, currencyCode: USD }, overagePrice: { amount: 0.10, currencyCode: USD } }
            }
          }
        }
      }
    ]
  ) {
    userErrors {
      field
      message
    }
    confirmationUrl
    appSubscription {
      id
    }
  }
}

上記のコードは割引の期間を指定せずにAppSubscriptionDiscountInputオブジェクトを作成する例です。このようにdurationLimitInIntervalsパラメータを省略することで、無制限期間の割引を作成できます。