CSS ラベルの管理

ショッピング比較サービス（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 でアカウント ラベルを使用するをご覧ください。

Content API の機能と CSS 用のエンドポイント

Content API には、CSS 用の次のエンドポイントがあります。

CSS ドメインとして accounts エンドポイントを呼び出す場合は、次の要件に注意してください。

  • 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’
}