googleads shopping samples

ショッピングおよびメーカーセンターAPIのコンテンツAPIのサンプル

これらのコードサンプルは、プラットフォームまたは言語によって編成されています。各言語ディレクトリには、その特定の言語のREADMEを実行する方法に関する詳細情報が含まれています。ここでは、認証とすべてのサンプルで使用される共通構成ファイルのセットアップをカバーします。

APIの詳細については、ショッピング用のコンテンツAPIおよびメーカーセンターAPIのドキュメントを参照してください。

認証方法を選択してください

開始する前に、ショッピングドキュメントについては、コンテンツAPIの開始セクションを確認してください。代わりにサービスアカウントを使用して、認証フローを簡素化することをお勧めします。これらのサンプルは、Googleアプリケーションのデフォルトの資格情報を使用してもサポートしています。

メーカーセンターAPIの認証のセットアップは、コンテンツAPIに似ています。 APIコンソールでメーカーセンターAPIを選択してください。両方のAPIの両方のAPIを試したい場合は、両方のAPIを選択できます。

認証とサンプル構成のセットアップ

1. ディレクトリ$(HOME)/shopping-samplesを作成して、構成を保存します。

   これが特定のセットアップのどこにあるのかわからない場合は、サンプルを実行します（言語固有のREADMEに続いて）。このディレクトリに関連するサンプルからのエラーまたは既存のファイルのいずれかに関連するエラーは、予想されるディレクトリ/ファイルへの完全なパスを提供します。

   このディレクトリ内で、次のサブディレクトリも作成します。

   • ショッピング用のコンテンツAPIのcontent
   • メーカーセンターAPIのmanufacturers

   試してみたいAPIの適切なサブディレクトリに以下のファイルを配置します。

2. 目的の認証方法を設定します。

   Googleアプリケーションのデフォルト資格情報を使用している場合：

   • Googleアプリケーションのデフォルトの資格情報ページの指示に従ってください。

   サービスアカウントを使用している場合：

   • 適切なAPI構成サブディレクトリにFile service-account.jsonにサービスアカウントを作成するときにダウンロードしたJSONファイルを配置します。

   OAUTH2クライアントIDを使用している場合：

   • 適切なAPI構成サブディレクトリのFile client-secrets.jsonにOAUTH2クライアント資格情報をファイルにダウンロードします。

     注：サンプルは、ループバックIPアドレスを使用してトークンを取得できるOAUTH2クライアントIDを使用していると仮定します。あなたがそうでないか、そうでない場合は、自分がそうでない場合は、[モバイル＆デスクトップアプリのoauth2.0]（https://developers.google.com/identity/protocols/oauth2installedapp）ページにアクセスして、そこの指示に従って、サンプルで使用する新しいOAUTH2クライアントID。

   複数の認証メソッドを設定して異なるフローを試してみることができますが、サンプルは常にロードできる最初の資格情報を使用して、次のことに注意してください。

   1. Googleアプリケーションデフォルトの資格情報
   2. サービスアカウントの資格情報
   3. OAUTH2クライアント資格情報

3. サンプルの各セットは、異なる構成ファイルを使用します。ショッピング用のコンテンツAPIについては、リポジトリルートからmerchant-info.json例を取り、 $(HOME)/shopping-samples/contentにコピーしてください。次に、その内容を適切に変更します。次のフィールドを持つJSONオブジェクトが含まれています。

   分野	タイプ	説明
   merchantId	番号	サンプルを実行するためのマーチャントセンターID。
   accountSampleUser	弦	非空白の場合、ユーザーがAccountsサービスのサンプルを追加/削除するための電子メールアドレス。
   accountSampleAdWordsCID	番号	ゼロ以外の場合、AdWordsの顧客IDは、 Accountsサービスのサンプルをリンク/リンクします。

   メーカーセンターAPIについては、リポジトリルートからmanufacturer-info.json例を取り、 $(HOME)/shopping-samples/manufacturersにコピーします。次に、その内容を適切に変更します。次のフィールドを持つJSONオブジェクトが含まれています。

   分野	タイプ	説明
   manufacturerId	番号	サンプルを実行するためのメーカーセンターID。
   websiteUrl	弦	メーカーセンターアカウントに関連付けられたURL（トレーリングスラッシュなし）。

   OAUTH2クライアント資格情報を使用する場合、アクセスを承認すると、トークンの詳細は、サンプル構成ディレクトリのstored-token.jsonファイルに保存されます。認証の問題がある場合は、このファイルを削除すると、アクセスを再承認するように求められます。

サンプルを試してみてください

共通のサンプル構成ファイルの両方を構成し、認証資格情報を設定したので、添加されたサンプルを構築および実行する時が来ました。前述のように、各言語サブディレクトリにあるREADMEには言語固有の指示があります。楽しむ！

考えられる問題

• ショッピングにコンテンツAPIを使用する場合、アカウントに税設定を設定していない場合は、特定のサンプルを実行するとエラーが発生する可能性があります。 「税の設定がない」エラーを受け取った場合は、これらのサンプルを試す前に、商人センターに税設定を設定します。 「米国で税金を請求しない」設定を選択するだけで十分です。