ショッピング比較サービス(CSS)は、CSS プログラムを利用できる国で、販売者に代わって Google でショッピング広告を掲載できます。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 アカウントにラベルを割り当てることができます。次の例は、前の例で作成した key-accounts ラベルを、最も重要な Merchant Center アカウントのいずれかに適用する方法を示しています。
ラベルを適用するには、次の 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 アカウントのラベルは異なることに注意してください。グループレベルのラベルは、accountId
として CSS グループ ID を使用して作成する必要があります。
ラベルを適用するには、次の URL とリクエスト本文を使用して POST
リクエストを行います。
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}