Manufacturer Center(MfC)API を使用すると、アプリが Manufacturer Center プラットフォームと直接やり取りできます。簡単に始められるように、Java と .NET のコードサンプルが用意されています。
このガイドでは、Manufacturer Center API を使って最初のアプリケーションを作成する方法について説明します。コーディングを始める前に、行うべきことがいくつかあります。
REST のサポート
REST API は、次の 2 種類のリソースに対して基本的な CRUD オペレーションをサポートしています。
- ブランド オーナーとデータ パートナー向けのプロダクト。
- 認証機関向けの ProductCertification。
このドキュメントの残りの部分では主にプロダクトについて説明していますが、プロセスはProductCertificationの場合と同様です。
Manufacturer Center アカウントを設定する
Manufacturer Center アカウントを作成します。
この Manufacturer Center アカウントの作成に使用したメールアドレスは、後で必要になるため、覚えておいてください。スクリーンショットでは、manufacturer_user@example.com として表されています。
最初の API リクエストを行う(コードを 1 行も使用しない)
Accounts.Products.list
のデベロッパー向けドキュメントで API Explorer にアクセスしてください。ログインした Google アカウントが、[設定] タブの [ユーザー] 設定に表示されていることを確認します。
API Explorer の [Authentication] プルダウン メニューで [Google OAuth 2.0] が選択されていることを確認します。
フォームの [親] フィールドに「
accounts/{account_id}
」と入力し、{account_id}
を Manufacturer Center アカウントの Manufacturer ID に置き換えて、[実行] をクリックします。成功を示すレスポンスが表示されます。お疲れさまでした。これで最初の Manufacturer Center API リクエストが送信されました。
Manufacturer Center に商品がまだ追加されていない場合は、リストに表示されません。この時点で、他のリクエストに移動してその内容を確認できます。これは RESTful API であるため、すべてのリクエストも同じように機能します。商品を作成したら、
Accounts.Products.get
を試すことをおすすめします。
Google API Console プロジェクトを作成する
Manufacturer Center API へのリクエストは、API Console プロジェクトを通じて行われます。ここでは、ユーザーが自身の Manufacturer Center アカウントにアクセスしていることを想定しているため、サービス アカウントを使用して認証フローを簡素化することをおすすめします。Manufacturer Center アカウントで使用する新しいサービス アカウントの設定方法について詳しくは、サービス アカウントのガイドをご覧ください。
Java を使用した最初の承認済み API リクエスト
サービス アカウントを設定し、サービス アカウント ID を Manufacturer Center アカウントに追加したので、利用可能なサンプルコードを使用してアカウントにアクセスできます。このガイドでは、Java サンプルを使用して API の使用方法を説明します。
Apache Maven をインストールします(まだインストールしていない場合)。
GitHub ページからショッピング サンプルをダウンロードしてください。
java
サブディレクトリ内から、Java サンプルをビルドします。$ mvn compile
次に、コード
ProductsListSample
を実行します(ProductCertification の例はListProductCertificationsSample
です)。$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
ソースファイルに付属する README の構成指示に従わないと、サンプル構成が見つからないというエラーが表示されます。README の指示に沿って構成ディレクトリを作成し、適切な情報を入力します。サービス アカウントの設定時にダウンロードした JSON ファイルは、
service-account.json
というファイル名でそのディレクトリに配置されます。次の環境変数を設定して、ファイルの場所をコードに伝えます。export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
サンプル構成を設定したので、
ProductsListSample
コードを再度実行します。$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
この時点で Java プログラムの実行が終了し、検出された商品のリスト、またはアカウントに商品がないことを示すメッセージが出力されます。「ユーザーがアカウント 1234567890 にアクセスできません」などのエラーが発生した場合は、Manufacturer Center でサービス アカウント ユーザーを承認済みユーザーとして設定していない可能性があります。API の観点からは、API Console プロジェクトが、承認済みの Manufacturer Center 管理者のリストに登録されていないユーザーに代わってリクエストを送信するため、そのリクエストは当然拒否されます。
ProductsListSample
は読み取り専用リクエストであるため、必要に応じて何度でも実行できます。また、Java と .NET 用に作成した他のサンプルを確認することもできます。