google-cloud-beyond_corp-app_gateways-v1 0.13.1 → 0.15.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 (28) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/README.md +3 -6
  4. data/lib/google/cloud/beyond_corp/app_gateways/v1/app_gateways_service/client.rb +21 -7
  5. data/lib/google/cloud/beyond_corp/app_gateways/v1/app_gateways_service/credentials.rb +1 -1
  6. data/lib/google/cloud/beyond_corp/app_gateways/v1/app_gateways_service/operations.rb +1 -1
  7. data/lib/google/cloud/beyond_corp/app_gateways/v1/app_gateways_service/paths.rb +1 -1
  8. data/lib/google/cloud/beyond_corp/app_gateways/v1/app_gateways_service.rb +7 -1
  9. data/lib/google/cloud/beyond_corp/app_gateways/v1/version.rb +1 -1
  10. data/lib/google/cloud/beyond_corp/app_gateways/v1.rb +1 -1
  11. data/lib/google/cloud/beyondcorp/appgateways/v1/app_gateways_service_pb.rb +2 -1
  12. data/lib/google/cloud/beyondcorp/appgateways/v1/app_gateways_service_services_pb.rb +5 -1
  13. data/lib/google-cloud-beyond_corp-app_gateways-v1.rb +1 -1
  14. data/proto_docs/README.md +1 -1
  15. data/proto_docs/google/api/client.rb +1 -1
  16. data/proto_docs/google/api/field_behavior.rb +1 -1
  17. data/proto_docs/google/api/launch_stage.rb +1 -1
  18. data/proto_docs/google/api/resource.rb +1 -1
  19. data/proto_docs/google/cloud/beyondcorp/appgateways/v1/app_gateways_service.rb +17 -10
  20. data/proto_docs/google/longrunning/operations.rb +1 -1
  21. data/proto_docs/google/protobuf/any.rb +1 -1
  22. data/proto_docs/google/protobuf/duration.rb +1 -1
  23. data/proto_docs/google/protobuf/empty.rb +1 -1
  24. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  25. data/proto_docs/google/rpc/status.rb +1 -1
  26. metadata +13 -13
  27. data/proto_docs/google/protobuf/field_mask.rb +0 -229
  28. data/proto_docs/google/type/expr.rb +0 -75
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 62826c4cb48a9f4c9c180475000f55b55ac71bf953f20d042cfad66f49f2002e
4
- data.tar.gz: f1a6abd31bd5de0d73a7cf32664c1d945766ae7a01fb349125d5c3e995016e7e
3
+ metadata.gz: e35689f67c281aa45715abb70a4ec9dd1ba9055d950af676264d412d8622791b
4
+ data.tar.gz: ea95dcde5306cfc63c82230fceeb262148bdec8f725274364fe49a5e38a65daf
5
5
  SHA512:
6
- metadata.gz: 4ed7999bf433dfe2b06ac02662fd313b75effd0486cb61df610c6f6d6bc215e984336c9905a378c2191b587543cf08ab2e0fc6da43bb80cf5e93b96893274f76
7
- data.tar.gz: e58fe5b0a28d5c56dc1e9288d19c87886562949e01fc08fbe9b2be34fc6c120b9653434980159456f54547ea0b1dd76f99d6b4445e3ce8828e891c4a4b973819
6
+ metadata.gz: a5ac68ca47178cf3ef6f35279fce65b4fa2cf240778f075e3d71c199ca41825a39ef5c7ae125f11ebb06b02723d66ca4c39f9845cfee8af9c392705686169422
7
+ data.tar.gz: 6b4982e735a613332c449cfb4ce129f254b6ca5c52be7b5262ffb7eda33b62f6336b179b4a78a8378871c39bfae168614dfb24727607b8308e277e72fa0ee051
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title="BeyondCorp AppGateways V1 API"
2
+ --title="BeyondCorp V1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/README.md CHANGED
@@ -1,12 +1,12 @@
1
- # Ruby Client for the BeyondCorp AppGateways V1 API
1
+ # Ruby Client for the BeyondCorp V1 API
2
2
 
3
- Beyondcorp Enterprise provides identity and context aware access controls for enterprise resources and enables zero-trust access. Using the Beyondcorp Enterprise APIs, enterprises can set up multi-cloud and on-prem connectivity using the App Connector hybrid connectivity solution.
3
+ Chrome Enterprise Premium is a secure enterprise browsing solution that provides secure access to applications and resources, and offers integrated threat and data protection. It adds an extra layer of security to safeguard your Chrome browser environment, including Data Loss Prevention (DLP), real-time URL and file scanning, and Context-Aware Access for SaaS and web apps.
4
4
 
5
5
 
6
6
  https://github.com/googleapis/google-cloud-ruby
7
7
 
8
8
  This gem is a _versioned_ client. It provides basic client classes for a
9
- specific version of the BeyondCorp AppGateways V1 API. Most users should consider using
9
+ specific version of the BeyondCorp V1 API. Most users should consider using
10
10
  the main client gem,
11
11
  [google-cloud-beyond_corp](https://rubygems.org/gems/google-cloud-beyond_corp).
12
12
  See the section below titled *Which client should I use?* for more information.
@@ -39,9 +39,6 @@ response = client.list_app_gateways request
39
39
  View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-beyond_corp-app_gateways-v1/latest)
40
40
  for class and method documentation.
41
41
 
