ショッピング比較サービス（CSS）を利用する

API を使用するにあたっては、API を使用して基本的なオペレーションを行うことから始めることをおすすめします。

前提条件

始める前に、次のことを行ってください。

• 有効な CSS Center アカウントがあることを確認します。
• API デベロッパーを登録します。
• 権限の設定が正しいことを確認します。
• CSS API が有効になっていることを確認します。
• 環境用のクライアント ライブラリがインストールされていることを確認します。

詳細については、クイックスタートをご覧ください。

CSS API を有効にする

CSS API を使用するデベロッパーとして登録するには、デベロッパー登録方法を使用して、CSS Center アカウントと Google Cloud プロジェクトを次のようにリンクする必要があります。

CSS Center と Google Cloud プロジェクトをリンクする: 呼び出し元はアクセス トークンまたは API キーに基づいて Google Cloud プロジェクトにアクセスでき、CSS Center アカウントの承認済みユーザーであるため、リンクは自動的に確立されます。

API デベロッパーを登録する

CSS Center アカウントに API デベロッパー ユーザーを追加する: ユーザーがすでに存在する場合は、新しい「API デベロッパー」アクセス権が付与されます。新しいユーザーの場合は、CSS Center の招待メールが届きます。

登録後、GetDeveloperRegistration を使用して登録ステータスを表示したり、UnregisterGCP を使用して登録を解除したりできます。次の登録呼び出しを使用できます。

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"[e-mail]"
}

リクエストが正常に実行されると、次のレスポンスが返されます。

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

CSS プロダクト

Products サブ API と同様に、CSS API は CssProductInput と ListCssProduct を区別します。InsertCssProductInput を使用して商品を挿入します。

内部システムで商品が処理されたら（数分かかることがあります）、ListCssProducts を使用して商品を取得します。

raw_provided_id を使用して商品を特定します。独自のシステムですでに使用している識別子を使用することをおすすめします。または、次のいずれかを使用して作成する一般的な方法もあります。

• グローバル一意識別子（GUID）
• Universally Unique Identifier（UUID）
• 連結された一意の商品属性（例: brand_model_color_size）

詳細については、商品の挿入、一覧表示、更新、削除をご覧ください。

基本的なオペレーション

以下に、お試しいただける基本的なリクエストをいくつかご紹介します。

1. InsertCssProductInput を使用してテスト商品を挿入します。送信する属性については、こちらのサンプルコードをご覧ください。

2. ListCssProducts を使用して、すべての商品を一覧表示します。商品を挿入してからリスティングに表示されるまでには、若干の処理遅延があります。すぐに表示されない場合は、数秒後に再度お試しください。

3. cssproductinput.name を使用して UpdateCssProductInput を使用して、単一の商品を更新します。更新に必要な属性のみを送信する必要があります。例については、サンプルコードをご覧ください。

4. DeleteCssProductInpu を使用してテスト商品を削除し、raw_provided_id を指定します。

制限事項

個々の商品の挿入や削除は時間がかかることがあります。パフォーマンスを向上させるには、非同期処理を使用してパフォーマンスを向上させるをご覧ください。これにより、API を並行して呼び出すことができます。

アカウントを一覧表示してラベル付けする

CSS API のラベル管理を使用すると、カスタムタグを使用してクライアントの Merchant Center アカウントをプログラムで整理できます。この機能を使用すると、クライアントを効率的に分類（タイプや戦略など）できるため、組織の改善と運用の効率化につながります。API を使用して、ラベルに対して次の関数を実行できます。

• CreateAccountLabel
• ListAccountLabels
• DeleteAccountLabel
• アカウントに割り当てる
• アカウントの割り当てを解除する