这是 Recommendations AI、Retail Search 和新的 Retail 控制台的文档。

创建和管理控件

本页面介绍了如何添加、查看、修改和删除控件。

  • 服务控制是指您定义并应用于各个零售搜索服务配置的规则。如需详细了解服务配置,请参阅服务配置
  • 网站级控件:适用于所有 Retail Search 结果。

投放控件

借助投放控件规则,您可以创建规则,从而自定义您的投放配置提供搜索结果的方式。

您可以在 Cloud Console 中创建服务控件,该控件由一个条件触发,以及在条件触发时触发的操作。然后,您可以将新的投放控件附加到您创建的任何 Retail Search 服务配置。

Retail Search 投放配置具有控件的多对多关系。您可以向投放配置添加多个控件,一个控件可以与多个投放配置相关联。

投放配置用于控制可以应用的控件。在传送时,系统只会考虑请求的有效传送配置的控件。

您可以创建控件,然后将其添加到全局 Retail Search 投放配置中或将其交换。

您可以随时在 Controls 页面上创建或修改服务控件,也可以使用 Controls.create 方法以内嵌方式进行修改。在服务配置创建过程中,您可以在控制台中选择创建控件。

您最多可以创建 1000 个投放控件。除了重定向控制机制之外,服务配置最多可以包含 100 个任何类型的控件,每个服务配置的数量上限为 1000。

投放控件适用于:

  • 提升/清除:影响返回结果列表中的结果排名和顺序。
  • 过滤条件:从返回的结果列表中移除未通过过滤条件的结果。
  • 重定向:根据搜索查询将用户重定向到特定网页。
  • 语言:自定义搜索查询语言。您可以使用以下几种语言控件:
    • 同义词:扩展搜索查询的搜索查询的同义词。
    • 单向同义词:针对特定字词扩展单向同义词。
    • 不关联:阻止在出现特定字词时搜索一组字词。
    • 忽略:阻止搜索中使用某个字词。
    • 替换:替换搜索查询中的字词。

如需查看这些控件的示例,请参阅服务控件

教程:重定向控件

本教程介绍了如何使用重定向控件。


如需在 Cloud Shell Editor 中直接获取有关此任务的分步指导,请点击操作演示

操作演示


以下部分将引导您完成与点击操作演示相同的步骤。

创建新的投放控件

在 Google Cloud Console 的“控制”页面上,或者使用 Controls.create 方法以内嵌方式创建新的服务控件。

控件因其类型而异的要求。转到您计划创建的控件类型的创建过程:

创建增强/控制项

如需详细了解此控制类型,请参阅增强/控制控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择增强/爆炸控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加查询按钮以添加要提升或被隐藏的查询字词(例如 running shoes),然后为每个字词选择以下选项之一:

    • 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
    • 完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。

      如果查询中包含其中一个字词,系统会应用控件。

    如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。

  2. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

    如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。

  3. 点击继续进入操作部分。

