管理供應控制項

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

如要瞭解供應控制項的一般資訊，以及如何建立供應控制項，請參閱「關於供應控制項」和「建立供應控制項」。

查看及編輯刊登控制項

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

在控制台中查看及編輯刊登控制項

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

您也可以在「供應設定」頁面查看及編輯特定供應設定的控制項。按一下供應設定，即可查看「Details」頁面，其中列出該設定的所有供應控制項。按一下控制項的 「編輯控制項」圖示，即可在「編輯控制項」面板中變更設定。按一下 「移除控制項」圖示，即可將控制項與供應設定分離 (不會刪除控制項)。

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

查看內嵌的供應控制項

如要查看單一供應控制項的內嵌內容，請使用 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」頁面。

    前往「控制」頁面

  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 值區中的檔案。

您可能會因為以下兩個原因匯出及匯入供應控制項：

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

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

你可以透過 Search for Commerce 控制台匯出及匯入資料。匯出供應控制項時，您會匯出專案中的所有供應控制項。

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

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

    前往「控制」頁面

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

  3. 在「Export Serving Controls」視窗中，選取要匯出控制項檔案的 Cloud Storage 值區。

  4. 按一下 [匯出]。

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

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. 匯出作業完成後，您可以在「Export activity」視窗的「Bulk import, export, delete activities」清單中查看作業狀態。如要開啟「匯出活動」視窗，請在訊息視窗中按一下「顯示」，或按照「查看特定整合作業的狀態」中的指示操作。

匯入供應控制項

如要大量新增或修改現有的供應控制項，您可以在匯出的控制項檔案中進行變更。接著，您可以將這些檔案匯入原始專案或其他專案。

匯入供應控制項時，請注意下列事項：

  • 如果供應控制檔案同時包含搜尋和推薦供應控制項，則無法匯入。

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

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

  1. 編輯及查看匯出的供應控制項檔案，並將檔案放入 Cloud Storage 值區。(如要匯出供應控制項，請參閱前述的「匯出供應控制項」工作)。

    請確認檔案只包含搜尋供應控制項或推薦供應控制項。您無法匯入同時包含這兩種類型的檔案。

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

    前往「控制」頁面

  3. 在「Serving controls」分頁中，按一下「Import controls」。

  4. 在「Import Serving Controls」視窗中：

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

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

    3. 查看匯入預覽方案。將建立的控制項會顯示在「New」分頁上，而要修改的控制項則會顯示在「Modified」分頁上。

  5. 按一下「匯入」。

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

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