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