google-cloud-datastore-admin-v1 0.8.0 → 0.9.1

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 (20) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/datastore/admin/v1/datastore_admin/client.rb +35 -45
  4. data/lib/google/cloud/datastore/admin/v1/datastore_admin/operations.rb +5 -3
  5. data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest/client.rb +35 -45
  6. data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest/operations.rb +9 -7
  7. data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest/service_stub.rb +6 -6
  8. data/lib/google/cloud/datastore/admin/v1/datastore_admin/rest.rb +19 -33
  9. data/lib/google/cloud/datastore/admin/v1/datastore_admin.rb +19 -33
  10. data/lib/google/cloud/datastore/admin/v1/version.rb +1 -1
  11. data/lib/google/datastore/admin/v1/datastore_admin_pb.rb +26 -93
  12. data/lib/google/datastore/admin/v1/datastore_admin_services_pb.rb +24 -37
  13. data/lib/google/datastore/admin/v1/index_pb.rb +24 -30
  14. data/lib/google/datastore/admin/v1/migration_pb.rb +24 -39
  15. data/proto_docs/google/api/client.rb +67 -4
  16. data/proto_docs/google/datastore/admin/v1/datastore_admin.rb +10 -6
  17. data/proto_docs/google/datastore/admin/v1/index.rb +8 -2
  18. data/proto_docs/google/protobuf/any.rb +7 -4
  19. data/proto_docs/google/protobuf/timestamp.rb +1 -3
  20. metadata +4 -4
data/lib/google/cloud/datastore/admin/v1/datastore_admin.rb CHANGED
@@ -35,14 +35,10 @@ module Google
35
35
  ##
36
36
  # Google Cloud Datastore Admin API
37
37
  #
38
- #
39
38
  # The Datastore Admin API provides several admin services for Cloud Datastore.
40
39
  #
41
- # -----------------------------------------------------------------------------
42
- # ## Concepts
43
- #
44
- # Project, namespace, kind, and entity as defined in the Google Cloud Datastore
45
- # API.
40
+ # Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
41
+ # Datastore API.
46
42
  #
47
43
  # Operation: An Operation represents work being performed in the background.
48
44
  #
@@ -50,50 +46,40 @@ module Google
50
46
  # specified as a combination of kinds and namespaces (either or both of which
51
47
  # may be all).
52
48
  #
53
- # -----------------------------------------------------------------------------
54
- # ## Services
55
- #
56
- # # Export/Import
49
+ # Export/Import Service:
57
50
  #
58
- # The Export/Import service provides the ability to copy all or a subset of
51
+ # - The Export/Import service provides the ability to copy all or a subset of
59
52
  # entities to/from Google Cloud Storage.
60
- #
61
- # Exported data may be imported into Cloud Datastore for any Google Cloud
53
+ # - Exported data may be imported into Cloud Datastore for any Google Cloud
62
54
  # Platform project. It is not restricted to the export source project. It is
63
55
  # possible to export from one project and then import into another.
64
- #
65
- # Exported data can also be loaded into Google BigQuery for analysis.
66
- #
67
- # Exports and imports are performed asynchronously. An Operation resource is
56
+ # - Exported data can also be loaded into Google BigQuery for analysis.
57
+ # - Exports and imports are performed asynchronously. An Operation resource is
68
58
  # created for each export/import. The state (including any errors encountered)
69
59
  # of the export/import may be queried via the Operation resource.
70
60
  #
71
- # # Index
61
+ # Index Service:
72
62
  #
73
- # The index service manages Cloud Datastore composite indexes.
74
- #
75
- # Index creation and deletion are performed asynchronously.
63
+ # - The index service manages Cloud Datastore composite indexes.
64
+ # - Index creation and deletion are performed asynchronously.
76
65
  # An Operation resource is created for each such asynchronous operation.
77
66
  # The state of the operation (including any errors encountered)
78
67
  # may be queried via the Operation resource.
79
68
  #
80
- # # Operation
69
+ # Operation Service:
81
70
  #
82
- # The Operations collection provides a record of actions performed for the
71
+ # - The Operations collection provides a record of actions performed for the
83
72
  # specified project (including any operations in progress). Operations are not
84
73
  # created directly but through calls on other collections or resources.
85
- #
86
- # An operation that is not yet done may be cancelled. The request to cancel is
87
- # asynchronous and the operation may continue to run for some time after the
74
+ # - An operation that is not yet done may be cancelled. The request to cancel
75
+ # is asynchronous and the operation may continue to run for some time after the
88
76
  # request to cancel is made.
89
- #
90
- # An operation that is done may be deleted so that it is no longer listed as
77
+ # - An operation that is done may be deleted so that it is no longer listed as
91
78
  # part of the Operation collection.
92
- #
93
- # ListOperations returns all pending operations, but not completed operations.
94
- #
95
- # Operations are created by service DatastoreAdmin,
96
- # but are accessed via service google.longrunning.Operations.
79
+ # - ListOperations returns all pending operations, but not completed
80
+ # operations.
81
+ # - Operations are created by service DatastoreAdmin, but are accessed via
82
+ # service google.longrunning.Operations.
97
83
  #
