@google-cloud/discoveryengine 1.7.0 → 1.9.0

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.
Files changed (229) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +33 -4
  3. package/build/protos/google/cloud/discoveryengine/v1/answer.proto +337 -0
  4. package/build/protos/google/cloud/discoveryengine/v1/common.proto +34 -1
  5. package/build/protos/google/cloud/discoveryengine/v1/completion.proto +1 -1
  6. package/build/protos/google/cloud/discoveryengine/v1/completion_service.proto +1 -1
  7. package/build/protos/google/cloud/discoveryengine/v1/control.proto +214 -0
  8. package/build/protos/google/cloud/discoveryengine/v1/control_service.proto +236 -0
  9. package/build/protos/google/cloud/discoveryengine/v1/conversation.proto +3 -3
  10. package/build/protos/google/cloud/discoveryengine/v1/conversational_search_service.proto +570 -1
  11. package/build/protos/google/cloud/discoveryengine/v1/data_store.proto +5 -1
  12. package/build/protos/google/cloud/discoveryengine/v1/data_store_service.proto +3 -3
  13. package/build/protos/google/cloud/discoveryengine/v1/document.proto +1 -1
  14. package/build/protos/google/cloud/discoveryengine/v1/document_processing_config.proto +92 -0
  15. package/build/protos/google/cloud/discoveryengine/v1/document_service.proto +7 -7
  16. package/build/protos/google/cloud/discoveryengine/v1/engine.proto +5 -5
  17. package/build/protos/google/cloud/discoveryengine/v1/engine_service.proto +1 -1
  18. package/build/protos/google/cloud/discoveryengine/v1/grounded_generation_service.proto +149 -0
  19. package/build/protos/google/cloud/discoveryengine/v1/grounding.proto +58 -0
  20. package/build/protos/google/cloud/discoveryengine/v1/import_config.proto +5 -5
  21. package/build/protos/google/cloud/discoveryengine/v1/project.proto +103 -0
  22. package/build/protos/google/cloud/discoveryengine/v1/project_service.proto +90 -0
  23. package/build/protos/google/cloud/discoveryengine/v1/purge_config.proto +1 -1
  24. package/build/protos/google/cloud/discoveryengine/v1/rank_service.proto +131 -0
  25. package/build/protos/google/cloud/discoveryengine/v1/recommendation_service.proto +21 -20
  26. package/build/protos/google/cloud/discoveryengine/v1/schema.proto +1 -1
  27. package/build/protos/google/cloud/discoveryengine/v1/schema_service.proto +6 -6
  28. package/build/protos/google/cloud/discoveryengine/v1/search_service.proto +24 -19
  29. package/build/protos/google/cloud/discoveryengine/v1/session.proto +97 -0
  30. package/build/protos/google/cloud/discoveryengine/v1/site_search_engine.proto +4 -1
  31. package/build/protos/google/cloud/discoveryengine/v1/site_search_engine_service.proto +1 -1
  32. package/build/protos/google/cloud/discoveryengine/v1/user_event.proto +29 -4
  33. package/build/protos/google/cloud/discoveryengine/v1/user_event_service.proto +19 -3
  34. package/build/protos/google/cloud/discoveryengine/v1alpha/acl_config.proto +1 -1
  35. package/build/protos/google/cloud/discoveryengine/v1alpha/acl_config_service.proto +1 -1
  36. package/build/protos/google/cloud/discoveryengine/v1alpha/answer.proto +10 -1
  37. package/build/protos/google/cloud/discoveryengine/v1alpha/chunk.proto +8 -1
  38. package/build/protos/google/cloud/discoveryengine/v1alpha/chunk_service.proto +1 -1
  39. package/build/protos/google/cloud/discoveryengine/v1alpha/common.proto +17 -1
  40. package/build/protos/google/cloud/discoveryengine/v1alpha/completion.proto +1 -1
  41. package/build/protos/google/cloud/discoveryengine/v1alpha/completion_service.proto +1 -1
  42. package/build/protos/google/cloud/discoveryengine/v1alpha/control.proto +217 -0
  43. package/build/protos/google/cloud/discoveryengine/v1alpha/control_service.proto +236 -0
  44. package/build/protos/google/cloud/discoveryengine/v1alpha/conversation.proto +3 -3
  45. package/build/protos/google/cloud/discoveryengine/v1alpha/conversational_search_service.proto +20 -4
  46. package/build/protos/google/cloud/discoveryengine/v1alpha/custom_tuning_model.proto +87 -0
  47. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store.proto +1 -1
  48. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store_service.proto +3 -3
  49. package/build/protos/google/cloud/discoveryengine/v1alpha/document.proto +1 -1
  50. package/build/protos/google/cloud/discoveryengine/v1alpha/document_processing_config.proto +2 -1
  51. package/build/protos/google/cloud/discoveryengine/v1alpha/document_service.proto +13 -10
  52. package/build/protos/google/cloud/discoveryengine/v1alpha/engine.proto +5 -5
  53. package/build/protos/google/cloud/discoveryengine/v1alpha/engine_service.proto +1 -1
  54. package/build/protos/google/cloud/discoveryengine/v1alpha/estimate_billing_service.proto +1 -1
  55. package/build/protos/google/cloud/discoveryengine/v1alpha/grounded_generation_service.proto +31 -2
  56. package/build/protos/google/cloud/discoveryengine/v1alpha/grounding.proto +4 -1
  57. package/build/protos/google/cloud/discoveryengine/v1alpha/import_config.proto +5 -5
  58. package/build/protos/google/cloud/discoveryengine/v1alpha/project.proto +2 -1
  59. package/build/protos/google/cloud/discoveryengine/v1alpha/project_service.proto +3 -1
  60. package/build/protos/google/cloud/discoveryengine/v1alpha/purge_config.proto +1 -1
  61. package/build/protos/google/cloud/discoveryengine/v1alpha/rank_service.proto +20 -1
  62. package/build/protos/google/cloud/discoveryengine/v1alpha/recommendation_service.proto +21 -20
  63. package/build/protos/google/cloud/discoveryengine/v1alpha/schema.proto +38 -3
  64. package/build/protos/google/cloud/discoveryengine/v1alpha/schema_service.proto +7 -7
  65. package/build/protos/google/cloud/discoveryengine/v1alpha/search_service.proto +29 -32
  66. package/build/protos/google/cloud/discoveryengine/v1alpha/search_tuning_service.proto +40 -1
  67. package/build/protos/google/cloud/discoveryengine/v1alpha/serving_config.proto +1 -1
  68. package/build/protos/google/cloud/discoveryengine/v1alpha/serving_config_service.proto +1 -1
  69. package/build/protos/google/cloud/discoveryengine/v1alpha/session.proto +4 -1
  70. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine.proto +4 -1
  71. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine_service.proto +1 -1
  72. package/build/protos/google/cloud/discoveryengine/v1alpha/user_event.proto +30 -4
  73. package/build/protos/google/cloud/discoveryengine/v1alpha/user_event_service.proto +19 -3
  74. package/build/protos/google/cloud/discoveryengine/v1beta/answer.proto +11 -2
  75. package/build/protos/google/cloud/discoveryengine/v1beta/common.proto +17 -1
  76. package/build/protos/google/cloud/discoveryengine/v1beta/completion.proto +1 -1
  77. package/build/protos/google/cloud/discoveryengine/v1beta/completion_service.proto +1 -1
  78. package/build/protos/google/cloud/discoveryengine/v1beta/control.proto +216 -0
  79. package/build/protos/google/cloud/discoveryengine/v1beta/control_service.proto +236 -0
  80. package/build/protos/google/cloud/discoveryengine/v1beta/conversation.proto +3 -3
  81. package/build/protos/google/cloud/discoveryengine/v1beta/conversational_search_service.proto +20 -4
  82. package/build/protos/google/cloud/discoveryengine/v1beta/custom_tuning_model.proto +87 -0
  83. package/build/protos/google/cloud/discoveryengine/v1beta/data_store.proto +1 -1
  84. package/build/protos/google/cloud/discoveryengine/v1beta/data_store_service.proto +3 -3
  85. package/build/protos/google/cloud/discoveryengine/v1beta/document.proto +1 -1
  86. package/build/protos/google/cloud/discoveryengine/v1beta/document_processing_config.proto +2 -1
  87. package/build/protos/google/cloud/discoveryengine/v1beta/document_service.proto +8 -9
  88. package/build/protos/google/cloud/discoveryengine/v1beta/engine.proto +5 -5
  89. package/build/protos/google/cloud/discoveryengine/v1beta/engine_service.proto +1 -1
  90. package/build/protos/google/cloud/discoveryengine/v1beta/grounded_generation_service.proto +31 -2
  91. package/build/protos/google/cloud/discoveryengine/v1beta/grounding.proto +4 -1
  92. package/build/protos/google/cloud/discoveryengine/v1beta/import_config.proto +5 -5
  93. package/build/protos/google/cloud/discoveryengine/v1beta/project.proto +103 -0
  94. package/build/protos/google/cloud/discoveryengine/v1beta/project_service.proto +90 -0
  95. package/build/protos/google/cloud/discoveryengine/v1beta/purge_config.proto +1 -1
  96. package/build/protos/google/cloud/discoveryengine/v1beta/rank_service.proto +20 -1
  97. package/build/protos/google/cloud/discoveryengine/v1beta/recommendation_service.proto +21 -20
  98. package/build/protos/google/cloud/discoveryengine/v1beta/schema.proto +1 -1
  99. package/build/protos/google/cloud/discoveryengine/v1beta/schema_service.proto +6 -6
  100. package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto +31 -25
  101. package/build/protos/google/cloud/discoveryengine/v1beta/search_tuning_service.proto +40 -1
  102. package/build/protos/google/cloud/discoveryengine/v1beta/serving_config.proto +1 -1
  103. package/build/protos/google/cloud/discoveryengine/v1beta/serving_config_service.proto +1 -1
  104. package/build/protos/google/cloud/discoveryengine/v1beta/session.proto +5 -2
  105. package/build/protos/google/cloud/discoveryengine/v1beta/site_search_engine.proto +4 -1
  106. package/build/protos/google/cloud/discoveryengine/v1beta/site_search_engine_service.proto +1 -1
  107. package/build/protos/google/cloud/discoveryengine/v1beta/user_event.proto +29 -4
  108. package/build/protos/google/cloud/discoveryengine/v1beta/user_event_service.proto +19 -3
  109. package/build/protos/protos.d.ts +52350 -38733
  110. package/build/protos/protos.js +136479 -103212
  111. package/build/protos/protos.json +9460 -5916
  112. package/build/src/index.d.ts +13 -1
  113. package/build/src/index.js +13 -1
  114. package/build/src/v1/completion_service_client.d.ts +549 -0
  115. package/build/src/v1/completion_service_client.js +771 -0
  116. package/build/src/v1/control_service_client.d.ts +1623 -0
  117. package/build/src/v1/control_service_client.js +2218 -0
  118. package/build/src/v1/control_service_client_config.json +63 -0
  119. package/build/src/v1/conversational_search_service_client.d.ts +893 -0
  120. package/build/src/v1/conversational_search_service_client.js +1040 -14
  121. package/build/src/v1/conversational_search_service_client_config.json +35 -0
  122. package/build/src/v1/data_store_service_client.d.ts +555 -6
  123. package/build/src/v1/data_store_service_client.js +775 -4
  124. package/build/src/v1/document_service_client.d.ts +557 -8
  125. package/build/src/v1/document_service_client.js +773 -2
  126. package/build/src/v1/engine_service_client.d.ts +549 -0
  127. package/build/src/v1/engine_service_client.js +771 -0
  128. package/build/src/v1/grounded_generation_service_client.d.ts +1439 -0
  129. package/build/src/v1/grounded_generation_service_client.js +2036 -0
  130. package/build/src/v1/grounded_generation_service_client_config.json +43 -0
  131. package/build/src/v1/index.d.ts +4 -0
  132. package/build/src/v1/index.js +9 -1
  133. package/build/src/v1/project_service_client.d.ts +1533 -0
  134. package/build/src/v1/project_service_client.js +2255 -0
  135. package/build/src/v1/project_service_client_config.json +43 -0
  136. package/build/src/v1/rank_service_client.d.ts +1449 -0
  137. package/build/src/v1/rank_service_client.js +2037 -0
  138. package/build/src/v1/rank_service_client_config.json +43 -0
  139. package/build/src/v1/recommendation_service_client.d.ts +568 -18
  140. package/build/src/v1/recommendation_service_client.js +756 -0
  141. package/build/src/v1/schema_service_client.d.ts +558 -9
  142. package/build/src/v1/schema_service_client.js +775 -4
  143. package/build/src/v1/search_service_client.d.ts +579 -21
  144. package/build/src/v1/search_service_client.js +776 -14
  145. package/build/src/v1/site_search_engine_service_client.d.ts +549 -0
  146. package/build/src/v1/site_search_engine_service_client.js +771 -0
  147. package/build/src/v1/user_event_service_client.d.ts +562 -2
  148. package/build/src/v1/user_event_service_client.js +771 -0
  149. package/build/src/v1alpha/acl_config_service_client.d.ts +237 -0
  150. package/build/src/v1alpha/acl_config_service_client.js +326 -0
  151. package/build/src/v1alpha/chunk_service_client.d.ts +237 -0
  152. package/build/src/v1alpha/chunk_service_client.js +326 -0
  153. package/build/src/v1alpha/completion_service_client.d.ts +237 -0
  154. package/build/src/v1alpha/completion_service_client.js +340 -0
  155. package/build/src/v1alpha/control_service_client.d.ts +2013 -0
  156. package/build/src/v1alpha/control_service_client.js +2757 -0
  157. package/build/src/v1alpha/control_service_client_config.json +63 -0
  158. package/build/src/v1alpha/conversational_search_service_client.d.ts +239 -2
  159. package/build/src/v1alpha/conversational_search_service_client.js +326 -0
  160. package/build/src/v1alpha/data_store_service_client.d.ts +243 -6
  161. package/build/src/v1alpha/data_store_service_client.js +344 -4
  162. package/build/src/v1alpha/document_service_client.d.ts +246 -9
  163. package/build/src/v1alpha/document_service_client.js +342 -2
  164. package/build/src/v1alpha/engine_service_client.d.ts +237 -0
  165. package/build/src/v1alpha/engine_service_client.js +340 -0
  166. package/build/src/v1alpha/estimate_billing_service_client.d.ts +237 -0
  167. package/build/src/v1alpha/estimate_billing_service_client.js +340 -0
  168. package/build/src/v1alpha/grounded_generation_service_client.d.ts +256 -1
  169. package/build/src/v1alpha/grounded_generation_service_client.js +326 -0
  170. package/build/src/v1alpha/index.d.ts +1 -0
  171. package/build/src/v1alpha/index.js +3 -1
  172. package/build/src/v1alpha/project_service_client.d.ts +239 -0
  173. package/build/src/v1alpha/project_service_client.js +340 -0
  174. package/build/src/v1alpha/project_service_client_config.json +21 -6
  175. package/build/src/v1alpha/rank_service_client.d.ts +255 -0
  176. package/build/src/v1alpha/rank_service_client.js +326 -0
  177. package/build/src/v1alpha/recommendation_service_client.d.ts +256 -18
  178. package/build/src/v1alpha/recommendation_service_client.js +326 -0
  179. package/build/src/v1alpha/schema_service_client.d.ts +247 -10
  180. package/build/src/v1alpha/schema_service_client.js +344 -4
  181. package/build/src/v1alpha/search_service_client.d.ts +267 -21
  182. package/build/src/v1alpha/search_service_client.js +346 -14
  183. package/build/src/v1alpha/search_tuning_service_client.d.ts +265 -0
  184. package/build/src/v1alpha/search_tuning_service_client.js +365 -1
  185. package/build/src/v1alpha/search_tuning_service_client_config.json +4 -0
  186. package/build/src/v1alpha/serving_config_service_client.d.ts +237 -0
  187. package/build/src/v1alpha/serving_config_service_client.js +326 -0
  188. package/build/src/v1alpha/site_search_engine_service_client.d.ts +237 -0
  189. package/build/src/v1alpha/site_search_engine_service_client.js +340 -0
  190. package/build/src/v1alpha/user_event_service_client.d.ts +250 -2
  191. package/build/src/v1alpha/user_event_service_client.js +340 -0
  192. package/build/src/v1beta/completion_service_client.d.ts +252 -0
  193. package/build/src/v1beta/completion_service_client.js +359 -0
  194. package/build/src/v1beta/control_service_client.d.ts +1860 -0
  195. package/build/src/v1beta/control_service_client.js +2545 -0
  196. package/build/src/v1beta/control_service_client_config.json +63 -0
  197. package/build/src/v1beta/conversational_search_service_client.d.ts +254 -2
  198. package/build/src/v1beta/conversational_search_service_client.js +348 -0
  199. package/build/src/v1beta/data_store_service_client.d.ts +258 -6
  200. package/build/src/v1beta/data_store_service_client.js +363 -4
  201. package/build/src/v1beta/document_service_client.d.ts +261 -10
  202. package/build/src/v1beta/document_service_client.js +361 -2
  203. package/build/src/v1beta/engine_service_client.d.ts +252 -0
  204. package/build/src/v1beta/engine_service_client.js +359 -0
  205. package/build/src/v1beta/grounded_generation_service_client.d.ts +271 -1
  206. package/build/src/v1beta/grounded_generation_service_client.js +348 -0
  207. package/build/src/v1beta/index.d.ts +2 -0
  208. package/build/src/v1beta/index.js +5 -1
  209. package/build/src/v1beta/project_service_client.d.ts +1770 -0
  210. package/build/src/v1beta/project_service_client.js +2576 -0
  211. package/build/src/v1beta/project_service_client_config.json +43 -0
  212. package/build/src/v1beta/rank_service_client.d.ts +270 -0
  213. package/build/src/v1beta/rank_service_client.js +348 -0
  214. package/build/src/v1beta/recommendation_service_client.d.ts +271 -18
  215. package/build/src/v1beta/recommendation_service_client.js +348 -0
  216. package/build/src/v1beta/schema_service_client.d.ts +261 -9
  217. package/build/src/v1beta/schema_service_client.js +363 -4
  218. package/build/src/v1beta/search_service_client.d.ts +282 -21
  219. package/build/src/v1beta/search_service_client.js +368 -14
  220. package/build/src/v1beta/search_tuning_service_client.d.ts +280 -0
  221. package/build/src/v1beta/search_tuning_service_client.js +384 -1
  222. package/build/src/v1beta/search_tuning_service_client_config.json +4 -0
  223. package/build/src/v1beta/serving_config_service_client.d.ts +237 -0
  224. package/build/src/v1beta/serving_config_service_client.js +326 -0
  225. package/build/src/v1beta/site_search_engine_service_client.d.ts +252 -0
  226. package/build/src/v1beta/site_search_engine_service_client.js +359 -0
  227. package/build/src/v1beta/user_event_service_client.d.ts +265 -2
  228. package/build/src/v1beta/user_event_service_client.js +359 -0
  229. package/package.json +2 -2
