管理供應設定

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

如需建立新供應設定的說明，請參閱建立供應設定。

搜尋功能不一定要設定供應設定才能運作。任何 serving_config_id 都可以做為搜尋要求的一部分，在這種情況下，系統會預設為空白或未設定的放送控制項。然後使用 Vertex AI Search for Commerce 的預設搜尋功能搜尋目錄。

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

編輯供應設定

你可以使用「搜尋」的電子商務控制台或 API 編輯供應設定。

在控制台中編輯供應設定

您可以在「供應設定」頁面查看及編輯各項供應設定的控制項。按一下供應設定即可查看「詳細資料」頁面，其中列出該設定的所有供應和全網站控制項。

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

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

直接編輯供應設定

您可以使用 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'

查看供應設定

你可以使用「搜尋商務」控制台或 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. 前往 Search for commerce 控制台的「Serving Configs」(放送設定) 頁面。

    前往「Serving configs」(放送設定) 頁面

  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'

查看供應設定統計資料

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

點閱率：顯示供應設定的每次搜尋點擊次數。 轉換率：指出設定的每次搜尋購買次數。