操作部分:

  1. Boost/bury product 字段中,为产品属性添加过滤条件。

    使用过滤和排序中记录的过滤条件表达式语法。

    例如,如需要指定“product1”和“product2”的红色和蓝色版本,请使用以下语法:(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  2. 对于提升/掩埋值,使用滑块设置提升强度。正值会增强结果,负值会掩埋结果。

  3. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建过滤器控件

如需详细了解此控件类型,请参阅过滤器控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择过滤器控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加查询按钮以添加要过滤的查询字词(例如 running shoes),并为每个字词选择以下选项之一:

    • 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
    • 完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。

    如果查询中包含其中一个字词,系统会应用控件。

    如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。

  2. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

    如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。

  3. 点击继续进入操作部分。

操作部分:

  1. 过滤操作字段中,为产品属性添加过滤条件。

    使用过滤和排序中记录的过滤条件表达式语法。

    例如,如需要指定“product1”和“product2”的红色和蓝色版本,请使用以下语法:(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  2. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

以下示例展示了

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建重定向控件

如需详细了解此控件类型,请参阅重定向控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择重定向控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分,创建至少一个查询字词或时间范围触发器。重定向控件至少需要一个触发器:

  1. 点击添加查询按钮以添加要过滤的查询字词(例如 running shoes),然后为每个术语选择以下选项之一:

    • 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
    • 完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。

    如果查询中包含其中一个字词,系统会应用控件。

    如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。

  2. 点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

    如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。

  3. 点击继续进入操作部分。

操作部分:

  1. 输入此控件被触发时要重定向到的 URI。

  2. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": REDIRECT_URI,
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建双向同义词控件

如需详细了解此控制类型,请参阅双向同义词控制

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

  3. 控件名称字段中,输入新控件的名称。

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  2. 选择双向同义词控制作为控件类型。

  3. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

  2. 点击继续进入操作部分。

操作部分:

  1. 同义词字段中,输入 2 到 100 个查询字词(例如 shirttop),这些字词应是彼此的同义词。

    如果查询中包含其中任一字词,则搜索会将其他查询字词视为所包含字词的同义词。

  2. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建单向同义词控制

如需详细了解此控制类型,请参阅单向同义词控制

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择单向同义词控制作为控制类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

  2. 点击继续进入操作部分。

操作部分:

  1. 查询字词字段中,输入查询中包含的任何字词(例如 shoes)的同义词。

  2. 同义词字段中,输入应该用作您指定的查询字词同义词(例如,sneakerssandals 作为查询字词 shoes 的单向同义词)。

  3. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建“不关联”控件

如需详细了解此控件类型,请参阅不关联控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择不关联控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

  2. 点击继续进入操作部分。

操作部分:

  1. 查询字词字段中,输入您希望明确区分的字词(例如 gShoe)。

  2. 关联字词字段中,输入不应在搜索结果中与您指定的查询字词关联的字词。

    例如,您可以将查询字词 gShoe 与字词 cheap 解除关联。

  3. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建忽略控件

如需详细了解此控件类型,请参阅忽略控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择不关联控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

  2. 点击继续进入操作部分。

操作部分:

  1. 忽略字词字段中,输入您希望搜索作为查询字词输入时忽略的字词(例如 shoddy)。

  2. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

创建替换控件

如需详细了解此控件类型,请参阅替换控件

控制台

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 投放控件标签页上,点击 创建控件

    系统随即会打开创建控件窗格。

偏好设置部分:

  1. 控件名称字段中,输入新控件的名称。

  2. (可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。

  3. 选择替换控件作为控件类型。

  4. 点击“继续”以转到触发器部分。

触发器部分:

  1. (可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。

  2. 点击继续进入操作部分。

操作部分:

  1. 查询字词字段中,输入要替换为替换字词的查询字词(例如 gShoe)。

  2. 替换字词字段中,输入应替换您指定的查询字词的字词。

    例如,您可以将查询字词 gShoe 替换为替换字词 Google Shoe

  3. 点击继续进入服务配置部分。

服务配置部分:

  1. 选择要应用控件的投放配置。

  2. 提交控件设置。

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

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

curl

发出 Control.create 请求,并在请求正文中包含控件 ID 和 Control 实例。

如需了解字段详情,请参阅 Controls API 参考文档Controls.create API 参考文档

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

如需向服务配置添加控件,请使用 ServingConfig.addControl 方法。请参阅向内嵌式服务配置添加控件

您可以在“控件”页面的投放控件 (Serving controls) 标签页上找到列出的新控件。

查看和修改投放控件

您可以使用 Retail 控制台或 Retail API 查看服务控件。

在控制台中查看和修改投放控件

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

您还可以在服务配置页面上查看和修改特定服务配置的控件。点击服务配置以查看其详细信息页面,其中列出了该配置的所有服务控件。点击某个控件的 Edit control 图标可在 Edit control 面板中更改其设置。点击 Remove control 图标以将控件与服务配置分离(这不会删除该控件)。

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

内嵌查看投放控制设置

要以内嵌方式查看单个服务控件,请使用 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. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  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 Console 内适用于目录商品属性提供网站级属性控制。

可用的网站级特性控件包括:

  • 可编入索引:Retail Search 可以使用此特性进行过滤和构面。
  • 动态构面:Retail Search 可以根据过去的用户行为(例如构面点击和视图)自动将此特性用作动态构面。如需为特性启用动态构面,必须将该属性的 Indexable 设置为 true。
  • 可搜索:此特性可通过 Retail Search 查询搜索,从而提高此特性的召回率。此控件仅适用于文本特性。

您可以为单个特性启用或停用侧边特性控件。

动态构面可用作网站级特性控件。默认情况下,系统会为所有自定义特性启用动态构面。

目录级配置模式中,可对“可编入索引”和“可搜索”使用网站级特性控件。

如需详细了解特性配置及其默认和允许的设置,请参阅配置特性主题。

设置网站级特性控件

在 Google Cloud Console 的“控件”页面上设置一个网站级特性控件。

可在默认的目录级配置模式下全局设置网站级属性控件。以前,产品级配置是默认模式。如果您仍处于产品级配置模式,需要切换模式,请与零售支持团队联系。

  1. 转到 Google Cloud Console 中的“零售控件”页面。

    转到“控件”页面

  2. 转到网站级控件 (Site-wide controls) 标签页。

    此标签页会显示一个表,其中包含您可以为其设置网站级控件的所有产品特性。

  3. 点击 修改控件

  4. 启用或停用控件。

    • True:为该属性启用控件。这会替换 Retail API 中的任何产品级属性配置。
    • False:停用相应属性的控件。这会替换 Retail API 中的任何产品级属性配置。

      请注意,您只能为同样设置为可编入索引的特性将动态构面设置为 true。

  5. 点击保存控件 (Save Controls)。

    对可编入索引且可搜索的属性配置设置所做的更改将在 12 小时内生效,或在您下次提取目录时生效。动态构面配置更改最多需要两天时间。您可以在评估页面上测试更改是否已应用,该页面会立即反映您的更改。