98
84
  # @example Load this service and instantiate a gRPC client
99
85
  #
data/lib/google/cloud/datastore/admin/v1/version.rb CHANGED
@@ -22,7 +22,7 @@ module Google
22
22
  module Datastore
23
23
  module Admin
24
24
  module V1
25
- VERSION = "0.8.0"
25
+ VERSION = "0.9.1"
26
26
  end
27
27
  end
28
28
  end
data/lib/google/datastore/admin/v1/datastore_admin_pb.rb CHANGED
@@ -1,3 +1,4 @@
1
+ # frozen_string_literal: true
1
2
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
3
  # source: google/datastore/admin/v1/datastore_admin.proto
3
4
 
@@ -11,101 +12,33 @@ require 'google/datastore/admin/v1/migration_pb'
11
12
  require 'google/longrunning/operations_pb'
12
13
  require 'google/protobuf/timestamp_pb'
13
14
 
14
- Google::Protobuf::DescriptorPool.generated_pool.build do
15
- add_file("google/datastore/admin/v1/datastore_admin.proto", :syntax => :proto3) do
16
- add_message "google.datastore.admin.v1.CommonMetadata" do
17
- optional :start_time, :message, 1, "google.protobuf.Timestamp"
18
- optional :end_time, :message, 2, "google.protobuf.Timestamp"
19
- optional :operation_type, :enum, 3, "google.datastore.admin.v1.OperationType"
20
- map :labels, :string, :string, 4
21
- optional :state, :enum, 5, "google.datastore.admin.v1.CommonMetadata.State"
22
- end
23
- add_enum "google.datastore.admin.v1.CommonMetadata.State" do
24
- value :STATE_UNSPECIFIED, 0
25
- value :INITIALIZING, 1
26
- value :PROCESSING, 2
27
- value :CANCELLING, 3
28
- value :FINALIZING, 4
29
- value :SUCCESSFUL, 5
30
- value :FAILED, 6
31
- value :CANCELLED, 7
32
- end
33
- add_message "google.datastore.admin.v1.Progress" do
34
- optional :work_completed, :int64, 1
35
- optional :work_estimated, :int64, 2
36
- end
37
- add_message "google.datastore.admin.v1.ExportEntitiesRequest" do
38
- optional :project_id, :string, 1
39
- map :labels, :string, :string, 2
40
- optional :entity_filter, :message, 3, "google.datastore.admin.v1.EntityFilter"
41
- optional :output_url_prefix, :string, 4
42
- end
43
- add_message "google.datastore.admin.v1.ImportEntitiesRequest" do
44
- optional :project_id, :string, 1
45
- map :labels, :string, :string, 2
46
- optional :input_url, :string, 3
47
- optional :entity_filter, :message, 4, "google.datastore.admin.v1.EntityFilter"
48
- end
49
- add_message "google.datastore.admin.v1.ExportEntitiesResponse" do
50
- optional :output_url, :string, 1
51
- end
52
- add_message "google.datastore.admin.v1.ExportEntitiesMetadata" do
53
- optional :common, :message, 1, "google.datastore.admin.v1.CommonMetadata"
54
- optional :progress_entities, :message, 2, "google.datastore.admin.v1.Progress"
55
- optional :progress_bytes, :message, 3, "google.datastore.admin.v1.Progress"
56
- optional :entity_filter, :message, 4, "google.datastore.admin.v1.EntityFilter"
57
- optional :output_url_prefix, :string, 5
58
- end
59
- add_message "google.datastore.admin.v1.ImportEntitiesMetadata" do
60
- optional :common, :message, 1, "google.datastore.admin.v1.CommonMetadata"
61
- optional :progress_entities, :message, 2, "google.datastore.admin.v1.Progress"
62
- optional :progress_bytes, :message, 3, "google.datastore.admin.v1.Progress"
63
- optional :entity_filter, :message, 4, "google.datastore.admin.v1.EntityFilter"
64
- optional :input_url, :string, 5
65
- end
66
- add_message "google.datastore.admin.v1.EntityFilter" do
67
- repeated :kinds, :string, 1
68
- repeated :namespace_ids, :string, 2
69
- end
70
- add_message "google.datastore.admin.v1.CreateIndexRequest" do
71
- optional :project_id, :string, 1
72
- optional :index, :message, 3, "google.datastore.admin.v1.Index"
73
- end
74
- add_message "google.datastore.admin.v1.DeleteIndexRequest" do
75
- optional :project_id, :string, 1
76
- optional :index_id, :string, 3
77
- end
78
- add_message "google.datastore.admin.v1.GetIndexRequest" do
79
- optional :project_id, :string, 1
80
- optional :index_id, :string, 3
81
- end
82
- add_message "google.datastore.admin.v1.ListIndexesRequest" do
83
- optional :project_id, :string, 1
84
- optional :filter, :string, 3
85
- optional :page_size, :int32, 4
86
- optional :page_token, :string, 5
87
- end
88
- add_message "google.datastore.admin.v1.ListIndexesResponse" do
89
- repeated :indexes, :message, 1, "google.datastore.admin.v1.Index"
90
- optional :next_page_token, :string, 2
91
- end
92
- add_message "google.datastore.admin.v1.IndexOperationMetadata" do
93
- optional :common, :message, 1, "google.datastore.admin.v1.CommonMetadata"
94
- optional :progress_entities, :message, 2, "google.datastore.admin.v1.Progress"
95
- optional :index_id, :string, 3
96
- end
97
- add_message "google.datastore.admin.v1.DatastoreFirestoreMigrationMetadata" do
98
- optional :migration_state, :enum, 1, "google.datastore.admin.v1.MigrationState"
99
- optional :migration_step, :enum, 2, "google.datastore.admin.v1.MigrationStep"
100
- end
101
- add_enum "google.datastore.admin.v1.OperationType" do
102
- value :OPERATION_TYPE_UNSPECIFIED, 0
103
- value :EXPORT_ENTITIES, 1
104
- value :IMPORT_ENTITIES, 2
105
- value :CREATE_INDEX, 3
106
- value :DELETE_INDEX, 4
15
+
16
+ descriptor_data = "\n/google/datastore/admin/v1/datastore_admin.proto\x12\x19google.datastore.admin.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a%google/datastore/admin/v1/index.proto\x1a)google/datastore/admin/v1/migration.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xf4\x03\n\x0e\x43ommonMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12@\n\x0eoperation_type\x18\x03 \x01(\x0e\x32(.google.datastore.admin.v1.OperationType\x12\x45\n\x06labels\x18\x04 \x03(\x0b\x32\x35.google.datastore.admin.v1.CommonMetadata.LabelsEntry\x12>\n\x05state\x18\x05 \x01(\x0e\x32/.google.datastore.admin.v1.CommonMetadata.State\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x8b\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x10\n\x0cINITIALIZING\x10\x01\x12\x0e\n\nPROCESSING\x10\x02\x12\x0e\n\nCANCELLING\x10\x03\x12\x0e\n\nFINALIZING\x10\x04\x12\x0e\n\nSUCCESSFUL\x10\x05\x12\n\n\x06\x46\x41ILED\x10\x06\x12\r\n\tCANCELLED\x10\x07\":\n\x08Progress\x12\x16\n\x0ework_completed\x18\x01 \x01(\x03\x12\x16\n\x0ework_estimated\x18\x02 \x01(\x03\"\x8d\x02\n\x15\x45xportEntitiesRequest\x12\x17\n\nproject_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12L\n\x06labels\x18\x02 \x03(\x0b\x32<.google.datastore.admin.v1.ExportEntitiesRequest.LabelsEntry\x12>\n\rentity_filter\x18\x03 \x01(\x0b\x32\'.google.datastore.admin.v1.EntityFilter\x12\x1e\n\x11output_url_prefix\x18\x04 \x01(\tB\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\"\x85\x02\n\x15ImportEntitiesRequest\x12\x17\n\nproject_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12L\n\x06labels\x18\x02 \x03(\x0b\x32<.google.datastore.admin.v1.ImportEntitiesRequest.LabelsEntry\x12\x16\n\tinput_url\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12>\n\rentity_filter\x18\x04 \x01(\x0b\x32\'.google.datastore.admin.v1.EntityFilter\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\",\n\x16\x45xportEntitiesResponse\x12\x12\n\noutput_url\x18\x01 \x01(\t\"\xab\x02\n\x16\x45xportEntitiesMetadata\x12\x39\n\x06\x63ommon\x18\x01 \x01(\x0b\x32).google.datastore.admin.v1.CommonMetadata\x12>\n\x11progress_entities\x18\x02 \x01(\x0b\x32#.google.datastore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x03 \x01(\x0b\x32#.google.datastore.admin.v1.Progress\x12>\n\rentity_filter\x18\x04 \x01(\x0b\x32\'.google.datastore.admin.v1.EntityFilter\x12\x19\n\x11output_url_prefix\x18\x05 \x01(\t\"\xa3\x02\n\x16ImportEntitiesMetadata\x12\x39\n\x06\x63ommon\x18\x01 \x01(\x0b\x32).google.datastore.admin.v1.CommonMetadata\x12>\n\x11progress_entities\x18\x02 \x01(\x0b\x32#.google.datastore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x03 \x01(\x0b\x32#.google.datastore.admin.v1.Progress\x12>\n\rentity_filter\x18\x04 \x01(\x0b\x32\'.google.datastore.admin.v1.EntityFilter\x12\x11\n\tinput_url\x18\x05 \x01(\t\"4\n\x0c\x45ntityFilter\x12\r\n\x05kinds\x18\x01 \x03(\t\x12\x15\n\rnamespace_ids\x18\x02 \x03(\t\"Y\n\x12\x43reateIndexRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12/\n\x05index\x18\x03 \x01(\x0b\x32 .google.datastore.admin.v1.Index\":\n\x12\x44\x65leteIndexRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x10\n\x08index_id\x18\x03 \x01(\t\"7\n\x0fGetIndexRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x10\n\x08index_id\x18\x03 \x01(\t\"_\n\x12ListIndexesRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t\"a\n\x13ListIndexesResponse\x12\x31\n\x07indexes\x18\x01 \x03(\x0b\x32 .google.datastore.admin.v1.Index\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\xa5\x01\n\x16IndexOperationMetadata\x12\x39\n\x06\x63ommon\x18\x01 \x01(\x0b\x32).google.datastore.admin.v1.CommonMetadata\x12>\n\x11progress_entities\x18\x02 \x01(\x0b\x32#.google.datastore.admin.v1.Progress\x12\x10\n\x08index_id\x18\x03 \x01(\t\"\xab\x01\n#DatastoreFirestoreMigrationMetadata\x12\x42\n\x0fmigration_state\x18\x01 \x01(\x0e\x32).google.datastore.admin.v1.MigrationState\x12@\n\x0emigration_step\x18\x02 \x01(\x0e\x32(.google.datastore.admin.v1.MigrationStep*}\n\rOperationType\x12\x1e\n\x1aOPERATION_TYPE_UNSPECIFIED\x10\x00\x12\x13\n\x0f\x45XPORT_ENTITIES\x10\x01\x12\x13\n\x0fIMPORT_ENTITIES\x10\x02\x12\x10\n\x0c\x43REATE_INDEX\x10\x03\x12\x10\n\x0c\x44\x45LETE_INDEX\x10\x04\x32\x84\n\n\x0e\x44\x61tastoreAdmin\x12\xf6\x01\n\x0e\x45xportEntities\x12\x30.google.datastore.admin.v1.ExportEntitiesRequest\x1a\x1d.google.longrunning.Operation\"\x92\x01\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:export:\x01*\xda\x41\x31project_id,labels,entity_filter,output_url_prefix\xca\x41\x30\n\x16\x45xportEntitiesResponse\x12\x16\x45xportEntitiesMetadata\x12\xed\x01\n\x0eImportEntities\x12\x30.google.datastore.admin.v1.ImportEntitiesRequest\x1a\x1d.google.longrunning.Operation\"\x89\x01\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:import:\x01*\xda\x41)project_id,labels,input_url,entity_filter\xca\x41/\n\x15google.protobuf.Empty\x12\x16ImportEntitiesMetadata\x12\xaf\x01\n\x0b\x43reateIndex\x12-.google.datastore.admin.v1.CreateIndexRequest\x1a\x1d.google.longrunning.Operation\"R\x82\xd3\xe4\x93\x02*\"!/v1/projects/{project_id}/indexes:\x05index\xca\x41\x1f\n\x05Index\x12\x16IndexOperationMetadata\x12\xb3\x01\n\x0b\x44\x65leteIndex\x12-.google.datastore.admin.v1.DeleteIndexRequest\x1a\x1d.google.longrunning.Operation\"V\x82\xd3\xe4\x93\x02.*,/v1/projects/{project_id}/indexes/{index_id}\xca\x41\x1f\n\x05Index\x12\x16IndexOperationMetadata\x12\x8e\x01\n\x08GetIndex\x12*.google.datastore.admin.v1.GetIndexRequest\x1a .google.datastore.admin.v1.Index\"4\x82\xd3\xe4\x93\x02.\x12,/v1/projects/{project_id}/indexes/{index_id}\x12\x97\x01\n\x0bListIndexes\x12-.google.datastore.admin.v1.ListIndexesRequest\x1a..google.datastore.admin.v1.ListIndexesResponse\")\x82\xd3\xe4\x93\x02#\x12!/v1/projects/{project_id}/indexes\x1av\xca\x41\x18\x64\x61tastore.googleapis.com\xd2\x41Xhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/datastoreB\xdb\x01\n\x1d\x63om.google.datastore.admin.v1B\x13\x44\x61tastoreAdminProtoP\x01Z9cloud.google.com/go/datastore/admin/apiv1/adminpb;adminpb\xaa\x02\x1fGoogle.Cloud.Datastore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Datastore\\Admin\\V1\xea\x02#Google::Cloud::Datastore::Admin::V1b\x06proto3"
17
+
18
+ pool = Google::Protobuf::DescriptorPool.generated_pool
19
+
20
+ begin
21
+ pool.add_serialized_file(descriptor_data)
22
+ rescue TypeError => e
23
+ # Compatibility code: will be removed in the next major version.
24
+ require 'google/protobuf/descriptor_pb'
25
+ parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
26
+ parsed.clear_dependency
27
+ serialized = parsed.class.encode(parsed)
28
+ file = pool.add_serialized_file(serialized)
29
+ warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
30
+ imports = [
31
+ ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
32
+ ["google.datastore.admin.v1.Index", "google/datastore/admin/v1/index.proto"],
33
+ ]
34
+ imports.each do |type_name, expected_filename|
35
+ import_file = pool.lookup(type_name).file_descriptor
36
+ if import_file.name != expected_filename
37
+ warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
107
38
  end