@@ -150,9 +150,12 @@ class SchemaServiceClient {
150
150
  // Create useful helper objects for these.
151
151
  this.pathTemplates = {
152
152
  enginePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}'),
153
+ projectPathTemplate: new this._gaxModule.PathTemplate('projects/{project}'),
153
154
  projectLocationCollectionDataStorePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}'),
154
155
  projectLocationCollectionDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
156
+ projectLocationCollectionDataStoreControlPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/controls/{control}'),
155
157
  projectLocationCollectionDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/conversations/{conversation}'),
158
+ projectLocationCollectionDataStoreCustomTuningModelPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}'),
156
159
  projectLocationCollectionDataStoreDocumentProcessingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/documentProcessingConfig'),
157
160
  projectLocationCollectionDataStoreSchemaPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/schemas/{schema}'),
158
161
  projectLocationCollectionDataStoreServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}'),
@@ -160,13 +163,16 @@ class SchemaServiceClient {
160
163
  projectLocationCollectionDataStoreSessionAnswerPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}/answers/{answer}'),
161
164
  projectLocationCollectionDataStoreSiteSearchEnginePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine'),
162
165
  projectLocationCollectionDataStoreSiteSearchEngineTargetSitePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/targetSites/{target_site}'),
166
+ projectLocationCollectionEngineControlPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/controls/{control}'),
163
167
  projectLocationCollectionEngineConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/conversations/{conversation}'),
