# Shopify コネクター

Shopify (opens new window) は、在庫から POS、配送、および返品に至るまで注文を管理できる e コマースプラットフォームです。

# API バージョン

このコネクターは、Shopify Admin API (opens new window) バージョン 2021-10 を使用します。API (およびその他サービス) の提供状況は、Shopifyのステータス (opens new window)ページから確認できます。

Shopify での API バージョンアップグレードの処理方法

一般に、Shopify の新規バージョンは3か月ごとにリリースされ、各リリースバージョンは最大12か月間保守されます。つまり、常に4つの安定バージョンがサポートされていることになります。

リリースされたバージョンが1年の期限を過ぎると、Shopify はそのバージョンの保守を終了し、当該バージョンをリクエストする API 呼び出しはすべて、現在サポートされている 最も古い安定バージョンに自動的に転送されます。

たとえば、現在利用可能な安定バージョンが 2021-012021-042021-072021-10 である場合、2020-04 バージョンをリクエストする API 呼び出しは Shopify によって自動的に 2021-01 バージョンに転送されます。

詳細については、Shopify の API バージョン管理 (opens new window)ページを確認してください。

# Workato での Shopify への接続方法

Workato を Shopify に接続するには、以下の表に示す項目を指定する必要があります。選択する認証タイプによっては、入力項目が追加される場合もあります。それらの項目については個々のセクションで詳しく説明します。

項目 説明
Connection name このコネクションに対して、接続先の Shopify インスタンスを識別する一意の名前を付けます。
Location コネクションを保管するプロジェクト内の場所を指定します。
Authentication type Workato は現在、(a) OAuth 2.0または (b) アクセストークンをサポートしています。
Shop Name ショップの名前です。たとえば、shopname.myshopify.com/admin のようになります。

現在、Shopify に接続する方法は OAuth2.0アクセストークンの2つがあります。

# OAuth 2.0

ユーザー独自の OAuth アプリを用意することによって OAuth 2.0認証を実行できます。

項目 説明
API key ユーザー独自の OAuth アプリを使用して接続するための API キー。ユーザー独自の OAuth アプリを使用して接続する場合に必要です。
API secret key ユーザー独自の OAuth アプリを使用して接続するための API シークレットキー。ユーザー独自の OAuth アプリを使用して接続する場合に必要です。
[オプション] Requested permissions (OAuth scopes) このコネクションに求める権限

ユーザー独自の OAuth アプリを作成するには、Shopify パートナーアカウントが必要です。以下の手順を実行して、必要なクライアント ID とクライアントシークレットを確認してください。

  1. パートナーアカウント (opens new window)にログインします。アカウントがない場合は、同じリンクから登録できます。
  2. 左のナビゲーションで [Apps] をクリックし、[Create app] をクリックします。
  3. [Create app manually] をクリックし、アプリの名前を指定します。最後に [Create] をクリックします。
  4. API キーと API シークレットキーを含むアプリのダッシュボードにリダイレクトされます。これらの項目を Workato のコネクション設定ページで入力してください。
  5. 左のナビゲーションで [App setup] オプションをクリックします。[App URL] フィールドに https://www.workato.com、[Allowed redirection URL(s)] フィールドに https://www.workato.com/oauth/callback と入力します。

詳しくは、OAuth アプリについて Shopify のドキュメント (opens new window)を参照してください。

# 要求されるスコープ

デフォルトでは、Shopify へのコネクションを設定する際、Workato は以下のスコープを要求します。

  • read_customers
  • write_customers
  • read_inventory
  • write_inventory
  • read_products
  • write_products
  • read_orders
  • write_orders

上記に加えて、以下の追加のスコープへのアクセスを Workato に許可するよう選択することもできます。

  • write_reports
  • read_reports
  • write_payment_terms
  • read_payment_terms
  • read_product_listings

# アクセストークン

アクセストークンを使用して Shopify に接続するには、カスタムアプリを作成する必要があります。OAuth 2.0認証タイプとは異なり、カスタムアプリの設定ページで権限/スコープを定義する必要があります。

項目 説明
Access token カスタムアプリをインストールする際に提供されるアクセストークン。トークンを確認できるのは Shopify と Workato の両方で一度限りなので、トークンは安全な場所に記録しておいてください。

カスタムアプリを作成して必要なアクセストークンを確認するには、以下の手順を実行します。

  1. Shopify にログインし、[App and sales channel settings] に移動します。
  2. [Develop apps for your store] > [Create an app] の順にクリックします。
  3. アプリに名前を付け、[Create an app] をクリックして確認します。
  4. アプリのダッシュボードにリダイレクトされます。[Overview] タブの [Configure Admin API scopes] をクリックし、必要なスコープを選択します。スコープはインストール後でも編集可能です。

    TIP

    Workato を Shopify に正しく接続するには、アプリに少なくとも read_products 権限スコープを設定してください。 推奨されるスコープのセットは以下のとおりです。

    • read_customers
    • write_customers
    • read_inventory
    • write_inventory
    • read_products
    • write_products
    • read_orders
    • write_orders
  5. [Save] をクリックし、右上隅の [Install App] をクリックします。
  6. アプリがインストールされると、アクセストークンを取得するオプションが表示されます。アクセストークンを表示してコピーします。トークンを確認できるのは Shopify と Workato の両方で一度限りなので、トークンは安全な場所に記録しておいてください。
  7. アクセストークンを Workato のコネクション設定ページで入力してください。

詳しくは、カスタムアプリについて Shopify のドキュメント (opens new window)を参照してください。

# 次のステップ

使用可能なトリガーとアクションを確認します。

# トリガー

# アクション


Last updated: 2023/8/31 1:07:14