42
- See also the [Product Documentation](https://cloud.google.com/beyondcorp/)
43
- for general usage information.
44
-
45
42
  ## Debug Logging
46
43
 
47
44
  This library comes with opt-in Debug Logging that can help you troubleshoot
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -45,6 +45,10 @@ module Google
45
45
  # The AppGatewaysService service provides methods to manage
46
46
  # (create/read/update/delete) BeyondCorp AppGateways.
47
47
  #
48
+ #
49
+ # Deprecated: App Connector is deprecated and creation of new App Connector
50
+ # resources is no longer permitted. Use Security Gateway instead.
51
+ #
48
52
  class Client
49
53
  # @private
50
54
  API_VERSION = ""
@@ -63,6 +67,8 @@ module Google
63
67
  # See {::Google::Cloud::BeyondCorp::AppGateways::V1::AppGatewaysService::Client::Configuration}
64
68
  # for a description of the configuration fields.
65
69
  #
70
+ # @deprecated This service is deprecated and may be removed in the next major version update.
71
+ #
66
72
  # @example
67
73
  #
68
74
  # # Modify the configuration for all AppGatewaysService clients
@@ -246,6 +252,8 @@ module Google
246
252
  ##
247
253
  # Lists AppGateways in a given project and location.
248
254
  #
255
+ # @deprecated This method is deprecated and may be removed in the next major version update.
256
+ #
249
257
  # @overload list_app_gateways(request, options = nil)
250
258
  # Pass arguments to `list_app_gateways` via a request object, either of type
251
259
  # {::Google::Cloud::BeyondCorp::AppGateways::V1::ListAppGatewaysRequest} or an equivalent Hash.
@@ -269,8 +277,8 @@ module Google
269
277
  # If not specified, a default value of 50 will be used by the service.
270
278
  # Regardless of the page_size value, the response may include a partial list
271
279
  # and a caller should only rely on response's
272
- # [next_page_token][BeyondCorp.ListAppGatewaysResponse.next_page_token] to
273
- # determine if there are more instances left to be queried.
280
+ # {::Google::Cloud::BeyondCorp::AppGateways::V1::ListAppGatewaysResponse#next_page_token next_page_token}
281
+ # to determine if there are more instances left to be queried.
274
282
  # @param page_token [::String]
275
283
  # Optional. The next_page_token value returned from a previous
276
284
  # ListAppGatewaysRequest, if any.
@@ -355,6 +363,8 @@ module Google
355
363
  ##
356
364
  # Gets details of a single AppGateway.
357
365
  #
366
+ # @deprecated This method is deprecated and may be removed in the next major version update.
367
+ #
358
368
  # @overload get_app_gateway(request, options = nil)
359
369
  # Pass arguments to `get_app_gateway` via a request object, either of type
360
370
  # {::Google::Cloud::BeyondCorp::AppGateways::V1::GetAppGatewayRequest} or an equivalent Hash.
@@ -441,6 +451,8 @@ module Google
441
451
  ##
442
452
  # Creates a new AppGateway in a given project and location.
443
453
  #
454
+ # @deprecated This method is deprecated and may be removed in the next major version update.
455
+ #
444
456
  # @overload create_app_gateway(request, options = nil)
445
457
  # Pass arguments to `create_app_gateway` via a request object, either of type
446
458
  # {::Google::Cloud::BeyondCorp::AppGateways::V1::CreateAppGatewayRequest} or an equivalent Hash.
@@ -472,8 +484,8 @@ module Google
472
484
  # ignore the request if it has already been completed. The server will
473
485
  # guarantee that for at least 60 minutes since the first request.
474
486
  #
475
- # For example, consider a situation where you make an initial request and t
476
- # he request times out. If you make the request again with the same request
487
+ # For example, consider a situation where you make an initial request and
488
+ # the request times out. If you make the request again with the same request
477
489
  # ID, the server can check if original operation with the same request ID
478
490
  # was received, and if so, will ignore the second request. This prevents
479
491
  # clients from accidentally creating duplicate commitments.
@@ -560,6 +572,8 @@ module Google
560
572
  ##
561
573
  # Deletes a single AppGateway.
562
574
  #
575
+ # @deprecated This method is deprecated and may be removed in the next major version update.
576
+ #
563
577
  # @overload delete_app_gateway(request, options = nil)
564
578
  # Pass arguments to `delete_app_gateway` via a request object, either of type
565
579
  # {::Google::Cloud::BeyondCorp::AppGateways::V1::DeleteAppGatewayRequest} or an equivalent Hash.
@@ -584,8 +598,8 @@ module Google
584
598
  # ignore the request if it has already been completed. The server will
585
599
  # guarantee that for at least 60 minutes after the first request.
586
600
  #
587
- # For example, consider a situation where you make an initial request and t
588
- # he request times out. If you make the request again with the same request
601
+ # For example, consider a situation where you make an initial request and
602
+ # the request times out. If you make the request again with the same request
589
603
  # ID, the server can check if original operation with the same request ID
590
604
  # was received, and if so, will ignore the second request. This prevents
591
605
  # clients from accidentally creating duplicate commitments.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -48,6 +48,12 @@ module Google
48
48
  # The AppGatewaysService service provides methods to manage
49
49
  # (create/read/update/delete) BeyondCorp AppGateways.
50
50
  #
51
+ #
52
+ # Deprecated: App Connector is deprecated and creation of new App Connector
53
+ # resources is no longer permitted. Use Security Gateway instead.
54
+ #
55
+ # @deprecated This service is deprecated and may be removed in the next major version update.
56
+ #
51
57
  # @example Load this service and instantiate a gRPC client
52
58
  #
53
59
  # require "google/cloud/beyond_corp/app_gateways/v1/app_gateways_service"
@@ -22,7 +22,7 @@ module Google
22
22
  module BeyondCorp
23
23
  module AppGateways
24
24
  module V1
25
- VERSION = "0.13.1"
25
+ VERSION = "0.15.0"
26
26
  end
27
27
  end
28
28
  end
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -9,10 +9,11 @@ require 'google/api/client_pb'
9
9
  require 'google/api/field_behavior_pb'
10
10
  require 'google/api/resource_pb'
11
11
  require 'google/longrunning/operations_pb'
12
+ require 'google/protobuf/empty_pb'
12
13
  require 'google/protobuf/timestamp_pb'
13
14
 
14
15
 
15
- descriptor_data = "\nAgoogle/cloud/beyondcorp/appgateways/v1/app_gateways_service.proto\x12&google.cloud.beyondcorp.appgateways.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xb3\x01\n\x16ListAppGatewaysRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$beyondcorp.googleapis.com/AppGateway\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x04 \x01(\tB\x03\xe0\x41\x01\x12\x15\n\x08order_by\x18\x05 \x01(\tB\x03\xe0\x41\x01\"\x91\x01\n\x17ListAppGatewaysResponse\x12H\n\x0c\x61pp_gateways\x18\x01 \x03(\x0b\x32\x32.google.cloud.beyondcorp.appgateways.v1.AppGateway\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t\"R\n\x14GetAppGatewayRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$beyondcorp.googleapis.com/AppGateway\"\xf7\x01\n\x17\x43reateAppGatewayRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$beyondcorp.googleapis.com/AppGateway\x12\x1b\n\x0e\x61pp_gateway_id\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12L\n\x0b\x61pp_gateway\x18\x03 \x01(\x0b\x32\x32.google.cloud.beyondcorp.appgateways.v1.AppGatewayB\x03\xe0\x41\x02\x12\x17\n\nrequest_id\x18\x04 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rvalidate_only\x18\x05 \x01(\x08\x42\x03\xe0\x41\x01\"\x8a\x01\n\x17\x44\x65leteAppGatewayRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$beyondcorp.googleapis.com/AppGateway\x12\x17\n\nrequest_id\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x1a\n\rvalidate_only\x18\x03 \x01(\x08\x42\x03\xe0\x41\x01\"\xaa\x08\n\nAppGateway\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x34\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12S\n\x06labels\x18\x04 \x03(\x0b\x32>.google.cloud.beyondcorp.appgateways.v1.AppGateway.LabelsEntryB\x03\xe0\x41\x01\x12\x19\n\x0c\x64isplay_name\x18\x05 \x01(\tB\x03\xe0\x41\x01\x12\x10\n\x03uid\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12J\n\x04type\x18\x07 \x01(\x0e\x32\x37.google.cloud.beyondcorp.appgateways.v1.AppGateway.TypeB\x03\xe0\x41\x02\x12L\n\x05state\x18\x08 \x01(\x0e\x32\x38.google.cloud.beyondcorp.appgateways.v1.AppGateway.StateB\x03\xe0\x41\x03\x12\x10\n\x03uri\x18\t \x01(\tB\x03\xe0\x41\x03\x12j\n\x15\x61llocated_connections\x18\n \x03(\x0b\x32\x46.google.cloud.beyondcorp.appgateways.v1.AppGateway.AllocatedConnectionB\x03\xe0\x41\x03\x12S\n\thost_type\x18\x0b \x01(\x0e\x32;.google.cloud.beyondcorp.appgateways.v1.AppGateway.HostTypeB\x03\xe0\x41\x02\x1a\x46\n\x13\x41llocatedConnection\x12\x14\n\x07psc_uri\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x19\n\x0cingress_port\x18\x02 \x01(\x05\x42\x03\xe0\x41\x02\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"+\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\r\n\tTCP_PROXY\x10\x01\"_\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07\x43REATED\x10\x02\x12\x0c\n\x08UPDATING\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\x08\n\x04\x44OWN\x10\x05\";\n\x08HostType\x12\x19\n\x15HOST_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10GCP_REGIONAL_MIG\x10\x01:l\xea\x41i\n$beyondcorp.googleapis.com/AppGateway\x12\x41projects/{project}/locations/{location}/appGateways/{app_gateway}\"\x8a\x02\n\x1b\x41ppGatewayOperationMetadata\x12\x34\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x31\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x13\n\x06target\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12\x11\n\x04verb\x18\x04 \x01(\tB\x03\xe0\x41\x03\x12\x1b\n\x0estatus_message\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12#\n\x16requested_cancellation\x18\x06 \x01(\x08\x42\x03\xe0\x41\x03\x12\x18\n\x0b\x61pi_version\x18\x07 \x01(\tB\x03\xe0\x41\x03\x32\xf6\x07\n\x12\x41ppGatewaysService\x12\xd4\x01\n\x0fListAppGateways\x12>.google.cloud.beyondcorp.appgateways.v1.ListAppGatewaysRequest\x1a?.google.cloud.beyondcorp.appgateways.v1.ListAppGatewaysResponse\"@\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x31\x12//v1/{parent=projects/*/locations/*}/appGateways\x12\xc1\x01\n\rGetAppGateway\x12<.google.cloud.beyondcorp.appgateways.v1.GetAppGatewayRequest\x1a\x32.google.cloud.beyondcorp.appgateways.v1.AppGateway\">\xda\x41\x04name\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=projects/*/locations/*/appGateways/*}\x12\x89\x02\n\x10\x43reateAppGateway\x12?.google.cloud.beyondcorp.appgateways.v1.CreateAppGatewayRequest\x1a\x1d.google.longrunning.Operation\"\x94\x01\xca\x41)\n\nAppGateway\x12\x1b\x41ppGatewayOperationMetadata\xda\x41!parent,app_gateway,app_gateway_id\x82\xd3\xe4\x93\x02>\"//v1/{parent=projects/*/locations/*}/appGateways:\x0b\x61pp_gateway\x12\xe9\x01\n\x10\x44\x65leteAppGateway\x12?.google.cloud.beyondcorp.appgateways.v1.DeleteAppGatewayRequest\x1a\x1d.google.longrunning.Operation\"u\xca\x41\x34\n\x15google.protobuf.Empty\x12\x1b\x41ppGatewayOperationMetadata\xda\x41\x04name\x82\xd3\xe4\x93\x02\x31*//v1/{name=projects/*/locations/*/appGateways/*}\x1aM\xca\x41\x19\x62\x65yondcorp.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n*com.google.cloud.beyondcorp.appgateways.v1B\x17\x41ppGatewaysServiceProtoP\x01ZLcloud.google.com/go/beyondcorp/appgateways/apiv1/appgatewayspb;appgatewayspb\xaa\x02&Google.Cloud.BeyondCorp.AppGateways.V1\xca\x02&Google\\Cloud\\BeyondCorp\\AppGateways\\V1\xea\x02*Google::Cloud::BeyondCorp::AppGateways::V1b\x06proto3"
16
+ descriptor_data = "\nAgoogle/cloud/beyondcorp/appgateways/v1/app_gateways_service.proto\x12&google.cloud.beyondcorp.appgateways.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xb8\x01\n\x16ListAppGatewaysRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe2\x41\x01\x02\xfa\x41&\x12$beyondcorp.googleapis.com/AppGateway\x12\x17\n\tpage_size\x18\x02 \x01(\x05\x42\x04\xe2\x41\x01\x01\x12\x18\n\npage_token\x18\x03 \x01(\tB\x04\xe2\x41\x01\x01\x12\x14\n\x06\x66ilter\x18\x04 \x01(\tB\x04\xe2\x41\x01\x01\x12\x16\n\x08order_by\x18\x05 \x01(\tB\x04\xe2\x41\x01\x01\"\x91\x01\n\x17ListAppGatewaysResponse\x12H\n\x0c\x61pp_gateways\x18\x01 \x03(\x0b\x32\x32.google.cloud.beyondcorp.appgateways.v1.AppGateway\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t\"S\n\x14GetAppGatewayRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe2\x41\x01\x02\xfa\x41&\n$beyondcorp.googleapis.com/AppGateway\"\xfc\x01\n\x17\x43reateAppGatewayRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe2\x41\x01\x02\xfa\x41&\x12$beyondcorp.googleapis.com/AppGateway\x12\x1c\n\x0e\x61pp_gateway_id\x18\x02 \x01(\tB\x04\xe2\x41\x01\x01\x12M\n\x0b\x61pp_gateway\x18\x03 \x01(\x0b\x32\x32.google.cloud.beyondcorp.appgateways.v1.AppGatewayB\x04\xe2\x41\x01\x02\x12\x18\n\nrequest_id\x18\x04 \x01(\tB\x04\xe2\x41\x01\x01\x12\x1b\n\rvalidate_only\x18\x05 \x01(\x08\x42\x04\xe2\x41\x01\x01\"\x8d\x01\n\x17\x44\x65leteAppGatewayRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe2\x41\x01\x02\xfa\x41&\n$beyondcorp.googleapis.com/AppGateway\x12\x18\n\nrequest_id\x18\x02 \x01(\tB\x04\xe2\x41\x01\x01\x12\x1b\n\rvalidate_only\x18\x03 \x01(\x08\x42\x04\xe2\x41\x01\x01\"\x9f\t\n\nAppGateway\x12\x12\n\x04name\x18\x01 \x01(\tB\x04\xe2\x41\x01\x02\x12\x35\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x03\x12\x35\n\x0bupdate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x03\x12T\n\x06labels\x18\x04 \x03(\x0b\x32>.google.cloud.beyondcorp.appgateways.v1.AppGateway.LabelsEntryB\x04\xe2\x41\x01\x01\x12\x1a\n\x0c\x64isplay_name\x18\x05 \x01(\tB\x04\xe2\x41\x01\x01\x12\x11\n\x03uid\x18\x06 \x01(\tB\x04\xe2\x41\x01\x03\x12K\n\x04type\x18\x07 \x01(\x0e\x32\x37.google.cloud.beyondcorp.appgateways.v1.AppGateway.TypeB\x04\xe2\x41\x01\x02\x12M\n\x05state\x18\x08 \x01(\x0e\x32\x38.google.cloud.beyondcorp.appgateways.v1.AppGateway.StateB\x04\xe2\x41\x01\x03\x12\x11\n\x03uri\x18\t \x01(\tB\x04\xe2\x41\x01\x03\x12k\n\x15\x61llocated_connections\x18\n \x03(\x0b\x32\x46.google.cloud.beyondcorp.appgateways.v1.AppGateway.AllocatedConnectionB\x04\xe2\x41\x01\x03\x12T\n\thost_type\x18\x0b \x01(\x0e\x32;.google.cloud.beyondcorp.appgateways.v1.AppGateway.HostTypeB\x04\xe2\x41\x01\x02\x12 \n\rsatisfies_pzs\x18\x0c \x01(\x08\x42\x04\xe2\x41\x01\x03H\x00\x88\x01\x01\x12 \n\rsatisfies_pzi\x18\r \x01(\x08\x42\x04\xe2\x41\x01\x03H\x01\x88\x01\x01\x1aH\n\x13\x41llocatedConnection\x12\x15\n\x07psc_uri\x18\x01 \x01(\tB\x04\xe2\x41\x01\x02\x12\x1a\n\x0cingress_port\x18\x02 \x01(\x05\x42\x04\xe2\x41\x01\x02\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"+\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\r\n\tTCP_PROXY\x10\x01\"_\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07\x43REATED\x10\x02\x12\x0c\n\x08UPDATING\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\x08\n\x04\x44OWN\x10\x05\";\n\x08HostType\x12\x19\n\x15HOST_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10GCP_REGIONAL_MIG\x10\x01:l\xea\x41i\n$beyondcorp.googleapis.com/AppGateway\x12\x41projects/{project}/locations/{location}/appGateways/{app_gateway}B\x10\n\x0e_satisfies_pzsB\x10\n\x0e_satisfies_pzi\"\x91\x02\n\x1b\x41ppGatewayOperationMetadata\x12\x35\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x03\x12\x32\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x04\xe2\x41\x01\x03\x12\x14\n\x06target\x18\x03 \x01(\tB\x04\xe2\x41\x01\x03\x12\x12\n\x04verb\x18\x04 \x01(\tB\x04\xe2\x41\x01\x03\x12\x1c\n\x0estatus_message\x18\x05 \x01(\tB\x04\xe2\x41\x01\x03\x12$\n\x16requested_cancellation\x18\x06 \x01(\x08\x42\x04\xe2\x41\x01\x03\x12\x19\n\x0b\x61pi_version\x18\x07 \x01(\tB\x04\xe2\x41\x01\x03\x32\x85\x08\n\x12\x41ppGatewaysService\x12\xd7\x01\n\x0fListAppGateways\x12>.google.cloud.beyondcorp.appgateways.v1.ListAppGatewaysRequest\x1a?.google.cloud.beyondcorp.appgateways.v1.ListAppGatewaysResponse\"C\x88\x02\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\x31\x12//v1/{parent=projects/*/locations/*}/appGateways\x12\xc4\x01\n\rGetAppGateway\x12<.google.cloud.beyondcorp.appgateways.v1.GetAppGatewayRequest\x1a\x32.google.cloud.beyondcorp.appgateways.v1.AppGateway\"A\x88\x02\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=projects/*/locations/*/appGateways/*}\x12\x8c\x02\n\x10\x43reateAppGateway\x12?.google.cloud.beyondcorp.appgateways.v1.CreateAppGatewayRequest\x1a\x1d.google.longrunning.Operation\"\x97\x01\x88\x02\x01\xca\x41)\n\nAppGateway\x12\x1b\x41ppGatewayOperationMetadata\xda\x41!parent,app_gateway,app_gateway_id\x82\xd3\xe4\x93\x02>\"//v1/{parent=projects/*/locations/*}/appGateways:\x0b\x61pp_gateway\x12\xec\x01\n\x10\x44\x65leteAppGateway\x12?.google.cloud.beyondcorp.appgateways.v1.DeleteAppGatewayRequest\x1a\x1d.google.longrunning.Operation\"x\x88\x02\x01\xca\x41\x34\n\x15google.protobuf.Empty\x12\x1b\x41ppGatewayOperationMetadata\xda\x41\x04name\x82\xd3\xe4\x93\x02\x31*//v1/{name=projects/*/locations/*/appGateways/*}\x1aP\x88\x02\x01\xca\x41\x19\x62\x65yondcorp.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x94\x02\n*com.google.cloud.beyondcorp.appgateways.v1B\x17\x41ppGatewaysServiceProtoP\x01ZLcloud.google.com/go/beyondcorp/appgateways/apiv1/appgatewayspb;appgatewayspb\xaa\x02&Google.Cloud.BeyondCorp.AppGateways.V1\xca\x02&Google\\Cloud\\BeyondCorp\\AppGateways\\V1\xea\x02*Google::Cloud::BeyondCorp::AppGateways::V1b\x06proto3"
16
17
 
17
18
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
18
19
  pool.add_serialized_file(descriptor_data)
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/cloud/beyondcorp/appgateways/v1/app_gateways_service.proto for package 'Google.Cloud.BeyondCorp.AppGateways.V1'
3
3
  # Original file comments:
4
- # Copyright 2022 Google LLC
4
+ # Copyright 2026 Google LLC
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -39,6 +39,10 @@ module Google
39
39
  #
40
40
  # The AppGatewaysService service provides methods to manage
41
41
  # (create/read/update/delete) BeyondCorp AppGateways.
42
+ #
43
+ #
44
+ # Deprecated: App Connector is deprecated and creation of new App Connector
45
+ # resources is no longer permitted. Use Security Gateway instead.
42
46
  class Service
43
47
 
44
48
  include ::GRPC::GenericService
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
data/proto_docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # BeyondCorp AppGateways V1 Protocol Buffer Documentation
1
+ # BeyondCorp V1 Protocol Buffer Documentation
2
2
 
3
3
  These files are for the YARD documentation of the generated protobuf files.
4
4
  They are not intended to be required or loaded at runtime.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -33,8 +33,8 @@ module Google
33
33
  # If not specified, a default value of 50 will be used by the service.
34
34
  # Regardless of the page_size value, the response may include a partial list
35
35
  # and a caller should only rely on response's
36
- # [next_page_token][BeyondCorp.ListAppGatewaysResponse.next_page_token] to
37
- # determine if there are more instances left to be queried.
36
+ # {::Google::Cloud::BeyondCorp::AppGateways::V1::ListAppGatewaysResponse#next_page_token next_page_token}
37
+ # to determine if there are more instances left to be queried.
38
38
  # @!attribute [rw] page_token
39
39
  # @return [::String]
40
40
  # Optional. The next_page_token value returned from a previous
@@ -100,8 +100,8 @@ module Google
100
100
  # ignore the request if it has already been completed. The server will
101
101
  # guarantee that for at least 60 minutes since the first request.
102
102
  #
103
- # For example, consider a situation where you make an initial request and t
104
- # he request times out. If you make the request again with the same request
103
+ # For example, consider a situation where you make an initial request and
104
+ # the request times out. If you make the request again with the same request
105
105
  # ID, the server can check if original operation with the same request ID
106
106
  # was received, and if so, will ignore the second request. This prevents
107
107
  # clients from accidentally creating duplicate commitments.
@@ -129,8 +129,8 @@ module Google
129
129
  # ignore the request if it has already been completed. The server will
130
130
  # guarantee that for at least 60 minutes after the first request.
131
131
  #
132
- # For example, consider a situation where you make an initial request and t
133
- # he request times out. If you make the request again with the same request
132
+ # For example, consider a situation where you make an initial request and
133
+ # the request times out. If you make the request again with the same request
134
134
  # ID, the server can check if original operation with the same request ID
135
135
  # was received, and if so, will ignore the second request. This prevents
136
136
  # clients from accidentally creating duplicate commitments.
@@ -186,6 +186,12 @@ module Google
186
186
  # @!attribute [rw] host_type
187
187
  # @return [::Google::Cloud::BeyondCorp::AppGateways::V1::AppGateway::HostType]
188
188
  # Required. The type of hosting used by the AppGateway.
189
+ # @!attribute [r] satisfies_pzs
190
+ # @return [::Boolean]
191
+ # Output only. Reserved for future use.
192
+ # @!attribute [r] satisfies_pzi
193
+ # @return [::Boolean]
194
+ # Output only. Reserved for future use.
189
195
  class AppGateway
190
196
  include ::Google::Protobuf::MessageExts
191
197
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -274,9 +280,10 @@ module Google
274
280
  # @return [::Boolean]
275
281
  # Output only. Identifies whether the user has requested cancellation
276
282
  # of the operation. Operations that have successfully been cancelled
277
- # have [Operation.error][] value with a
278
- # {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
279
- # `Code.CANCELLED`.
283
+ # have
284
+ # {::Google::Longrunning::Operation#error google.longrunning.Operation.error}
285
+ # value with a {::Google::Rpc::Status#code google.rpc.Status.code} of `1`,
286
+ # corresponding to `Code.CANCELLED`.
280
287
  # @!attribute [r] api_version
281
288
  # @return [::String]
282
289
  # Output only. API version used to start the operation.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -110,14 +110,15 @@ module Google
110
110
  # ) to obtain a formatter capable of generating timestamps in this format.
111
111
  # @!attribute [rw] seconds
112
112
  # @return [::Integer]
113
- # Represents seconds of UTC time since Unix epoch
114
- # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
115
- # 9999-12-31T23:59:59Z inclusive.
113
+ # Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must
114
+ # be between -315576000000 and 315576000000 inclusive (which corresponds to
115
+ # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
116
116
  # @!attribute [rw] nanos
117
117
  # @return [::Integer]
118
- # Non-negative fractions of a second at nanosecond resolution. Negative
119
- # second values with fractions must still have non-negative nanos values
120
- # that count forward in time. Must be from 0 to 999,999,999
118
+ # Non-negative fractions of a second at nanosecond resolution. This field is
119
+ # the nanosecond portion of the duration, not an alternative to seconds.
120
+ # Negative second values with fractions must still have non-negative nanos
121
+ # values that count forward in time. Must be between 0 and 999,999,999
121
122
  # inclusive.
122
123
  class Timestamp
123
124
  include ::Google::Protobuf::MessageExts
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2022 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-beyond_corp-app_gateways-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.1
4
+ version: 0.15.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -15,14 +15,14 @@ dependencies:
15
15
  requirements:
16
16
  - - "~>"
17
17
  - !ruby/object:Gem::Version
18
- version: '1.3'
18
+ version: '1.6'
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - "~>"
24
24
  - !ruby/object:Gem::Version
25
- version: '1.3'
25
+ version: '1.6'
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: google-cloud-errors
28
28
  requirement: !ruby/object:Gem::Requirement
@@ -65,10 +65,11 @@ dependencies:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
67
  version: '1.3'
68
- description: Beyondcorp Enterprise provides identity and context aware access controls
69
- for enterprise resources and enables zero-trust access. Using the Beyondcorp Enterprise
70
- APIs, enterprises can set up multi-cloud and on-prem connectivity using the App
71
- Connector hybrid connectivity solution. Note that google-cloud-beyond_corp-app_gateways-v1
68
+ description: Chrome Enterprise Premium is a secure enterprise browsing solution that
69
+ provides secure access to applications and resources, and offers integrated threat
70
+ and data protection. It adds an extra layer of security to safeguard your Chrome
71
+ browser environment, including Data Loss Prevention (DLP), real-time URL and file
72
+ scanning, and Context-Aware Access for SaaS and web apps. Note that google-cloud-beyond_corp-app_gateways-v1
72
73
  is a version-specific client library. For most uses, we recommend installing the
73
74
  main client library google-cloud-beyond_corp instead. See the readme for more details.
74
75
  email: googleapis-packages@google.com
@@ -100,10 +101,8 @@ files:
100
101
  - proto_docs/google/protobuf/any.rb
101
102
  - proto_docs/google/protobuf/duration.rb
102
103
  - proto_docs/google/protobuf/empty.rb
103
- - proto_docs/google/protobuf/field_mask.rb
104
104
  - proto_docs/google/protobuf/timestamp.rb
105
105
  - proto_docs/google/rpc/status.rb
106
- - proto_docs/google/type/expr.rb
107
106
  homepage: https://github.com/googleapis/google-cloud-ruby
108
107
  licenses:
109
108
  - Apache-2.0
@@ -124,8 +123,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
124
123
  requirements: []
125
124
  rubygems_version: 3.6.9
126
125
  specification_version: 4
127
- summary: Beyondcorp Enterprise provides identity and context aware access controls
128
- for enterprise resources and enables zero-trust access. Using the Beyondcorp Enterprise
129
- APIs, enterprises can set up multi-cloud and on-prem connectivity using the App
130
- Connector hybrid connectivity solution.
126
+ summary: Chrome Enterprise Premium is a secure enterprise browsing solution that provides
127
+ secure access to applications and resources, and offers integrated threat and data
128
+ protection. It adds an extra layer of security to safeguard your Chrome browser
129
+ environment, including Data Loss Prevention (DLP), real-time URL and file scanning,
130
+ and Context-Aware Access for SaaS and web apps.
131
131
  test_files: []
@@ -1,229 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2022 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
-
20
- module Google
21
- module Protobuf
22
- # `FieldMask` represents a set of symbolic field paths, for example:
23
- #
24
- # paths: "f.a"
25
- # paths: "f.b.d"
26
- #
27
- # Here `f` represents a field in some root message, `a` and `b`
28
- # fields in the message found in `f`, and `d` a field found in the
29
- # message in `f.b`.
30
- #
31
- # Field masks are used to specify a subset of fields that should be
32
- # returned by a get operation or modified by an update operation.
33
- # Field masks also have a custom JSON encoding (see below).
34
- #
35
- # # Field Masks in Projections
36
- #
37
- # When used in the context of a projection, a response message or
38
- # sub-message is filtered by the API to only contain those fields as
39
- # specified in the mask. For example, if the mask in the previous
40
- # example is applied to a response message as follows:
41
- #
42
- # f {
43
- # a : 22
44
- # b {
45
- # d : 1
46
- # x : 2
47
- # }
48
- # y : 13
49
- # }
50
- # z: 8
51
- #
52
- # The result will not contain specific values for fields x,y and z
53
- # (their value will be set to the default, and omitted in proto text
54
- # output):
55
- #
56
- #
57
- # f {
58
- # a : 22
59
- # b {
60
- # d : 1
61
- # }
62
- # }
63
- #
64
- # A repeated field is not allowed except at the last position of a
65
- # paths string.
66
- #
67
- # If a FieldMask object is not present in a get operation, the
68
- # operation applies to all fields (as if a FieldMask of all fields
69
- # had been specified).
70
- #
71
- # Note that a field mask does not necessarily apply to the
72
- # top-level response message. In case of a REST get operation, the
73
- # field mask applies directly to the response, but in case of a REST
74
- # list operation, the mask instead applies to each individual message
75
- # in the returned resource list. In case of a REST custom method,
76
- # other definitions may be used. Where the mask applies will be
77
- # clearly documented together with its declaration in the API. In
78
- # any case, the effect on the returned resource/resources is required
79
- # behavior for APIs.
80
- #
81
- # # Field Masks in Update Operations
82
- #
83
- # A field mask in update operations specifies which fields of the
84
- # targeted resource are going to be updated. The API is required
85
- # to only change the values of the fields as specified in the mask
86
- # and leave the others untouched. If a resource is passed in to
87
- # describe the updated values, the API ignores the values of all
88
- # fields not covered by the mask.
89
- #
90
- # If a repeated field is specified for an update operation, new values will
91
- # be appended to the existing repeated field in the target resource. Note that
92
- # a repeated field is only allowed in the last position of a `paths` string.
93
- #
94
- # If a sub-message is specified in the last position of the field mask for an
95
- # update operation, then new value will be merged into the existing sub-message
96
- # in the target resource.
97
- #
98
- # For example, given the target message:
99
- #
100
- # f {
101
- # b {
102
- # d: 1
103
- # x: 2
104
- # }
105
- # c: [1]
106
- # }
107
- #
108
- # And an update message:
109
- #
110
- # f {
111
- # b {
112
- # d: 10
113
- # }
114
- # c: [2]
115
- # }
116
- #
117
- # then if the field mask is:
118
- #
119
- # paths: ["f.b", "f.c"]
120
- #
121
- # then the result will be:
122
- #
123
- # f {
124
- # b {
125
- # d: 10
126
- # x: 2
127
- # }
128
- # c: [1, 2]
129
- # }
130
- #
131
- # An implementation may provide options to override this default behavior for
132
- # repeated and message fields.
133
- #
134
- # In order to reset a field's value to the default, the field must
135
- # be in the mask and set to the default value in the provided resource.
136
- # Hence, in order to reset all fields of a resource, provide a default
137
- # instance of the resource and set all fields in the mask, or do
138
- # not provide a mask as described below.
139
- #
140
- # If a field mask is not present on update, the operation applies to
141
- # all fields (as if a field mask of all fields has been specified).
142
- # Note that in the presence of schema evolution, this may mean that
143
- # fields the client does not know and has therefore not filled into
144
- # the request will be reset to their default. If this is unwanted
145
- # behavior, a specific service may require a client to always specify
146
- # a field mask, producing an error if not.
147
- #
148
- # As with get operations, the location of the resource which
149
- # describes the updated values in the request message depends on the
150
- # operation kind. In any case, the effect of the field mask is
151
- # required to be honored by the API.
152
- #
153
- # ## Considerations for HTTP REST
154
- #
155
- # The HTTP kind of an update operation which uses a field mask must
156
- # be set to PATCH instead of PUT in order to satisfy HTTP semantics
157
- # (PUT must only be used for full updates).
158
- #
159
- # # JSON Encoding of Field Masks
160
- #
161
- # In JSON, a field mask is encoded as a single string where paths are
162
- # separated by a comma. Fields name in each path are converted
163
- # to/from lower-camel naming conventions.
164
- #
165
- # As an example, consider the following message declarations:
166
- #
167
- # message Profile {
168
- # User user = 1;
169
- # Photo photo = 2;
170
- # }
171
- # message User {
172
- # string display_name = 1;
173
- # string address = 2;
174
- # }
175
- #
176
- # In proto a field mask for `Profile` may look as such:
177
- #
178
- # mask {
179
- # paths: "user.display_name"
180
- # paths: "photo"
181
- # }
182
- #
183
- # In JSON, the same mask is represented as below:
184
- #
185
- # {
186
- # mask: "user.displayName,photo"
187
- # }
188
- #
189
- # # Field Masks and Oneof Fields
190
- #
191
- # Field masks treat fields in oneofs just as regular fields. Consider the
192
- # following message:
193
- #
194
- # message SampleMessage {
195
- # oneof test_oneof {
196
- # string name = 4;
197
- # SubMessage sub_message = 9;
198
- # }
199
- # }
200
- #
201
- # The field mask can be:
202
- #
203
- # mask {
204
- # paths: "name"
205
- # }
206
- #
207
- # Or:
208
- #
209
- # mask {
210
- # paths: "sub_message"
211
- # }
212
- #
213
- # Note that oneof type names ("test_oneof" in this case) cannot be used in
214
- # paths.
215
- #
216
- # ## Field Mask Verification
217
- #
218
- # The implementation of any API method which has a FieldMask type field in the
219
- # request should verify the included field paths, and return an
220
- # `INVALID_ARGUMENT` error if any path is unmappable.
221
- # @!attribute [rw] paths
222
- # @return [::Array<::String>]
223
- # The set of field mask paths.
224
- class FieldMask
225
- include ::Google::Protobuf::MessageExts
226
- extend ::Google::Protobuf::MessageExts::ClassMethods
227
- end
228
- end
229
- end
@@ -1,75 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright 2022 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
-
20
- module Google
21
- module Type
22
- # Represents a textual expression in the Common Expression Language (CEL)
23
- # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
24
- # are documented at https://github.com/google/cel-spec.
25
- #
26
- # Example (Comparison):
27
- #
28
- # title: "Summary size limit"
29
- # description: "Determines if a summary is less than 100 chars"
30
- # expression: "document.summary.size() < 100"
31
- #
32
- # Example (Equality):
33
- #
34
- # title: "Requestor is owner"
35
- # description: "Determines if requestor is the document owner"
36
- # expression: "document.owner == request.auth.claims.email"
37
- #
38
- # Example (Logic):
39
- #
40
- # title: "Public documents"
41
- # description: "Determine whether the document should be publicly visible"
42
- # expression: "document.type != 'private' && document.type != 'internal'"
43
- #
44
- # Example (Data Manipulation):
45
- #
46
- # title: "Notification string"
47
- # description: "Create a notification string with a timestamp."
48
- # expression: "'New message received at ' + string(document.create_time)"
49
- #
50
- # The exact variables and functions that may be referenced within an expression
51
- # are determined by the service that evaluates it. See the service
52
- # documentation for additional information.
53
- # @!attribute [rw] expression
54
- # @return [::String]
55
- # Textual representation of an expression in Common Expression Language
56
- # syntax.
57
- # @!attribute [rw] title
58
- # @return [::String]
59
- # Optional. Title for the expression, i.e. a short string describing
60
- # its purpose. This can be used e.g. in UIs which allow to enter the
61
- # expression.
62
- # @!attribute [rw] description
63
- # @return [::String]
64
- # Optional. Description of the expression. This is a longer text which
65
- # describes the expression, e.g. when hovered over it in a UI.
66
- # @!attribute [rw] location
67
- # @return [::String]
68
- # Optional. String indicating the location of the expression for error
69
- # reporting, e.g. a file name and a position in the file.
70
- class Expr
71
- include ::Google::Protobuf::MessageExts
72
- extend ::Google::Protobuf::MessageExts::ClassMethods
73
- end
74
- end
75
- end