CSS 標籤管理

在已推出 CSS 計畫的國家/地區中，購物比較服務 (CSS) 可以代表商家在 Google 服務中刊登購物廣告。Content API 可讓 CSS 網域和 CSS 群組使用標籤整理相關聯的帳戶。CSS 網域可以列出、標記及篩選與網域相關聯的 Merchant Center 帳戶。CSS 群組可以標示並列出與群組相關聯的 CSS 網域。這些 Content API 服務提供一些程式輔助功能，與 Comparison Shopping Service Center 提供的功能類似。

如要進一步瞭解購物比較服務，請參閱這篇文章。如要瞭解如何在 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 提供下列端點：

以 CSS 網域身分呼叫 accounts 端點時，請注意下列規定：

  • 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) key-accounts 標籤，篩選與 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 方法，將建立的重要網域群組層級標籤套用至最重要的 CSS 網域帳戶。請注意，CSS 網域和 Merchant Center 帳戶的標籤是分開的。必須使用 CSS 群組 ID 做為 accountId，才能建立群組層級的標籤。

電話索取標籤 id。

如要套用標籤，請使用下列網址和要求主體提出 POST 要求：

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}