本页面介绍了如何添加、查看、修改和删除控件。
- 服务控制是指您定义并应用于各个零售搜索服务配置的规则。如需详细了解服务配置,请参阅服务配置。
- 网站级控件:适用于所有 Retail Search 结果。
投放控件
借助投放控件规则,您可以创建规则,从而自定义您的投放配置提供搜索结果的方式。
您可以在 Cloud Console 中创建服务控件,该控件由一个条件触发,以及在条件触发时触发的操作。然后,您可以将新的投放控件附加到您创建的任何 Retail Search 服务配置。
Retail Search 投放配置具有控件的多对多关系。您可以向投放配置添加多个控件,一个控件可以与多个投放配置相关联。
投放配置用于控制可以应用的控件。在传送时,系统只会考虑请求的有效传送配置的控件。
您可以创建控件,然后将其添加到全局 Retail Search 投放配置中或将其交换。
您可以随时在 Controls 页面上创建或修改服务控件,也可以使用 Controls.create
方法以内嵌方式进行修改。在服务配置创建过程中,您可以在控制台中选择创建控件。
您最多可以创建 1000 个投放控件。除了重定向控制机制之外,服务配置最多可以包含 100 个任何类型的控件,每个服务配置的数量上限为 1000。
投放控件适用于:
- 提升/清除:影响返回结果列表中的结果排名和顺序。
- 过滤条件:从返回的结果列表中移除未通过过滤条件的结果。
- 重定向:根据搜索查询将用户重定向到特定网页。
- 语言:自定义搜索查询语言。您可以使用以下几种语言控件:
- 同义词:扩展搜索查询的搜索查询的同义词。
- 单向同义词:针对特定字词扩展单向同义词。
- 不关联:阻止在出现特定字词时搜索一组字词。
- 忽略:阻止搜索中使用某个字词。
- 替换:替换搜索查询中的字词。
如需查看这些控件的示例,请参阅服务控件。
教程:重定向控件
本教程介绍了如何使用重定向控件。
如需在 Cloud Shell Editor 中直接获取有关此任务的分步指导,请点击操作演示:
以下部分将引导您完成与点击操作演示相同的步骤。
创建新的投放控件
在 Google Cloud Console 的“控制”页面上,或者使用 Controls.create
方法以内嵌方式创建新的服务控件。
控件因其类型而异的要求。转到您计划创建的控件类型的创建过程:
创建增强/控制项
如需详细了解此控制类型,请参阅增强/控制控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择增强/爆炸控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加查询按钮以添加要提升或被隐藏的查询字词(例如
running shoes
),然后为每个字词选择以下选项之一:- 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。
如果查询中包含其中一个字词,系统会应用控件。
如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。
点击继续进入操作部分。
在操作部分:
在 Boost/bury product 字段中,为产品属性添加过滤条件。
使用过滤和排序中记录的过滤条件表达式语法。
例如,如需要指定“product1”和“product2”的红色和蓝色版本,请使用以下语法:
(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
对于提升/掩埋值,使用滑块设置提升强度。正值会增强结果,负值会掩埋结果。
点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建过滤器控件
如需详细了解此控件类型,请参阅过滤器控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择过滤器控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加查询按钮以添加要过滤的查询字词(例如
running shoes
),并为每个字词选择以下选项之一:- 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
- 完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。
如果查询中包含其中一个字词,系统会应用控件。
如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。
点击继续进入操作部分。
在操作部分:
在过滤操作字段中,为产品属性添加过滤条件。
使用过滤和排序中记录的过滤条件表达式语法。
例如,如需要指定“product1”和“product2”的红色和蓝色版本,请使用以下语法:
(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建重定向控件
如需详细了解此控件类型,请参阅重定向控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择重定向控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分,创建至少一个查询字词或时间范围触发器。重定向控件至少需要一个触发器:
点击添加查询按钮以添加要过滤的查询字词(例如
running shoes
),然后为每个术语选择以下选项之一:- 部分匹配:当查询包含与此查询字词的部分匹配时,此控件适用。
- 完全匹配:仅当查询包含与此查询字词的完全匹配时,此控件才适用。
如果查询中包含其中一个字词,系统会应用控件。
如果您除了指定此条件外,还指定了时间范围条件,则仅当同时满足这两个条件时,系统才会应用控制措施。
点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
如果除了此时间范围条件外,您还指定了查询条件条件,则该控件仅在同时满足这两个条件时才应用。
点击继续进入操作部分。
在操作部分:
输入此控件被触发时要重定向到的 URI。
点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建双向同义词控件
如需详细了解此控制类型,请参阅双向同义词控制。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
在控件名称字段中,输入新控件的名称。
系统随即会打开创建控件窗格。
在偏好设置部分:
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择双向同义词控制作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
点击继续进入操作部分。
在操作部分:
在同义词字段中,输入 2 到 100 个查询字词(例如
shirt
和top
),这些字词应是彼此的同义词。如果查询中包含其中任一字词,则搜索会将其他查询字词视为所包含字词的同义词。
点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建单向同义词控制
如需详细了解此控制类型,请参阅单向同义词控制。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择单向同义词控制作为控制类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
点击继续进入操作部分。
在操作部分:
在查询字词字段中,输入查询中包含的任何字词(例如
shoes
)的同义词。在同义词字段中,输入应该用作您指定的查询字词同义词(例如,
sneakers
和sandals
作为查询字词shoes
的单向同义词)。点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建“不关联”控件
如需详细了解此控件类型,请参阅不关联控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择不关联控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
点击继续进入操作部分。
在操作部分:
在查询字词字段中,输入您希望明确区分的字词(例如
gShoe
)。在关联字词字段中,输入不应在搜索结果中与您指定的查询字词关联的字词。
例如,您可以将查询字词
gShoe
与字词cheap
解除关联。点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建忽略控件
如需详细了解此控件类型,请参阅忽略控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择不关联控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
点击继续进入操作部分。
在操作部分:
在忽略字词字段中,输入您希望搜索作为查询字词输入时忽略的字词(例如
shoddy
)。点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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
方法。请参阅向内嵌式服务配置添加控件。
创建替换控件
如需详细了解此控件类型,请参阅替换控件。
控制台
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在投放控件标签页上,点击 add_box 创建控件。
系统随即会打开创建控件窗格。
在偏好设置部分:
在控件名称字段中,输入新控件的名称。
(可选)要更改自动创建的控件 ID,请点击控件名称字段下的修改,然后输入新的控件 ID。
选择替换控件作为控件类型。
点击“继续”以转到触发器部分。
在触发器部分:
(可选)点击添加时间范围按钮,添加可应用此控件的一个或多个时间范围。
点击继续进入操作部分。
在操作部分:
在查询字词字段中,输入要替换为替换字词的查询字词(例如
gShoe
)。在替换字词字段中,输入应替换您指定的查询字词的字词。
例如,您可以将查询字词
gShoe
替换为替换字词Google Shoe
。点击继续进入服务配置部分。
在服务配置部分:
选择要应用控件的投放配置。
提交控件设置。
新创建的或更新的控件需要几分钟时间才能准备好传送实时流量。您可以在控制台的评估页面上测试更改是否已应用。
您可以在“控件”页面的投放控件 (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 查看服务控件。
在控制台中查看和修改投放控件
“控件”页面的服务控件标签页列出了所有服务控件及其关联的服务配置。点击控件的 edit修改控件图标,即可在修改控件面板中更改其设置和关联的服务配置。点击某个控件的 deleteDelete control 图标可将其删除,这也会将其从所有服务配置中移除。
您还可以在服务配置页面上查看和修改特定服务配置的控件。点击服务配置以查看其详细信息页面,其中列出了该配置的所有服务控件。点击某个控件的 editEdit control 图标可在 Edit control 面板中更改其设置。点击 remove-circle-outlineRemove 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
方法从控制台或内嵌方法删除服务控件。
在控制台中删除服务控件
删除服务控件,以从使用该控件的所有服务配置中移除该控件。
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面在计划要移除的控件的表行中,点击 delete 删除。
在确认窗口中,点击删除以完成删除。
删除内嵌控件
如需以内嵌方式删除服务控件,请使用 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 的“控件”页面上设置一个网站级特性控件。
可在默认的目录级配置模式下全局设置网站级属性控件。以前,产品级配置是默认模式。如果您仍处于产品级配置模式,需要切换模式,请与零售支持团队联系。
转到 Google Cloud Console 中的“零售控件”页面。
转到“控件”页面转到网站级控件 (Site-wide controls) 标签页。
此标签页会显示一个表,其中包含您可以为其设置网站级控件的所有产品特性。
点击 edit 修改控件。
启用或停用控件。
- True:为该属性启用控件。这会替换 Retail API 中的任何产品级属性配置。
False:停用相应属性的控件。这会替换 Retail API 中的任何产品级属性配置。
请注意,您只能为同样设置为可编入索引的特性将动态构面设置为 true。
点击保存控件 (Save Controls)。
对可编入索引且可搜索的属性配置设置所做的更改将在 12 小时内生效,或在您下次提取目录时生效。动态构面配置更改最多需要两天时间。您可以在评估页面上测试更改是否已应用,该页面会立即反映您的更改。