108
39
  end
40
+ warn "Each proto file must use a consistent fully-qualified name."
41
+ warn "This will become an error in the next major version."
109
42
  end
110
43
 
111
44
  module Google
data/lib/google/datastore/admin/v1/datastore_admin_services_pb.rb CHANGED
@@ -27,14 +27,10 @@ module Google
27
27
  module DatastoreAdmin
28
28
  # Google Cloud Datastore Admin API
29
29
  #
30
- #
31
30
  # The Datastore Admin API provides several admin services for Cloud Datastore.
32
31
  #
33
- # -----------------------------------------------------------------------------
34
- # ## Concepts
35
- #
36
- # Project, namespace, kind, and entity as defined in the Google Cloud Datastore
37
- # API.
32
+ # Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
33
+ # Datastore API.
38
34
  #
39
35
  # Operation: An Operation represents work being performed in the background.
40
36
  #
@@ -42,50 +38,40 @@ module Google
42
38
  # specified as a combination of kinds and namespaces (either or both of which
43
39
  # may be all).
44
40
  #
45
- # -----------------------------------------------------------------------------
46
- # ## Services
47
- #
48
- # # Export/Import
41
+ # Export/Import Service:
49
42
  #
50
- # The Export/Import service provides the ability to copy all or a subset of
43
+ # - The Export/Import service provides the ability to copy all or a subset of
51
44
  # entities to/from Google Cloud Storage.
