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

Sign up to get free protection for your applications and to get access to all the features.
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?