ストアを移す Shopify のキー

このキーとは何か、なぜ自分で作るのか

Shopify は、他のサービスがあなたのストアを読めるようなパスワードを配ったりはしません。代わりに、あなたが自分のストアに小さなアプリを作り、何を読んでよいかを正確に指定します。すると Shopify がそのアプリにトークンを渡します。そのトークンを Omniterra に貼り付けると、こちらはそれを通してカタログを読みます。

ここから二つのことが導かれ、どちらもあなたに有利です。

• 何を見せるかはあなたが決めます。 こちらが得るのは、あなたがチェックした権限だけです。お願いするのは読み取り権限で、Shopify ストアに書き込むものは含みません。
• いつでも断ち切れます。 Shopify でアプリを削除すればトークンは即座に使えなくなります。誰にも通知は飛びません。

その間もあなたの Shopify ストアは動き続けます。こちらの作業がそれを変えることはありません。

手順 1 — アプリ設定を開く

Shopify 管理画面で 設定 → アプリと販売チャネル → アプリを開発 に進みます。

カスタムアプリの開発を許可 というボタンが出たら押してください。Shopify はストアごとに一度だけ確認し、ストアのオーナーだけが実行できます。

手順 2 — アプリを作る

アプリを作成 を押し、あとで見分けのつく名前を付けて——「Omniterra 移行」で十分です——確定します。

この時点でアプリは空です。まだ何も読めません。

手順 3 — 権限にチェックを入れる

設定 タブを開き、続いて Admin API 統合 → 編集 に進みます。

持っていきたいものすべてに読み取り権限を付けます。

保存 を押します。

Omniterra は同じ一覧をインポート画面にもコピーできる形で表示し、接続が不十分だった場合はどれがまだ足りないかを知らせます。

手順 4 — アプリをインストールしてトークンをコピーする

API 認証情報 タブへ行き、アプリをインストール を押します。

ここで Shopify が Admin API アクセストークン を表示します。`shpat_` で始まる文字列です。これをコピーしてください。

この部分はよく読んでください。Shopify はこのトークンを一度しか表示しません。 コピーせずにページを閉じると二度と見られず、新しいものを得るにはアプリをアンインストールして入れ直すしかありません。作業が消えるわけではありませんが、面倒な五分です。

手順 5 — Omniterra に貼り付ける

Omniterra の管理画面で 商品 → インポート / エクスポート を開き、Shopify を選び、ストアのアドレス（`my-store.myshopify.com`）を入力してトークンを貼り付けます。

接続 を押します。カタログを読み取り、何かを書き込む前に見つかったものを提示します——商品・顧客・注文・ページがそれぞれいくつあるか。あなたが言うまで何も動きません。

権限が足りないと表示されたら

これは驚かれることが多いので先に書いておきます。Shopify が報告するのは、アプリをインストールした時点で付与された権限であって、いま設定に書かれている内容ではありません。 インストール後にチェックを増やしても、アプリは以前の狭いままの権限を保持します。

直し方は入れ直しです。設定 → Admin API 統合 → 編集 で足りないものにチェックを入れ、保存し、API 認証情報 → アプリを再インストール。トークンは同じままです。

Dev Dashboard でアプリを作った場合

ストア管理画面ではなく `dev.shopify.com` で作られたアプリを持つストアもあります。考え方は同じで、細かい点が二つ増えます。

1. アプリ設定の `access_scopes` を編集して 保存 を押します。
2. リリース を押します。リリースしないかぎり変更は未公開バージョンのままで、ストアからは決して見えません。
3. 新しい権限が実際に付与されるよう、ストアにアプリを入れ直します。

何が移り、何が移せないか

商品とそのバリエーション、画像、コレクション、顧客、注文、割引、ページ、ブログ記事、メニュー、リダイレクト、ファイル——これらはすべて移ります。

移せないものもあり、それは始める前にお伝えします。終わってからではありません。ギフトカードのコード（Shopify は決して外に出しません）、保存済みのカード情報（これはストアではなく決済事業者のものです）、そしてインストール済みの外部アプリと、その内部に保持されているデータです。

届いた商品が思ったより少ないとき

ほとんどの場合、理由は三つのいずれかで、どれも取り込みが失敗したという意味ではありません。

下書きとアーカイブ済みの商品は、既定では残ります。 Shopify がそれらを有効なカタログから外しており、こちらも同じ扱いです。必要であれば、取り込みの前に Shopify で公開するか、持ってきてからこちらで下書きに戻してください。

価格のない商品やバリエーションのない商品は、そのままでは販売できないため飛ばされます。最後のレポートに名前付きで並ぶので、どれがなぜ飛ばされたのかがはっきり分かります。

インストール後に追加した権限は、アプリを入れ直すまで効きません。前述と同じ落とし穴です。入れ直してから、取り込み画面の「再確認」を押してください。すでに届いているものには触れずに、カタログをもう一度読み直します。

必要なら取り込みは二度走らせて構いません。商品は Shopify の識別子で突き合わせるので、二度目はすでにあるものを更新し、重複は作りません。

どれくらいかかるか

数百点の商品カタログなら、たいてい二分ほどで終わります。大きなストアは分割して進むので、ページを離れてかまいません——インポートは続き、戻ってきたときに進み具合を確認できます。