google-cloud-discovery_engine-v1beta 0.26.0 → 0.28.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 (275) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +4 -4
  3. data/README.md +5 -5
  4. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/client.rb +591 -0
  5. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/credentials.rb +49 -0
  6. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/paths.rb +50 -0
  7. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/rest/client.rb +534 -0
  8. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/rest/service_stub.rb +204 -0
  9. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service/rest.rb +52 -0
  10. data/lib/google/cloud/discovery_engine/v1beta/acl_config_service.rb +55 -0
  11. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/client.rb +1058 -0
  12. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/credentials.rb +50 -0
  13. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/paths.rb +230 -0
  14. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/rest/client.rb +975 -0
  15. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/rest/service_stub.rb +444 -0
  16. data/lib/google/cloud/discovery_engine/v1beta/assistant_service/rest.rb +52 -0
  17. data/lib/google/cloud/discovery_engine/v1beta/assistant_service.rb +55 -0
  18. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/client.rb +823 -0
  19. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/credentials.rb +49 -0
  20. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/operations.rb +843 -0
  21. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/paths.rb +135 -0
  22. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/rest/client.rb +752 -0
  23. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/rest/operations.rb +1152 -0
  24. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/rest/service_stub.rb +341 -0
  25. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service/rest.rb +53 -0
  26. data/lib/google/cloud/discovery_engine/v1beta/cmek_config_service.rb +56 -0
  27. data/lib/google/cloud/discovery_engine/v1beta/completion_service/client.rb +148 -12
  28. data/lib/google/cloud/discovery_engine/v1beta/completion_service/credentials.rb +5 -1
  29. data/lib/google/cloud/discovery_engine/v1beta/completion_service/operations.rb +2 -0
  30. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/client.rb +141 -12
  31. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/operations.rb +23 -0
  32. data/lib/google/cloud/discovery_engine/v1beta/completion_service/rest/service_stub.rb +62 -0
  33. data/lib/google/cloud/discovery_engine/v1beta/control_service/client.rb +2 -0
  34. data/lib/google/cloud/discovery_engine/v1beta/control_service/credentials.rb +3 -1
  35. data/lib/google/cloud/discovery_engine/v1beta/control_service/paths.rb +53 -0
  36. data/lib/google/cloud/discovery_engine/v1beta/control_service/rest/client.rb +2 -0
  37. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/client.rb +212 -10
  38. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/credentials.rb +3 -1
  39. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/paths.rb +46 -0
  40. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/client.rb +207 -10
  41. data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/service_stub.rb +72 -0
  42. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/client.rb +13 -1
  43. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/credentials.rb +3 -1
  44. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/operations.rb +2 -0
  45. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/paths.rb +104 -0
  46. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/client.rb +13 -1
  47. data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/operations.rb +23 -0
  48. data/lib/google/cloud/discovery_engine/v1beta/document_service/client.rb +10 -3
  49. data/lib/google/cloud/discovery_engine/v1beta/document_service/credentials.rb +3 -1
  50. data/lib/google/cloud/discovery_engine/v1beta/document_service/operations.rb +2 -0
  51. data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/client.rb +10 -3
  52. data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/operations.rb +23 -0
  53. data/lib/google/cloud/discovery_engine/v1beta/engine_service/client.rb +226 -6
  54. data/lib/google/cloud/discovery_engine/v1beta/engine_service/credentials.rb +3 -1
  55. data/lib/google/cloud/discovery_engine/v1beta/engine_service/operations.rb +2 -0
  56. data/lib/google/cloud/discovery_engine/v1beta/engine_service/paths.rb +104 -0
  57. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/client.rb +212 -6
  58. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/operations.rb +23 -0
  59. data/lib/google/cloud/discovery_engine/v1beta/engine_service/rest/service_stub.rb +123 -0
  60. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/client.rb +13 -9
  61. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/credentials.rb +4 -1
  62. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/operations.rb +2 -0
  63. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/paths.rb +21 -0
  64. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/client.rb +13 -9
  65. data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/rest/operations.rb +23 -0
  66. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/client.rb +2 -0
  67. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/credentials.rb +3 -1
  68. data/lib/google/cloud/discovery_engine/v1beta/grounded_generation_service/rest/client.rb +2 -0
  69. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/client.rb +1180 -0
  70. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/credentials.rb +49 -0
  71. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/operations.rb +843 -0
  72. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/paths.rb +154 -0
  73. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/rest/client.rb +1088 -0
  74. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/rest/operations.rb +1152 -0
  75. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/rest/service_stub.rb +511 -0
  76. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service/rest.rb +53 -0
  77. data/lib/google/cloud/discovery_engine/v1beta/identity_mapping_store_service.rb +56 -0
  78. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/client.rb +1050 -0
  79. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/credentials.rb +49 -0
  80. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/paths.rb +86 -0
  81. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/rest/client.rb +965 -0
  82. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/rest/service_stub.rb +451 -0
  83. data/lib/google/cloud/discovery_engine/v1beta/license_config_service/rest.rb +52 -0
  84. data/lib/google/cloud/discovery_engine/v1beta/license_config_service.rb +55 -0
  85. data/lib/google/cloud/discovery_engine/v1beta/project_service/client.rb +5 -1
  86. data/lib/google/cloud/discovery_engine/v1beta/project_service/credentials.rb +3 -1
  87. data/lib/google/cloud/discovery_engine/v1beta/project_service/operations.rb +2 -0
  88. data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/client.rb +5 -1
  89. data/lib/google/cloud/discovery_engine/v1beta/project_service/rest/operations.rb +23 -0
  90. data/lib/google/cloud/discovery_engine/v1beta/rank_service/client.rb +4 -2
  91. data/lib/google/cloud/discovery_engine/v1beta/rank_service/credentials.rb +3 -1
  92. data/lib/google/cloud/discovery_engine/v1beta/rank_service/rest/client.rb +4 -2
  93. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/client.rb +4 -2
  94. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/credentials.rb +3 -1
  95. data/lib/google/cloud/discovery_engine/v1beta/recommendation_service/rest/client.rb +4 -2
  96. data/lib/google/cloud/discovery_engine/v1beta/rest.rb +10 -3
  97. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/client.rb +2 -0
  98. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/credentials.rb +3 -1
  99. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/operations.rb +2 -0
  100. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/client.rb +2 -0
  101. data/lib/google/cloud/discovery_engine/v1beta/sample_query_service/rest/operations.rb +23 -0
  102. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/client.rb +2 -0
  103. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/credentials.rb +3 -1
  104. data/lib/google/cloud/discovery_engine/v1beta/sample_query_set_service/rest/client.rb +2 -0
  105. data/lib/google/cloud/discovery_engine/v1beta/schema_service/client.rb +2 -0
  106. data/lib/google/cloud/discovery_engine/v1beta/schema_service/credentials.rb +3 -1
  107. data/lib/google/cloud/discovery_engine/v1beta/schema_service/operations.rb +2 -0
  108. data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/client.rb +2 -0
  109. data/lib/google/cloud/discovery_engine/v1beta/schema_service/rest/operations.rb +23 -0
  110. data/lib/google/cloud/discovery_engine/v1beta/search_service/client.rb +196 -38
  111. data/lib/google/cloud/discovery_engine/v1beta/search_service/credentials.rb +4 -1
  112. data/lib/google/cloud/discovery_engine/v1beta/search_service/paths.rb +21 -0
  113. data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/client.rb +196 -38
  114. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/client.rb +2 -0
  115. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/credentials.rb +3 -1
  116. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/operations.rb +2 -0
  117. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/client.rb +2 -0
  118. data/lib/google/cloud/discovery_engine/v1beta/search_tuning_service/rest/operations.rb +23 -0
  119. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/client.rb +209 -3
  120. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/credentials.rb +3 -1
  121. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/client.rb +195 -3
  122. data/lib/google/cloud/discovery_engine/v1beta/serving_config_service/rest/service_stub.rb +153 -0
  123. data/lib/google/cloud/discovery_engine/v1beta/session_service/client.rb +27 -9
  124. data/lib/google/cloud/discovery_engine/v1beta/session_service/credentials.rb +4 -1
  125. data/lib/google/cloud/discovery_engine/v1beta/session_service/paths.rb +46 -0
  126. data/lib/google/cloud/discovery_engine/v1beta/session_service/rest/client.rb +27 -9
  127. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/client.rb +3 -3
  128. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/credentials.rb +3 -1
  129. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/operations.rb +2 -0
  130. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/client.rb +3 -3
  131. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/operations.rb +23 -0
  132. data/lib/google/cloud/discovery_engine/v1beta/site_search_engine_service/rest/service_stub.rb +7 -0
  133. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/client.rb +25 -11
  134. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/credentials.rb +4 -1
  135. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/operations.rb +2 -0
  136. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/client.rb +25 -11
  137. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/operations.rb +23 -0
  138. data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/service_stub.rb +8 -0
  139. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/client.rb +768 -0
  140. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/credentials.rb +49 -0
  141. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/operations.rb +843 -0
  142. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/paths.rb +71 -0
  143. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/rest/client.rb +704 -0
  144. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/rest/operations.rb +1152 -0
  145. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/rest/service_stub.rb +265 -0
  146. data/lib/google/cloud/discovery_engine/v1beta/user_license_service/rest.rb +53 -0
  147. data/lib/google/cloud/discovery_engine/v1beta/user_license_service.rb +56 -0
  148. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/client.rb +590 -0
  149. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/credentials.rb +49 -0
  150. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/paths.rb +71 -0
  151. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/rest/client.rb +533 -0
  152. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/rest/service_stub.rb +204 -0
  153. data/lib/google/cloud/discovery_engine/v1beta/user_store_service/rest.rb +52 -0
  154. data/lib/google/cloud/discovery_engine/v1beta/user_store_service.rb +55 -0
  155. data/lib/google/cloud/discovery_engine/v1beta/version.rb +1 -1
  156. data/lib/google/cloud/discovery_engine/v1beta.rb +11 -4
  157. data/lib/google/cloud/discoveryengine/v1beta/acl_config_pb.rb +25 -0
  158. data/lib/google/cloud/discoveryengine/v1beta/acl_config_service_pb.rb +28 -0
  159. data/lib/google/cloud/discoveryengine/v1beta/acl_config_service_services_pb.rb +49 -0
  160. data/lib/google/cloud/discoveryengine/v1beta/agent_gateway_setting_pb.rb +25 -0
  161. data/lib/google/cloud/discoveryengine/v1beta/answer_pb.rb +6 -1
  162. data/lib/google/cloud/discoveryengine/v1beta/assist_answer_pb.rb +48 -0
  163. data/lib/google/cloud/discoveryengine/v1beta/assistant_pb.rb +35 -0
  164. data/lib/google/cloud/discoveryengine/v1beta/assistant_service_pb.rb +48 -0
  165. data/lib/google/cloud/discoveryengine/v1beta/assistant_service_services_pb.rb +56 -0
  166. data/lib/google/cloud/discoveryengine/v1beta/chunk_pb.rb +4 -1
  167. data/lib/google/cloud/discoveryengine/v1beta/cmek_config_service_pb.rb +39 -0
  168. data/lib/google/cloud/discoveryengine/v1beta/cmek_config_service_services_pb.rb +55 -0
  169. data/lib/google/cloud/discoveryengine/v1beta/common_pb.rb +12 -1
  170. data/lib/google/cloud/discoveryengine/v1beta/completion_service_pb.rb +4 -1
  171. data/lib/google/cloud/discoveryengine/v1beta/completion_service_services_pb.rb +6 -0
  172. data/lib/google/cloud/discoveryengine/v1beta/control_pb.rb +6 -1
  173. data/lib/google/cloud/discoveryengine/v1beta/control_service_pb.rb +1 -1
  174. data/lib/google/cloud/discoveryengine/v1beta/conversational_search_service_pb.rb +12 -1
  175. data/lib/google/cloud/discoveryengine/v1beta/conversational_search_service_services_pb.rb +8 -0
  176. data/lib/google/cloud/discoveryengine/v1beta/data_store_pb.rb +11 -1
  177. data/lib/google/cloud/discoveryengine/v1beta/data_store_service_pb.rb +1 -1
  178. data/lib/google/cloud/discoveryengine/v1beta/document_pb.rb +4 -1
  179. data/lib/google/cloud/discoveryengine/v1beta/document_processing_config_pb.rb +1 -1
  180. data/lib/google/cloud/discoveryengine/v1beta/document_service_pb.rb +1 -1
  181. data/lib/google/cloud/discoveryengine/v1beta/engine_pb.rb +17 -1
  182. data/lib/google/cloud/discoveryengine/v1beta/engine_service_pb.rb +3 -1
  183. data/lib/google/cloud/discoveryengine/v1beta/engine_service_services_pb.rb +28 -6
  184. data/lib/google/cloud/discoveryengine/v1beta/evaluation_pb.rb +1 -1
  185. data/lib/google/cloud/discoveryengine/v1beta/evaluation_service_pb.rb +1 -1
  186. data/lib/google/cloud/discoveryengine/v1beta/feedback_pb.rb +28 -0
  187. data/lib/google/cloud/discoveryengine/v1beta/grounded_generation_service_pb.rb +11 -1
  188. data/lib/google/cloud/discoveryengine/v1beta/grounding_pb.rb +1 -1
  189. data/lib/google/cloud/discoveryengine/v1beta/identity_mapping_store_pb.rb +26 -0
  190. data/lib/google/cloud/discoveryengine/v1beta/identity_mapping_store_service_pb.rb +44 -0
  191. data/lib/google/cloud/discoveryengine/v1beta/identity_mapping_store_service_services_pb.rb +58 -0
  192. data/lib/google/cloud/discoveryengine/v1beta/import_config_pb.rb +1 -1
  193. data/lib/google/cloud/discoveryengine/v1beta/license_config_pb.rb +27 -0
  194. data/lib/google/cloud/discoveryengine/v1beta/license_config_service_pb.rb +36 -0
  195. data/lib/google/cloud/discoveryengine/v1beta/license_config_service_services_pb.rb +65 -0
  196. data/lib/google/cloud/discoveryengine/v1beta/logging_pb.rb +24 -0
  197. data/lib/google/cloud/discoveryengine/v1beta/project_pb.rb +10 -1
  198. data/lib/google/cloud/discoveryengine/v1beta/project_service_pb.rb +2 -1
  199. data/lib/google/cloud/discoveryengine/v1beta/rank_service_pb.rb +1 -1
  200. data/lib/google/cloud/discoveryengine/v1beta/recommendation_service_pb.rb +1 -1
  201. data/lib/google/cloud/discoveryengine/v1beta/safety_pb.rb +26 -0
  202. data/lib/google/cloud/discoveryengine/v1beta/sample_query_service_pb.rb +1 -1
  203. data/lib/google/cloud/discoveryengine/v1beta/sample_query_set_service_pb.rb +1 -1
  204. data/lib/google/cloud/discoveryengine/v1beta/schema_service_pb.rb +1 -1
  205. data/lib/google/cloud/discoveryengine/v1beta/search_service_pb.rb +18 -2
  206. data/lib/google/cloud/discoveryengine/v1beta/search_tuning_service_pb.rb +1 -1
  207. data/lib/google/cloud/discoveryengine/v1beta/serving_config_pb.rb +3 -1
  208. data/lib/google/cloud/discoveryengine/v1beta/serving_config_service_pb.rb +4 -1
  209. data/lib/google/cloud/discoveryengine/v1beta/serving_config_service_services_pb.rb +14 -0
  210. data/lib/google/cloud/discoveryengine/v1beta/session_pb.rb +2 -1
  211. data/lib/google/cloud/discoveryengine/v1beta/session_service_pb.rb +1 -1
  212. data/lib/google/cloud/discoveryengine/v1beta/site_search_engine_pb.rb +1 -1
  213. data/lib/google/cloud/discoveryengine/v1beta/site_search_engine_service_pb.rb +1 -1
  214. data/lib/google/cloud/discoveryengine/v1beta/user_event_pb.rb +2 -1
  215. data/lib/google/cloud/discoveryengine/v1beta/user_event_service_pb.rb +1 -1
  216. data/lib/google/cloud/discoveryengine/v1beta/user_license_pb.rb +27 -0
  217. data/lib/google/cloud/discoveryengine/v1beta/user_license_service_pb.rb +38 -0
  218. data/lib/google/cloud/discoveryengine/v1beta/user_license_service_services_pb.rb +52 -0
  219. data/lib/google/cloud/discoveryengine/v1beta/user_store_pb.rb +24 -0
  220. data/lib/google/cloud/discoveryengine/v1beta/user_store_service_pb.rb +29 -0
  221. data/lib/google/cloud/discoveryengine/v1beta/user_store_service_services_pb.rb +47 -0
  222. data/proto_docs/google/cloud/discoveryengine/v1beta/acl_config.rb +43 -0
  223. data/proto_docs/google/cloud/discoveryengine/v1beta/acl_config_service.rb +49 -0
  224. data/proto_docs/google/cloud/discoveryengine/v1beta/agent_gateway_setting.rb +53 -0
  225. data/proto_docs/google/cloud/discoveryengine/v1beta/answer.rb +117 -2
  226. data/proto_docs/google/cloud/discoveryengine/v1beta/assist_answer.rb +401 -0
  227. data/proto_docs/google/cloud/discoveryengine/v1beta/assistant.rb +253 -0
  228. data/proto_docs/google/cloud/discoveryengine/v1beta/assistant_service.rb +368 -0
  229. data/proto_docs/google/cloud/discoveryengine/v1beta/chunk.rb +60 -1
  230. data/proto_docs/google/cloud/discoveryengine/v1beta/cmek_config_service.rb +228 -0
  231. data/proto_docs/google/cloud/discoveryengine/v1beta/common.rb +223 -0
  232. data/proto_docs/google/cloud/discoveryengine/v1beta/completion_service.rb +115 -13
  233. data/proto_docs/google/cloud/discoveryengine/v1beta/control.rb +119 -6
  234. data/proto_docs/google/cloud/discoveryengine/v1beta/conversational_search_service.rb +178 -8
  235. data/proto_docs/google/cloud/discoveryengine/v1beta/data_store.rb +218 -9
  236. data/proto_docs/google/cloud/discoveryengine/v1beta/data_store_service.rb +12 -0
  237. data/proto_docs/google/cloud/discoveryengine/v1beta/document.rb +115 -10
  238. data/proto_docs/google/cloud/discoveryengine/v1beta/document_processing_config.rb +30 -0
  239. data/proto_docs/google/cloud/discoveryengine/v1beta/document_service.rb +1 -1
  240. data/proto_docs/google/cloud/discoveryengine/v1beta/engine.rb +388 -8
  241. data/proto_docs/google/cloud/discoveryengine/v1beta/evaluation.rb +2 -2
  242. data/proto_docs/google/cloud/discoveryengine/v1beta/evaluation_service.rb +13 -11
  243. data/proto_docs/google/cloud/discoveryengine/v1beta/feedback.rb +147 -0
  244. data/proto_docs/google/cloud/discoveryengine/v1beta/grounded_generation_service.rb +190 -9
  245. data/proto_docs/google/cloud/discoveryengine/v1beta/grounding.rb +9 -0
  246. data/proto_docs/google/cloud/discoveryengine/v1beta/identity_mapping_store.rb +84 -0
  247. data/proto_docs/google/cloud/discoveryengine/v1beta/identity_mapping_store_service.rb +280 -0
  248. data/proto_docs/google/cloud/discoveryengine/v1beta/import_config.rb +25 -5
  249. data/proto_docs/google/cloud/discoveryengine/v1beta/license_config.rb +101 -0
  250. data/proto_docs/google/cloud/discoveryengine/v1beta/license_config_service.rb +224 -0
  251. data/proto_docs/google/cloud/discoveryengine/v1beta/logging.rb +40 -0
  252. data/proto_docs/google/cloud/discoveryengine/v1beta/project.rb +214 -0
  253. data/proto_docs/google/cloud/discoveryengine/v1beta/project_service.rb +18 -0
  254. data/proto_docs/google/cloud/discoveryengine/v1beta/purge_config.rb +9 -5
  255. data/proto_docs/google/cloud/discoveryengine/v1beta/rank_service.rb +4 -2
  256. data/proto_docs/google/cloud/discoveryengine/v1beta/recommendation_service.rb +2 -2
  257. data/proto_docs/google/cloud/discoveryengine/v1beta/safety.rb +108 -0
  258. data/proto_docs/google/cloud/discoveryengine/v1beta/search_service.rb +461 -69
  259. data/proto_docs/google/cloud/discoveryengine/v1beta/serving_config.rb +50 -3
  260. data/proto_docs/google/cloud/discoveryengine/v1beta/serving_config_service.rb +30 -0
  261. data/proto_docs/google/cloud/discoveryengine/v1beta/session.rb +21 -0
  262. data/proto_docs/google/cloud/discoveryengine/v1beta/site_search_engine.rb +8 -2
  263. data/proto_docs/google/cloud/discoveryengine/v1beta/site_search_engine_service.rb +7 -3
  264. data/proto_docs/google/cloud/discoveryengine/v1beta/user_event.rb +39 -3
  265. data/proto_docs/google/cloud/discoveryengine/v1beta/user_event_service.rb +14 -6
  266. data/proto_docs/google/cloud/discoveryengine/v1beta/user_license.rb +100 -0
  267. data/proto_docs/google/cloud/discoveryengine/v1beta/user_license_service.rb +202 -0
  268. data/proto_docs/google/cloud/discoveryengine/v1beta/user_store.rb +67 -0
  269. data/proto_docs/google/cloud/discoveryengine/v1beta/user_store_service.rb +54 -0
  270. data/proto_docs/google/iam/v1/iam_policy.rb +87 -0
  271. data/proto_docs/google/iam/v1/options.rb +50 -0
  272. data/proto_docs/google/iam/v1/policy.rb +426 -0
  273. data/proto_docs/google/type/expr.rb +75 -0
  274. data/proto_docs/google/type/latlng.rb +38 -0
  275. metadata +120 -3
