購物比較服務 (CSS) 可以代表 Google 在 Google 服務中刊登購物廣告 適用的 CSS 供應商在已推出 CSS 計畫的國家/地區中。Content API 可讓 CSS 網域和 CSS 群組管理相關聯的帳戶 標籤CSS 網域可以列出、標籤及篩選 Merchant Center 帳戶 與網域建立關聯。CSS 群組可以標籤及列出 CSS 網域 這些 Content API 服務提供 相當於購物比較廣告活動提供的部分功能 服務中心
若要進一步瞭解 CSS,請參閱: 購物比較服務: 如要瞭解如何在 CSS Center 中使用標籤,請參閱 在 Comparison Shopping Service Center 中使用帳戶標籤。
CSS 帳戶類型
CSS 供應商可使用以下三種帳戶類型:
- CSS 群組是包含一或多個 CSS 的頂層帳戶 網域。
- CSS 網域是指 CSS 本身用來刊登購物廣告的帳戶 。每個 CSS 網域都只能屬於一個 CSS 群組。
- Merchant Center 帳戶:指的是刊登 CSS 網域的商家 購物廣告。CSS 可與數種不同的商家類型建立關聯 Center 帳戶,包括多重客戶帳戶 (MCA) 和個人商家 帳戶。每個 Merchant Center 帳戶只能與一個 CSS 建立關聯 網域。如要進一步瞭解不同類型的 Merchant Center 帳戶,請按照下列步驟操作: 看 Comparison Shopping Service Center 的帳戶類型:
CSS 標籤類型
CSS 有兩種標籤:
- 手動標籤是由 CSS 建立並指派給 Merchant Center 帳戶 以及 CSS 網域
- 自動標籤是由系統自動建立,並指派給 Merchant Center 共用 Merchant Center 帳戶自動標籤適用於不同類型的 帳戶指標有助您找出重要帳戶和重要的帳戶和業務指標 帳戶活動
進一步瞭解標籤類型 (包括可用的自動功能) 標籤,請參閱 在 Comparison Shopping Service Center 中使用帳戶標籤。
CSS 適用的 Content API 功能和端點
Content API 提供下列 CSS 端點:
accounts.labels
:允許 建立、擷取及修改標籤,以便套用至 CSS 網域和商家 。如需範例,請參閱建立標籤。accounts.updatelabels
: 可讓您將標籤套用至單一 Merchant Center 帳戶。例如 請參閱「將標籤套用至 Merchant Center 帳戶」一文。accounts.list
:允許 可讓您擷取與 CSS 網域相關聯的所有 Merchant Center 帳戶 包括每個帳戶套用的標籤您也可以依「id
」標籤篩選 擷取部分相關帳戶。如需範例,請參閱 使用標籤篩選 Merchant Center 帳戶。accounts.get
:允許 可用於擷取單一 Merchant Center 帳戶套用的標籤csses
:可讓您查看及 管理標籤和 CSS 網域之間的關聯。如需範例,請參閱 將標籤套用至 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
建立標籤
以下示範如何建立網域層級金鑰帳戶
並能套用至與
網域。如要建立標籤,請使用以下網址提出 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 網域相關聯的 Center 帳戶。下列範例示範
如何將先前範例建立的 key-accounts 標籤套用至
最重要的 Merchant Center 帳戶
如要套用標籤,請使用以下網址提出 POST
要求,並要求
內文:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
範例:使用標籤篩選 Merchant Center 帳戶
為 Merchant Center 帳戶連結的 Merchant Center 帳戶建立標籤並套用標籤後
透過 CSS 網域,您可以使用 accounts.list
方法並傳遞標籤
查詢參數,只傳回含有該標籤的帳戶。
以下範例說明如何篩選 Merchant Center 帳戶
與 CSS 網域建立關聯,並使用金鑰帳戶的 id
(123
)
在「建立標籤」範例中建立的標籤。若要擷取
受益人,請使用以下網址提出 GET
要求:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
不需要任何要求主體。
範例:將標籤套用至 CSS 網域
您也可以使用 csses.updatelabels
方法為 CSS 指派標籤
網域。以下範例說明如何
套用 key-domains 群組層級標籤
將 accounts.labels.create
方法連結到最重要的 CSS 網域
帳戶。請注意,CSS 網域和 Merchant Center 帳戶的標籤
是各自獨立的資源群組層級標籤必須使用 CSS 群組 ID 做為
accountId
。
如要套用標籤,請使用以下網址提出 POST
要求,並要求
內文:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}