管理投放控制

本页面介绍了如何查看、修改、删除、导出和导入服务控件。

如需了解有关服务控件的一般信息以及有关如何创建 服务控件的说明，请参阅关于服务控件和 创建服务控件。

查看和修改服务控件

您可以使用控制台和 API 查看 AI Commerce Search 的服务控件。

在控制台中查看和修改服务控件

“控件”页面的 服务控件 标签页 列出了所有服务控件及其关联的 服务配置。点击控件的 修改控件图标，可在修改控件 面板中更改其设置和关联的服务配置。点击控件的删除控件图标 可将其删除，同时也会将其从所有服务配置中移除。

您还可以在 服务配置页面上查看和修改特定服务配置的控件。 点击服务配置可查看其详细信息 页面，该页面列出了该配置的所有服务控件。点击控件的 修改控件图标可更改其在修改控件面板中的设置。点击 移除控件图标可将控件与服务配置取消关联（这不会删除 控件）。

新创建的或更新的控件需要几分钟时间才能准备好传送实时路况。您可以在 控制台的 评估 页面上测试更改是否已应用。

内嵌查看服务控件

如需内嵌查看单个服务控件，请使用 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. 在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中，前往控件 页面。

    前往“控件”页面

  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 存储桶中的文件。

您可能需要导出和导入服务控件，原因如下：

  • 将服务控件从一个项目移到另一个项目。

  • 对全部或部分服务控件执行批量修改。导出服务控件，修改导出的文件，然后导入该文件以更改或添加服务控件。

您可以通过 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 导出和导入。 导出服务控件时，您会导出项目中的所有服务控件。

如需导出服务控件，请执行以下操作：

  1. 在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中，前往控件 页面。

    前往“控件”页面

  2. 在服务控件 标签页上，点击导出控件 。

  3. 在导出服务控件 窗口中，选择要将控件文件导出到的 Cloud Storage 存储桶。

  4. 点击导出 。

    导出的控件会保存到所选存储桶中的 NDJSON 文件，文件名的格式如下：

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. 导出操作完成后，您可以在导出活动 窗口的批量导入、导出、删除活动 列表中查看操作状态。如需打开导出活动 窗口，请点击消息窗口中的显示 ，或按照查看特定集成操作的状态中的说明操作。

导入服务控件

如需批量添加服务控件或修改现有服务控件，您可以在导出的控件文件中进行更改。然后，您可以将它们导入到原始项目或其他项目。

关于导入服务控件，您需要了解以下事项：

  • 如果服务控件文件同时包含搜索服务控件和推荐服务控件，则无法导入该文件。

  • 导入服务控件时，文件中的所有服务控件都会与您在导入时指定的服务配置相关联。如果服务控件已与项目中的其他服务配置相关联，则该关联也会保留。

如需导入服务控件，请执行以下操作：

  1. 修改并查看导出的服务控件文件，然后将该文件放入 Cloud Storage 存储桶中。（如需导出服务控件，请参阅前面的任务 导出服务控件。）

    确保文件仅包含搜索服务控件或仅包含推荐服务控件。您无法导入同时包含这两种类型的文件。

  2. 在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中，前往控件 页面。

    前往“控件”页面

  3. 在服务控件 标签页上，点击导入控件 。

  4. 在导入服务控件 窗口中：

    1. 浏览并选择 Cloud Storage 存储桶和 NDJSON 文件，其中包含您要导入的控件。

    2. 选择要与导入的服务控件关联的服务配置。

    3. 查看导入预览计划。将创建的控件显示在新建 标签页上，将修改的控件显示在已修改 标签页上。

  5. 点击导入 。

    系统会启动一项长时间运行的操作，以导入新建和修改的控件。

  6. 导入操作完成后，您可以在活动状态 窗口的控件 标签页中查看操作状态。如需打开活动 状态 窗口，请点击消息窗口中的显示 ，或按照 查看特定集成操作的状态中的说明操作。