TROCCO®のHTTPコネクタでBASEの注文データを取得する方法

Last updated at 2024-08-07Posted at 2024-08-07

はじめに

BASEは、誰でも簡単にECサイトを開設できるサービスです。
ECサイトを運営していこうとすると、顧客の注文状況を踏まえて、顧客のニーズを的確に理解しながら販売戦略を練る必要があります。

このとき、サービスにあるダッシュボードを見ながら現状を把握するのは重要ですが、データを自由に取り扱ってもう少し深く分析してみたいと思う人もいるはずです。
このときBASEでは、BASE APIを活用することで、注文データを外部に取得することができます。

今回の記事では、TROCCO®のHTTP(・HTTPS)コネクタでBASEの注文データを取得する方法を紹介します。

対象とする読者

BASEの注文データを活用して、ECサイトの運営に活かしたい方
データを取得するにあたって、TROCCO®の活用を検討している方

そもそもHTTPとは？

「HTTPって何？」という読者の方もいると思うので、簡単な用語解説を行いたいと思います。

HTTPとはWebブラウザ上でリクエストを投げると、取りたい情報が返ってくる仕組みです。
TROCCO®には転送元のコネクタの1つとしてHTTP（・HTTPS）が存在し、TROCCO®でデータを取得することができます。

引用元: 『HTTPとは？HTTPSとの違いをサイト移行で実施するリダイレクト設定などをもとに解説』アイティーエムHPより

事前準備

TROCCO®アカウントの作成

まずはTROCCO®のアカウント作成から始めましょう。
TROCCO®では無料で利用開始できるフリープランがあります。

BASEアカウントと注文データの準備

本記事ではBASEのアカウント上に注文データ（orders）のデータがあることを前提としています。

BASE APIの認証設定

次にBASEから注文データをとるために、BASE APIの認証設定を行います。

API(Application Programing Interface)という用語がわからない方は、こちらの記事などを参考にしてください。

認証設定には以下2つのステップで行なっていきます。

BASE DevelopersからBASE APIの利用申請
TROCCO®でのOAuth2.0の設定

なお、今回APIの認証方法として、OAuth2.0という方式を採用します。

OAuth2.0とは、ユーザーが直接情報を入力することなく、WEBサーバーが間接的に発行したユーザー情報を認証する方法になります。
そのため、セキュリティ的に優れた認証・認可の仕組みになります。

OAuth2.0の詳しい仕組みを知りたい方は、Google Cloud OAuth2.0の概要などを参照してください。

BASE DevelopersからBASE APIの利用申請

BASE APIの利用には、BASE Developersサイトでの申請が必要です。

申請をするにあたり、BASEの「ショップ設定>運営に関する情報」で電話番号が認証されている必要があります。お済みでない方は認証をお願いします。

では実際の申請に移っていきます。
トップページ左下の「申請する」ボタンを押下します。

画面遷移後、今回利用するTROCCO®の情報を記載していきます。
利用権限には「注文情報を見る」にチェックを入れます。

コールバックURLは、TROCCO®側で認証できるような設定にする必要があります。
TROCCO®ヘルプセンター「HTTP・HTTPSの接続情報」のクライアントアプリ設定情報に記載の通りで設定します。

https://trocco.io/connections/http/callback

最後に、開発者情報に住所等の個人情報を記載し、「申請する」ボタンを押下します。

申請後、次のステップ以降で使うclient_idとclient　secretが記載されてるのを確認し、申請終了となります。

TROCCO®でのOAuth2.0の設定

次に作成したBASE APIで申請した情報を元に、TROCCO®でBASE APIの認証設定を行なっていきます。

まず、TROCCO®のホーム画面の「接続情報一覧」から「接続情報の新規作成（サービスの選択）」を行い、「HTTP・HTTPS」を選択します。

「HTTP・HTTPS」選択後、「接続情報の作成・設定」画面に飛び、「作成したアプリ情報の入力へ」ボタンを押下します。
以前に設定した、「コールバックURL」はここからも確認ができます。

画面遷移後、BASE APIの認証情報を入力していきます。

TROCCO®ヘルプセンター「HTTP・HTTPSの接続情報」とBASE API公式「oauth/authorize」・「oauth/access_token」を参考に、以下の表のように設定します。

設定項目	内容
グラントタイプ	認可コード
クライアントID	`client_id`
クライアントシークレット	`client　secret`
認可URL	`https://api.thebase.in/1/oauth/authorize`
アクセストークンURL	`https://api.thebase.in/1/oauth/token`
スコープ	read_orders

認証に成功すると、BASE APIの事前準備は完了です。

転送設定の実装

最後にTROCCO®でデータを取得していきます。
今回の記事では、転送先にはデータウェアハウスのGoogle BigQueryを採用しました。

では、実際の転送設定に移っていきます。
TROCCO®にログインし、転送設定の新規作成に進み、以下を選択します。

転送元 HTTP・HTTPS
転送先 BigQuery

転送元の設定

初めに、「TROCCO®でのOAuth2.0の設定」の章で設定した「HTTP・HTTPS」接続情報を選択します。

カスタム変数機能についても設定を行います。
今回はBASE APIのパラメータで使用する、 $start_date$ と $end_date$ を設定します。
BASE APIの仕様に合わせて、日付フォーマットを%Y-%m-%dで設定します。

BASE API公式の「はじめに」と「orders」を参考に、TROCCO®で設定する際は以下表の通りとなります。
表にない項目はデフォルトの値で問題ありません。

設定項目名	設定内容
URL	`https://api.thebase.in/1/orders`
HTTPメソッド	GET
文字エンコーディング	UTF-8
ファイル入力形式	JSONPath
JSONPath	$.orders
パラメータ`start_ordered`	$start_date$
パラメータ`end_ordered`	$end_date$