開始使用購物比較服務 (CSS)

使用 API 執行基本作業,是開始使用 API 的好方法。

必要條件

開始之前,請先完成下列操作:

  • 確認你擁有有效的 CSS Center 帳戶。
  • 註冊 API 開發人員。
  • 確認權限設定是否正確。
  • 確認已啟用 CSS API。
  • 確認您已為環境安裝用戶端程式庫。

詳情請參閱快速入門導覽課程

啟用 CSS API

如要使用 CSS API,請先註冊為開發人員,然後使用開發人員註冊方法,連結 CSS Center 帳戶和 Google Cloud 專案,步驟如下:

連結 CSS Center 和 Google Cloud 專案:系統會自動建立連結,因為呼叫端可根據存取權杖或 API 金鑰存取 Google Cloud 專案,且是 CSS Center 帳戶的授權使用者。

註冊 API 開發人員

將 API 開發人員使用者新增至 CSS Center 帳戶:如果使用者已存在,系統只會授予新的「API 開發人員」存取類型。如果是新使用者,他們會收到 CSS 中心電子郵件邀請。

註冊後,您可以使用 GetDeveloperRegistration 查看註冊狀態,或使用 UnregisterGCP 取消註冊。您可以使用下列註冊呼叫:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

要求成功執行後,您應該會收到以下回應:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

CSS 產品

產品子 API 類似,CSS API 會區分 CssProductInputListCssProduct。插入產品,並使用 InsertCssProductInput

內部系統處理完產品後 (可能需要幾分鐘),請使用 ListCssProducts 擷取產品。

使用 raw_provided_id 識別產品。建議您使用自家系統中已有的 ID。或者,建立憑證的常見方法包括使用下列其中一項:

  • 全域專屬 ID (GUID)
  • 通用唯一識別碼 (UUID)
  • 串連的專屬產品屬性 (例如 brand_model_color_size)

詳情請參閱「插入/列出/更新/刪除產品」。

基本操作

你可以試試以下基本要求。

  1. 使用 InsertCssProductInput 插入測試產品。 如需傳送屬性的相關說明,請參閱這個程式碼範例

  2. 使用 ListCssProducts 列出所有產品。請注意,插入產品後,系統需要一小段處理時間,產品才會顯示在產品資訊中。如果沒有立即看到,請稍候幾秒再試一次。

  3. 使用 UpdateCssProductInput 透過 cssproductinput.name 更新單一產品。你只需要傳送需要更新的屬性。如需範例,請參閱範例程式碼

  4. 使用 DeleteCssProductInpu 刪除測試產品,並提供 raw_provided_id

限制

插入或刪除個別產品可能需要較長時間。如要提升效能,請使用 Async 提升效能。這樣就能平行呼叫 API。

列出及標記帳戶

透過 CSS API 中的標籤管理功能,您可以使用自訂標籤,以程式輔助方式整理用戶端 Merchant Center 帳戶。這項功能可協助您有效率地分類客戶 (例如依類型或策略),進而提升管理效率及簡化作業。您可以使用這個 API 對標籤執行下列功能: