公開連携
Shopify
最終更新日:
Client IDとClient SecretでShopifyアプリを作成し、ストアのブログをClodixに連携する手順をステップごとに解説します。
Clodixは、記事をShopifyストアのブログに直接公開します。Shopifyは既成のアクセスキーを発行しなくなったため、ご自身のShopify開発者アカウントで小さなアプリを作成し、その認証情報をClodixに渡します。Shopifyの審査は不要で、所要時間は約5分です。
アプリを作成する
- dev.shopify.com を開き、アプリを開く(または新規作成する)。
- アプリの設定で、次のように設定します。
- App URL を
https://www.clodix.aiにします。Shopifyではこの項目が必須ですが、ご自身のストアを指していてはいけません。 - Embed app in Shopify admin — オフ にします。
- Use legacy install flow — オフ にします。
- App URL を
- API access で Select scopes をクリックし、「content」で検索して、
read_contentとwrite_contentにチェックを入れます。Optional scopes は空のままにします。 - Shopifyでは、設定がバージョンとして保存されます。変更後は、新しいバージョンを作成して Release をクリック してください。それまでは古いバージョンが動き続けます。
ストアにインストールする
- Install app をクリックして、ストアを選択します。
- Shopifyの権限確認画面が表示されたら、Install をクリックします。
- 代わりにストアのホームページに戻されて何も起きない場合は、上のステップ4で作成した新しいバージョンがまだ Release されていません。戻って Release してください。
- アプリを開き、Credentials から Client ID と Client Secret をコピーします。
Clodixで連携する
- Settings → Publishing integrations を開き、Shopify をクリックします。
- 次の項目を入力します。
- Store URL — Shopifyへのログインに使うアドレスで、
mystore.myshopify.comのような形式です(わからない場合は、Shopifyの Settings → Domains で確認できます。ストアフロントのアドレスとは異なります)。 - Client ID と Client Secret — 先ほど作成したアプリのものです。
- Store URL — Shopifyへのログインに使うアドレスで、
- Connect to Shopify をクリックします。
公開された投稿の内容
- 記事は、ストアの最初のブログに、タイトル、本文、メタサマリー付きで作成され、すぐに公開されます。
- カバー画像は記事の画像として設定され、技術的な
.myshopify.comのアドレスではなく、サイト自体のドメインから取得されます。そのため、記事同士のリンクは本来のドメイン上に保たれます。 - 記事をあとで編集して再公開すると、同じShopifyの記事が更新されます。 Clodixが2つ目のコピーを作成することはありません。
- Unpublish を実行すると、Shopify上で記事が非公開(下書き)に戻ります。
よくある問題
Connect が失敗した場合は、フォームの下に表示されるメッセージで問題がわかります。以下から該当するものを探してください。
ストアフロントのアドレスを入力した
表示されるメッセージ: 「That is your storefront address — we need the admin one」または「Store URL should look like mystore.myshopify.com」
管理画面のアドレスではなく、ストアの公開ドメイン(例:mystore.com)を入力しています。.myshopify.com で終わるアドレスを使ってください。Shopifyの Settings → Domains で確認できます。
このアドレスにShopifyストアが存在しない
表示されるメッセージ: 「There is no Shopify store at …」
Store URLがどのストアも指していません。多くはタイプミスか、ストアフロントから推測した名前です。名前は管理画面のリンクから取得してください。admin.shopify.com/store/NAME は NAME.myshopify.com を意味します。
ShopifyがClient IDとClient Secretを受け付けない
表示されるメッセージ: 「Shopify does not accept this Client ID and Client Secret」
別のアプリのペアか、コピー後にシークレットが再生成されています。dev.shopify.comで同じアプリの Credentials を開き、両方の値をもう一度コピーしてください。
アプリがストアにインストールされていない
表示されるメッセージ: 「The app is not installed on … yet」
アプリは作成されていますが、ストアにインストールされていません。dev.shopify.comで Install app をクリックし、ストアを選んで、権限確認画面を完了してください。
Shopifyがアプリを見つけられない
表示されるメッセージ: 「Shopify cannot find this app」
開発者アカウントでアプリが削除されています。アプリを作り直し、ストアにインストールして、新しいClient IDとClient Secretで連携してください。
記事の公開が「applicationcannotbe_found」で失敗する場合は? 原因は同じで、あとから発覚したものです。Shopifyを連携したあとにアプリを削除または作り直したため、Clodixが保持しているキーがどこにも対応しなくなっています。記事は下書きのまま残ります。Manage → Disconnect を押し、アプリを作り直して、新しいキーで連携したあと、下書きの Publish を押してください。
アプリが別のShopifyアカウントに属している
表示されるメッセージ: 「This app belongs to a different Shopify account」
ストアを所有するアカウントとは別のShopifyアカウントでアプリが作成されています。ストアを所有するアカウントでdev.shopify.comにログインした状態で、アプリを作り直してください。
アプリにコンテンツの権限がない
表示されるメッセージ: 「The app is missing the content permissions」
アプリにブログコンテンツへのアクセス権がありません。アプリの API access → Select scopes で read_content と write_content にチェックを入れ、新しいバージョンを作成して Release をクリックしてください。
ストアにまだブログがない
表示されるメッセージ: 「This store has no blog yet」
公開先となるブログがありません。Shopifyの Content → Blog posts で作成してから、もう一度連携してください。
Shopifyが応答しなかった
表示されるメッセージ: 「Shopify did not answer — try again in a few minutes」
Shopifyが応答しませんでした。入力内容が原因ではありません。数分待ってから、もう一度 Connect を押してください。
Install後に、ドキュメント用の例のページが表示される
Installをクリックすると、「This domain is for use in documentation examples」というページが表示されます。問題ありません。これはプレースホルダーのApp URLで、アプリは インストールされています。dev.shopify.com → アプリ → Credentials に戻ってClient IDとClient Secretをコピーし、Clodixで連携してください。
アプリをインストールできない:配布方法が未設定
表示されるメッセージ: 「This app can't be installed yet — the developer needs to select a distribution method」
すでに閉鎖された古いインストール経路を使っています。このページの手順を最初から行ってください。Dev Dashboardでアプリを作成し、スコープを設定し、バージョンを Release してから、Install app を実行します。
Installするとストアのホームページに移動する
Installをクリックするとストアのホームページに移動し、何もインストールされません。アプリの設定が従来のインストールフローのままか、App URLがご自身のストアのアドレスになっています。アプリの Versions → Create version で Use legacy install flow をオフにし、App URLをストアフロントのアドレス以外に設定し(https://www.clodix.ai で動作します)、Release してから、もう一度 Install app をクリックしてください。
アプリはインストールしたのに、Clodixでまだ「Connect」と表示される
ストアにアプリをインストールするのは、承認にすぎません。連携自体はClodixで行います。dev.shopify.comでアプリを開き、Credentials から Client ID と Client Secret をコピーしたら、Clodixの Settings → Publishing integrations → Shopify で、.myshopify.com のアドレスと一緒に貼り付けてください。
Scopesフィールドが空になっている
新しいアプリには、最初はスコープがありません。アプリのバージョン設定で、Scopes に read_content,write_content を入力するか(カンマ区切り、スペースなし)、Select scopes で「content」を検索して両方にチェックを入れたあと、バージョンを Release して、もう一度インストールしてください。
FAQ
Clodixを使うのに、Shopifyの承認は必要ですか?
いいえ。アプリはご自身のShopify開発者アカウント内にあり、ご自身のストアにのみインストールされるため、Shopifyの審査ステップはありません。
以前のように、アクセストークンを貼り付けるだけにできないのはなぜですか?
Shopifyは、カスタムアプリ向けの事前発行アクセストークンを廃止しました。現在作成するClient ID / Client Secretのペアは、Clodixが公開するたびに自動で新しいトークンを発行します。連携後に、ご自身で触る必要はありません。
ストアのテーマやチェックアウトには影響しますか?
いいえ。アプリの権限はブログコンテンツの読み取りと書き込み(read_content、write_content)に限られており、商品、注文、テーマ、チェックアウトにはアクセスできません。