始める

Manufacturer Center(MfC)API を使用すると、アプリで Manufacturer Center プラットフォームを直接操作できます。すぐに始められるように、Java と .NET でコードサンプルが用意されています。

このガイドは、Manufacturer Center API を使用して最初のアプリケーションを作成する際に役立ちます。コーディングを開始する前に、行うべきことがいくつかあります。

REST サポート

REST API は、次の 2 種類のリソースの基本的な CRUD オペレーションをサポートしています。

このドキュメントの残りの部分は主に Product について記載していますが、プロセスは ProductCertification の場合も同様です。

Manufacturer Center アカウントを設定する

  1. Manufacturer Center アカウントを作成します。

  2. この Manufacturer Center アカウントの作成に使用したメールアドレスは、後で必要になります。覚えておいてください。スクリーンショットでは、manufacturer_user@example.com と表示されています。

最初の API リクエストを作成します(1 行のコードなし)。

  1. Accounts.Products.list のデベロッパー向けドキュメントの API Explorer をご覧ください。

  2. ログインした Google アカウントが [設定] タブの [ユーザー] 設定に表示されていることを確認します。

  3. API Explorer で、[認証] プルダウン メニューで [Google OAuth 2.0] が選択されていることを確認します。

  4. モデルの「親」フィールドに、accounts/{account_id} {account_id} を Manufacturer Center アカウントのメーカー ID に置き換えて、[実行] をクリックします。

  5. 正常なレスポンスが表示されます。これで完了です。最初の Manufacturer Center API リクエストの作成が完了しました。

  6. Manufacturer Center にまだ商品がない場合、リストには何も表示されません。この時点で、他のリクエストに移動してその動作を確認できます。これは RESTful API であるため、すべてのリクエストが同じように機能します。商品を作成したら、Accounts.Products.get を試してみることをおすすめします。

Google API Console プロジェクトを作成する

Manufacturer Center API へのリクエストは、API Console プロジェクトを介して行われます。ここでは、ユーザー自身が Manufacturer Center アカウントにアクセスすることを前提としているため、サービス アカウントを使用して認証フローを簡素化することをおすすめします。Manufacturer Center アカウントで使用する新しいサービス アカウントを設定する方法について詳しくは、サービス アカウントのガイドをご覧ください。

Java を使用した最初の承認済み API リクエスト

サービス アカウントを設定し、その Manufacturer Center アカウントにサービス アカウント ID を追加したら、利用可能なサンプルコードを使用してアカウントにアクセスできます。このガイドでは、Java サンプルを使用して API の使い方を説明します。

  1. Apache Maven をインストールします(まだインストールしていない場合)。

  2. GitHub ページからショッピング サンプルをダウンロードします。

  3. java サブディレクトリから Java サンプルをビルドします。

    $ mvn compile
    
  4. ProductsListSampleProductCertification の例は ListProductCertificationsSample)のコードを実行します。

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. ソースファイルに付属している README の構成手順に従わなかった場合、サンプル構成が見つからないというエラーが表示されます。README の手順に沿って、構成ディレクトリを作成し、適切な情報を入力します。サービス アカウントの設定時にダウンロードした JSON ファイルを、service-account.json ディレクトリに保存します。次の環境変数を設定して、ファイルの場所をコードに伝えます。

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
    
  6. サンプル構成を設定したので、ProductsListSample コードを再度実行します。

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  7. この時点で、Java プログラムは実行を終了し、見つかった商品のリストまたはアカウントに商品がなかったというメッセージを出力します。「ユーザーがアカウント 1234567890 にアクセスできません」というエラーが表示された場合は、サービス アカウント ユーザーが Manufacturer Center の承認済みユーザーとして設定されていない可能性があります。API の観点から、API Console プロジェクトは、承認された Manufacturer Center 管理者のリストに含まれていなかったユーザーに代わってリクエストを送信しました。そのため、リクエストは当然拒否されます。

  8. ProductsListSample は読み取り専用であるため、何度でも実行できます。Java と .NET 用に作成した他のサンプルもご覧ください。