52
- #
53
- # Exported data may be imported into Cloud Datastore for any Google Cloud
45
+ # - Exported data may be imported into Cloud Datastore for any Google Cloud
54
46
  # Platform project. It is not restricted to the export source project. It is
55
47
  # possible to export from one project and then import into another.
56
- #
57
- # Exported data can also be loaded into Google BigQuery for analysis.
58
- #
59
- # Exports and imports are performed asynchronously. An Operation resource is
48
+ # - Exported data can also be loaded into Google BigQuery for analysis.
49
+ # - Exports and imports are performed asynchronously. An Operation resource is
60
50
  # created for each export/import. The state (including any errors encountered)
61
51
  # of the export/import may be queried via the Operation resource.
62
52
  #
63
- # # Index
53
+ # Index Service:
64
54
  #
65
- # The index service manages Cloud Datastore composite indexes.
66
- #
67
- # Index creation and deletion are performed asynchronously.
55
+ # - The index service manages Cloud Datastore composite indexes.
56
+ # - Index creation and deletion are performed asynchronously.
68
57
  # An Operation resource is created for each such asynchronous operation.
69
58
  # The state of the operation (including any errors encountered)
70
59
  # may be queried via the Operation resource.
71
60
  #
72
- # # Operation
61
+ # Operation Service:
73
62
  #
