CSS 標籤管理

在已推出 CSS 計畫的國家/地區中,購物比較服務 (CSS) 可以代表商家在 Google 服務中刊登購物廣告。Content API 可讓 CSS 網域和 CSS 群組利用標籤整理關聯帳戶。CSS 網域可以列出、加上標籤及篩選與網域相關聯的 Merchant Center 帳戶。CSS 群組可以加上標籤及列出與群組相關聯的 CSS 網域。下列 Content API 服務在程式上也提供了 Comparison Shopping Service Center 的部分功能。

如要進一步瞭解 CSS,請參閱「購物比較服務」。如要瞭解如何在 CSS Center 中使用標籤,請參閱「在 Comparison Shopping Service Center 中使用帳戶標籤」。

CSS 帳戶類型

CSS 會使用以下三種帳戶類型:

  • CSS 群組是可包含一或多個 CSS 網域的頂層帳戶。
  • CSS 網域是 CSS 本身的帳戶,會代表商家刊登購物廣告。每個 CSS 網域只能隸屬於一個 CSS 群組。
  • Merchant Center 帳戶是指要刊登購物廣告的 CSS 網域商家。CSS 可與多種不同類型的 Merchant Center 帳戶建立關聯,包括多重客戶帳戶 (MCA) 和個別商家帳戶。每個 Merchant Center 帳戶只能與一個 CSS 網域建立關聯。如要進一步瞭解不同類型的 Merchant Center 帳戶,請參閱 Comparison Shopping Service Center 的帳戶類型

CSS 標籤類型

CSS 供應商使用兩種標籤:

  • 手動標籤是由 CSS 網域建立並指派給 Merchant Center 帳戶,以及依 CSS 群組指派給 CSS 網域。
  • CSS Center 會自動建立自動標籤,並指派給 Merchant Center 帳戶。自動標籤適用於不同類型的帳戶指標,幫助您找出重要帳戶和重要的帳戶活動。

如要進一步瞭解標籤類型 (包括可用的自動標籤),請參閱「在 Comparison Shopping Service Center 中使用帳戶標籤」。

CSS 適用的 Content API 功能和端點

Content API 提供 CSS 適用的下列端點:

accounts 端點呼叫為 CSS 網域時,請注意下列規定:

  • CSS 網域必須提供 cssId,而非 merchantId
  • 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 帳戶。如要建立標籤,請使用以下網址和要求主體提出 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 帳戶。

如要套用標籤,請使用以下網址提出 POST 要求並要求主體:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
 "labelIds": [‘123’] // ‘key-accounts’
}

範例:使用標籤篩選 Merchant Center 帳戶

建立標籤並套用至與 CSS 網域相關聯的 Merchant Center 帳戶後,您可以使用 accounts.list 方法,並在要求中傳遞標籤查詢參數,讓系統只傳回含有該標籤的帳戶。以下範例說明如何使用在「建立標籤」一節中建立的金鑰帳戶標籤的 id (123),篩選與 CSS 網域相關聯的 Merchant Center 帳戶。如要擷取帳戶,請使用以下網址提出 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

如要套用標籤,請使用以下網址提出 POST 要求並要求主體:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
 "labelIds": [‘456’] // ‘key-domains’
}