@@ -0,0 +1,768 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/cloud/discoveryengine/v1beta/user_license_service_pb"
21
+ require "google/cloud/location"
22
+
23
+ module Google
24
+ module Cloud
25
+ module DiscoveryEngine
26
+ module V1beta
27
+ module UserLicenseService
28
+ ##
29
+ # Client for the UserLicenseService service.
30
+ #
31
+ # Service for managing User Licenses.
32
+ #
33
+ class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
37
+ # @private
38
+ DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
39
+
40
+ include Paths
41
+
42
+ # @private
43
+ attr_reader :user_license_service_stub
44
+
45
+ ##
46
+ # Configure the UserLicenseService Client class.
47
+ #
48
+ # See {::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client::Configuration}
49
+ # for a description of the configuration fields.
50
+ #
51
+ # @example
52
+ #
53
+ # # Modify the configuration for all UserLicenseService clients
54
+ # ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.configure do |config|
55
+ # config.timeout = 10.0
56
+ # end
57
+ #
58
+ # @yield [config] Configure the Client client.
59
+ # @yieldparam config [Client::Configuration]
60
+ #
61
+ # @return [Client::Configuration]
62
+ #
63
+ def self.configure
64
+ @configure ||= begin
65
+ namespace = ["Google", "Cloud", "DiscoveryEngine", "V1beta"]
66
+ parent_config = while namespace.any?
67
+ parent_name = namespace.join "::"
68
+ parent_const = const_get parent_name
69
+ break parent_const.configure if parent_const.respond_to? :configure
70
+ namespace.pop
71
+ end
72
+ default_config = Client::Configuration.new parent_config
73
+
74
+ default_config
75
+ end
76
+ yield @configure if block_given?
77
+ @configure
78
+ end
79
+
80
+ ##
81
+ # Configure the UserLicenseService Client instance.
82
+ #
83
+ # The configuration is set to the derived mode, meaning that values can be changed,
84
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
85
+ # should be made on {Client.configure}.
86
+ #
87
+ # See {::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client::Configuration}
88
+ # for a description of the configuration fields.
89
+ #
90
+ # @yield [config] Configure the Client client.
91
+ # @yieldparam config [Client::Configuration]
92
+ #
93
+ # @return [Client::Configuration]
94
+ #
95
+ def configure
96
+ yield @config if block_given?
97
+ @config
98
+ end
99
+
100
+ ##
101
+ # The effective universe domain
102
+ #
103
+ # @return [String]
104
+ #
105
+ def universe_domain
106
+ @user_license_service_stub.universe_domain
107
+ end
108
+
109
+ ##
110
+ # Create a new UserLicenseService client object.
111
+ #
112
+ # @example
113
+ #
114
+ # # Create a client using the default configuration
115
+ # client = ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new
116
+ #
117
+ # # Create a client using a custom configuration
118
+ # client = ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new do |config|
119
+ # config.timeout = 10.0
120
+ # end
121
+ #
122
+ # @yield [config] Configure the UserLicenseService client.
123
+ # @yieldparam config [Client::Configuration]
124
+ #
125
+ def initialize
126
+ # These require statements are intentionally placed here to initialize
127
+ # the gRPC module only when it's required.
128
+ # See https://github.com/googleapis/toolkit/issues/446
129
+ require "gapic/grpc"
130
+ require "google/cloud/discoveryengine/v1beta/user_license_service_services_pb"
131
+
132
+ # Create the configuration object
133
+ @config = Configuration.new Client.configure
134
+
135
+ # Yield the configuration if needed
136
+ yield @config if block_given?
137
+
138
+ # Create credentials
139
+ credentials = @config.credentials
140
+ # Use self-signed JWT if the endpoint is unchanged from default,
141
+ # but only if the default endpoint does not have a region prefix.
142
+ enable_self_signed_jwt = @config.endpoint.nil? ||
143
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
144
+ !@config.endpoint.split(".").first.include?("-"))
145
+ credentials ||= Credentials.default scope: @config.scope,
146
+ enable_self_signed_jwt: enable_self_signed_jwt
147
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
148
+ credentials = Credentials.new credentials, scope: @config.scope
149
+ end
150
+ @quota_project_id = @config.quota_project
151
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
152
+
153
+ @operations_client = Operations.new do |config|
154
+ config.credentials = credentials
155
+ config.quota_project = @quota_project_id
156
+ config.endpoint = @config.endpoint
157
+ config.universe_domain = @config.universe_domain
158
+ end
159
+
160
+ @user_license_service_stub = ::Gapic::ServiceStub.new(
161
+ ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Stub,
162
+ credentials: credentials,
163
+ endpoint: @config.endpoint,
164
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
165
+ universe_domain: @config.universe_domain,
166
+ channel_args: @config.channel_args,
167
+ interceptors: @config.interceptors,
168
+ channel_pool_config: @config.channel_pool,
169
+ logger: @config.logger
170
+ )
171
+
172
+ @user_license_service_stub.stub_logger&.info do |entry|
173
+ entry.set_system_name
174
+ entry.set_service
175
+ entry.message = "Created client for #{entry.service}"
176
+ entry.set_credentials_fields credentials
177
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
178
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
179
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
180
+ end
181
+
182
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
183
+ config.credentials = credentials
184
+ config.quota_project = @quota_project_id
185
+ config.endpoint = @user_license_service_stub.endpoint
186
+ config.universe_domain = @user_license_service_stub.universe_domain
187
+ config.logger = @user_license_service_stub.logger if config.respond_to? :logger=
188
+ end
189
+ end
190
+
191
+ ##
192
+ # Get the associated client for long-running operations.
193
+ #
194
+ # @return [::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Operations]
195
+ #
196
+ attr_reader :operations_client
197
+
198
+ ##
199
+ # Get the associated client for mix-in of the Locations.
200
+ #
201
+ # @return [Google::Cloud::Location::Locations::Client]
202
+ #
203
+ attr_reader :location_client
204
+
205
+ ##
206
+ # The logger used for request/response debug logging.
207
+ #
208
+ # @return [Logger]
209
+ #
210
+ def logger
211
+ @user_license_service_stub.logger
212
+ end
213
+
214
+ # Service calls
215
+
216
+ ##
217
+ # Lists the User Licenses.
218
+ #
219
+ # @overload list_user_licenses(request, options = nil)
220
+ # Pass arguments to `list_user_licenses` via a request object, either of type
221
+ # {::Google::Cloud::DiscoveryEngine::V1beta::ListUserLicensesRequest} or an equivalent Hash.
222
+ #
223
+ # @param request [::Google::Cloud::DiscoveryEngine::V1beta::ListUserLicensesRequest, ::Hash]
224
+ # A request object representing the call parameters. Required. To specify no
225
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
226
+ # @param options [::Gapic::CallOptions, ::Hash]
227
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
228
+ #
229
+ # @overload list_user_licenses(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
230
+ # Pass arguments to `list_user_licenses` via keyword arguments. Note that at
231
+ # least one keyword argument is required. To specify no parameters, or to keep all
232
+ # the default parameter values, pass an empty Hash as a request object (see above).
233
+ #
234
+ # @param parent [::String]
235
+ # Required. The parent
236
+ # {::Google::Cloud::DiscoveryEngine::V1beta::UserStore UserStore} resource name,
237
+ # format:
238
+ # `projects/{project}/locations/{location}/userStores/{user_store_id}`.
239
+ # @param page_size [::Integer]
240
+ # Optional. Requested page size. Server may return fewer items than
241
+ # requested. If unspecified, defaults to 10. The maximum value is 50; values
242
+ # above 50 will be coerced to 50.
243
+ #
244
+ # If this field is negative, an INVALID_ARGUMENT error is returned.
245
+ # @param page_token [::String]
246
+ # Optional. A page token, received from a previous `ListUserLicenses` call.
247
+ # Provide this to retrieve the subsequent page.
248
+ #
249
+ # When paginating, all other parameters provided to `ListUserLicenses`
250
+ # must match the call that provided the page token.
251
+ # @param filter [::String]
252
+ # Optional. Filter for the list request.
253
+ #
254
+ # Supported fields:
255
+ #
256
+ # * `license_assignment_state`
257
+ # * `user_principal`
258
+ # *
259
+ # Examples:
260
+ #
261
+ # * `license_assignment_state = ASSIGNED` to list assigned user licenses.
262
+ # * `license_assignment_state = NO_LICENSE` to list not licensed users.
263
+ # * `license_assignment_state = NO_LICENSE_ATTEMPTED_LOGIN` to list users
264
+ # who attempted login but no license assigned.
265
+ # * `license_assignment_state != NO_LICENSE_ATTEMPTED_LOGIN` to filter
266
+ # out users who attempted login but no license assigned.
267
+ # * `user_principal = user1@example.com` to list user license for
268
+ # `user1@example.com`.
269
+ # @param order_by [::String]
270
+ # Optional. The order in which the
271
+ # {::Google::Cloud::DiscoveryEngine::V1beta::UserLicense UserLicense}s are listed.
272
+ # The value must be a comma-separated list of fields. Default sorting order
273
+ # is ascending. To specify descending order for a field, append a " desc"
274
+ # suffix. Redundant space characters in the syntax are insignificant.
275
+ #
276
+ # Supported fields (only `user_principal` is supported for now):
277
+ #
278
+ # * `user_principal`
279
+ #
280
+ # If not set, the default ordering is by `user_principal`.
281
+ #
282
+ # Examples:
283
+ #
284
+ # * `user_principal` to order by `user_principal` in ascending order.
285
+ # * `user_principal desc` to order by `user_principal` in descending order.
286
+ #
287
+ # @yield [response, operation] Access the result along with the RPC operation
288
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1beta::UserLicense>]
289
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
290
+ #
291
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1beta::UserLicense>]
292
+ #
293
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
294
+ #
295
+ # @example Basic example
296
+ # require "google/cloud/discovery_engine/v1beta"
297
+ #
298
+ # # Create a client object. The client can be reused for multiple calls.
299
+ # client = Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new
300
+ #
301
+ # # Create a request. To set request fields, pass in keyword arguments.
302
+ # request = Google::Cloud::DiscoveryEngine::V1beta::ListUserLicensesRequest.new
303
+ #
304
+ # # Call the list_user_licenses method.
305
+ # result = client.list_user_licenses request
306
+ #
307
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
308
+ # # over elements, and API calls will be issued to fetch pages as needed.
309
+ # result.each do |item|
310
+ # # Each element is of type ::Google::Cloud::DiscoveryEngine::V1beta::UserLicense.
311
+ # p item
312
+ # end
313
+ #
314
+ def list_user_licenses request, options = nil
315
+ raise ::ArgumentError, "request must be provided" if request.nil?
316
+
317
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::ListUserLicensesRequest
318
+
319
+ # Converts hash and nil to an options object
320
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
321
+
322
+ # Customize the options with defaults
323
+ metadata = @config.rpcs.list_user_licenses.metadata.to_h
324
+
325
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
326
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
327
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
328
+ gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
329
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
330
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
331
+
332
+ header_params = {}
333
+ if request.parent
334
+ header_params["parent"] = request.parent
335
+ end
336
+
337
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
338
+ metadata[:"x-goog-request-params"] ||= request_params_header
339
+
340
+ options.apply_defaults timeout: @config.rpcs.list_user_licenses.timeout,
341
+ metadata: metadata,
342
+ retry_policy: @config.rpcs.list_user_licenses.retry_policy
343
+
344
+ options.apply_defaults timeout: @config.timeout,
345
+ metadata: @config.metadata,
346
+ retry_policy: @config.retry_policy
347
+
348
+ @user_license_service_stub.call_rpc :list_user_licenses, request, options: options do |response, operation|
349
+ response = ::Gapic::PagedEnumerable.new @user_license_service_stub, :list_user_licenses, request, response, operation, options
350
+ yield response, operation if block_given?
351
+ throw :response, response
352
+ end
353
+ rescue ::GRPC::BadStatus => e
354
+ raise ::Google::Cloud::Error.from_error(e)
355
+ end
356
+
357
+ ##
358
+ # Lists all the
359
+ # {::Google::Cloud::DiscoveryEngine::V1beta::LicenseConfigUsageStats LicenseConfigUsageStats}s
360
+ # associated with the project.
361
+ #
362
+ # @overload list_license_configs_usage_stats(request, options = nil)
363
+ # Pass arguments to `list_license_configs_usage_stats` via a request object, either of type
364
+ # {::Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsRequest} or an equivalent Hash.
365
+ #
366
+ # @param request [::Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsRequest, ::Hash]
367
+ # A request object representing the call parameters. Required. To specify no
368
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
369
+ # @param options [::Gapic::CallOptions, ::Hash]
370
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
371
+ #
372
+ # @overload list_license_configs_usage_stats(parent: nil)
373
+ # Pass arguments to `list_license_configs_usage_stats` via keyword arguments. Note that at
374
+ # least one keyword argument is required. To specify no parameters, or to keep all
375
+ # the default parameter values, pass an empty Hash as a request object (see above).
376
+ #
377
+ # @param parent [::String]
378
+ # Required. The parent branch resource name, such as
379
+ # `projects/{project}/locations/{location}/userStores/{user_store_id}`.
380
+ #
381
+ # @yield [response, operation] Access the result along with the RPC operation
382
+ # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsResponse]
383
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
384
+ #
385
+ # @return [::Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsResponse]
386
+ #
387
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
388
+ #
389
+ # @example Basic example
390
+ # require "google/cloud/discovery_engine/v1beta"
391
+ #
392
+ # # Create a client object. The client can be reused for multiple calls.
393
+ # client = Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new
394
+ #
395
+ # # Create a request. To set request fields, pass in keyword arguments.
396
+ # request = Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsRequest.new
397
+ #
398
+ # # Call the list_license_configs_usage_stats method.
399
+ # result = client.list_license_configs_usage_stats request
400
+ #
401
+ # # The returned object is of type Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsResponse.
402
+ # p result
403
+ #
404
+ def list_license_configs_usage_stats request, options = nil
405
+ raise ::ArgumentError, "request must be provided" if request.nil?
406
+
407
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::ListLicenseConfigsUsageStatsRequest
408
+
409
+ # Converts hash and nil to an options object
410
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
411
+
412
+ # Customize the options with defaults
413
+ metadata = @config.rpcs.list_license_configs_usage_stats.metadata.to_h
414
+
415
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
416
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
417
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
418
+ gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
419
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
420
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
421
+
422
+ header_params = {}
423
+ if request.parent
424
+ header_params["parent"] = request.parent
425
+ end
426
+
427
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
428
+ metadata[:"x-goog-request-params"] ||= request_params_header
429
+
430
+ options.apply_defaults timeout: @config.rpcs.list_license_configs_usage_stats.timeout,
431
+ metadata: metadata,
432
+ retry_policy: @config.rpcs.list_license_configs_usage_stats.retry_policy
433
+
434
+ options.apply_defaults timeout: @config.timeout,
435
+ metadata: @config.metadata,
436
+ retry_policy: @config.retry_policy
437
+
438
+ @user_license_service_stub.call_rpc :list_license_configs_usage_stats, request, options: options do |response, operation|
439
+ yield response, operation if block_given?
440
+ end
441
+ rescue ::GRPC::BadStatus => e
442
+ raise ::Google::Cloud::Error.from_error(e)
443
+ end
444
+
445
+ ##
446
+ # Updates the User License.
447
+ # This method is used for batch assign/unassign licenses to users.
448
+ #
449
+ # @overload batch_update_user_licenses(request, options = nil)
450
+ # Pass arguments to `batch_update_user_licenses` via a request object, either of type
451
+ # {::Google::Cloud::DiscoveryEngine::V1beta::BatchUpdateUserLicensesRequest} or an equivalent Hash.
452
+ #
453
+ # @param request [::Google::Cloud::DiscoveryEngine::V1beta::BatchUpdateUserLicensesRequest, ::Hash]
454
+ # A request object representing the call parameters. Required. To specify no
455
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
456
+ # @param options [::Gapic::CallOptions, ::Hash]
457
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
458
+ #
459
+ # @overload batch_update_user_licenses(inline_source: nil, parent: nil, delete_unassigned_user_licenses: nil)
460
+ # Pass arguments to `batch_update_user_licenses` via keyword arguments. Note that at
461
+ # least one keyword argument is required. To specify no parameters, or to keep all
462
+ # the default parameter values, pass an empty Hash as a request object (see above).
463
+ #
464
+ # @param inline_source [::Google::Cloud::DiscoveryEngine::V1beta::BatchUpdateUserLicensesRequest::InlineSource, ::Hash]
465
+ # The inline source for the input content for document embeddings.
466
+ # @param parent [::String]
467
+ # Required. The parent
468
+ # {::Google::Cloud::DiscoveryEngine::V1beta::UserStore UserStore} resource name,
469
+ # format:
470
+ # `projects/{project}/locations/{location}/userStores/{user_store_id}`.
471
+ # @param delete_unassigned_user_licenses [::Boolean]
472
+ # Optional. If true, if user licenses removed associated license config, the
473
+ # user license will be deleted. By default which is false, the user license
474
+ # will be updated to unassigned state.
475
+ #
476
+ # @yield [response, operation] Access the result along with the RPC operation
477
+ # @yieldparam response [::Gapic::Operation]
478
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
479
+ #
480
+ # @return [::Gapic::Operation]
481
+ #
482
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
483
+ #
484
+ # @example Basic example
485
+ # require "google/cloud/discovery_engine/v1beta"
486
+ #
487
+ # # Create a client object. The client can be reused for multiple calls.
488
+ # client = Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new
489
+ #
490
+ # # Create a request. To set request fields, pass in keyword arguments.
491
+ # request = Google::Cloud::DiscoveryEngine::V1beta::BatchUpdateUserLicensesRequest.new
492
+ #
493
+ # # Call the batch_update_user_licenses method.
494
+ # result = client.batch_update_user_licenses request
495
+ #
496
+ # # The returned object is of type Gapic::Operation. You can use it to
497
+ # # check the status of an operation, cancel it, or wait for results.
498
+ # # Here is how to wait for a response.
499
+ # result.wait_until_done! timeout: 60
500
+ # if result.response?
501
+ # p result.response
502
+ # else
503
+ # puts "No response received."
504
+ # end
505
+ #
506
+ def batch_update_user_licenses request, options = nil
507
+ raise ::ArgumentError, "request must be provided" if request.nil?
508
+
509
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::BatchUpdateUserLicensesRequest
510
+
511
+ # Converts hash and nil to an options object
512
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
513
+
514
+ # Customize the options with defaults
515
+ metadata = @config.rpcs.batch_update_user_licenses.metadata.to_h
516
+
517
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
518
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
519
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
520
+ gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
521
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
522
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
523
+
524
+ header_params = {}
525
+ if request.parent
526
+ header_params["parent"] = request.parent
527
+ end
528
+
529
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
530
+ metadata[:"x-goog-request-params"] ||= request_params_header
531
+
532
+ options.apply_defaults timeout: @config.rpcs.batch_update_user_licenses.timeout,
533
+ metadata: metadata,
534
+ retry_policy: @config.rpcs.batch_update_user_licenses.retry_policy
535
+
536
+ options.apply_defaults timeout: @config.timeout,
537
+ metadata: @config.metadata,
538
+ retry_policy: @config.retry_policy
539
+
540
+ @user_license_service_stub.call_rpc :batch_update_user_licenses, request, options: options do |response, operation|
541
+ response = ::Gapic::Operation.new response, @operations_client, options: options
542
+ yield response, operation if block_given?
543
+ throw :response, response
544
+ end
545
+ rescue ::GRPC::BadStatus => e
546
+ raise ::Google::Cloud::Error.from_error(e)
547
+ end
548
+
549
+ ##
550
+ # Configuration class for the UserLicenseService API.
551
+ #
552
+ # This class represents the configuration for UserLicenseService,
553
+ # providing control over timeouts, retry behavior, logging, transport
554
+ # parameters, and other low-level controls. Certain parameters can also be
555
+ # applied individually to specific RPCs. See
556
+ # {::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client::Configuration::Rpcs}
557
+ # for a list of RPCs that can be configured independently.
558
+ #
559
+ # Configuration can be applied globally to all clients, or to a single client
560
+ # on construction.
561
+ #
562
+ # @example
563
+ #
564
+ # # Modify the global config, setting the timeout for
565
+ # # list_user_licenses to 20 seconds,
566
+ # # and all remaining timeouts to 10 seconds.
567
+ # ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.configure do |config|
568
+ # config.timeout = 10.0
569
+ # config.rpcs.list_user_licenses.timeout = 20.0
570
+ # end
571
+ #
572
+ # # Apply the above configuration only to a new client.
573
+ # client = ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new do |config|
574
+ # config.timeout = 10.0
575
+ # config.rpcs.list_user_licenses.timeout = 20.0
576
+ # end
577
+ #
578
+ # @!attribute [rw] endpoint
579
+ # A custom service endpoint, as a hostname or hostname:port. The default is
580
+ # nil, indicating to use the default endpoint in the current universe domain.
581
+ # @return [::String,nil]
582
+ # @!attribute [rw] credentials
583
+ # Credentials to send with calls. You may provide any of the following types:
584
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
585
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
586
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
587
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
588
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
589
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
590
+ # * (`nil`) indicating no credentials
591
+ #
592
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
593
+ # is deprecated. Providing an unvalidated credential configuration to
594
+ # Google APIs can compromise the security of your systems and data.
595
+ #
596
+ # @example
597
+ #
598
+ # # The recommended way to provide credentials is to use the `make_creds` method
599
+ # # on the appropriate credentials class for your environment.
600
+ #
601
+ # require "googleauth"
602
+ #
603
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
604
+ # json_key_io: ::File.open("/path/to/keyfile.json")
605
+ # )
606
+ #
607
+ # client = ::Google::Cloud::DiscoveryEngine::V1beta::UserLicenseService::Client.new do |config|
608
+ # config.credentials = credentials
609
+ # end
610
+ #
611
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
612
+ # external source for authentication to Google Cloud, you must validate it before
613
+ # providing it to a Google API client library. Providing an unvalidated credential
614
+ # configuration to Google APIs can compromise the security of your systems and data.
615
+ # For more information, refer to [Validate credential configurations from external
616
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
617
+ # @return [::Object]
618
+ # @!attribute [rw] scope
619
+ # The OAuth scopes
620
+ # @return [::Array<::String>]
621
+ # @!attribute [rw] lib_name
622
+ # The library name as recorded in instrumentation and logging
623
+ # @return [::String]
624
+ # @!attribute [rw] lib_version
625
+ # The library version as recorded in instrumentation and logging
626
+ # @return [::String]
627
+ # @!attribute [rw] channel_args
628
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
629
+ # `GRPC::Core::Channel` object is provided as the credential.
630
+ # @return [::Hash]
631
+ # @!attribute [rw] interceptors
632
+ # An array of interceptors that are run before calls are executed.
633
+ # @return [::Array<::GRPC::ClientInterceptor>]
634
+ # @!attribute [rw] timeout
635
+ # The call timeout in seconds.
636
+ # @return [::Numeric]
637
+ # @!attribute [rw] metadata
638
+ # Additional gRPC headers to be sent with the call.
639
+ # @return [::Hash{::Symbol=>::String}]
640
+ # @!attribute [rw] retry_policy
641
+ # The retry policy. The value is a hash with the following keys:
642
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
643
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
644
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
645
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
646
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
647
+ # trigger a retry.
648
+ # @return [::Hash]
649
+ # @!attribute [rw] quota_project
650
+ # A separate project against which to charge quota.
651
+ # @return [::String]
652
+ # @!attribute [rw] universe_domain
653
+ # The universe domain within which to make requests. This determines the
654
+ # default endpoint URL. The default value of nil uses the environment
655
+ # universe (usually the default "googleapis.com" universe).
656
+ # @return [::String,nil]
657
+ # @!attribute [rw] logger
658
+ # A custom logger to use for request/response debug logging, or the value
659
+ # `:default` (the default) to construct a default logger, or `nil` to
660
+ # explicitly disable logging.
661
+ # @return [::Logger,:default,nil]
662
+ #
663
+ class Configuration
664
+ extend ::Gapic::Config
665
+
666
+ # @private
667
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
668
+ DEFAULT_ENDPOINT = "discoveryengine.googleapis.com"
669
+
670
+ config_attr :endpoint, nil, ::String, nil
671
+ config_attr :credentials, nil do |value|
672
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
673
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
674
+ allowed.any? { |klass| klass === value }
675
+ end
676
+ config_attr :scope, nil, ::String, ::Array, nil
677
+ config_attr :lib_name, nil, ::String, nil
678
+ config_attr :lib_version, nil, ::String, nil
679
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
680
+ config_attr :interceptors, nil, ::Array, nil
681
+ config_attr :timeout, nil, ::Numeric, nil
682
+ config_attr :metadata, nil, ::Hash, nil
683
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
684
+ config_attr :quota_project, nil, ::String, nil
685
+ config_attr :universe_domain, nil, ::String, nil
686
+ config_attr :logger, :default, ::Logger, nil, :default
687
+
688
+ # @private
689
+ def initialize parent_config = nil
690
+ @parent_config = parent_config unless parent_config.nil?
691
+
692
+ yield self if block_given?
693
+ end
694
+
695
+ ##
696
+ # Configurations for individual RPCs
697
+ # @return [Rpcs]
698
+ #
699
+ def rpcs
700
+ @rpcs ||= begin
701
+ parent_rpcs = nil
702
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
703
+ Rpcs.new parent_rpcs
704
+ end
705
+ end
706
+
707
+ ##
708
+ # Configuration for the channel pool
709
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
710
+ #
711
+ def channel_pool
712
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
713
+ end
714
+
715
+ ##
716
+ # Configuration RPC class for the UserLicenseService API.
717
+ #
718
+ # Includes fields providing the configuration for each RPC in this service.
719
+ # Each configuration object is of type `Gapic::Config::Method` and includes
720
+ # the following configuration fields:
721
+ #
722
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
723
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
724
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
725
+ # include the following keys:
726
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
727
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
728
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
729
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
730
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
731
+ # trigger a retry.
732
+ #
733
+ class Rpcs
734
+ ##
735
+ # RPC-specific configuration for `list_user_licenses`
736
+ # @return [::Gapic::Config::Method]
737
+ #
738
+ attr_reader :list_user_licenses
739
+ ##
740
+ # RPC-specific configuration for `list_license_configs_usage_stats`
741
+ # @return [::Gapic::Config::Method]
742
+ #
743
+ attr_reader :list_license_configs_usage_stats
744
+ ##
745
+ # RPC-specific configuration for `batch_update_user_licenses`
746
+ # @return [::Gapic::Config::Method]
747
+ #
748
+ attr_reader :batch_update_user_licenses
749
+
750
+ # @private
751
+ def initialize parent_rpcs = nil
752
+ list_user_licenses_config = parent_rpcs.list_user_licenses if parent_rpcs.respond_to? :list_user_licenses
753
+ @list_user_licenses = ::Gapic::Config::Method.new list_user_licenses_config
754
+ list_license_configs_usage_stats_config = parent_rpcs.list_license_configs_usage_stats if parent_rpcs.respond_to? :list_license_configs_usage_stats
755
+ @list_license_configs_usage_stats = ::Gapic::Config::Method.new list_license_configs_usage_stats_config
756
+ batch_update_user_licenses_config = parent_rpcs.batch_update_user_licenses if parent_rpcs.respond_to? :batch_update_user_licenses
757
+ @batch_update_user_licenses = ::Gapic::Config::Method.new batch_update_user_licenses_config
758
+
759
+ yield self if block_given?
760
+ end
761
+ end
762
+ end
763
+ end
764
+ end
765
+ end
766
+ end
767
+ end
768
+ end