algolia 3.35.0 → 3.35.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/Gemfile.lock +8 -8
- data/lib/algolia/api/analytics_client.rb +6 -6
- data/lib/algolia/api/composition_client.rb +2 -2
- data/lib/algolia/api/ingestion_client.rb +22 -22
- data/lib/algolia/api/search_client.rb +8 -8
- data/lib/algolia/defaults.rb +3 -0
- data/lib/algolia/models/composition/base_injection_query_parameters.rb +2 -2
- data/lib/algolia/models/composition/ignore_plurals.rb +1 -1
- data/lib/algolia/models/composition/main_injection_query_parameters.rb +2 -2
- data/lib/algolia/models/composition/optional_words.rb +1 -1
- data/lib/algolia/models/composition/params.rb +2 -2
- data/lib/algolia/models/composition/remove_stop_words.rb +1 -1
- data/lib/algolia/models/composition/time_range.rb +2 -2
- data/lib/algolia/models/ingestion/authentication.rb +2 -2
- data/lib/algolia/models/ingestion/authentication_create_response.rb +1 -1
- data/lib/algolia/models/ingestion/authentication_update_response.rb +1 -1
- data/lib/algolia/models/ingestion/delete_response.rb +1 -1
- data/lib/algolia/models/ingestion/destination.rb +2 -2
- data/lib/algolia/models/ingestion/destination_create_response.rb +1 -1
- data/lib/algolia/models/ingestion/destination_update_response.rb +1 -1
- data/lib/algolia/models/ingestion/event.rb +1 -1
- data/lib/algolia/models/ingestion/run.rb +3 -3
- data/lib/algolia/models/ingestion/run_response.rb +1 -1
- data/lib/algolia/models/ingestion/run_source_response.rb +1 -1
- data/lib/algolia/models/ingestion/source.rb +2 -2
- data/lib/algolia/models/ingestion/source_create_response.rb +1 -1
- data/lib/algolia/models/ingestion/source_update_response.rb +1 -1
- data/lib/algolia/models/ingestion/task.rb +3 -3
- data/lib/algolia/models/ingestion/task_create.rb +1 -1
- data/lib/algolia/models/ingestion/task_create_response.rb +1 -1
- data/lib/algolia/models/ingestion/task_create_v1.rb +2 -2
- data/lib/algolia/models/ingestion/task_replace.rb +1 -1
- data/lib/algolia/models/ingestion/task_update_response.rb +1 -1
- data/lib/algolia/models/ingestion/task_update_v1.rb +1 -1
- data/lib/algolia/models/ingestion/task_v1.rb +4 -4
- data/lib/algolia/models/ingestion/transformation.rb +2 -2
- data/lib/algolia/models/ingestion/transformation_create_response.rb +1 -1
- data/lib/algolia/models/ingestion/transformation_update_response.rb +1 -1
- data/lib/algolia/models/ingestion/watch_response.rb +1 -1
- data/lib/algolia/models/ingestion/window.rb +2 -2
- data/lib/algolia/models/insights/added_to_cart_object_ids.rb +1 -1
- data/lib/algolia/models/insights/added_to_cart_object_ids_after_search.rb +1 -1
- data/lib/algolia/models/insights/clicked_filters.rb +1 -1
- data/lib/algolia/models/insights/clicked_object_ids.rb +1 -1
- data/lib/algolia/models/insights/clicked_object_ids_after_search.rb +1 -1
- data/lib/algolia/models/insights/converted_filters.rb +1 -1
- data/lib/algolia/models/insights/converted_object_ids.rb +1 -1
- data/lib/algolia/models/insights/converted_object_ids_after_search.rb +1 -1
- data/lib/algolia/models/insights/purchased_object_ids.rb +1 -1
- data/lib/algolia/models/insights/purchased_object_ids_after_search.rb +1 -1
- data/lib/algolia/models/insights/viewed_filters.rb +1 -1
- data/lib/algolia/models/insights/viewed_object_ids.rb +1 -1
- data/lib/algolia/models/recommend/condition.rb +1 -1
- data/lib/algolia/models/recommend/fallback_params.rb +4 -4
- data/lib/algolia/models/recommend/ignore_plurals.rb +1 -1
- data/lib/algolia/models/recommend/optional_words.rb +1 -1
- data/lib/algolia/models/recommend/params_consequence.rb +1 -1
- data/lib/algolia/models/recommend/recommend_search_params.rb +4 -4
- data/lib/algolia/models/recommend/remove_stop_words.rb +1 -1
- data/lib/algolia/models/recommend/time_range.rb +2 -2
- data/lib/algolia/models/search/api_key.rb +1 -1
- data/lib/algolia/models/search/browse_params_object.rb +3 -3
- data/lib/algolia/models/search/browse_response.rb +0 -4
- data/lib/algolia/models/search/consequence.rb +10 -1
- data/lib/algolia/models/search/consequence_params.rb +3 -3
- data/lib/algolia/models/search/consequence_redirect.rb +210 -0
- data/lib/algolia/models/search/delete_by_params.rb +1 -1
- data/lib/algolia/models/search/event.rb +1 -1
- data/lib/algolia/models/search/get_api_key_response.rb +1 -1
- data/lib/algolia/models/search/ignore_plurals.rb +1 -1
- data/lib/algolia/models/search/index_settings.rb +3 -3
- data/lib/algolia/models/search/optional_words.rb +1 -1
- data/lib/algolia/models/search/remove_stop_words.rb +1 -1
- data/lib/algolia/models/search/search_for_facets.rb +3 -3
- data/lib/algolia/models/search/search_for_hits.rb +3 -3
- data/lib/algolia/models/search/search_params_object.rb +3 -3
- data/lib/algolia/models/search/search_response.rb +0 -4
- data/lib/algolia/models/search/secured_api_key_restrictions.rb +1 -1
- data/lib/algolia/models/search/settings_response.rb +3 -3
- data/lib/algolia/models/search/time_range.rb +2 -2
- data/lib/algolia/models/search/watch_response.rb +1 -1
- data/lib/algolia/transport/retry_strategy.rb +1 -2
- data/lib/algolia/transport/transport.rb +4 -4
- data/lib/algolia/version.rb +1 -1
- metadata +2 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d7319119e646ce2ddd4ae9c3752f51e2c43c9b749692366b39923e76739d35a3
|
|
4
|
+
data.tar.gz: b0a4f259d562b26a79823bd7a88e7609012a542e92c40ebe92446594fa50e7d4
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 41c7e5e8a0886a04a85e57c22284c691b7c5fd4a99bcd48735ec689c67f0e56338d95a5217a0a0d3551c483ac7f1b7fae0e5a3e7bd5cf5cd9dbebf5bd3b1439f
|
|
7
|
+
data.tar.gz: 4cae09ffbd9b1d8bbbd4b07846f1f0ed773db05534a6f7a4639412a95ad6753fe340439892e272bfa709dbb2e137f88e1c34dd29e69180d34799c4b79aa47e86
|
data/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
## [3.35.1](https://github.com/algolia/algoliasearch-client-ruby/compare/3.35.0...3.35.1)
|
|
2
|
+
|
|
3
|
+
- [46be49a3f](https://github.com/algolia/api-clients-automation/commit/46be49a3f) docs(specs): align with style guides ([#5930](https://github.com/algolia/api-clients-automation/pull/5930)) by [@kai687](https://github.com/kai687/)
|
|
4
|
+
- [799a10c44](https://github.com/algolia/api-clients-automation/commit/799a10c44) fix(specs): insights-api timestamp documentation ([#5925](https://github.com/algolia/api-clients-automation/pull/5925)) by [@sirockin](https://github.com/sirockin/)
|
|
5
|
+
- [5670d2b29](https://github.com/algolia/api-clients-automation/commit/5670d2b29) fix(ruby): Implement host reset ([#5922](https://github.com/algolia/api-clients-automation/pull/5922)) by [@MarioAlexandruDan](https://github.com/MarioAlexandruDan/)
|
|
6
|
+
- [4b3dc5c26](https://github.com/algolia/api-clients-automation/commit/4b3dc5c26) fix(specs): BREAKING CHANGE – remove unnecessary required fields ([#5959](https://github.com/algolia/api-clients-automation/pull/5959)) by [@MarioAlexandruDan](https://github.com/MarioAlexandruDan/)
|
|
7
|
+
- The `SearchResponse` model now accepts `query` and `params` as optional parameters, as they are not always returned by the API.
|
|
8
|
+
- [dfd992583](https://github.com/algolia/api-clients-automation/commit/dfd992583) fix(specs): add missing `redirect` property to rule consequence schema ([#5934](https://github.com/algolia/api-clients-automation/pull/5934)) by [@Fluf22](https://github.com/Fluf22/)
|
|
9
|
+
- [b39c0798e](https://github.com/algolia/api-clients-automation/commit/b39c0798e) chore(deps): dependencies 2026-02-09 ([#5935](https://github.com/algolia/api-clients-automation/pull/5935)) by [@algolia-bot](https://github.com/algolia-bot/)
|
|
10
|
+
|
|
1
11
|
## [3.35.0](https://github.com/algolia/algoliasearch-client-ruby/compare/3.34.4...3.35.0)
|
|
2
12
|
|
|
3
13
|
BREAKING CHANGES: this minor version includes multiple breaking changes related to fixes on different APIs. See below for more details.
|
data/Gemfile.lock
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
PATH
|
|
2
2
|
remote: .
|
|
3
3
|
specs:
|
|
4
|
-
algolia (3.35.
|
|
4
|
+
algolia (3.35.1)
|
|
5
5
|
base64 (>= 0.2.0, < 1)
|
|
6
6
|
faraday (>= 1.0.1, < 3.0)
|
|
7
7
|
faraday-net_http_persistent (>= 0.15, < 3)
|
|
@@ -12,23 +12,23 @@ GEM
|
|
|
12
12
|
specs:
|
|
13
13
|
base64 (0.3.0)
|
|
14
14
|
connection_pool (2.5.4)
|
|
15
|
-
faraday (2.14.
|
|
15
|
+
faraday (2.14.1)
|
|
16
16
|
faraday-net_http (>= 2.0, < 3.5)
|
|
17
17
|
json
|
|
18
18
|
logger
|
|
19
|
-
faraday-net_http (3.4.
|
|
20
|
-
net-http (
|
|
19
|
+
faraday-net_http (3.4.2)
|
|
20
|
+
net-http (~> 0.5)
|
|
21
21
|
faraday-net_http_persistent (2.3.1)
|
|
22
22
|
faraday (~> 2.5)
|
|
23
23
|
net-http-persistent (>= 4.0.4, < 5)
|
|
24
|
-
json (2.
|
|
24
|
+
json (2.18.1)
|
|
25
25
|
logger (1.7.0)
|
|
26
|
-
net-http (0.
|
|
27
|
-
uri
|
|
26
|
+
net-http (0.9.1)
|
|
27
|
+
uri (>= 0.11.1)
|
|
28
28
|
net-http-persistent (4.0.6)
|
|
29
29
|
connection_pool (~> 2.2, >= 2.2.4)
|
|
30
30
|
rake (13.3.0)
|
|
31
|
-
uri (1.
|
|
31
|
+
uri (1.1.1)
|
|
32
32
|
|
|
33
33
|
PLATFORMS
|
|
34
34
|
aarch64-linux
|
|
@@ -647,7 +647,7 @@ module Algolia
|
|
|
647
647
|
)
|
|
648
648
|
end
|
|
649
649
|
|
|
650
|
-
# Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day. The rate is
|
|
650
|
+
# Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days, including the current day. The rate is purchase conversion events divided by tracked searches. A search is tracked if it returns a query ID (`clickAnalytics` is `true`). This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. **There's a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:** - **Null** means there were no queries. Algolia didn't receive any events, so the purchase rate is null. - **0** means there were queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
651
651
|
#
|
|
652
652
|
# Required API Key ACLs:
|
|
653
653
|
# - analytics
|
|
@@ -686,7 +686,7 @@ module Algolia
|
|
|
686
686
|
@api_client.call_api(:GET, path, new_options)
|
|
687
687
|
end
|
|
688
688
|
|
|
689
|
-
# Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day. The rate is
|
|
689
|
+
# Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days, including the current day. The rate is purchase conversion events divided by tracked searches. A search is tracked if it returns a query ID (`clickAnalytics` is `true`). This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. **There's a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:** - **Null** means there were no queries. Algolia didn't receive any events, so the purchase rate is null. - **0** means there were queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
690
690
|
#
|
|
691
691
|
# Required API Key ACLs:
|
|
692
692
|
# - analytics
|
|
@@ -1401,7 +1401,7 @@ module Algolia
|
|
|
1401
1401
|
)
|
|
1402
1402
|
end
|
|
1403
1403
|
|
|
1404
|
-
# Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to true
|
|
1404
|
+
# Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to `true`, the response also includes: - Tracked searches count. Tracked searches are Search API requests with `clickAnalytics` set to `true`. This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There's a difference between 0% rates and null rates:** - **Null** means there were no queries. Algolia didn't receive any events, so rates are null. - **0% rates** mean there were queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
1405
1405
|
#
|
|
1406
1406
|
# Required API Key ACLs:
|
|
1407
1407
|
# - analytics
|
|
@@ -1461,7 +1461,7 @@ module Algolia
|
|
|
1461
1461
|
@api_client.call_api(:GET, path, new_options)
|
|
1462
1462
|
end
|
|
1463
1463
|
|
|
1464
|
-
# Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to true
|
|
1464
|
+
# Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to `true`, the response also includes: - Tracked searches count. Tracked searches are Search API requests with `clickAnalytics` set to `true`. This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There's a difference between 0% rates and null rates:** - **Null** means there were no queries. Algolia didn't receive any events, so rates are null. - **0% rates** mean there were queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
1465
1465
|
#
|
|
1466
1466
|
# Required API Key ACLs:
|
|
1467
1467
|
# - analytics
|
|
@@ -1503,7 +1503,7 @@ module Algolia
|
|
|
1503
1503
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Analytics::GetTopHitsResponse")
|
|
1504
1504
|
end
|
|
1505
1505
|
|
|
1506
|
-
# Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes - Tracked searches count
|
|
1506
|
+
# Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes: - Tracked searches count Tracked searches are Search API requests with `clickAnalytics` set to `true`. This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` query parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There's a difference between 0% rates and null rates:** - **Null** means there were no queries. Algolia didn't receive any events, so rates are null. - **0% rates** mean there were queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
1507
1507
|
#
|
|
1508
1508
|
# Required API Key ACLs:
|
|
1509
1509
|
# - analytics
|
|
@@ -1566,7 +1566,7 @@ module Algolia
|
|
|
1566
1566
|
@api_client.call_api(:GET, path, new_options)
|
|
1567
1567
|
end
|
|
1568
1568
|
|
|
1569
|
-
# Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes - Tracked searches count
|
|
1569
|
+
# Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes: - Tracked searches count Tracked searches are Search API requests with `clickAnalytics` set to `true`. This differs from the response's `count`, which includes searches where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` query parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There's a difference between 0% rates and null rates:** - **Null** means there were no queries. Algolia didn't receive any events, so rates are null. - **0% rates** mean there were queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
1570
1570
|
#
|
|
1571
1571
|
# Required API Key ACLs:
|
|
1572
1572
|
# - analytics
|
|
@@ -947,7 +947,7 @@ module Algolia
|
|
|
947
947
|
)
|
|
948
948
|
end
|
|
949
949
|
|
|
950
|
-
# Updates the \"sortingStrategy\" field of an existing composition. This endpoint
|
|
950
|
+
# Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create a new sorting strategy mapping or replace the configured one. The provided sorting indices must be associated indices or replicas of the main targeted index. This endpoint can't validate whether the sort index is related to the composition's main index. Validation fails at runtime if the index you updated isn't related. The update is applied to the specified composition within the current Algolia application and returns a taskID that can be used to track the operation’s completion.
|
|
951
951
|
#
|
|
952
952
|
# Required API Key ACLs:
|
|
953
953
|
# - editSettings
|
|
@@ -990,7 +990,7 @@ module Algolia
|
|
|
990
990
|
@api_client.call_api(:POST, path, new_options)
|
|
991
991
|
end
|
|
992
992
|
|
|
993
|
-
# Updates the \"sortingStrategy\" field of an existing composition. This endpoint
|
|
993
|
+
# Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create a new sorting strategy mapping or replace the configured one. The provided sorting indices must be associated indices or replicas of the main targeted index. This endpoint can't validate whether the sort index is related to the composition's main index. Validation fails at runtime if the index you updated isn't related. The update is applied to the specified composition within the current Algolia application and returns a taskID that can be used to track the operation’s completion.
|
|
994
994
|
#
|
|
995
995
|
# Required API Key ACLs:
|
|
996
996
|
# - editSettings
|
|
@@ -267,7 +267,7 @@ module Algolia
|
|
|
267
267
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::TaskCreateResponse")
|
|
268
268
|
end
|
|
269
269
|
|
|
270
|
-
# Creates a new task using the v1 endpoint
|
|
270
|
+
# Creates a new task using the v1 endpoint. Use `createTask` instead.
|
|
271
271
|
#
|
|
272
272
|
# Required API Key ACLs:
|
|
273
273
|
# - addObject
|
|
@@ -302,7 +302,7 @@ module Algolia
|
|
|
302
302
|
@api_client.call_api(:POST, path, new_options)
|
|
303
303
|
end
|
|
304
304
|
|
|
305
|
-
# Creates a new task using the v1 endpoint
|
|
305
|
+
# Creates a new task using the v1 endpoint. Use `createTask` instead.
|
|
306
306
|
#
|
|
307
307
|
# Required API Key ACLs:
|
|
308
308
|
# - addObject
|
|
@@ -741,7 +741,7 @@ module Algolia
|
|
|
741
741
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::DeleteResponse")
|
|
742
742
|
end
|
|
743
743
|
|
|
744
|
-
# Deletes a task by its ID using the v1 endpoint
|
|
744
|
+
# Deletes a task by its ID using the v1 endpoint. Use `deleteTask` instead.
|
|
745
745
|
#
|
|
746
746
|
# Required API Key ACLs:
|
|
747
747
|
# - addObject
|
|
@@ -776,7 +776,7 @@ module Algolia
|
|
|
776
776
|
@api_client.call_api(:DELETE, path, new_options)
|
|
777
777
|
end
|
|
778
778
|
|
|
779
|
-
# Deletes a task by its ID using the v1 endpoint
|
|
779
|
+
# Deletes a task by its ID using the v1 endpoint. Use `deleteTask` instead.
|
|
780
780
|
#
|
|
781
781
|
# Required API Key ACLs:
|
|
782
782
|
# - addObject
|
|
@@ -889,7 +889,7 @@ module Algolia
|
|
|
889
889
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::TaskUpdateResponse")
|
|
890
890
|
end
|
|
891
891
|
|
|
892
|
-
# Disables a task using the v1 endpoint
|
|
892
|
+
# Disables a task using the v1 endpoint. Use `disableTask` instead.
|
|
893
893
|
#
|
|
894
894
|
# Required API Key ACLs:
|
|
895
895
|
# - addObject
|
|
@@ -924,7 +924,7 @@ module Algolia
|
|
|
924
924
|
@api_client.call_api(:PUT, path, new_options)
|
|
925
925
|
end
|
|
926
926
|
|
|
927
|
-
# Disables a task using the v1 endpoint
|
|
927
|
+
# Disables a task using the v1 endpoint. Use `disableTask` instead.
|
|
928
928
|
#
|
|
929
929
|
# Required API Key ACLs:
|
|
930
930
|
# - addObject
|
|
@@ -986,7 +986,7 @@ module Algolia
|
|
|
986
986
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::TaskUpdateResponse")
|
|
987
987
|
end
|
|
988
988
|
|
|
989
|
-
# Enables a task using the v1 endpoint
|
|
989
|
+
# Enables a task using the v1 endpoint. Use `enableTask` instead.
|
|
990
990
|
#
|
|
991
991
|
# Required API Key ACLs:
|
|
992
992
|
# - addObject
|
|
@@ -1021,7 +1021,7 @@ module Algolia
|
|
|
1021
1021
|
@api_client.call_api(:PUT, path, new_options)
|
|
1022
1022
|
end
|
|
1023
1023
|
|
|
1024
|
-
# Enables a task using the v1 endpoint
|
|
1024
|
+
# Enables a task using the v1 endpoint. Use `enableTask` instead.
|
|
1025
1025
|
#
|
|
1026
1026
|
# Required API Key ACLs:
|
|
1027
1027
|
# - addObject
|
|
@@ -1338,7 +1338,7 @@ module Algolia
|
|
|
1338
1338
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::Task")
|
|
1339
1339
|
end
|
|
1340
1340
|
|
|
1341
|
-
# Retrieves a task by its ID using the v1 endpoint
|
|
1341
|
+
# Retrieves a task by its ID using the v1 endpoint. Use `getTask` instead.
|
|
1342
1342
|
#
|
|
1343
1343
|
# Required API Key ACLs:
|
|
1344
1344
|
# - addObject
|
|
@@ -1373,7 +1373,7 @@ module Algolia
|
|
|
1373
1373
|
@api_client.call_api(:GET, path, new_options)
|
|
1374
1374
|
end
|
|
1375
1375
|
|
|
1376
|
-
# Retrieves a task by its ID using the v1 endpoint
|
|
1376
|
+
# Retrieves a task by its ID using the v1 endpoint. Use `getTask` instead.
|
|
1377
1377
|
#
|
|
1378
1378
|
# Required API Key ACLs:
|
|
1379
1379
|
# - addObject
|
|
@@ -1729,8 +1729,8 @@ module Algolia
|
|
|
1729
1729
|
# @param task_id [String] Task ID for filtering the list of task runs.
|
|
1730
1730
|
# @param sort [RunSortKeys] Property by which to sort the list of task runs. (default to 'createdAt')
|
|
1731
1731
|
# @param order [OrderKeys] Sort order of the response, ascending or descending. (default to 'desc')
|
|
1732
|
-
# @param start_date [String] Date
|
|
1733
|
-
# @param end_date [String] Date
|
|
1732
|
+
# @param start_date [String] Date and time for the earliest run to retrieve, in RFC 3339 format. By default, the current day minus seven days is used.
|
|
1733
|
+
# @param end_date [String] Date and time for the latest run to retrieve, in RFC 3339 format. By default, the current day is used.
|
|
1734
1734
|
# @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
|
|
1735
1735
|
# @return [Http::Response] the response
|
|
1736
1736
|
def list_runs_with_http_info(
|
|
@@ -1786,8 +1786,8 @@ module Algolia
|
|
|
1786
1786
|
# @param task_id [String] Task ID for filtering the list of task runs.
|
|
1787
1787
|
# @param sort [RunSortKeys] Property by which to sort the list of task runs. (default to 'createdAt')
|
|
1788
1788
|
# @param order [OrderKeys] Sort order of the response, ascending or descending. (default to 'desc')
|
|
1789
|
-
# @param start_date [String] Date
|
|
1790
|
-
# @param end_date [String] Date
|
|
1789
|
+
# @param start_date [String] Date and time for the earliest run to retrieve, in RFC 3339 format. By default, the current day minus seven days is used.
|
|
1790
|
+
# @param end_date [String] Date and time for the latest run to retrieve, in RFC 3339 format. By default, the current day is used.
|
|
1791
1791
|
# @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
|
|
1792
1792
|
# @return [RunListResponse]
|
|
1793
1793
|
def list_runs(
|
|
@@ -2019,7 +2019,7 @@ module Algolia
|
|
|
2019
2019
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::ListTasksResponse")
|
|
2020
2020
|
end
|
|
2021
2021
|
|
|
2022
|
-
# Retrieves a list of tasks using the v1 endpoint
|
|
2022
|
+
# Retrieves a list of tasks using the v1 endpoint. Use `getTasks` instead.
|
|
2023
2023
|
#
|
|
2024
2024
|
# Required API Key ACLs:
|
|
2025
2025
|
# - addObject
|
|
@@ -2080,7 +2080,7 @@ module Algolia
|
|
|
2080
2080
|
@api_client.call_api(:GET, path, new_options)
|
|
2081
2081
|
end
|
|
2082
2082
|
|
|
2083
|
-
# Retrieves a list of tasks using the v1 endpoint
|
|
2083
|
+
# Retrieves a list of tasks using the v1 endpoint. Use `getTasks` instead.
|
|
2084
2084
|
#
|
|
2085
2085
|
# Required API Key ACLs:
|
|
2086
2086
|
# - addObject
|
|
@@ -2478,7 +2478,7 @@ module Algolia
|
|
|
2478
2478
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::RunResponse")
|
|
2479
2479
|
end
|
|
2480
2480
|
|
|
2481
|
-
# Runs a task using the v1 endpoint
|
|
2481
|
+
# Runs a task using the v1 endpoint. Use `runTask` instead. You can check the status of task runs with the observability endpoints.
|
|
2482
2482
|
#
|
|
2483
2483
|
# Required API Key ACLs:
|
|
2484
2484
|
# - addObject
|
|
@@ -2514,7 +2514,7 @@ module Algolia
|
|
|
2514
2514
|
@api_client.call_api(:POST, path, new_options)
|
|
2515
2515
|
end
|
|
2516
2516
|
|
|
2517
|
-
# Runs a task using the v1 endpoint
|
|
2517
|
+
# Runs a task using the v1 endpoint. Use `runTask` instead. You can check the status of task runs with the observability endpoints.
|
|
2518
2518
|
#
|
|
2519
2519
|
# Required API Key ACLs:
|
|
2520
2520
|
# - addObject
|
|
@@ -2721,7 +2721,7 @@ module Algolia
|
|
|
2721
2721
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Array<Ingestion::Task>")
|
|
2722
2722
|
end
|
|
2723
2723
|
|
|
2724
|
-
# Searches for tasks using the v1 endpoint
|
|
2724
|
+
# Searches for tasks using the v1 endpoint. Use `searchTasks` instead.
|
|
2725
2725
|
#
|
|
2726
2726
|
# Required API Key ACLs:
|
|
2727
2727
|
# - addObject
|
|
@@ -2756,7 +2756,7 @@ module Algolia
|
|
|
2756
2756
|
@api_client.call_api(:POST, path, new_options)
|
|
2757
2757
|
end
|
|
2758
2758
|
|
|
2759
|
-
# Searches for tasks using the v1 endpoint
|
|
2759
|
+
# Searches for tasks using the v1 endpoint. Use `searchTasks` instead.
|
|
2760
2760
|
#
|
|
2761
2761
|
# Required API Key ACLs:
|
|
2762
2762
|
# - addObject
|
|
@@ -3213,7 +3213,7 @@ module Algolia
|
|
|
3213
3213
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Ingestion::TaskUpdateResponse")
|
|
3214
3214
|
end
|
|
3215
3215
|
|
|
3216
|
-
# Updates a task by its ID using the v1 endpoint
|
|
3216
|
+
# Updates a task by its ID using the v1 endpoint. Use `updateTask` instead.
|
|
3217
3217
|
#
|
|
3218
3218
|
# Required API Key ACLs:
|
|
3219
3219
|
# - addObject
|
|
@@ -3253,7 +3253,7 @@ module Algolia
|
|
|
3253
3253
|
@api_client.call_api(:PATCH, path, new_options)
|
|
3254
3254
|
end
|
|
3255
3255
|
|
|
3256
|
-
# Updates a task by its ID using the v1 endpoint
|
|
3256
|
+
# Updates a task by its ID using the v1 endpoint. Use `updateTask` instead.
|
|
3257
3257
|
#
|
|
3258
3258
|
# Required API Key ACLs:
|
|
3259
3259
|
# - addObject
|
|
@@ -432,7 +432,7 @@ module Algolia
|
|
|
432
432
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::UpdatedAtResponse")
|
|
433
433
|
end
|
|
434
434
|
|
|
435
|
-
# Retrieves records from an index, up to 1,000 per request.
|
|
435
|
+
# Retrieves records from an index, up to 1,000 per request. Searching returns _hits_ (records augmented with highlighting and ranking details). Browsing returns matching records only. Use browse to export your indices. - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for typo tolerance, number of matched words, proximity, or geo distance. Browse requests automatically apply these settings: - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` evaluate to `true`) If you send these parameters with your browse requests, they're ignored.
|
|
436
436
|
#
|
|
437
437
|
# Required API Key ACLs:
|
|
438
438
|
# - browse
|
|
@@ -465,7 +465,7 @@ module Algolia
|
|
|
465
465
|
@api_client.call_api(:POST, path, new_options)
|
|
466
466
|
end
|
|
467
467
|
|
|
468
|
-
# Retrieves records from an index, up to 1,000 per request.
|
|
468
|
+
# Retrieves records from an index, up to 1,000 per request. Searching returns _hits_ (records augmented with highlighting and ranking details). Browsing returns matching records only. Use browse to export your indices. - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for typo tolerance, number of matched words, proximity, or geo distance. Browse requests automatically apply these settings: - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` evaluate to `true`) If you send these parameters with your browse requests, they're ignored.
|
|
469
469
|
#
|
|
470
470
|
# Required API Key ACLs:
|
|
471
471
|
# - browse
|
|
@@ -836,7 +836,7 @@ module Algolia
|
|
|
836
836
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::DeleteApiKeyResponse")
|
|
837
837
|
end
|
|
838
838
|
|
|
839
|
-
# This operation doesn't accept empty filters. This operation is resource-intensive.
|
|
839
|
+
# This operation doesn't accept empty filters. This operation is resource-intensive. Use it only if you can't get the object IDs of the records you want to delete. It's more efficient to get a list of object IDs with the [`browse` operation](https://www.algolia.com/doc/rest-api/search/browse), and then delete the records using the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
840
840
|
#
|
|
841
841
|
# Required API Key ACLs:
|
|
842
842
|
# - deleteIndex
|
|
@@ -873,7 +873,7 @@ module Algolia
|
|
|
873
873
|
@api_client.call_api(:POST, path, new_options)
|
|
874
874
|
end
|
|
875
875
|
|
|
876
|
-
# This operation doesn't accept empty filters. This operation is resource-intensive.
|
|
876
|
+
# This operation doesn't accept empty filters. This operation is resource-intensive. Use it only if you can't get the object IDs of the records you want to delete. It's more efficient to get a list of object IDs with the [`browse` operation](https://www.algolia.com/doc/rest-api/search/browse), and then delete the records using the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
877
877
|
#
|
|
878
878
|
# Required API Key ACLs:
|
|
879
879
|
# - deleteIndex
|
|
@@ -2027,7 +2027,7 @@ module Algolia
|
|
|
2027
2027
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::MultipleBatchResponse")
|
|
2028
2028
|
end
|
|
2029
2029
|
|
|
2030
|
-
# Copies or moves (renames) an index within the same Algolia application. - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it'
|
|
2030
|
+
# Copies or moves (renames) an index within the same Algolia application. Notes: - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it's created. - This operation is resource-intensive. **Copy** - If the source index doesn't exist, copying creates a new index with 0 records and default settings. - API keys from the source index are merged with the existing keys in the destination index. - You can't copy the `enableReRanking`, `mode`, and `replicas` settings. - You can't copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - For more information, see [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices). **Move** - If the source index doesn't exist, moving is ignored without returning an error. - When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name. To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - For more information, see [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
2031
2031
|
#
|
|
2032
2032
|
# Required API Key ACLs:
|
|
2033
2033
|
# - addObject
|
|
@@ -2064,7 +2064,7 @@ module Algolia
|
|
|
2064
2064
|
@api_client.call_api(:POST, path, new_options)
|
|
2065
2065
|
end
|
|
2066
2066
|
|
|
2067
|
-
# Copies or moves (renames) an index within the same Algolia application. - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it'
|
|
2067
|
+
# Copies or moves (renames) an index within the same Algolia application. Notes: - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it's created. - This operation is resource-intensive. **Copy** - If the source index doesn't exist, copying creates a new index with 0 records and default settings. - API keys from the source index are merged with the existing keys in the destination index. - You can't copy the `enableReRanking`, `mode`, and `replicas` settings. - You can't copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - For more information, see [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices). **Move** - If the source index doesn't exist, moving is ignored without returning an error. - When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name. To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - For more information, see [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
2068
2068
|
#
|
|
2069
2069
|
# Required API Key ACLs:
|
|
2070
2070
|
# - addObject
|
|
@@ -2077,7 +2077,7 @@ module Algolia
|
|
|
2077
2077
|
@api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::UpdatedAtResponse")
|
|
2078
2078
|
end
|
|
2079
2079
|
|
|
2080
|
-
# Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn't exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. -
|
|
2080
|
+
# Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn't exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. - Use first-level attributes only. Nested attributes aren't supported. If you specify a nested attribute, this operation replaces its first-level ancestor. To update attributes without replacing the full record, use these built-in operations. These operations are useful when the initial data isn't available. - `Increment`: increment a numeric attribute. - `Decrement`: decrement a numeric attribute. - `Add`: append a number or string element to an array attribute. - `Remove`: remove all matching number or string elements from an array attribute made of numbers or strings. - `AddUnique`: add a number or string element to an array attribute made of numbers or strings only if it's not already present. - `IncrementFrom`: increment a numeric integer attribute only if the provided value matches the current value. Otherwise, the update is ignored. Example: If you pass an `IncrementFrom` value of 2 for the `version` attribute but the current value is 1, the API ignores the update. If the object doesn't exist, the API only creates it if you pass an `IncrementFrom` value of 0. - `IncrementSet`: increment a numeric integer attribute only if the provided value is greater than the current value. Otherwise, the update is ignored. Example: If you pass an `IncrementSet` value of 2 for the `version` attribute and the current value is 1, the API updates the object. If the object doesn't exist yet, the API only creates it if you pass an `IncrementSet` value greater than 0. Specify an operation by providing an object with the attribute to update as the key and its value as an object with these properties: - `_operation`: the operation to apply on the attribute. - `value`: the right-hand side argument to the operation, for example, increment or decrement step, or a value to add or remove. When updating multiple attributes or using multiple operations targeting the same record, use a single partial update for faster processing. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
2081
2081
|
#
|
|
2082
2082
|
# Required API Key ACLs:
|
|
2083
2083
|
# - addObject
|
|
@@ -2129,7 +2129,7 @@ module Algolia
|
|
|
2129
2129
|
@api_client.call_api(:POST, path, new_options)
|
|
2130
2130
|
end
|
|
2131
2131
|
|
|
2132
|
-
# Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn't exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. -
|
|
2132
|
+
# Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn't exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. - Use first-level attributes only. Nested attributes aren't supported. If you specify a nested attribute, this operation replaces its first-level ancestor. To update attributes without replacing the full record, use these built-in operations. These operations are useful when the initial data isn't available. - `Increment`: increment a numeric attribute. - `Decrement`: decrement a numeric attribute. - `Add`: append a number or string element to an array attribute. - `Remove`: remove all matching number or string elements from an array attribute made of numbers or strings. - `AddUnique`: add a number or string element to an array attribute made of numbers or strings only if it's not already present. - `IncrementFrom`: increment a numeric integer attribute only if the provided value matches the current value. Otherwise, the update is ignored. Example: If you pass an `IncrementFrom` value of 2 for the `version` attribute but the current value is 1, the API ignores the update. If the object doesn't exist, the API only creates it if you pass an `IncrementFrom` value of 0. - `IncrementSet`: increment a numeric integer attribute only if the provided value is greater than the current value. Otherwise, the update is ignored. Example: If you pass an `IncrementSet` value of 2 for the `version` attribute and the current value is 1, the API updates the object. If the object doesn't exist yet, the API only creates it if you pass an `IncrementSet` value greater than 0. Specify an operation by providing an object with the attribute to update as the key and its value as an object with these properties: - `_operation`: the operation to apply on the attribute. - `value`: the right-hand side argument to the operation, for example, increment or decrement step, or a value to add or remove. When updating multiple attributes or using multiple operations targeting the same record, use a single partial update for faster processing. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
2133
2133
|
#
|
|
2134
2134
|
# Required API Key ACLs:
|
|
2135
2135
|
# - addObject
|
data/lib/algolia/defaults.rb
CHANGED
|
@@ -65,7 +65,7 @@ module Algolia
|
|
|
65
65
|
|
|
66
66
|
attr_accessor :facet_filters
|
|
67
67
|
|
|
68
|
-
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper
|
|
68
|
+
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>`, where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>`, where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can't use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can't combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes if the facet attribute name or facet value contains spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
69
69
|
attr_accessor :filters
|
|
70
70
|
|
|
71
71
|
# Whether the search response should include detailed ranking information.
|
|
@@ -106,7 +106,7 @@ module Algolia
|
|
|
106
106
|
# Impact that Personalization should have on this search The higher this value is, the more Personalization determines the ranking compared to other factors. For more information, see [Understanding Personalization impact](https://www.algolia.com/doc/guides/personalization/personalizing-results/in-depth/configuring-personalization/#understanding-personalization-impact).
|
|
107
107
|
attr_accessor :personalization_impact
|
|
108
108
|
|
|
109
|
-
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries
|
|
109
|
+
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries. This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages. To support this, place the CJK language **first**. **Always specify a query language.** If you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
110
110
|
attr_accessor :query_languages
|
|
111
111
|
|
|
112
112
|
attr_accessor :query_type
|
|
@@ -7,7 +7,7 @@ require "time"
|
|
|
7
7
|
|
|
8
8
|
module Algolia
|
|
9
9
|
module Composition
|
|
10
|
-
# Treat singular, plurals, and other forms of declensions as equivalent.
|
|
10
|
+
# Treat singular, plurals, and other forms of declensions as equivalent. Only use this feature for the languages used in your index.
|
|
11
11
|
module IgnorePlurals
|
|
12
12
|
class << self
|
|
13
13
|
# List of class defined in oneOf (OpenAPI v3)
|
|
@@ -65,7 +65,7 @@ module Algolia
|
|
|
65
65
|
|
|
66
66
|
attr_accessor :facet_filters
|
|
67
67
|
|
|
68
|
-
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper
|
|
68
|
+
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>`, where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>`, where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can't use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can't combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes if the facet attribute name or facet value contains spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
69
69
|
attr_accessor :filters
|
|
70
70
|
|
|
71
71
|
# Whether the search response should include detailed ranking information.
|
|
@@ -106,7 +106,7 @@ module Algolia
|
|
|
106
106
|
# Impact that Personalization should have on this search The higher this value is, the more Personalization determines the ranking compared to other factors. For more information, see [Understanding Personalization impact](https://www.algolia.com/doc/guides/personalization/personalizing-results/in-depth/configuring-personalization/#understanding-personalization-impact).
|
|
107
107
|
attr_accessor :personalization_impact
|
|
108
108
|
|
|
109
|
-
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries
|
|
109
|
+
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries. This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages. To support this, place the CJK language **first**. **Always specify a query language.** If you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
110
110
|
attr_accessor :query_languages
|
|
111
111
|
|
|
112
112
|
attr_accessor :query_type
|
|
@@ -7,7 +7,7 @@ require "time"
|
|
|
7
7
|
|
|
8
8
|
module Algolia
|
|
9
9
|
module Composition
|
|
10
|
-
# Words that should be considered optional when found in the query. By default, records must match all words in the search query to be included in the search results. Adding optional words can
|
|
10
|
+
# Words that should be considered optional when found in the query. By default, records must match all words in the search query to be included in the search results. Adding optional words can increase the number of search results by running an additional search query that doesn't include the optional words. For example, if the search query is \"action video\" and \"video\" is optional, the search engine runs two queries: one for \"action video\" and one for \"action\". Records that match all words are ranked higher. For a search query with 4 or more words **and** all its words are optional, the number of matched words required for a record to be included in the search results increases for every 1,000 records: - If `optionalWords` has fewer than 10 words, the required number of matched words increases by 1: results 1 to 1,000 require 1 matched word; results 1,001 to 2,000 need 2 matched words. - If `optionalWords` has 10 or more words, the required number of matched words increases by the number of optional words divided by 5 (rounded down). Example: with 18 optional words, results 1 to 1,000 require 1 matched word; results 1,001 to 2,000 need 4 matched words. For more information, see [Optional words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/#creating-a-list-of-optional-words).
|
|
11
11
|
module OptionalWords
|
|
12
12
|
class << self
|
|
13
13
|
# List of class defined in oneOf (OpenAPI v3)
|
|
@@ -44,7 +44,7 @@ module Algolia
|
|
|
44
44
|
# Facets for which to retrieve facet values that match the search criteria and the number of matching facet values To retrieve all facets, use the wildcard character `*`. To retrieve disjunctive facets lists, annotate any facets with the `disjunctive` modifier. For more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts) and [disjunctive faceting for Smart Groups](https://www.algolia.com/doc/guides/managing-results/compositions/search-based-groups#facets-including-disjunctive-faceting).
|
|
45
45
|
attr_accessor :facets
|
|
46
46
|
|
|
47
|
-
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper
|
|
47
|
+
# Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>`, where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>`, where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can't use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can't combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes if the facet attribute name or facet value contains spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
48
48
|
attr_accessor :filters
|
|
49
49
|
|
|
50
50
|
# Whether the run response should include detailed ranking information.
|
|
@@ -77,7 +77,7 @@ module Algolia
|
|
|
77
77
|
# Search query.
|
|
78
78
|
attr_accessor :query
|
|
79
79
|
|
|
80
|
-
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries
|
|
80
|
+
# Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries. This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages. To support this, place the CJK language **first**. **Always specify a query language.** If you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
81
81
|
attr_accessor :query_languages
|
|
82
82
|
|
|
83
83
|
# Relevancy threshold below which less relevant results aren't included in the results You can only set `relevancyStrictness` on [virtual replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas/#what-are-virtual-replicas). Use this setting to strike a balance between the relevance and number of returned results.
|
|
@@ -7,7 +7,7 @@ require "time"
|
|
|
7
7
|
|
|
8
8
|
module Algolia
|
|
9
9
|
module Composition
|
|
10
|
-
# Removes stop words from the search query. Stop words are common words like articles, conjunctions, prepositions, or pronouns that have little or no meaning on their own. In English, \"the\", \"a\", or \"and\" are stop words.
|
|
10
|
+
# Removes stop words from the search query. Stop words are common words like articles, conjunctions, prepositions, or pronouns that have little or no meaning on their own. In English, \"the\", \"a\", or \"and\" are stop words. Only use this feature for the languages used in your index.
|
|
11
11
|
module RemoveStopWords
|
|
12
12
|
class << self
|
|
13
13
|
# List of class defined in oneOf (OpenAPI v3)
|