74
- # The Operations collection provides a record of actions performed for the
63
+ # - The Operations collection provides a record of actions performed for the
75
64
  # specified project (including any operations in progress). Operations are not
76
65
  # created directly but through calls on other collections or resources.
77
- #
78
- # An operation that is not yet done may be cancelled. The request to cancel is
79
- # asynchronous and the operation may continue to run for some time after the
66
+ # - An operation that is not yet done may be cancelled. The request to cancel
67
+ # is asynchronous and the operation may continue to run for some time after the
80
68
  # request to cancel is made.
81
- #
82
- # An operation that is done may be deleted so that it is no longer listed as
69
+ # - An operation that is done may be deleted so that it is no longer listed as
83
70
  # part of the Operation collection.
84
- #
85
- # ListOperations returns all pending operations, but not completed operations.
86
- #
87
- # Operations are created by service DatastoreAdmin,
88
- # but are accessed via service google.longrunning.Operations.
71
+ # - ListOperations returns all pending operations, but not completed
72
+ # operations.
73
+ # - Operations are created by service DatastoreAdmin, but are accessed via
74
+ # service google.longrunning.Operations.
89
75
  class Service
90
76
 
91
77
  include ::GRPC::GenericService
@@ -111,9 +97,9 @@ module Google
111
97
  rpc :ImportEntities, ::Google::Cloud::Datastore::Admin::V1::ImportEntitiesRequest, ::Google::Longrunning::Operation
112
98
  # Creates the specified index.
113
99
  # A newly created index's initial state is `CREATING`. On completion of the
114
- # returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`.
115
- # If the index already exists, the call will return an `ALREADY_EXISTS`
116
- # status.
100
+ # returned [google.longrunning.Operation][google.longrunning.Operation], the
101
+ # state will be `READY`. If the index already exists, the call will return an
102
+ # `ALREADY_EXISTS` status.
117
103
  #
118
104
  # During index creation, the process could result in an error, in which
119
105
  # case the index will move to the `ERROR` state. The process can be recovered
@@ -128,7 +114,8 @@ module Google
128
114
  # An index can only be deleted if it is in a `READY` or `ERROR` state. On
129
115
  # successful execution of the request, the index will be in a `DELETING`
130
116
  # [state][google.datastore.admin.v1.Index.State]. And on completion of the
131
- # returned [google.longrunning.Operation][google.longrunning.Operation], the index will be removed.
117
+ # returned [google.longrunning.Operation][google.longrunning.Operation], the
118
+ # index will be removed.
132
119
  #
