在已推出 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.labels
:可讓您建立、擷取及修改標籤,並套用至 CSS 網域和 Merchant Center 帳戶。如需範例,請參閱「建立標籤」。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
。
以下範例說明如何建立網域層級金鑰帳戶標籤,然後套用至與該網域相關聯的 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’
}