管理供應控制項

本頁說明如何查看、編輯、刪除、匯出及匯入供應控制項。

如要大致瞭解供應控制項，以及如何建立供應控制項，請參閱「關於供應控制項」和「建立供應控制項」一文。

查看及編輯放送控制選項

您可以使用控制台和 API，查看 Vertex AI Search for Commerce 的放送控制選項。

在控制台中查看及編輯放送控制項

「控制項」頁面的「供應控制項」分頁會列出所有供應控制項及其相關聯的供應設定。按一下控管機制的「編輯控管」圖示，即可在「編輯控管」面板中變更控管機制的設定和相關聯的供應設定。按一下控制項的「刪除控制項」圖示，即可刪除控制項，並從所有供應設定中移除。

您也可以在供應設定頁面上，查看及編輯特定供應設定的控制項。 按一下供應設定，即可查看「詳細資料」頁面，其中列出該設定的所有供應控制項。按一下控制項的「編輯控制項」圖示，即可在「編輯控制項」面板中變更設定。按一下「移除控制項」圖示，即可將控制項與供應設定取消關聯 (這不會刪除控制項)。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面測試變更是否已套用。

內嵌查看供應控制項

如要內嵌顯示單一供應控制項，請使用 Control.get。

如要進一步瞭解這個方法，請參閱 Control.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/controls/CONTROL_ID'

如要內嵌列出多個放送控制項，請使用 Controls.list。

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

如要只列出與特定供應設定相關聯的控制項，請使用 filter 查詢參數指定供應設定 ID。

如要進一步瞭解這個方法，請參閱 Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

內嵌修補供應控制項

如要更新放送控制項中的欄位，請使用 Controls.patch，並在要求主體中加入 Control 的執行個體。使用 updateMask 參數指定要更新的欄位，或將其設為未設定，即可更新所有支援的欄位。

如要進一步瞭解這個方法，請參閱 Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

在供應設定中直接新增控制項

如要將控制項新增至供應設定，請使用 ServingConfig.addControl。

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

如需這個方法的範例，請參閱「管理放送設定」。

直接從供應設定中移除控制項

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

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

如需這個方法的範例，請參閱「管理放送設定」。

刪除供應控制項

您可以透過控制台或使用 Controls.delete 方法，以內嵌方式刪除放送控制項。

在控制台中刪除放送控制項

刪除供應控制項，即可從所有使用該控制項的供應設定中移除該控制項。

  1. 前往 Search for commerce 控制台的「Controls」頁面。

    前往「Controls」(控制項) 頁面

  2. 在要移除的控制項表格列中，按一下「刪除」。

  3. 在確認視窗中按一下「刪除」，即可完成刪除作業。

刪除供應控制項內嵌

如要刪除內嵌的放送控制選項，請使用 Controls.delete。

如要進一步瞭解這個方法，請參閱 Controls.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/controls/SERVING_CONTROL_ID'

匯出供應控制項

您可以將供應控制項匯出至 Cloud Storage 值區中的檔案。

匯出及匯入供應控制項的原因有兩個：

  • 將放送控制項從一個專案移至另一個專案。

  • 對所有或部分供應控制項執行大量編輯作業。匯出供應控制項、編輯匯出的檔案，然後匯入檔案來變更或新增供應控制項。

你可以透過「搜尋」的商家主控台匯出及匯入資料。匯出供應控制項時，系統會匯出專案中的所有供應控制項。

如要匯出供應控制項，請按照下列步驟操作：

  1. 前往 Search for commerce 控制台的「Controls」頁面。

    前往「Controls」(控制項) 頁面

  2. 在「供應控制項」分頁標籤中，按一下「匯出控制項」。

  3. 在「Export Serving Controls」(匯出放送控制項)視窗中，選取要將控制項檔案匯出至哪個 Cloud Storage 值區。

  4. 按一下 [匯出]。

    匯出的控制項會儲存至所選 bucket 的 NDJSON 檔案，名稱格式如下：

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. 匯出作業完成後，您可以在「匯出活動」視窗的「大量匯入、匯出、刪除活動」清單中，查看作業狀態。按一下訊息視窗中的「顯示」，或按照「查看特定整合作業的狀態」一文中的操作說明，開啟「匯出活動」視窗。

匯入供應控制項

如要大量新增或修改放送控制項，請在匯出的控制項檔案中進行變更。然後匯入原始專案或其他專案。

匯入供應控制項須知：

  • 如果供應控制項檔案同時包含搜尋和建議供應控制項，您就無法匯入。

  • 匯入供應控制項時，檔案中的所有供應控制項都會與您在匯入時指定的供應設定建立關聯。如果供應控制項已與專案中的其他供應設定建立關聯，系統也會保留該關聯。

如要匯入供應控制項，請按照下列步驟操作：

  1. 編輯及檢查匯出的供應控制項檔案，然後將檔案放入 Cloud Storage 值區。(如要匯出供應控制項，請參閱上述「匯出供應控制項」一節)。

    確認檔案只包含搜尋服務控制項，或只包含建議服務控制項。您無法匯入同時包含這兩種檔案的檔案。

  2. 前往 Search for commerce 控制台的「Controls」頁面。

    前往「Controls」(控制項) 頁面

  3. 在「放送控制選項」分頁中，按一下「匯入控制選項」。

  4. 在「匯入供應控制項」視窗中：

    1. 瀏覽並選取 Cloud Storage 值區和 NDJSON 檔案，其中包含要匯入的控制項。

    2. 選取要與匯入的供應控制項建立關聯的供應設定。

    3. 查看「匯入預覽」方案。系統會在「New」分頁中顯示要建立的控制項，並在「Modified」分頁中顯示要修改的控制項。

  5. 按一下「匯入」。

    系統會啟動長時間執行的作業，匯入新的和經過修改的控制項。

  6. 匯入作業完成後，您可以在「活動狀態」視窗的「控制項」分頁中查看作業狀態。在訊息視窗中點選「顯示」，或按照「查看特定整合作業的狀態」一文中的操作說明，開啟「活動狀態」視窗。