133
120
  # During index deletion, the process could result in an error, in which
134
121
  # case the index will move to the `ERROR` state. The process can be recovered
data/lib/google/datastore/admin/v1/index_pb.rb CHANGED
@@ -1,3 +1,4 @@
1
+ # frozen_string_literal: true
1
2
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
3
  # source: google/datastore/admin/v1/index.proto
3
4
 
@@ -5,38 +6,31 @@ require 'google/protobuf'
5
6
 
6
7
  require 'google/api/field_behavior_pb'
7
8
 
8
- Google::Protobuf::DescriptorPool.generated_pool.build do
9
- add_file("google/datastore/admin/v1/index.proto", :syntax => :proto3) do
10
- add_message "google.datastore.admin.v1.Index" do
11
- optional :project_id, :string, 1
12
- optional :index_id, :string, 3
13
- optional :kind, :string, 4
14
- optional :ancestor, :enum, 5, "google.datastore.admin.v1.Index.AncestorMode"
15
- repeated :properties, :message, 6, "google.datastore.admin.v1.Index.IndexedProperty"
16
- optional :state, :enum, 7, "google.datastore.admin.v1.Index.State"
17
- end
18
- add_message "google.datastore.admin.v1.Index.IndexedProperty" do
19
- optional :name, :string, 1
20
- optional :direction, :enum, 2, "google.datastore.admin.v1.Index.Direction"
21
- end
22
- add_enum "google.datastore.admin.v1.Index.AncestorMode" do
23
- value :ANCESTOR_MODE_UNSPECIFIED, 0
24
- value :NONE, 1
25
- value :ALL_ANCESTORS, 2
26
- end
27
- add_enum "google.datastore.admin.v1.Index.Direction" do
28
- value :DIRECTION_UNSPECIFIED, 0
29
- value :ASCENDING, 1
30
- value :DESCENDING, 2
31
- end
32
- add_enum "google.datastore.admin.v1.Index.State" do
33
- value :STATE_UNSPECIFIED, 0
34
- value :CREATING, 1
35
- value :READY, 2
36
- value :DELETING, 3
37
- value :ERROR, 4
9
+
10
+ descriptor_data = "\n%google/datastore/admin/v1/index.proto\x12\x19google.datastore.admin.v1\x1a\x1fgoogle/api/field_behavior.proto\"\xe6\x04\n\x05Index\x12\x17\n\nproject_id\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x15\n\x08index_id\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12\x11\n\x04kind\x18\x04 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\x08\x61ncestor\x18\x05 \x01(\x0e\x32-.google.datastore.admin.v1.Index.AncestorModeB\x03\xe0\x41\x02\x12I\n\nproperties\x18\x06 \x03(\x0b\x32\x30.google.datastore.admin.v1.Index.IndexedPropertyB\x03\xe0\x41\x02\x12:\n\x05state\x18\x07 \x01(\x0e\x32&.google.datastore.admin.v1.Index.StateB\x03\xe0\x41\x03\x1ah\n\x0fIndexedProperty\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x42\n\tdirection\x18\x02 \x01(\x0e\x32*.google.datastore.admin.v1.Index.DirectionB\x03\xe0\x41\x02\"J\n\x0c\x41ncestorMode\x12\x1d\n\x19\x41NCESTOR_MODE_UNSPECIFIED\x10\x00\x12\x08\n\x04NONE\x10\x01\x12\x11\n\rALL_ANCESTORS\x10\x02\"E\n\tDirection\x12\x19\n\x15\x44IRECTION_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02\"P\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x0c\n\x08\x44\x45LETING\x10\x03\x12\t\n\x05\x45RROR\x10\x04\x42\xd2\x01\n\x1d\x63om.google.datastore.admin.v1B\nIndexProtoP\x01Z9cloud.google.com/go/datastore/admin/apiv1/adminpb;adminpb\xaa\x02\x1fGoogle.Cloud.Datastore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Datastore\\Admin\\V1\xea\x02#Google::Cloud::Datastore::Admin::V1b\x06proto3"
11
+
12
+ pool = Google::Protobuf::DescriptorPool.generated_pool
13
+
14
+ begin
15
+ pool.add_serialized_file(descriptor_data)
16
+ rescue TypeError => e
17
+ # Compatibility code: will be removed in the next major version.
18
+ require 'google/protobuf/descriptor_pb'
19
+ parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
20
+ parsed.clear_dependency
21
+ serialized = parsed.class.encode(parsed)
22
+ file = pool.add_serialized_file(serialized)
23
+ warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
24
+ imports = [
25
+ ]
26
+ imports.each do |type_name, expected_filename|
27
+ import_file = pool.lookup(type_name).file_descriptor
28
+ if import_file.name != expected_filename
29
+ warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
38
30
  end
39
31
  end
32
+ warn "Each proto file must use a consistent fully-qualified name."
33
+ warn "This will become an error in the next major version."
40
34
  end
41
35
 
42
36
  module Google