164
168
  projectLocationCollectionEngineServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}'),
165
169
  projectLocationCollectionEngineSessionPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}'),
166
170
  projectLocationCollectionEngineSessionAnswerPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/answers/{answer}'),
167
171
  projectLocationDataStorePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}'),
168
172
  projectLocationDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
173
+ projectLocationDataStoreControlPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/controls/{control}'),
169
174
  projectLocationDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/conversations/{conversation}'),
175
+ projectLocationDataStoreCustomTuningModelPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}'),
170
176
  projectLocationDataStoreDocumentProcessingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/documentProcessingConfig'),
171
177
  projectLocationDataStoreSchemaPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/schemas/{schema}'),
172
178
  projectLocationDataStoreServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/servingConfigs/{serving_config}'),
@@ -192,6 +198,17 @@ class SchemaServiceClient {
192
198
  if (opts.fallback) {
193
199
  lroOptions.protoJson = protoFilesRoot;
194
200
  lroOptions.httpRules = [
201
+ {
202
+ selector: 'google.longrunning.Operations.CancelOperation',
203
+ post: '/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/operations/*}:cancel',
204
+ body: '*',
205
+ additional_bindings: [
206
+ {
207
+ post: '/v1beta/{name=projects/*/locations/*/dataStores/*/branches/*/operations/*}:cancel',
208
+ body: '*',
209
+ },
210
+ ],
211
+ },
195
212
  {
196
213
  selector: 'google.longrunning.Operations.GetOperation',
197
214
  get: '/v1beta/{name=projects/*/locations/*/collections/*/dataConnector/operations/*}',
@@ -577,9 +594,9 @@ class SchemaServiceClient {
577
594
  * to return. The service may return fewer than this value.
578
595
  *
579
596
  * If unspecified, at most 100
580
- * {@link protos.google.cloud.discoveryengine.v1beta.Schema|Schema}s will be returned.
597
+ * {@link protos.google.cloud.discoveryengine.v1beta.Schema|Schema}s are returned.
581
598
  *
582
- * The maximum value is 1000; values above 1000 will be coerced to 1000.
599
+ * The maximum value is 1000; values above 1000 are set to 1000.
583
600
  * @param {string} request.pageToken
584
601
  * A page token, received from a previous
585
602
  * {@link protos.google.cloud.discoveryengine.v1beta.SchemaService.ListSchemas|SchemaService.ListSchemas}
@@ -628,9 +645,9 @@ class SchemaServiceClient {
628
645
  * to return. The service may return fewer than this value.
629
646
  *
630
647
  * If unspecified, at most 100
631
- * {@link protos.google.cloud.discoveryengine.v1beta.Schema|Schema}s will be returned.
648
+ * {@link protos.google.cloud.discoveryengine.v1beta.Schema|Schema}s are returned.
632
649
  *
633
- * The maximum value is 1000; values above 1000 will be coerced to 1000.
650
+ * The maximum value is 1000; values above 1000 are set to 1000.
634
651
  * @param {string} request.pageToken
635
652
  * A page token, received from a previous
636
653
  * {@link protos.google.cloud.discoveryengine.v1beta.SchemaService.ListSchemas|SchemaService.ListSchemas}
@@ -909,6 +926,27 @@ class SchemaServiceClient {
909
926
  matchEngineFromEngineName(engineName) {
910
927
  return this.pathTemplates.enginePathTemplate.match(engineName).engine;
911
928
  }
929
+ /**
930
+ * Return a fully-qualified project resource name string.
931
+ *
932
+ * @param {string} project
933
+ * @returns {string} Resource name string.
934
+ */
935
+ projectPath(project) {
936
+ return this.pathTemplates.projectPathTemplate.render({
937
+ project: project,
938
+ });
939
+ }
940
+ /**
941
+ * Parse the project from Project resource.
942
+ *
943
+ * @param {string} projectName
944
+ * A fully-qualified path representing Project resource.
945
+ * @returns {string} A string representing the project.
946
+ */
947
+ matchProjectFromProjectName(projectName) {
948
+ return this.pathTemplates.projectPathTemplate.match(projectName).project;
949
+ }
912
950
  /**
913
951
  * Return a fully-qualified projectLocationCollectionDataStore resource name string.
914
952
  *
@@ -1047,6 +1085,75 @@ class SchemaServiceClient {
1047
1085
  matchDocumentFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName) {
1048
1086
  return this.pathTemplates.projectLocationCollectionDataStoreBranchDocumentPathTemplate.match(projectLocationCollectionDataStoreBranchDocumentName).document;
1049
1087
  }
1088
+ /**
1089
+ * Return a fully-qualified projectLocationCollectionDataStoreControl resource name string.
1090
+ *
1091
+ * @param {string} project
1092
+ * @param {string} location
1093
+ * @param {string} collection
1094
+ * @param {string} data_store
1095
+ * @param {string} control
1096
+ * @returns {string} Resource name string.
1097
+ */
1098
+ projectLocationCollectionDataStoreControlPath(project, location, collection, dataStore, control) {
1099
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.render({
1100
+ project: project,
1101
+ location: location,
1102
+ collection: collection,
1103
+ data_store: dataStore,
1104
+ control: control,
1105
+ });
1106
+ }
1107
+ /**
1108
+ * Parse the project from ProjectLocationCollectionDataStoreControl resource.
1109
+ *
1110
+ * @param {string} projectLocationCollectionDataStoreControlName
1111
+ * A fully-qualified path representing project_location_collection_data_store_control resource.
1112
+ * @returns {string} A string representing the project.
1113
+ */
1114
+ matchProjectFromProjectLocationCollectionDataStoreControlName(projectLocationCollectionDataStoreControlName) {
1115
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.match(projectLocationCollectionDataStoreControlName).project;
1116
+ }
1117
+ /**
1118
+ * Parse the location from ProjectLocationCollectionDataStoreControl resource.
1119
+ *
1120
+ * @param {string} projectLocationCollectionDataStoreControlName
1121
+ * A fully-qualified path representing project_location_collection_data_store_control resource.
1122
+ * @returns {string} A string representing the location.
1123
+ */
1124
+ matchLocationFromProjectLocationCollectionDataStoreControlName(projectLocationCollectionDataStoreControlName) {
1125
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.match(projectLocationCollectionDataStoreControlName).location;
1126
+ }
1127
+ /**
1128
+ * Parse the collection from ProjectLocationCollectionDataStoreControl resource.
1129
+ *
1130
+ * @param {string} projectLocationCollectionDataStoreControlName
1131
+ * A fully-qualified path representing project_location_collection_data_store_control resource.
1132
+ * @returns {string} A string representing the collection.
1133
+ */
1134
+ matchCollectionFromProjectLocationCollectionDataStoreControlName(projectLocationCollectionDataStoreControlName) {
1135
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.match(projectLocationCollectionDataStoreControlName).collection;
1136
+ }
1137
+ /**
1138
+ * Parse the data_store from ProjectLocationCollectionDataStoreControl resource.
1139
+ *
1140
+ * @param {string} projectLocationCollectionDataStoreControlName
1141
+ * A fully-qualified path representing project_location_collection_data_store_control resource.
1142
+ * @returns {string} A string representing the data_store.
1143
+ */
1144
+ matchDataStoreFromProjectLocationCollectionDataStoreControlName(projectLocationCollectionDataStoreControlName) {
1145
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.match(projectLocationCollectionDataStoreControlName).data_store;
1146
+ }
1147
+ /**
1148
+ * Parse the control from ProjectLocationCollectionDataStoreControl resource.
1149
+ *
1150
+ * @param {string} projectLocationCollectionDataStoreControlName
1151
+ * A fully-qualified path representing project_location_collection_data_store_control resource.
1152
+ * @returns {string} A string representing the control.
1153
+ */
1154
+ matchControlFromProjectLocationCollectionDataStoreControlName(projectLocationCollectionDataStoreControlName) {
1155
+ return this.pathTemplates.projectLocationCollectionDataStoreControlPathTemplate.match(projectLocationCollectionDataStoreControlName).control;
1156
+ }
1050
1157
  /**
1051
1158
  * Return a fully-qualified projectLocationCollectionDataStoreConversation resource name string.
1052
1159
  *
@@ -1116,6 +1223,75 @@ class SchemaServiceClient {
1116
1223
  matchConversationFromProjectLocationCollectionDataStoreConversationName(projectLocationCollectionDataStoreConversationName) {
1117
1224
  return this.pathTemplates.projectLocationCollectionDataStoreConversationPathTemplate.match(projectLocationCollectionDataStoreConversationName).conversation;
1118
1225
  }
1226
+ /**
1227
+ * Return a fully-qualified projectLocationCollectionDataStoreCustomTuningModel resource name string.
1228
+ *
1229
+ * @param {string} project
1230
+ * @param {string} location
1231
+ * @param {string} collection
1232
+ * @param {string} data_store
1233
+ * @param {string} custom_tuning_model
1234
+ * @returns {string} Resource name string.
1235
+ */
1236
+ projectLocationCollectionDataStoreCustomTuningModelPath(project, location, collection, dataStore, customTuningModel) {
1237
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.render({
1238
+ project: project,
1239
+ location: location,
1240
+ collection: collection,
1241
+ data_store: dataStore,
1242
+ custom_tuning_model: customTuningModel,
1243
+ });
1244
+ }
1245
+ /**
1246
+ * Parse the project from ProjectLocationCollectionDataStoreCustomTuningModel resource.
1247
+ *
1248
+ * @param {string} projectLocationCollectionDataStoreCustomTuningModelName
1249
+ * A fully-qualified path representing project_location_collection_data_store_custom_tuning_model resource.
1250
+ * @returns {string} A string representing the project.
1251
+ */
1252
+ matchProjectFromProjectLocationCollectionDataStoreCustomTuningModelName(projectLocationCollectionDataStoreCustomTuningModelName) {
1253
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.match(projectLocationCollectionDataStoreCustomTuningModelName).project;
1254
+ }
1255
+ /**
1256
+ * Parse the location from ProjectLocationCollectionDataStoreCustomTuningModel resource.
1257
+ *
1258
+ * @param {string} projectLocationCollectionDataStoreCustomTuningModelName
1259
+ * A fully-qualified path representing project_location_collection_data_store_custom_tuning_model resource.
1260
+ * @returns {string} A string representing the location.
1261
+ */
1262
+ matchLocationFromProjectLocationCollectionDataStoreCustomTuningModelName(projectLocationCollectionDataStoreCustomTuningModelName) {
1263
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.match(projectLocationCollectionDataStoreCustomTuningModelName).location;
1264
+ }
1265
+ /**
1266
+ * Parse the collection from ProjectLocationCollectionDataStoreCustomTuningModel resource.
1267
+ *
1268
+ * @param {string} projectLocationCollectionDataStoreCustomTuningModelName
1269
+ * A fully-qualified path representing project_location_collection_data_store_custom_tuning_model resource.
1270
+ * @returns {string} A string representing the collection.
1271
+ */
1272
+ matchCollectionFromProjectLocationCollectionDataStoreCustomTuningModelName(projectLocationCollectionDataStoreCustomTuningModelName) {
1273
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.match(projectLocationCollectionDataStoreCustomTuningModelName).collection;
1274
+ }
1275
+ /**
1276
+ * Parse the data_store from ProjectLocationCollectionDataStoreCustomTuningModel resource.
1277
+ *
1278
+ * @param {string} projectLocationCollectionDataStoreCustomTuningModelName
1279
+ * A fully-qualified path representing project_location_collection_data_store_custom_tuning_model resource.
1280
+ * @returns {string} A string representing the data_store.
1281
+ */
1282
+ matchDataStoreFromProjectLocationCollectionDataStoreCustomTuningModelName(projectLocationCollectionDataStoreCustomTuningModelName) {
1283
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.match(projectLocationCollectionDataStoreCustomTuningModelName).data_store;
1284
+ }
1285
+ /**
1286
+ * Parse the custom_tuning_model from ProjectLocationCollectionDataStoreCustomTuningModel resource.
1287
+ *
1288
+ * @param {string} projectLocationCollectionDataStoreCustomTuningModelName
1289
+ * A fully-qualified path representing project_location_collection_data_store_custom_tuning_model resource.
1290
+ * @returns {string} A string representing the custom_tuning_model.
1291
+ */
1292
+ matchCustomTuningModelFromProjectLocationCollectionDataStoreCustomTuningModelName(projectLocationCollectionDataStoreCustomTuningModelName) {
1293
+ return this.pathTemplates.projectLocationCollectionDataStoreCustomTuningModelPathTemplate.match(projectLocationCollectionDataStoreCustomTuningModelName).custom_tuning_model;
1294
+ }
1119
1295
  /**
1120
1296
  * Return a fully-qualified projectLocationCollectionDataStoreDocumentProcessingConfig resource name string.
1121
1297
  *
@@ -1587,6 +1763,75 @@ class SchemaServiceClient {
1587
1763
  matchTargetSiteFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName) {
1588
1764
  return this.pathTemplates.projectLocationCollectionDataStoreSiteSearchEngineTargetSitePathTemplate.match(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName).target_site;
1589
1765
  }
1766
+ /**
1767
+ * Return a fully-qualified projectLocationCollectionEngineControl resource name string.
1768
+ *
1769
+ * @param {string} project
1770
+ * @param {string} location
1771
+ * @param {string} collection
1772
+ * @param {string} engine
1773
+ * @param {string} control
1774
+ * @returns {string} Resource name string.
1775
+ */
1776
+ projectLocationCollectionEngineControlPath(project, location, collection, engine, control) {
1777
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.render({
1778
+ project: project,
1779
+ location: location,
1780
+ collection: collection,
1781
+ engine: engine,
1782
+ control: control,
1783
+ });
1784
+ }
1785
+ /**
1786
+ * Parse the project from ProjectLocationCollectionEngineControl resource.
1787
+ *
1788
+ * @param {string} projectLocationCollectionEngineControlName
1789
+ * A fully-qualified path representing project_location_collection_engine_control resource.
1790
+ * @returns {string} A string representing the project.
1791
+ */
1792
+ matchProjectFromProjectLocationCollectionEngineControlName(projectLocationCollectionEngineControlName) {
1793
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.match(projectLocationCollectionEngineControlName).project;
1794
+ }
1795
+ /**
1796
+ * Parse the location from ProjectLocationCollectionEngineControl resource.
1797
+ *
1798
+ * @param {string} projectLocationCollectionEngineControlName
1799
+ * A fully-qualified path representing project_location_collection_engine_control resource.
1800
+ * @returns {string} A string representing the location.
1801
+ */
1802
+ matchLocationFromProjectLocationCollectionEngineControlName(projectLocationCollectionEngineControlName) {
1803
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.match(projectLocationCollectionEngineControlName).location;
1804
+ }
1805
+ /**
1806
+ * Parse the collection from ProjectLocationCollectionEngineControl resource.
1807
+ *
1808
+ * @param {string} projectLocationCollectionEngineControlName
1809
+ * A fully-qualified path representing project_location_collection_engine_control resource.
1810
+ * @returns {string} A string representing the collection.
1811
+ */
1812
+ matchCollectionFromProjectLocationCollectionEngineControlName(projectLocationCollectionEngineControlName) {
1813
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.match(projectLocationCollectionEngineControlName).collection;
1814
+ }
1815
+ /**
1816
+ * Parse the engine from ProjectLocationCollectionEngineControl resource.
1817
+ *
1818
+ * @param {string} projectLocationCollectionEngineControlName
1819
+ * A fully-qualified path representing project_location_collection_engine_control resource.
1820
+ * @returns {string} A string representing the engine.
1821
+ */
1822
+ matchEngineFromProjectLocationCollectionEngineControlName(projectLocationCollectionEngineControlName) {
1823
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.match(projectLocationCollectionEngineControlName).engine;
1824
+ }
1825
+ /**
1826
+ * Parse the control from ProjectLocationCollectionEngineControl resource.
1827
+ *
1828
+ * @param {string} projectLocationCollectionEngineControlName
1829
+ * A fully-qualified path representing project_location_collection_engine_control resource.
1830
+ * @returns {string} A string representing the control.
1831
+ */
1832
+ matchControlFromProjectLocationCollectionEngineControlName(projectLocationCollectionEngineControlName) {
1833
+ return this.pathTemplates.projectLocationCollectionEngineControlPathTemplate.match(projectLocationCollectionEngineControlName).control;
1834
+ }
1590
1835
  /**
1591
1836
  * Return a fully-qualified projectLocationCollectionEngineConversation resource name string.
1592
1837
  *
@@ -1989,6 +2234,63 @@ class SchemaServiceClient {
1989
2234
  matchDocumentFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName) {
1990
2235
  return this.pathTemplates.projectLocationDataStoreBranchDocumentPathTemplate.match(projectLocationDataStoreBranchDocumentName).document;
1991
2236
  }
2237
+ /**
2238
+ * Return a fully-qualified projectLocationDataStoreControl resource name string.
2239
+ *
2240
+ * @param {string} project
2241
+ * @param {string} location
2242
+ * @param {string} data_store
2243
+ * @param {string} control
2244
+ * @returns {string} Resource name string.
2245
+ */
2246
+ projectLocationDataStoreControlPath(project, location, dataStore, control) {
2247
+ return this.pathTemplates.projectLocationDataStoreControlPathTemplate.render({
2248
+ project: project,
2249
+ location: location,
2250
+ data_store: dataStore,
2251
+ control: control,
2252
+ });
2253
+ }
2254
+ /**
2255
+ * Parse the project from ProjectLocationDataStoreControl resource.
2256
+ *
2257
+ * @param {string} projectLocationDataStoreControlName
2258
+ * A fully-qualified path representing project_location_data_store_control resource.
2259
+ * @returns {string} A string representing the project.
2260
+ */
2261
+ matchProjectFromProjectLocationDataStoreControlName(projectLocationDataStoreControlName) {
2262
+ return this.pathTemplates.projectLocationDataStoreControlPathTemplate.match(projectLocationDataStoreControlName).project;
2263
+ }
2264
+ /**
2265
+ * Parse the location from ProjectLocationDataStoreControl resource.
2266
+ *
2267
+ * @param {string} projectLocationDataStoreControlName
2268
+ * A fully-qualified path representing project_location_data_store_control resource.
2269
+ * @returns {string} A string representing the location.
2270
+ */
2271
+ matchLocationFromProjectLocationDataStoreControlName(projectLocationDataStoreControlName) {
2272
+ return this.pathTemplates.projectLocationDataStoreControlPathTemplate.match(projectLocationDataStoreControlName).location;
2273
+ }
2274
+ /**
2275
+ * Parse the data_store from ProjectLocationDataStoreControl resource.
2276
+ *
2277
+ * @param {string} projectLocationDataStoreControlName
2278
+ * A fully-qualified path representing project_location_data_store_control resource.
2279
+ * @returns {string} A string representing the data_store.
2280
+ */
2281
+ matchDataStoreFromProjectLocationDataStoreControlName(projectLocationDataStoreControlName) {
2282
+ return this.pathTemplates.projectLocationDataStoreControlPathTemplate.match(projectLocationDataStoreControlName).data_store;
2283
+ }
2284
+ /**
2285
+ * Parse the control from ProjectLocationDataStoreControl resource.
2286
+ *
2287
+ * @param {string} projectLocationDataStoreControlName
2288
+ * A fully-qualified path representing project_location_data_store_control resource.
2289
+ * @returns {string} A string representing the control.
2290
+ */
2291
+ matchControlFromProjectLocationDataStoreControlName(projectLocationDataStoreControlName) {
2292
+ return this.pathTemplates.projectLocationDataStoreControlPathTemplate.match(projectLocationDataStoreControlName).control;
2293
+ }
1992
2294
  /**
1993
2295
  * Return a fully-qualified projectLocationDataStoreConversation resource name string.
1994
2296
  *
@@ -2046,6 +2348,63 @@ class SchemaServiceClient {
2046
2348
  matchConversationFromProjectLocationDataStoreConversationName(projectLocationDataStoreConversationName) {
2047
2349
  return this.pathTemplates.projectLocationDataStoreConversationPathTemplate.match(projectLocationDataStoreConversationName).conversation;
2048
2350
  }
2351
+ /**
2352
+ * Return a fully-qualified projectLocationDataStoreCustomTuningModel resource name string.
2353
+ *
2354
+ * @param {string} project
2355
+ * @param {string} location
2356
+ * @param {string} data_store
2357
+ * @param {string} custom_tuning_model
2358
+ * @returns {string} Resource name string.
2359
+ */
2360
+ projectLocationDataStoreCustomTuningModelPath(project, location, dataStore, customTuningModel) {
2361
+ return this.pathTemplates.projectLocationDataStoreCustomTuningModelPathTemplate.render({
2362
+ project: project,
2363
+ location: location,
2364
+ data_store: dataStore,
2365
+ custom_tuning_model: customTuningModel,
2366
+ });
2367
+ }
2368
+ /**
2369
+ * Parse the project from ProjectLocationDataStoreCustomTuningModel resource.
2370
+ *
2371
+ * @param {string} projectLocationDataStoreCustomTuningModelName
2372
+ * A fully-qualified path representing project_location_data_store_custom_tuning_model resource.
2373
+ * @returns {string} A string representing the project.
2374
+ */
2375
+ matchProjectFromProjectLocationDataStoreCustomTuningModelName(projectLocationDataStoreCustomTuningModelName) {
2376
+ return this.pathTemplates.projectLocationDataStoreCustomTuningModelPathTemplate.match(projectLocationDataStoreCustomTuningModelName).project;
2377
+ }
2378
+ /**
2379
+ * Parse the location from ProjectLocationDataStoreCustomTuningModel resource.
2380
+ *
2381
+ * @param {string} projectLocationDataStoreCustomTuningModelName
2382
+ * A fully-qualified path representing project_location_data_store_custom_tuning_model resource.
2383
+ * @returns {string} A string representing the location.
2384
+ */
2385
+ matchLocationFromProjectLocationDataStoreCustomTuningModelName(projectLocationDataStoreCustomTuningModelName) {
2386
+ return this.pathTemplates.projectLocationDataStoreCustomTuningModelPathTemplate.match(projectLocationDataStoreCustomTuningModelName).location;
2387
+ }
2388
+ /**
2389
+ * Parse the data_store from ProjectLocationDataStoreCustomTuningModel resource.
2390
+ *
2391
+ * @param {string} projectLocationDataStoreCustomTuningModelName
2392
+ * A fully-qualified path representing project_location_data_store_custom_tuning_model resource.
2393
+ * @returns {string} A string representing the data_store.
2394
+ */
2395
+ matchDataStoreFromProjectLocationDataStoreCustomTuningModelName(projectLocationDataStoreCustomTuningModelName) {
2396
+ return this.pathTemplates.projectLocationDataStoreCustomTuningModelPathTemplate.match(projectLocationDataStoreCustomTuningModelName).data_store;
2397
+ }
2398
+ /**
2399
+ * Parse the custom_tuning_model from ProjectLocationDataStoreCustomTuningModel resource.
2400
+ *
2401
+ * @param {string} projectLocationDataStoreCustomTuningModelName
2402
+ * A fully-qualified path representing project_location_data_store_custom_tuning_model resource.
2403
+ * @returns {string} A string representing the custom_tuning_model.
2404
+ */
2405
+ matchCustomTuningModelFromProjectLocationDataStoreCustomTuningModelName(projectLocationDataStoreCustomTuningModelName) {
2406
+ return this.pathTemplates.projectLocationDataStoreCustomTuningModelPathTemplate.match(projectLocationDataStoreCustomTuningModelName).custom_tuning_model;
2407
+ }
2049
2408
  /**
2050
2409
  * Return a fully-qualified projectLocationDataStoreDocumentProcessingConfig resource name string.
2051
2410
  *