管理供應設定

本頁面說明如何刪除、編輯及列出提交設定，以及查看各設定的統計資料。

如需建立新的供應設定，請參閱「建立供應設定」。

您不必設定供應設定，搜尋功能仍可正常運作。任何 serving_config_id 都可以加入搜尋要求，在這種情況下，系統會預設為空白或未設定的放送控制項。接著，系統會使用商家適用的 Vertex AI Search 預設搜尋功能搜尋目錄。

如果您有現有的刊登位置，或建立新的刊登位置，Vertex AI Search for Commerce 會自動建立與每個刊登位置相關聯的放送設定。建立供應設定不會建立對應的刊登位置。刪除供應設定會刪除相應的顯示位置，而刪除顯示位置會刪除相應的供應設定。

編輯供應設定

你可以使用 Search for Commerce 主控台或 API 編輯供應設定。

在控制台中編輯內容提供設定

您可以在「供應設定」頁面中查看及修改各個供應設定的控制項。按一下供應設定，即可查看其「Details」頁面，其中列出該設定的所有供應和網站層級控制項。

您可以在這個頁面中編輯控制項、建立新的控制項，或將現有控制項套用至設定。

新建或更新的放送設定需要幾分鐘才能準備好放送即時流量。您可以立即在「評估」頁面上測試變更。

內嵌編輯內容提供設定

您可以使用 API 方法更新服務設定欄位、新增服務控制項，以及移除內嵌的服務控制項。

內嵌供應設定修補程式

如要更新服務設定中的欄位，請使用 ServingConfig.patch，並在要求主體中加入 ServingConfig 的例項。請使用 updateMask 參數指定要更新的欄位，或是將其設為未設定，以便更新所有支援的欄位。

如要進一步瞭解這個方法，請參閱 ServingConfig.patch API 參考資料。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

在供應設定內嵌控制項

如要為供應設定新增控制項，請使用 ServingConfig.addControl。控制項會新增至所屬控制項清單的最後一個位置。例如，facetSpec 控制項會套用至 servingConfig.facetSpecIds 的最後一個位置。

如要進一步瞭解這個方法，請參閱 ServingConfig.addControl API 參考資料。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

從內嵌的供應設定中移除控制項

如要從供應設定中移除控制項，請使用 ServingConfig.removeControl。

如要進一步瞭解這個方法，請參閱 ServingConfig.removeControl API 參考資料。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

查看供應設定

你可以使用 Search for Commerce 主控台或 API 查看供應設定。

在控制台中查看供應設定

您可以在「供應設定」頁面中查看所有供應設定。

在內文中查看供應設定

如要查看單一供應設定的內嵌內容，請使用 ServingConfig.get。

如要進一步瞭解這個方法，請參閱 ServingConfig.get API 參考資料。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

如要列出所有內嵌供應設定，請使用 ServingConfig.list。

您可以選擇使用 pageSize 參數，設定要傳回的結果數量上限。如果有更多結果，list 回應會包含頁面權杖。您可以在 list 要求的 pageToken 參數中傳遞分頁符記，以便擷取下一頁的結果。

如要進一步瞭解這個方法，請參閱 ServingConfig.list API 參考資料。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

刪除供應設定

你可以使用 Search for Commerce 控制台或 API 刪除供應設定。

在控制台中刪除供應設定

如何在控制台中刪除供應設定：

  1. 前往 Google 商務搜尋控制台的「供應設定」頁面。

    前往「Serving 設定」頁面

  2. 按一下要刪除的供應設定，開啟詳細資料頁面。

  3. 按一下頁面頂端按鈕列中的「刪除」圖示 。

  4. 如果系統判定放送設定為有效，您必須重新輸入 ID，然後按一下「確認」，才能完成刪除作業。

刪除內嵌供應設定

如要刪除單一內嵌供應設定，請使用 ServingConfig.delete。

如要進一步瞭解這個方法，請參閱 ServingConfig.delete API 參考資料。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

查看供應設定統計資料

您可以在「供應設定」頁面中查看各供應設定的詳細資料。如要查看表格中的任何設定，請按一下「查看數據分析」，即可查看統計資料。

「點閱率」：顯示供應設定的每次搜尋點擊次數。「轉換率」：表示每個搜尋查詢的購買次數。