data/lib/google/datastore/admin/v1/migration_pb.rb CHANGED
@@ -1,49 +1,34 @@
1
+ # frozen_string_literal: true
1
2
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
3
  # source: google/datastore/admin/v1/migration.proto
3
4
 
4
5
  require 'google/protobuf'
5
6
 
6
- Google::Protobuf::DescriptorPool.generated_pool.build do
7
- add_file("google/datastore/admin/v1/migration.proto", :syntax => :proto3) do
8
- add_message "google.datastore.admin.v1.MigrationStateEvent" do
9
- optional :state, :enum, 1, "google.datastore.admin.v1.MigrationState"
10
- end
11
- add_message "google.datastore.admin.v1.MigrationProgressEvent" do
12
- optional :step, :enum, 1, "google.datastore.admin.v1.MigrationStep"
13
- oneof :step_details do
14
- optional :prepare_step_details, :message, 2, "google.datastore.admin.v1.MigrationProgressEvent.PrepareStepDetails"
15
- optional :redirect_writes_step_details, :message, 3, "google.datastore.admin.v1.MigrationProgressEvent.RedirectWritesStepDetails"
16
- end
17
- end
18
- add_message "google.datastore.admin.v1.MigrationProgressEvent.PrepareStepDetails" do
19
- optional :concurrency_mode, :enum, 1, "google.datastore.admin.v1.MigrationProgressEvent.ConcurrencyMode"
20
- end
21
- add_message "google.datastore.admin.v1.MigrationProgressEvent.RedirectWritesStepDetails" do
22
- optional :concurrency_mode, :enum, 1, "google.datastore.admin.v1.MigrationProgressEvent.ConcurrencyMode"
23
- end
24
- add_enum "google.datastore.admin.v1.MigrationProgressEvent.ConcurrencyMode" do
25
- value :CONCURRENCY_MODE_UNSPECIFIED, 0
26
- value :PESSIMISTIC, 1
27
- value :OPTIMISTIC, 2
28
- value :OPTIMISTIC_WITH_ENTITY_GROUPS, 3
29
- end
30
- add_enum "google.datastore.admin.v1.MigrationState" do
31
- value :MIGRATION_STATE_UNSPECIFIED, 0
32
- value :RUNNING, 1
33
- value :PAUSED, 2
34
- value :COMPLETE, 3
35
- end
36
- add_enum "google.datastore.admin.v1.MigrationStep" do
37
- value :MIGRATION_STEP_UNSPECIFIED, 0
38
- value :PREPARE, 6
39
- value :START, 1
40
- value :APPLY_WRITES_SYNCHRONOUSLY, 7
41
- value :COPY_AND_VERIFY, 2
42
- value :REDIRECT_EVENTUALLY_CONSISTENT_READS, 3
43
- value :REDIRECT_STRONGLY_CONSISTENT_READS, 4
44
- value :REDIRECT_WRITES, 5
7
+
8
+ descriptor_data = "\n)google/datastore/admin/v1/migration.proto\x12\x19google.datastore.admin.v1\"O\n\x13MigrationStateEvent\x12\x38\n\x05state\x18\x01 \x01(\x0e\x32).google.datastore.admin.v1.MigrationState\"\xa1\x05\n\x16MigrationProgressEvent\x12\x36\n\x04step\x18\x01 \x01(\x0e\x32(.google.datastore.admin.v1.MigrationStep\x12\x64\n\x14prepare_step_details\x18\x02 \x01(\x0b\x32\x44.google.datastore.admin.v1.MigrationProgressEvent.PrepareStepDetailsH\x00\x12s\n\x1credirect_writes_step_details\x18\x03 \x01(\x0b\x32K.google.datastore.admin.v1.MigrationProgressEvent.RedirectWritesStepDetailsH\x00\x1aq\n\x12PrepareStepDetails\x12[\n\x10\x63oncurrency_mode\x18\x01 \x01(\x0e\x32\x41.google.datastore.admin.v1.MigrationProgressEvent.ConcurrencyMode\x1ax\n\x19RedirectWritesStepDetails\x12[\n\x10\x63oncurrency_mode\x18\x01 \x01(\x0e\x32\x41.google.datastore.admin.v1.MigrationProgressEvent.ConcurrencyMode\"w\n\x0f\x43oncurrencyMode\x12 \n\x1c\x43ONCURRENCY_MODE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bPESSIMISTIC\x10\x01\x12\x0e\n\nOPTIMISTIC\x10\x02\x12!\n\x1dOPTIMISTIC_WITH_ENTITY_GROUPS\x10\x03\x42\x0e\n\x0cstep_details*X\n\x0eMigrationState\x12\x1f\n\x1bMIGRATION_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x43OMPLETE\x10\x03*\xe3\x01\n\rMigrationStep\x12\x1e\n\x1aMIGRATION_STEP_UNSPECIFIED\x10\x00\x12\x0b\n\x07PREPARE\x10\x06\x12\t\n\x05START\x10\x01\x12\x1e\n\x1a\x41PPLY_WRITES_SYNCHRONOUSLY\x10\x07\x12\x13\n\x0f\x43OPY_AND_VERIFY\x10\x02\x12(\n$REDIRECT_EVENTUALLY_CONSISTENT_READS\x10\x03\x12&\n\"REDIRECT_STRONGLY_CONSISTENT_READS\x10\x04\x12\x13\n\x0fREDIRECT_WRITES\x10\x05\x42\xd6\x01\n\x1d\x63om.google.datastore.admin.v1B\x0eMigrationProtoP\x01Z9cloud.google.com/go/datastore/admin/apiv1/adminpb;adminpb\xaa\x02\x1fGoogle.Cloud.Datastore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Datastore\\Admin\\V1\xea\x02#Google::Cloud::Datastore::Admin::V1b\x06proto3"
9
+
10
+ pool = Google::Protobuf::DescriptorPool.generated_pool
11
+
12
+ begin
13
+ pool.add_serialized_file(descriptor_data)
14
+ rescue TypeError => e
15
+ # Compatibility code: will be removed in the next major version.
16
+ require 'google/protobuf/descriptor_pb'
17
+ parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
18
+ parsed.clear_dependency
19
+ serialized = parsed.class.encode(parsed)
20
+ file = pool.add_serialized_file(serialized)
21
+ warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
22
+ imports = [
23
+ ]
24
+ imports.each do |type_name, expected_filename|
25
+ import_file = pool.lookup(type_name).file_descriptor
26
+ if import_file.name != expected_filename
27
+ warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
45
28
  end
