feat(specs): add acl permissions to operations (#2555)

Co-authored-by: Clément Vannicatte <vannicattec@gmail.com>

Author: kai687

specs/abtesting/paths/abtest.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - abtest
   operationId: getABTest
+  x-acl:
+    - analytics
   summary: Get A/B test details.
   description: >
     Get specific details for an A/B test.
@@ -29,6 +31,8 @@ delete:
   tags:
     - abtest
   operationId: deleteABTest
+  x-acl:
+    - editSettings
   summary: Delete an A/B test.
   description: >
     Delete an A/B test.

specs/abtesting/paths/abtests.yml

@@ -2,6 +2,8 @@ post:
   tags:
     - abtest
   operationId: addABTests
+  x-acl:
+    - editSettings
   summary: Create an A/B test.
   description: Creates an A/B test.
   requestBody:
@@ -48,6 +50,8 @@ get:
   tags:
     - abtest
   operationId: listABTests
+  x-acl:
+    - analytics
   summary: List all A/B tests.
   description: List all A/B tests.
   parameters:

specs/abtesting/paths/stopABTest.yml

@@ -2,11 +2,13 @@ post:
   tags:
     - abtest
   operationId: stopABTest
+  x-acl:
+    - editSettings
   summary: Stop an A/B test.
   description: >
     If stopped, the test is over and can't be restarted.
     There is now only one index, receiving 100% of all search requests.
-    
+
     The data gathered for stopped A/B tests is retained.
 
     To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).

specs/analytics/paths/click/getAverageClickPosition.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - click
   operationId: getAverageClickPosition
+  x-acl:
+    - analytics
   summary: Get average click position.
   description: >
     Return the average click position for the complete time range and for individual days.

specs/analytics/paths/click/getClickPositions.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - click
   operationId: getClickPositions
+  x-acl:
+    - analytics
   summary: Get click positions.
   description: |
     Show the number of clicks events and their associated position in the search results.
@@ -46,7 +48,7 @@ get:
                         - For positions 11 to 20, all click events are grouped
                         - For positions 21 and up, all click events are grouped.
                       type: array
-                      example: [10,10]
+                      example: [10, 10]
                       items:
                         type: integer
                     clickCount:

specs/analytics/paths/click/getClickThroughRate.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - click
   operationId: getClickThroughRate
+  x-acl:
+    - analytics
   summary: Get click-through rate (CTR).
   description: Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
   parameters:

specs/analytics/paths/click/getConversionRate.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - click
   operationId: getConversationRate
+  x-acl:
+    - analytics
   summary: Get conversion rate (CR).
   description: Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
   parameters:

specs/analytics/paths/search/getNoClickRate.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - search
   operationId: getNoClickRate
+  x-acl:
+    - analytics
   summary: Get no click rate.
   description: Returns the rate at which searches don't lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
   parameters:

specs/analytics/paths/search/getNoResultsRate.yml

@@ -2,8 +2,10 @@ get:
   tags:
     - search
   operationId: getNoResultsRate
+  x-acl:
+    - analytics
   summary: Get no results rate.
-  description: Returns the rate at which searches didn't return any results. 
+  description: Returns the rate at which searches didn't return any results.
   parameters:
     - $ref: '../../../common/parameters.yml#/Index'
     - $ref: '../../../common/parameters.yml#/StartDate'

specs/analytics/paths/search/getSearchesCount.yml

@@ -2,6 +2,8 @@ get:
   tags:
     - search
   operationId: getSearchesCount
+  x-acl:
+    - analytics
   summary: Get number of searches.
   description: Returns the number of searches within a time range.
   parameters: