ショッピング比較サービス（CSS）では、CSS プログラムが利用可能な国で、販売者の代理として Google にショッピング広告を掲載できます。Content API を使用すると、CSS ドメインと CSS グループはラベルを使用して関連付けられたアカウントを整理できます。CSS ドメインは、ドメインに関連付けられている Merchant Center アカウントを一覧表示、ラベル付け、フィルタできます。CSS グループは、グループに関連付けられている CSS ドメインにラベルを付けて一覧表示できます。これらの Content API サービスは、ショッピング比較サービス センターで利用できる機能の一部に相当するプログラムを提供します。
CSS について詳しくは、ショッピング比較サービスをご覧ください。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: 単一の 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 アカウントにラベルを割り当てることができます。次の例は、前の例で作成した key-accounts ラベルを最も重要な Merchant Center アカウントの 1 つに適用する方法を示しています。
ラベルを適用するには、次の 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 ドメイン アカウントの 1 つに適用する方法を示しています。CSS ドメインと Merchant Center アカウントのラベルは別々であることにご注意ください。グループレベルのラベルは、CSS グループ ID を accountId として使用して作成する必要があります。
ラベルを適用するには、次の URL とリクエスト本文を使用して POST リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}