使用 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 會區分 CssProductInput
和 ListCssProduct
。插入產品,並使用 InsertCssProductInput
。
內部系統處理完產品後 (可能需要幾分鐘),請使用 ListCssProducts
擷取產品。
使用 raw_provided_id
識別產品。建議您使用自家系統中已有的 ID。或者,建立憑證的常見方法包括使用下列其中一項:
- 全域專屬 ID (GUID)
- 通用唯一識別碼 (UUID)
- 串連的專屬產品屬性 (例如 brand_model_color_size)
詳情請參閱「插入/列出/更新/刪除產品」。
基本操作
你可以試試以下基本要求。
使用
InsertCssProductInput
插入測試產品。 如需傳送屬性的相關說明,請參閱這個程式碼範例。使用
ListCssProducts
列出所有產品。請注意,插入產品後,系統需要一小段處理時間,產品才會顯示在產品資訊中。如果沒有立即看到,請稍候幾秒再試一次。使用
UpdateCssProductInput
透過cssproductinput.name
更新單一產品。你只需要傳送需要更新的屬性。如需範例,請參閱範例程式碼。使用
DeleteCssProductInpu
刪除測試產品,並提供raw_provided_id
。
限制
插入或刪除個別產品可能需要較長時間。如要提升效能,請使用 Async 提升效能。這樣就能平行呼叫 API。
列出及標記帳戶
透過 CSS API 中的標籤管理功能,您可以使用自訂標籤,以程式輔助方式整理用戶端 Merchant Center 帳戶。這項功能可協助您有效率地分類客戶 (例如依類型或策略),進而提升管理效率及簡化作業。您可以使用這個 API 對標籤執行下列功能: