Skip to content

Commit 458516b

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
feat: [retail] add analytics service (#10261)
* feat: add analytics service PiperOrigin-RevId: 600040070 Source-Link: googleapis/googleapis@f4efe4b Source-Link: https://github.com/googleapis/googleapis-gen/commit/2154296dd71c00bb805b3d1e9b9b715739145623 Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6IjIxNTQyOTZkZDcxYzAwYmI4MDViM2QxZTliOWI3MTU3MzkxNDU2MjMifQ== feat: add analytics service PiperOrigin-RevId: 599976565 Source-Link: googleapis/googleapis@3d20b39 Source-Link: https://github.com/googleapis/googleapis-gen/commit/f916ef865f8ab85ccf50d10a644e4356389c87ca Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6ImY5MTZlZjg2NWY4YWI4NWNjZjUwZDEwYTY0NGU0MzU2Mzg5Yzg3Y2EifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 9785f8c commit 458516b

File tree

125 files changed

+20202
-918
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

125 files changed

+20202
-918
lines changed

‎java-retail/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
195195
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
196196
[stability-image]: https://img.shields.io/badge/stability-stable-green
197197
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-retail.svg
198-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-retail/2.34.0
198+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-retail/2.35.0
199199
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
200200
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
201201
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

‎java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java

Lines changed: 49 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -58,50 +58,52 @@
5858
* as threads. In the example above, try-with-resources is used, which automatically calls close().
5959
*
6060
* <table>
61+
* <caption>Methods</caption>
6162
* <tr>
6263
* <th>Method</th>
6364
* <th>Description</th>
6465
* <th>Method Variants</th>
66+
* </tr>
6567
* <tr>
66-
* <td>ListCatalogs</td>
68+
* <td><p> ListCatalogs</td>
6769
* <td><p> Lists all the [Catalog][google.cloud.retail.v2.Catalog]s associated with the project.</td>
6870
* <td>
6971
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
7072
* <ul>
71-
* <li>listCatalogs(ListCatalogsRequest request)
73+
* <li><p> listCatalogs(ListCatalogsRequest request)
7274
* </ul>
7375
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
7476
* <ul>
75-
* <li>listCatalogs(LocationName parent)
76-
* <li>listCatalogs(String parent)
77+
* <li><p> listCatalogs(LocationName parent)
78+
* <li><p> listCatalogs(String parent)
7779
* </ul>
7880
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
7981
* <ul>
80-
* <li>listCatalogsPagedCallable()
81-
* <li>listCatalogsCallable()
82+
* <li><p> listCatalogsPagedCallable()
83+
* <li><p> listCatalogsCallable()
8284
* </ul>
8385
* </td>
8486
* </tr>
8587
* <tr>
86-
* <td>UpdateCatalog</td>
88+
* <td><p> UpdateCatalog</td>
8789
* <td><p> Updates the [Catalog][google.cloud.retail.v2.Catalog]s.</td>
8890
* <td>
8991
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
9092
* <ul>
91-
* <li>updateCatalog(UpdateCatalogRequest request)
93+
* <li><p> updateCatalog(UpdateCatalogRequest request)
9294
* </ul>
9395
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
9496
* <ul>
95-
* <li>updateCatalog(Catalog catalog, FieldMask updateMask)
97+
* <li><p> updateCatalog(Catalog catalog, FieldMask updateMask)
9698
* </ul>
9799
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
98100
* <ul>
99-
* <li>updateCatalogCallable()
101+
* <li><p> updateCatalogCallable()
100102
* </ul>
101103
* </td>
102104
* </tr>
103105
* <tr>
104-
* <td>SetDefaultBranch</td>
106+
* <td><p> SetDefaultBranch</td>
105107
* <td><p> Set a specified branch id as default branch. API methods such as [SearchService.Search][google.cloud.retail.v2.SearchService.Search], [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct], [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts] will treat requests using "default_branch" to the actual branch id set as default.
106108
* <p> For example, if `projects/&#42;/locations/&#42;/catalogs/&#42;/branches/1` is set as default, setting [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to `projects/&#42;/locations/&#42;/catalogs/&#42;/branches/default_branch` is equivalent to setting [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to `projects/&#42;/locations/&#42;/catalogs/&#42;/branches/1`.
107109
* <p> Using multiple branches can be useful when developers would like to have a staging branch to test and verify for future usage. When it becomes ready, developers switch on the staging branch using this API while keeping using `projects/&#42;/locations/&#42;/catalogs/&#42;/branches/default_branch` as [SearchRequest.branch][google.cloud.retail.v2.SearchRequest.branch] to route the traffic to this staging branch.
@@ -115,159 +117,158 @@
115117
* <td>
116118
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
117119
* <ul>
118-
* <li>setDefaultBranch(SetDefaultBranchRequest request)
120+
* <li><p> setDefaultBranch(SetDefaultBranchRequest request)
119121
* </ul>
120122
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
121123
* <ul>
122-
* <li>setDefaultBranch(CatalogName catalog)
123-
* <li>setDefaultBranch(String catalog)
124+
* <li><p> setDefaultBranch(CatalogName catalog)
125+
* <li><p> setDefaultBranch(String catalog)
124126
* </ul>
125127
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
126128
* <ul>
127-
* <li>setDefaultBranchCallable()
129+
* <li><p> setDefaultBranchCallable()
128130
* </ul>
129131
* </td>
130132
* </tr>
131133
* <tr>
132-
* <td>GetDefaultBranch</td>
134+
* <td><p> GetDefaultBranch</td>
133135
* <td><p> Get which branch is currently default branch set by [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch] method under a specified parent catalog.</td>
134136
* <td>
135137
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
136138
* <ul>
137-
* <li>getDefaultBranch(GetDefaultBranchRequest request)
139+
* <li><p> getDefaultBranch(GetDefaultBranchRequest request)
138140
* </ul>
139141
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
140142
* <ul>
141-
* <li>getDefaultBranch(CatalogName catalog)
142-
* <li>getDefaultBranch(String catalog)
143+
* <li><p> getDefaultBranch(CatalogName catalog)
144+
* <li><p> getDefaultBranch(String catalog)
143145
* </ul>
144146
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
145147
* <ul>
146-
* <li>getDefaultBranchCallable()
148+
* <li><p> getDefaultBranchCallable()
147149
* </ul>
148150
* </td>
149151
* </tr>
150152
* <tr>
151-
* <td>GetCompletionConfig</td>
153+
* <td><p> GetCompletionConfig</td>
152154
* <td><p> Gets a [CompletionConfig][google.cloud.retail.v2.CompletionConfig].</td>
153155
* <td>
154156
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
155157
* <ul>
156-
* <li>getCompletionConfig(GetCompletionConfigRequest request)
158+
* <li><p> getCompletionConfig(GetCompletionConfigRequest request)
157159
* </ul>
158160
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
159161
* <ul>
160-
* <li>getCompletionConfig(CompletionConfigName name)
161-
* <li>getCompletionConfig(String name)
162+
* <li><p> getCompletionConfig(CompletionConfigName name)
163+
* <li><p> getCompletionConfig(String name)
162164
* </ul>
163165
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
164166
* <ul>
165-
* <li>getCompletionConfigCallable()
167+
* <li><p> getCompletionConfigCallable()
166168
* </ul>
167169
* </td>
168170
* </tr>
169171
* <tr>
170-
* <td>UpdateCompletionConfig</td>
172+
* <td><p> UpdateCompletionConfig</td>
171173
* <td><p> Updates the [CompletionConfig][google.cloud.retail.v2.CompletionConfig]s.</td>
172174
* <td>
173175
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
174176
* <ul>
175-
* <li>updateCompletionConfig(UpdateCompletionConfigRequest request)
177+
* <li><p> updateCompletionConfig(UpdateCompletionConfigRequest request)
176178
* </ul>
177179
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
178180
* <ul>
179-
* <li>updateCompletionConfig(CompletionConfig completionConfig, FieldMask updateMask)
181+
* <li><p> updateCompletionConfig(CompletionConfig completionConfig, FieldMask updateMask)
180182
* </ul>
181183
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
182184
* <ul>
183-
* <li>updateCompletionConfigCallable()
185+
* <li><p> updateCompletionConfigCallable()
184186
* </ul>
185187
* </td>
186188
* </tr>
187189
* <tr>
188-
* <td>GetAttributesConfig</td>
190+
* <td><p> GetAttributesConfig</td>
189191
* <td><p> Gets an [AttributesConfig][google.cloud.retail.v2.AttributesConfig].</td>
190192
* <td>
191193
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
192194
* <ul>
193-
* <li>getAttributesConfig(GetAttributesConfigRequest request)
195+
* <li><p> getAttributesConfig(GetAttributesConfigRequest request)
194196
* </ul>
195197
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
196198
* <ul>
197-
* <li>getAttributesConfig(AttributesConfigName name)
198-
* <li>getAttributesConfig(String name)
199+
* <li><p> getAttributesConfig(AttributesConfigName name)
200+
* <li><p> getAttributesConfig(String name)
199201
* </ul>
200202
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
201203
* <ul>
202-
* <li>getAttributesConfigCallable()
204+
* <li><p> getAttributesConfigCallable()
203205
* </ul>
204206
* </td>
205207
* </tr>
206208
* <tr>
207-
* <td>UpdateAttributesConfig</td>
209+
* <td><p> UpdateAttributesConfig</td>
208210
* <td><p> Updates the [AttributesConfig][google.cloud.retail.v2.AttributesConfig].
209211
* <p> The catalog attributes in the request will be updated in the catalog, or inserted if they do not exist. Existing catalog attributes not included in the request will remain unchanged. Attributes that are assigned to products, but do not exist at the catalog level, are always included in the response. The product attribute is assigned default values for missing catalog attribute fields, e.g., searchable and dynamic facetable options.</td>
210212
* <td>
211213
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
212214
* <ul>
213-
* <li>updateAttributesConfig(UpdateAttributesConfigRequest request)
215+
* <li><p> updateAttributesConfig(UpdateAttributesConfigRequest request)
214216
* </ul>
215217
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
216218
* <ul>
217-
* <li>updateAttributesConfig(AttributesConfig attributesConfig, FieldMask updateMask)
219+
* <li><p> updateAttributesConfig(AttributesConfig attributesConfig, FieldMask updateMask)
218220
* </ul>
219221
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
220222
* <ul>
221-
* <li>updateAttributesConfigCallable()
223+
* <li><p> updateAttributesConfigCallable()
222224
* </ul>
223225
* </td>
224226
* </tr>
225227
* <tr>
226-
* <td>AddCatalogAttribute</td>
228+
* <td><p> AddCatalogAttribute</td>
227229
* <td><p> Adds the specified [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] to the [AttributesConfig][google.cloud.retail.v2.AttributesConfig].
228230
* <p> If the [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] to add already exists, an ALREADY_EXISTS error is returned.</td>
229231
* <td>
230232
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
231233
* <ul>
232-
* <li>addCatalogAttribute(AddCatalogAttributeRequest request)
234+
* <li><p> addCatalogAttribute(AddCatalogAttributeRequest request)
233235
* </ul>
234236
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
235237
* <ul>
236-
* <li>addCatalogAttributeCallable()
238+
* <li><p> addCatalogAttributeCallable()
237239
* </ul>
238240
* </td>
239241
* </tr>
240242
* <tr>
241-
* <td>RemoveCatalogAttribute</td>
243+
* <td><p> RemoveCatalogAttribute</td>
242244
* <td><p> Removes the specified [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] from the [AttributesConfig][google.cloud.retail.v2.AttributesConfig].
243245
* <p> If the [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] to remove does not exist, a NOT_FOUND error is returned.</td>
244246
* <td>
245247
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
246248
* <ul>
247-
* <li>removeCatalogAttribute(RemoveCatalogAttributeRequest request)
249+
* <li><p> removeCatalogAttribute(RemoveCatalogAttributeRequest request)
248250
* </ul>
249251
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
250252
* <ul>
251-
* <li>removeCatalogAttributeCallable()
253+
* <li><p> removeCatalogAttributeCallable()
252254
* </ul>
253255
* </td>
254256
* </tr>
255257
* <tr>
256-
* <td>ReplaceCatalogAttribute</td>
258+
* <td><p> ReplaceCatalogAttribute</td>
257259
* <td><p> Replaces the specified [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] in the [AttributesConfig][google.cloud.retail.v2.AttributesConfig] by updating the catalog attribute with the same [CatalogAttribute.key][google.cloud.retail.v2.CatalogAttribute.key].
258260
* <p> If the [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] to replace does not exist, a NOT_FOUND error is returned.</td>
259261
* <td>
260262
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
261263
* <ul>
262-
* <li>replaceCatalogAttribute(ReplaceCatalogAttributeRequest request)
264+
* <li><p> replaceCatalogAttribute(ReplaceCatalogAttributeRequest request)
263265
* </ul>
264266
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
265267
* <ul>
266-
* <li>replaceCatalogAttributeCallable()
268+
* <li><p> replaceCatalogAttributeCallable()
267269
* </ul>
268270
* </td>
269271
* </tr>
270-
* </tr>
271272
* </table>
272273
*
273274
* <p>See the individual methods for example code.

‎java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -66,44 +66,45 @@
6666
* close().
6767
*
6868
* <table>
69+
* <caption>Methods</caption>
6970
* <tr>
7071
* <th>Method</th>
7172
* <th>Description</th>
7273
* <th>Method Variants</th>
74+
* </tr>
7375
* <tr>
74-
* <td>CompleteQuery</td>
76+
* <td><p> CompleteQuery</td>
7577
* <td><p> Completes the specified prefix with keyword suggestions.
7678
* <p> This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.</td>
7779
* <td>
7880
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
7981
* <ul>
80-
* <li>completeQuery(CompleteQueryRequest request)
82+
* <li><p> completeQuery(CompleteQueryRequest request)
8183
* </ul>
8284
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
8385
* <ul>
84-
* <li>completeQueryCallable()
86+
* <li><p> completeQueryCallable()
8587
* </ul>
8688
* </td>
8789
* </tr>
8890
* <tr>
89-
* <td>ImportCompletionData</td>
91+
* <td><p> ImportCompletionData</td>
9092
* <td><p> Bulk import of processed completion dataset.
9193
* <p> Request processing is asynchronous. Partial updating is not supported.
9294
* <p> The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours.
9395
* <p> This feature is only available for users who have Retail Search enabled. Enable Retail Search on Cloud Console before using this feature.</td>
9496
* <td>
9597
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
9698
* <ul>
97-
* <li>importCompletionDataAsync(ImportCompletionDataRequest request)
99+
* <li><p> importCompletionDataAsync(ImportCompletionDataRequest request)
98100
* </ul>
99101
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
100102
* <ul>
101-
* <li>importCompletionDataOperationCallable()
102-
* <li>importCompletionDataCallable()
103+
* <li><p> importCompletionDataOperationCallable()
104+
* <li><p> importCompletionDataCallable()
103105
* </ul>
104106
* </td>
105107
* </tr>
106-
* </tr>
107108
* </table>
108109
*
109110
* <p>See the individual methods for example code.

0 commit comments

Comments
 (0)