在已推出 CSS 計畫的國家/地區中,購物比較服務 (CSS) 可以代表商家在 Google 服務中刊登購物廣告。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 可與數種不同類型的 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
方法,並在要求中傳送標籤查詢參數,只傳回含有該標籤的帳戶。以下範例說明如何使用「建立標籤」範例中建立的「key-accounts」標籤 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’
}