CartLineのviewKeyをレスポンスで読み取れるように

新フィールド

Storefront API の CartLine タイプに追加。id（UUID）と並んで返ってくる。クエリに明示的に追記する必要あり。

後方互換

id フィールドは従来どおり機能。viewKey を使わないアプリへの影響はゼロ。段階的移行が可能。

注意

これまで viewKey は cartLinesUpdate / cartLinesRemove の入力にのみ存在。今回のアップデートでクエリでも読めるようになった。

Liquid 連携

CartLine.viewKey は Liquid ストアフロントが描画する viewKey と同一の値を返す（元記事記載）。Liquid↔API 間の整合性が取れる。

クエリ例

query CartLines($cartId: ID!) {
  cart(id: $cartId) {
    lines(first: 10) {
      edges {
        node {
          id
          viewKey
        }
      }
    }
  }
}

ストレージ

viewKey はカートがすでに内部に保持している値を読むだけ。新たなストレージや処理コストは発生しない（元記事記載）。