46
29
  end
30
+ warn "Each proto file must use a consistent fully-qualified name."
31
+ warn "This will become an error in the next major version."
47
32
  end
48
33
 
49
34
  module Google
data/proto_docs/google/api/client.rb CHANGED
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
81
83
  # long-running operation pattern.
82
84
  # @!attribute [rw] new_issue_uri
83
85
  # @return [::String]
84
- # Link to a place that API users can report issues. Example:
86
+ # Link to a *public* URI where users can report issues. Example:
85
87
  # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
88
  # @!attribute [rw] documentation_uri
87
89
  # @return [::String]
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
203
209
  # @!attribute [rw] common
204
210
  # @return [::Google::Api::CommonLanguageSettings]
205
211
  # Some settings.
212
+ # @!attribute [rw] renamed_services
213
+ # @return [::Google::Protobuf::Map{::String => ::String}]
214
+ # Map from original service names to renamed versions.
215
+ # This is used when the default generated types
216
+ # would cause a naming conflict. (Neither name is
217
+ # fully-qualified.)
218
+ # Example: Subscriber to SubscriberServiceApi.
219
+ # @!attribute [rw] renamed_resources
220
+ # @return [::Google::Protobuf::Map{::String => ::String}]
221
+ # Map from full resource types to the effective short name
222
+ # for the resource. This is used when otherwise resource
223
+ # named from different services would cause naming collisions.
224
+ # Example entry:
225
+ # "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
226
+ # @!attribute [rw] ignored_resources
227
+ # @return [::Array<::String>]
228
+ # List of full resource types to ignore during generation.
229
+ # This is typically used for API-specific Location resources,
230
+ # which should be handled by the generator as if they were actually
231
+ # the common Location resources.
232
+ # Example entry: "documentai.googleapis.com/Location"
233
+ # @!attribute [rw] forced_namespace_aliases
234
+ # @return [::Array<::String>]
235
+ # Namespaces which must be aliased in snippets due to
236
+ # a known (but non-generator-predictable) naming collision
237
+ # @!attribute [rw] handwritten_signatures
238
+ # @return [::Array<::String>]
239
+ # Method signatures (in the form "service.method(signature)")
240
+ # which are provided separately, so shouldn't be generated.
241
+ # Snippets *calling* these methods are still generated, however.
206
242
  class DotnetSettings
207
243
  include ::Google::Protobuf::MessageExts
208
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
245
+
246
+ # @!attribute [rw] key
247
+ # @return [::String]
248
+ # @!attribute [rw] value
249
+ # @return [::String]
250
+ class RenamedServicesEntry
251
+ include ::Google::Protobuf::MessageExts
252
+ extend ::Google::Protobuf::MessageExts::ClassMethods
253
+ end
254
+
255
+ # @!attribute [rw] key
256
+ # @return [::String]
257
+ # @!attribute [rw] value
258
+ # @return [::String]
259
+ class RenamedResourcesEntry
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
209
263
  end
210
264
 
211
265
  # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
240
294
  # Example of a YAML configuration::
241
295
  #
242
296
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
297
+ # method_settings:
298
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
299
  # long_running:
246
300
  # initial_poll_delay:
247
301
  # seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
299
353
 
300
354
  # Street View Org.
301
355
  STREET_VIEW = 4
356
+
357
+ # Shopping Org.
358
+ SHOPPING = 5
359
+
360
+ # Geo Org.
361
+ GEO = 6
362
+
363
+ # Generative AI - https://developers.generativeai.google
364
+ GENERATIVE_AI = 7
302
365
  end
303
366
 
304
367
  # To where should client libraries be published?