ショッピング比較サービス（CSS）プログラムを利用できる国では、販売者に代わってショッピング比較サービス（CSS）がショッピング広告を掲載できます。Content API では、CSS ドメインと CSS グループがラベルを使用して、関連するアカウントを整理できます。CSS ドメインでは、ドメインに関連付けられている Merchant Center アカウントを一覧表示、ラベル付け、フィルタできます。CSS グループでは、そのグループに関連する CSS ドメインにラベルを付けて一覧表示できます。これらの Content API サービスは、Comparison Shopping Service Center で利用できる一部の機能と同等の機能をプログラマティックに提供しています。
ショッピング比較サービスについて詳しくは、ショッピング比較サービスをご覧ください。CSS Center でのラベルの操作については、Comparison Shopping Service Center でのアカウント ラベルの使用をご覧ください。
CSS アカウントの種類
CSS では、次の 3 種類のアカウントを使用します。
- CSS グループは、1 つまたは複数の CSS ドメインを含めることができる最上位のアカウントです。
- CSS ドメインは CSS 自体のアカウントであり、販売者に代わってショッピング広告を掲載します。各 CSS ドメインは、1 つの CSS グループにしか所属できません。
- Merchant Center アカウントは、CSS ドメインがショッピング広告を掲載する販売者です。CSS は、マルチクライアント アカウント（MCA）や個別の販売アカウントなど、さまざまな種類の Merchant Center アカウントに関連付けることができます。各 Merchant Center アカウントは、1 つの CSS ドメインにのみ関連付けることができます。さまざまな種類の Merchant Center アカウントについて詳しくは、Comparison Shopping Service Center のアカウントの種類をご覧ください。
CSS ラベルの種類
CSS では、次の 2 種類のラベルを使用します。
- 手動ラベルは、CSS ドメインによって Merchant Center アカウントに、CSS グループによって CSS ドメインによって作成され、割り当てられます。
- 自動ラベルは、CSS Center によって自動的に作成され、Merchant Center アカウントに割り当てられます。自動ラベルは、さまざまな種類のアカウント指標で使用でき、重要なアカウントと重要なアカウント アクティビティを識別するのに役立ちます。
使用可能な自動ラベルなど、ラベルタイプの詳細については、Comparison Shopping Service Center でアカウント ラベルを使用するをご覧ください。
CSS の Content API 機能とエンドポイント
Content API には、CSS 用に以下のエンドポイントが用意されています。
accounts.labels: CSS ドメイン アカウントと Merchant Center アカウントに適用するラベルを作成、取得、変更できます。例については、ラベルの作成をご覧ください。accounts.updatelabels: 1 つの Merchant Center アカウントにラベルを適用できます。例については、Merchant Center アカウントにラベルを適用するをご覧ください。accounts.list: CSS ドメインに関連付けられているすべての Merchant Center アカウント（各アカウントに適用されているラベルを含む）を取得できます。ラベルidでフィルタして、関連するアカウントのサブセットを取得することもできます。例については、ラベルを使用して Merchant Center アカウントをフィルタするをご覧ください。accounts.get: 1 つの Merchant Center アカウントに適用されているラベルを取得できます。csses: ラベルと CSS ドメイン間の関連付けを表示して管理できます。例については、CSS ドメインにラベルを適用するをご覧ください。
accounts エンドポイントを CSS ドメインとして呼び出す場合は、次の要件に注意してください。
- CSS ドメインでは、
merchantIdではなくcssIdを指定する必要があります。 - CSS ドメインでは、
view=CSSのクエリ パラメータを指定する必要があります。 - CSS ドメインは、関連する Merchant Center アカウント ID を
accountIdとして指定する必要があります。
例: ラベルを作成する
新しいラベルを作成するには、accounts.labels.create メソッドを使用します。ラベルは、CSS ドメインと Merchant Center アカウントに適用できます。ただし、アカウント タイプのラベルは別個のものであるため、同じものとして使用することはできません。ドメインに関連付けられた Merchant Center アカウントに適用できるドメインレベルのラベルを作成するには、ラベルの作成時に CSS ドメイン ID を accountId として使用します。グループレベルのラベルを作成して、そのグループと関連付けられている CSS ドメインに適用できるようにするには、ラベルの作成時に CSS グループ ID を accountId として使用します。
次の例は、ドメインレベルのキーアカウント ラベルを作成する方法を示しています。このラベルは、ドメインに関連付けられた Merchant Center アカウントに適用できます。ラベルを作成するには、次の URL とリクエスト本文を使用して POST リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
"name": "key-accounts",
"description": "All accounts with over a million products"
}
例: Merchant Center アカウントにラベルを適用する
accounts.updatelabels メソッドを使用して、CSS ドメインに関連付けられている Merchant Center アカウントにラベルを割り当てることができます。次の例は、最も重要な Merchant Center アカウントの 1 つに、前の例で作成した key-accounts ラベルを適用する方法を示しています。
ラベルを適用するには、次の URL とリクエスト本文を使用して POST リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
例: ラベルを使用して Merchant Center アカウントをフィルタする
ラベルを作成して CSS ドメインに関連付けられた Merchant Center アカウントに適用したら、accounts.list メソッドを使用してラベルのクエリ パラメータをリクエストで渡すと、そのラベルの付いたアカウントのみを取得できます。次の例は、ラベルの作成の例で作成した key-accounts ラベルの id（123）を使用して、CSS ドメインに関連付けられた Merchant Center アカウントをフィルタリングする方法を示しています。アカウントを取得するには、次の URL を使用して GET リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
リクエスト本文は必要ありません。
例: CSS ドメインにラベルを適用する
csses.updatelabels メソッドを使用して、CSS グループに関連付けられた CSS ドメインにラベルを割り当てることもできます。次の例は、accounts.labels.create メソッドを使用して作成した Key-domains グループレベルのラベルを、最も重要な CSS ドメイン アカウントのいずれかに適用する方法を示しています。CSS ドメインと Merchant Center アカウントのラベルは別のものです。グループレベルのラベルは、CSS グループ ID を accountId として使用して作成する必要があります。
ラベルを適用するには、次の URL とリクエスト本文を使用して POST リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}