CSS 標籤管理

在已推出 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 端點呼叫為 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’
}