google-api-client 0.10.1 → 0.10.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (176) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +3 -0
  3. data/api_names.yaml +395 -0
  4. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  5. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +254 -254
  6. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +65 -65
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +220 -220
  8. data/generated/google/apis/admin_directory_v1.rb +1 -1
  9. data/generated/google/apis/admin_directory_v1/classes.rb +106 -0
  10. data/generated/google/apis/admin_directory_v1/representations.rb +37 -0
  11. data/generated/google/apis/admin_reports_v1.rb +3 -3
  12. data/generated/google/apis/admin_reports_v1/service.rb +6 -6
  13. data/generated/google/apis/adsense_v1_4.rb +1 -1
  14. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  15. data/generated/google/apis/analytics_v3.rb +1 -1
  16. data/generated/google/apis/analytics_v3/service.rb +39 -0
  17. data/generated/google/apis/analyticsreporting_v4/classes.rb +920 -920
  18. data/generated/google/apis/analyticsreporting_v4/representations.rb +197 -197
  19. data/generated/google/apis/analyticsreporting_v4/service.rb +4 -4
  20. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  21. data/generated/google/apis/androidenterprise_v1/classes.rb +8 -13
  22. data/generated/google/apis/androidenterprise_v1/service.rb +3 -3
  23. data/generated/google/apis/appengine_v1beta5.rb +1 -1
  24. data/generated/google/apis/appengine_v1beta5/classes.rb +115 -5
  25. data/generated/google/apis/appengine_v1beta5/representations.rb +37 -0
  26. data/generated/google/apis/appengine_v1beta5/service.rb +12 -9
  27. data/generated/google/apis/appstate_v1.rb +1 -1
  28. data/generated/google/apis/bigquery_v2.rb +1 -1
  29. data/generated/google/apis/bigquery_v2/classes.rb +32 -37
  30. data/generated/google/apis/bigquery_v2/service.rb +10 -2
  31. data/generated/google/apis/calendar_v3.rb +1 -1
  32. data/generated/google/apis/calendar_v3/classes.rb +205 -0
  33. data/generated/google/apis/calendar_v3/representations.rb +97 -0
  34. data/generated/google/apis/classroom_v1.rb +22 -25
  35. data/generated/google/apis/classroom_v1/classes.rb +998 -907
  36. data/generated/google/apis/classroom_v1/representations.rb +240 -240
  37. data/generated/google/apis/classroom_v1/service.rb +1269 -1061
  38. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  39. data/generated/google/apis/cloudbuild_v1/classes.rb +164 -163
  40. data/generated/google/apis/cloudbuild_v1/representations.rb +31 -31
  41. data/generated/google/apis/cloudbuild_v1/service.rb +114 -114
  42. data/generated/google/apis/clouddebugger_v2.rb +1 -1
  43. data/generated/google/apis/clouddebugger_v2/classes.rb +687 -687
  44. data/generated/google/apis/clouddebugger_v2/representations.rb +147 -147
  45. data/generated/google/apis/clouddebugger_v2/service.rb +132 -132
  46. data/generated/google/apis/cloudkms_v1.rb +1 -1
  47. data/generated/google/apis/cloudkms_v1/classes.rb +231 -248
  48. data/generated/google/apis/cloudkms_v1/representations.rb +74 -74
  49. data/generated/google/apis/cloudkms_v1/service.rb +228 -228
  50. data/generated/google/apis/cloudmonitoring_v2beta2.rb +1 -1
  51. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  52. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +738 -128
  53. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +245 -23
  54. data/generated/google/apis/cloudresourcemanager_v1/service.rb +1293 -249
  55. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +4 -4
  56. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +982 -372
  57. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +293 -71
  58. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +626 -277
  59. data/generated/google/apis/cloudtrace_v1.rb +1 -1
  60. data/generated/google/apis/cloudtrace_v1/classes.rb +19 -19
  61. data/generated/google/apis/cloudtrace_v1/representations.rb +2 -2
  62. data/generated/google/apis/cloudtrace_v1/service.rb +30 -30
  63. data/generated/google/apis/compute_beta.rb +1 -1
  64. data/generated/google/apis/compute_beta/classes.rb +116 -0
  65. data/generated/google/apis/compute_beta/representations.rb +48 -0
  66. data/generated/google/apis/compute_beta/service.rb +46 -1
  67. data/generated/google/apis/compute_v1.rb +1 -1
  68. data/generated/google/apis/dataflow_v1b3.rb +1 -1
  69. data/generated/google/apis/dataflow_v1b3/classes.rb +3276 -3320
  70. data/generated/google/apis/dataflow_v1b3/representations.rb +779 -781
  71. data/generated/google/apis/dataflow_v1b3/service.rb +225 -225
  72. data/generated/google/apis/dataproc_v1.rb +1 -1
  73. data/generated/google/apis/dataproc_v1/classes.rb +1221 -1207
  74. data/generated/google/apis/dataproc_v1/representations.rb +255 -253
  75. data/generated/google/apis/dataproc_v1/service.rb +100 -100
  76. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  77. data/generated/google/apis/deploymentmanager_v2/classes.rb +5 -5
  78. data/generated/google/apis/dns_v1.rb +1 -1
  79. data/generated/google/apis/dns_v2beta1.rb +1 -1
  80. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  81. data/generated/google/apis/drive_v2.rb +1 -1
  82. data/generated/google/apis/drive_v2/classes.rb +3 -1
  83. data/generated/google/apis/drive_v3.rb +1 -1
  84. data/generated/google/apis/drive_v3/classes.rb +3 -1
  85. data/generated/google/apis/fusiontables_v2.rb +1 -1
  86. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  87. data/generated/google/apis/games_management_v1management.rb +1 -1
  88. data/generated/google/apis/games_v1.rb +1 -1
  89. data/generated/google/apis/genomics_v1.rb +7 -7
  90. data/generated/google/apis/genomics_v1/classes.rb +959 -959
  91. data/generated/google/apis/genomics_v1/representations.rb +238 -238
  92. data/generated/google/apis/genomics_v1/service.rb +996 -996
  93. data/generated/google/apis/iam_v1.rb +1 -1
  94. data/generated/google/apis/iam_v1/classes.rb +440 -440
  95. data/generated/google/apis/iam_v1/representations.rb +94 -94
  96. data/generated/google/apis/iam_v1/service.rb +170 -173
  97. data/generated/google/apis/identitytoolkit_v3.rb +1 -1
  98. data/generated/google/apis/identitytoolkit_v3/classes.rb +55 -0
  99. data/generated/google/apis/identitytoolkit_v3/representations.rb +8 -0
  100. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  101. data/generated/google/apis/language_v1beta1.rb +1 -1
  102. data/generated/google/apis/language_v1beta1/classes.rb +427 -427
  103. data/generated/google/apis/language_v1beta1/representations.rb +113 -113
  104. data/generated/google/apis/language_v1beta1/service.rb +25 -24
  105. data/generated/google/apis/licensing_v1.rb +2 -2
  106. data/generated/google/apis/licensing_v1/classes.rb +14 -2
  107. data/generated/google/apis/licensing_v1/representations.rb +2 -0
  108. data/generated/google/apis/licensing_v1/service.rb +1 -1
  109. data/generated/google/apis/logging_v2beta1.rb +1 -1
  110. data/generated/google/apis/logging_v2beta1/classes.rb +864 -864
  111. data/generated/google/apis/logging_v2beta1/representations.rb +168 -168
  112. data/generated/google/apis/logging_v2beta1/service.rb +261 -261
  113. data/generated/google/apis/manufacturers_v1.rb +1 -1
  114. data/generated/google/apis/manufacturers_v1/classes.rb +452 -105
  115. data/generated/google/apis/manufacturers_v1/representations.rb +138 -18
  116. data/generated/google/apis/manufacturers_v1/service.rb +11 -11
  117. data/generated/google/apis/mirror_v1.rb +1 -1
  118. data/generated/google/apis/monitoring_v3.rb +7 -7
  119. data/generated/google/apis/monitoring_v3/classes.rb +668 -670
  120. data/generated/google/apis/monitoring_v3/representations.rb +140 -140
  121. data/generated/google/apis/monitoring_v3/service.rb +208 -208
  122. data/generated/google/apis/partners_v2.rb +1 -1
  123. data/generated/google/apis/partners_v2/classes.rb +505 -505
  124. data/generated/google/apis/partners_v2/representations.rb +118 -118
  125. data/generated/google/apis/partners_v2/service.rb +275 -275
  126. data/generated/google/apis/people_v1.rb +1 -1
  127. data/generated/google/apis/people_v1/classes.rb +1037 -1031
  128. data/generated/google/apis/people_v1/representations.rb +247 -246
  129. data/generated/google/apis/people_v1/service.rb +20 -20
  130. data/generated/google/apis/plus_domains_v1.rb +1 -1
  131. data/generated/google/apis/plus_v1.rb +1 -1
  132. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  133. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +392 -392
  134. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +93 -93
  135. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +381 -381
  136. data/generated/google/apis/pubsub_v1.rb +4 -4
  137. data/generated/google/apis/pubsub_v1/classes.rb +131 -132
  138. data/generated/google/apis/pubsub_v1/representations.rb +35 -35
  139. data/generated/google/apis/pubsub_v1/service.rb +399 -408
  140. data/generated/google/apis/reseller_v1.rb +1 -1
  141. data/generated/google/apis/reseller_v1/classes.rb +9 -0
  142. data/generated/google/apis/reseller_v1/representations.rb +1 -0
  143. data/generated/google/apis/script_v1.rb +9 -9
  144. data/generated/google/apis/script_v1/classes.rb +110 -110
  145. data/generated/google/apis/script_v1/representations.rb +26 -26
  146. data/generated/google/apis/sheets_v4.rb +4 -4
  147. data/generated/google/apis/sheets_v4/classes.rb +4329 -4329
  148. data/generated/google/apis/sheets_v4/representations.rb +856 -856
  149. data/generated/google/apis/sheets_v4/service.rb +106 -106
  150. data/generated/google/apis/slides_v1.rb +4 -4
  151. data/generated/google/apis/slides_v1/classes.rb +2923 -2841
  152. data/generated/google/apis/slides_v1/representations.rb +722 -691
  153. data/generated/google/apis/slides_v1/service.rb +58 -15
  154. data/generated/google/apis/speech_v1beta1.rb +1 -1
  155. data/generated/google/apis/speech_v1beta1/classes.rb +191 -191
  156. data/generated/google/apis/speech_v1beta1/representations.rb +57 -57
  157. data/generated/google/apis/speech_v1beta1/service.rb +70 -70
  158. data/generated/google/apis/storage_v1.rb +1 -1
  159. data/generated/google/apis/storage_v1/classes.rb +151 -0
  160. data/generated/google/apis/storage_v1/representations.rb +45 -0
  161. data/generated/google/apis/storage_v1/service.rb +248 -0
  162. data/generated/google/apis/vision_v1.rb +1 -1
  163. data/generated/google/apis/vision_v1/classes.rb +1227 -1221
  164. data/generated/google/apis/vision_v1/representations.rb +217 -215
  165. data/generated/google/apis/webmasters_v3.rb +1 -1
  166. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  167. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  168. data/generated/google/apis/youtube_partner_v1/classes.rb +78 -0
  169. data/generated/google/apis/youtube_partner_v1/representations.rb +34 -0
  170. data/generated/google/apis/youtube_partner_v1/service.rb +40 -0
  171. data/generated/google/apis/youtubereporting_v1.rb +4 -4
  172. data/generated/google/apis/youtubereporting_v1/classes.rb +65 -65
  173. data/generated/google/apis/youtubereporting_v1/representations.rb +18 -18
  174. data/generated/google/apis/youtubereporting_v1/service.rb +111 -111
  175. data/lib/google/apis/version.rb +1 -1
  176. metadata +2 -2
@@ -46,70 +46,144 @@ module Google
46
46
  super('https://pubsub.googleapis.com/', '')
47
47
  end
48
48
 
49
- # Gets the configuration of a topic.
50
- # @param [String] topic
51
- # The name of the topic to get.
52
- # Format is `projects/`project`/topics/`topic``.
49
+ # Acknowledges the messages associated with the `ack_ids` in the
50
+ # `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
51
+ # from the subscription.
52
+ # Acknowledging a message whose ack deadline has expired may succeed,
53
+ # but such a message may be redelivered later. Acknowledging a message more
54
+ # than once will not result in an error.
55
+ # @param [String] subscription
56
+ # The subscription whose message is being acknowledged.
57
+ # Format is `projects/`project`/subscriptions/`sub``.
58
+ # @param [Google::Apis::PubsubV1::AcknowledgeRequest] acknowledge_request_object
59
+ # @param [String] quota_user
60
+ # Available to use for quota purposes for server-side applications. Can be any
61
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
53
62
  # @param [String] fields
54
63
  # Selector specifying which fields to include in a partial response.
64
+ # @param [Google::Apis::RequestOptions] options
65
+ # Request-specific options
66
+ #
67
+ # @yield [result, err] Result & error if block supplied
68
+ # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
69
+ # @yieldparam err [StandardError] error object if request failed
70
+ #
71
+ # @return [Google::Apis::PubsubV1::Empty]
72
+ #
73
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
74
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
75
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
76
+ def acknowledge_subscription(subscription, acknowledge_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
77
+ command = make_simple_command(:post, 'v1/{+subscription}:acknowledge', options)
78
+ command.request_representation = Google::Apis::PubsubV1::AcknowledgeRequest::Representation
79
+ command.request_object = acknowledge_request_object
80
+ command.response_representation = Google::Apis::PubsubV1::Empty::Representation
81
+ command.response_class = Google::Apis::PubsubV1::Empty
82
+ command.params['subscription'] = subscription unless subscription.nil?
83
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
84
+ command.query['fields'] = fields unless fields.nil?
85
+ execute_or_queue_command(command, &block)
86
+ end
87
+
88
+ # Modifies the ack deadline for a specific message. This method is useful
89
+ # to indicate that more time is needed to process a message by the
90
+ # subscriber, or to make the message available for redelivery if the
91
+ # processing was interrupted. Note that this does not modify the
92
+ # subscription-level `ackDeadlineSeconds` used for subsequent messages.
93
+ # @param [String] subscription
94
+ # The name of the subscription.
95
+ # Format is `projects/`project`/subscriptions/`sub``.
96
+ # @param [Google::Apis::PubsubV1::ModifyAckDeadlineRequest] modify_ack_deadline_request_object
55
97
  # @param [String] quota_user
56
98
  # Available to use for quota purposes for server-side applications. Can be any
57
99
  # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [String] fields
101
+ # Selector specifying which fields to include in a partial response.
58
102
  # @param [Google::Apis::RequestOptions] options
59
103
  # Request-specific options
60
104
  #
61
105
  # @yield [result, err] Result & error if block supplied
62
- # @yieldparam result [Google::Apis::PubsubV1::Topic] parsed result object
106
+ # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
63
107
  # @yieldparam err [StandardError] error object if request failed
64
108
  #
65
- # @return [Google::Apis::PubsubV1::Topic]
109
+ # @return [Google::Apis::PubsubV1::Empty]
66
110
  #
67
111
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
68
112
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
69
113
  # @raise [Google::Apis::AuthorizationError] Authorization is required
70
- def get_topic(topic, fields: nil, quota_user: nil, options: nil, &block)
71
- command = make_simple_command(:get, 'v1/{+topic}', options)
72
- command.response_representation = Google::Apis::PubsubV1::Topic::Representation
73
- command.response_class = Google::Apis::PubsubV1::Topic
74
- command.params['topic'] = topic unless topic.nil?
75
- command.query['fields'] = fields unless fields.nil?
114
+ def modify_subscription_ack_deadline(subscription, modify_ack_deadline_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
115
+ command = make_simple_command(:post, 'v1/{+subscription}:modifyAckDeadline', options)
116
+ command.request_representation = Google::Apis::PubsubV1::ModifyAckDeadlineRequest::Representation
117
+ command.request_object = modify_ack_deadline_request_object
118
+ command.response_representation = Google::Apis::PubsubV1::Empty::Representation
119
+ command.response_class = Google::Apis::PubsubV1::Empty
120
+ command.params['subscription'] = subscription unless subscription.nil?
76
121
  command.query['quotaUser'] = quota_user unless quota_user.nil?
122
+ command.query['fields'] = fields unless fields.nil?
77
123
  execute_or_queue_command(command, &block)
78
124
  end
79
125
 
80
- # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
81
- # does not exist. The message payload must not be empty; it must contain
82
- # either a non-empty data field, or at least one attribute.
83
- # @param [String] topic
84
- # The messages in the request will be published on this topic.
85
- # Format is `projects/`project`/topics/`topic``.
86
- # @param [Google::Apis::PubsubV1::PublishRequest] publish_request_object
126
+ # Gets the access control policy for a resource.
127
+ # Returns an empty policy if the resource exists and does not have a policy
128
+ # set.
129
+ # @param [String] resource
130
+ # REQUIRED: The resource for which the policy is being requested.
131
+ # See the operation documentation for the appropriate value for this field.
132
+ # @param [String] quota_user
133
+ # Available to use for quota purposes for server-side applications. Can be any
134
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
87
135
  # @param [String] fields
88
136
  # Selector specifying which fields to include in a partial response.
137
+ # @param [Google::Apis::RequestOptions] options
138
+ # Request-specific options
139
+ #
140
+ # @yield [result, err] Result & error if block supplied
141
+ # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
142
+ # @yieldparam err [StandardError] error object if request failed
143
+ #
144
+ # @return [Google::Apis::PubsubV1::Policy]
145
+ #
146
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
147
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
148
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
149
+ def get_project_subscription_iam_policy(resource, quota_user: nil, fields: nil, options: nil, &block)
150
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
151
+ command.response_representation = Google::Apis::PubsubV1::Policy::Representation
152
+ command.response_class = Google::Apis::PubsubV1::Policy
153
+ command.params['resource'] = resource unless resource.nil?
154
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
155
+ command.query['fields'] = fields unless fields.nil?
156
+ execute_or_queue_command(command, &block)
157
+ end
158
+
159
+ # Gets the configuration details of a subscription.
160
+ # @param [String] subscription
161
+ # The name of the subscription to get.
162
+ # Format is `projects/`project`/subscriptions/`sub``.
89
163
  # @param [String] quota_user
90
164
  # Available to use for quota purposes for server-side applications. Can be any
91
165
  # arbitrary string assigned to a user, but should not exceed 40 characters.
166
+ # @param [String] fields
167
+ # Selector specifying which fields to include in a partial response.
92
168
  # @param [Google::Apis::RequestOptions] options
93
169
  # Request-specific options
94
170
  #
95
171
  # @yield [result, err] Result & error if block supplied
96
- # @yieldparam result [Google::Apis::PubsubV1::PublishResponse] parsed result object
172
+ # @yieldparam result [Google::Apis::PubsubV1::Subscription] parsed result object
97
173
  # @yieldparam err [StandardError] error object if request failed
98
174
  #
99
- # @return [Google::Apis::PubsubV1::PublishResponse]
175
+ # @return [Google::Apis::PubsubV1::Subscription]
100
176
  #
101
177
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
102
178
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
103
179
  # @raise [Google::Apis::AuthorizationError] Authorization is required
104
- def publish_topic(topic, publish_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
105
- command = make_simple_command(:post, 'v1/{+topic}:publish', options)
106
- command.request_representation = Google::Apis::PubsubV1::PublishRequest::Representation
107
- command.request_object = publish_request_object
108
- command.response_representation = Google::Apis::PubsubV1::PublishResponse::Representation
109
- command.response_class = Google::Apis::PubsubV1::PublishResponse
110
- command.params['topic'] = topic unless topic.nil?
111
- command.query['fields'] = fields unless fields.nil?
180
+ def get_subscription(subscription, quota_user: nil, fields: nil, options: nil, &block)
181
+ command = make_simple_command(:get, 'v1/{+subscription}', options)
182
+ command.response_representation = Google::Apis::PubsubV1::Subscription::Representation
183
+ command.response_class = Google::Apis::PubsubV1::Subscription
184
+ command.params['subscription'] = subscription unless subscription.nil?
112
185
  command.query['quotaUser'] = quota_user unless quota_user.nil?
186
+ command.query['fields'] = fields unless fields.nil?
113
187
  execute_or_queue_command(command, &block)
114
188
  end
115
189
 
@@ -121,14 +195,13 @@ module Google
121
195
  # may "fail open" without warning.
122
196
  # @param [String] resource
123
197
  # REQUIRED: The resource for which the policy detail is being requested.
124
- # `resource` is usually specified as a path. For example, a Project
125
- # resource is specified as `projects/`project``.
198
+ # See the operation documentation for the appropriate value for this field.
126
199
  # @param [Google::Apis::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
127
- # @param [String] fields
128
- # Selector specifying which fields to include in a partial response.
129
200
  # @param [String] quota_user
130
201
  # Available to use for quota purposes for server-side applications. Can be any
131
202
  # arbitrary string assigned to a user, but should not exceed 40 characters.
203
+ # @param [String] fields
204
+ # Selector specifying which fields to include in a partial response.
132
205
  # @param [Google::Apis::RequestOptions] options
133
206
  # Request-specific options
134
207
  #
@@ -141,31 +214,32 @@ module Google
141
214
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
142
215
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
143
216
  # @raise [Google::Apis::AuthorizationError] Authorization is required
144
- def test_topic_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
217
+ def test_subscription_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
145
218
  command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
146
219
  command.request_representation = Google::Apis::PubsubV1::TestIamPermissionsRequest::Representation
147
220
  command.request_object = test_iam_permissions_request_object
148
221
  command.response_representation = Google::Apis::PubsubV1::TestIamPermissionsResponse::Representation
149
222
  command.response_class = Google::Apis::PubsubV1::TestIamPermissionsResponse
150
223
  command.params['resource'] = resource unless resource.nil?
151
- command.query['fields'] = fields unless fields.nil?
152
224
  command.query['quotaUser'] = quota_user unless quota_user.nil?
225
+ command.query['fields'] = fields unless fields.nil?
153
226
  execute_or_queue_command(command, &block)
154
227
  end
155
228
 
156
- # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
157
- # does not exist. After a topic is deleted, a new topic may be created with
158
- # the same name; this is an entirely new topic with none of the old
159
- # configuration or subscriptions. Existing subscriptions to this topic are
160
- # not deleted, but their `topic` field is set to `_deleted-topic_`.
161
- # @param [String] topic
162
- # Name of the topic to delete.
163
- # Format is `projects/`project`/topics/`topic``.
164
- # @param [String] fields
165
- # Selector specifying which fields to include in a partial response.
229
+ # Modifies the `PushConfig` for a specified subscription.
230
+ # This may be used to change a push subscription to a pull one (signified by
231
+ # an empty `PushConfig`) or vice versa, or change the endpoint URL and other
232
+ # attributes of a push subscription. Messages will accumulate for delivery
233
+ # continuously through the call regardless of changes to the `PushConfig`.
234
+ # @param [String] subscription
235
+ # The name of the subscription.
236
+ # Format is `projects/`project`/subscriptions/`sub``.
237
+ # @param [Google::Apis::PubsubV1::ModifyPushConfigRequest] modify_push_config_request_object
166
238
  # @param [String] quota_user
167
239
  # Available to use for quota purposes for server-side applications. Can be any
168
240
  # arbitrary string assigned to a user, but should not exceed 40 characters.
241
+ # @param [String] fields
242
+ # Selector specifying which fields to include in a partial response.
169
243
  # @param [Google::Apis::RequestOptions] options
170
244
  # Request-specific options
171
245
  #
@@ -178,90 +252,126 @@ module Google
178
252
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
179
253
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
180
254
  # @raise [Google::Apis::AuthorizationError] Authorization is required
181
- def delete_topic(topic, fields: nil, quota_user: nil, options: nil, &block)
182
- command = make_simple_command(:delete, 'v1/{+topic}', options)
255
+ def modify_subscription_push_config(subscription, modify_push_config_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
256
+ command = make_simple_command(:post, 'v1/{+subscription}:modifyPushConfig', options)
257
+ command.request_representation = Google::Apis::PubsubV1::ModifyPushConfigRequest::Representation
258
+ command.request_object = modify_push_config_request_object
183
259
  command.response_representation = Google::Apis::PubsubV1::Empty::Representation
184
260
  command.response_class = Google::Apis::PubsubV1::Empty
185
- command.params['topic'] = topic unless topic.nil?
186
- command.query['fields'] = fields unless fields.nil?
261
+ command.params['subscription'] = subscription unless subscription.nil?
187
262
  command.query['quotaUser'] = quota_user unless quota_user.nil?
263
+ command.query['fields'] = fields unless fields.nil?
188
264
  execute_or_queue_command(command, &block)
189
265
  end
190
266
 
191
- # Lists matching topics.
192
- # @param [String] project
193
- # The name of the cloud project that topics belong to.
194
- # Format is `projects/`project``.
195
- # @param [Fixnum] page_size
196
- # Maximum number of topics to return.
197
- # @param [String] page_token
198
- # The value returned by the last `ListTopicsResponse`; indicates that this is
199
- # a continuation of a prior `ListTopics` call, and that the system should
200
- # return the next page of data.
201
- # @param [String] fields
202
- # Selector specifying which fields to include in a partial response.
267
+ # Deletes an existing subscription. All messages retained in the subscription
268
+ # are immediately dropped. Calls to `Pull` after deletion will return
269
+ # `NOT_FOUND`. After a subscription is deleted, a new one may be created with
270
+ # the same name, but the new one has no association with the old
271
+ # subscription or its topic unless the same topic is specified.
272
+ # @param [String] subscription
273
+ # The subscription to delete.
274
+ # Format is `projects/`project`/subscriptions/`sub``.
203
275
  # @param [String] quota_user
204
276
  # Available to use for quota purposes for server-side applications. Can be any
205
277
  # arbitrary string assigned to a user, but should not exceed 40 characters.
278
+ # @param [String] fields
279
+ # Selector specifying which fields to include in a partial response.
206
280
  # @param [Google::Apis::RequestOptions] options
207
281
  # Request-specific options
208
282
  #
209
283
  # @yield [result, err] Result & error if block supplied
210
- # @yieldparam result [Google::Apis::PubsubV1::ListTopicsResponse] parsed result object
284
+ # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
211
285
  # @yieldparam err [StandardError] error object if request failed
212
286
  #
213
- # @return [Google::Apis::PubsubV1::ListTopicsResponse]
287
+ # @return [Google::Apis::PubsubV1::Empty]
214
288
  #
215
289
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
216
290
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
217
291
  # @raise [Google::Apis::AuthorizationError] Authorization is required
218
- def list_topics(project, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
219
- command = make_simple_command(:get, 'v1/{+project}/topics', options)
220
- command.response_representation = Google::Apis::PubsubV1::ListTopicsResponse::Representation
221
- command.response_class = Google::Apis::PubsubV1::ListTopicsResponse
222
- command.params['project'] = project unless project.nil?
223
- command.query['pageSize'] = page_size unless page_size.nil?
224
- command.query['pageToken'] = page_token unless page_token.nil?
225
- command.query['fields'] = fields unless fields.nil?
292
+ def delete_subscription(subscription, quota_user: nil, fields: nil, options: nil, &block)
293
+ command = make_simple_command(:delete, 'v1/{+subscription}', options)
294
+ command.response_representation = Google::Apis::PubsubV1::Empty::Representation
295
+ command.response_class = Google::Apis::PubsubV1::Empty
296
+ command.params['subscription'] = subscription unless subscription.nil?
226
297
  command.query['quotaUser'] = quota_user unless quota_user.nil?
298
+ command.query['fields'] = fields unless fields.nil?
227
299
  execute_or_queue_command(command, &block)
228
300
  end
229
301
 
230
- # Creates the given topic with the given name.
231
- # @param [String] name
232
- # The name of the topic. It must have the format
233
- # `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter,
234
- # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
235
- # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
236
- # signs (`%`). It must be between 3 and 255 characters in length, and it
237
- # must not start with `"goog"`.
238
- # @param [Google::Apis::PubsubV1::Topic] topic_object
302
+ # Pulls messages from the server. Returns an empty list if there are no
303
+ # messages available in the backlog. The server may return `UNAVAILABLE` if
304
+ # there are too many concurrent pull requests pending for the given
305
+ # subscription.
306
+ # @param [String] subscription
307
+ # The subscription from which messages should be pulled.
308
+ # Format is `projects/`project`/subscriptions/`sub``.
309
+ # @param [Google::Apis::PubsubV1::PullRequest] pull_request_object
310
+ # @param [String] quota_user
311
+ # Available to use for quota purposes for server-side applications. Can be any
312
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
239
313
  # @param [String] fields
240
314
  # Selector specifying which fields to include in a partial response.
315
+ # @param [Google::Apis::RequestOptions] options
316
+ # Request-specific options
317
+ #
318
+ # @yield [result, err] Result & error if block supplied
319
+ # @yieldparam result [Google::Apis::PubsubV1::PullResponse] parsed result object
320
+ # @yieldparam err [StandardError] error object if request failed
321
+ #
322
+ # @return [Google::Apis::PubsubV1::PullResponse]
323
+ #
324
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
325
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
326
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
327
+ def pull_subscription(subscription, pull_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
328
+ command = make_simple_command(:post, 'v1/{+subscription}:pull', options)
329
+ command.request_representation = Google::Apis::PubsubV1::PullRequest::Representation
330
+ command.request_object = pull_request_object
331
+ command.response_representation = Google::Apis::PubsubV1::PullResponse::Representation
332
+ command.response_class = Google::Apis::PubsubV1::PullResponse
333
+ command.params['subscription'] = subscription unless subscription.nil?
334
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
335
+ command.query['fields'] = fields unless fields.nil?
336
+ execute_or_queue_command(command, &block)
337
+ end
338
+
339
+ # Lists matching subscriptions.
340
+ # @param [String] project
341
+ # The name of the cloud project that subscriptions belong to.
342
+ # Format is `projects/`project``.
343
+ # @param [String] page_token
344
+ # The value returned by the last `ListSubscriptionsResponse`; indicates that
345
+ # this is a continuation of a prior `ListSubscriptions` call, and that the
346
+ # system should return the next page of data.
347
+ # @param [Fixnum] page_size
348
+ # Maximum number of subscriptions to return.
241
349
  # @param [String] quota_user
242
350
  # Available to use for quota purposes for server-side applications. Can be any
243
351
  # arbitrary string assigned to a user, but should not exceed 40 characters.
352
+ # @param [String] fields
353
+ # Selector specifying which fields to include in a partial response.
244
354
  # @param [Google::Apis::RequestOptions] options
245
355
  # Request-specific options
246
356
  #
247
357
  # @yield [result, err] Result & error if block supplied
248
- # @yieldparam result [Google::Apis::PubsubV1::Topic] parsed result object
358
+ # @yieldparam result [Google::Apis::PubsubV1::ListSubscriptionsResponse] parsed result object
249
359
  # @yieldparam err [StandardError] error object if request failed
250
360
  #
251
- # @return [Google::Apis::PubsubV1::Topic]
361
+ # @return [Google::Apis::PubsubV1::ListSubscriptionsResponse]
252
362
  #
253
363
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
254
364
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
255
365
  # @raise [Google::Apis::AuthorizationError] Authorization is required
256
- def create_topic(name, topic_object = nil, fields: nil, quota_user: nil, options: nil, &block)
257
- command = make_simple_command(:put, 'v1/{+name}', options)
258
- command.request_representation = Google::Apis::PubsubV1::Topic::Representation
259
- command.request_object = topic_object
260
- command.response_representation = Google::Apis::PubsubV1::Topic::Representation
261
- command.response_class = Google::Apis::PubsubV1::Topic
262
- command.params['name'] = name unless name.nil?
263
- command.query['fields'] = fields unless fields.nil?
366
+ def list_subscriptions(project, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
367
+ command = make_simple_command(:get, 'v1/{+project}/subscriptions', options)
368
+ command.response_representation = Google::Apis::PubsubV1::ListSubscriptionsResponse::Representation
369
+ command.response_class = Google::Apis::PubsubV1::ListSubscriptionsResponse
370
+ command.params['project'] = project unless project.nil?
371
+ command.query['pageToken'] = page_token unless page_token.nil?
372
+ command.query['pageSize'] = page_size unless page_size.nil?
264
373
  command.query['quotaUser'] = quota_user unless quota_user.nil?
374
+ command.query['fields'] = fields unless fields.nil?
265
375
  execute_or_queue_command(command, &block)
266
376
  end
267
377
 
@@ -269,14 +379,13 @@ module Google
269
379
  # existing policy.
270
380
  # @param [String] resource
271
381
  # REQUIRED: The resource for which the policy is being specified.
272
- # `resource` is usually specified as a path. For example, a Project
273
- # resource is specified as `projects/`project``.
382
+ # See the operation documentation for the appropriate value for this field.
274
383
  # @param [Google::Apis::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
275
- # @param [String] fields
276
- # Selector specifying which fields to include in a partial response.
277
384
  # @param [String] quota_user
278
385
  # Available to use for quota purposes for server-side applications. Can be any
279
386
  # arbitrary string assigned to a user, but should not exceed 40 characters.
387
+ # @param [String] fields
388
+ # Selector specifying which fields to include in a partial response.
280
389
  # @param [Google::Apis::RequestOptions] options
281
390
  # Request-specific options
282
391
  #
@@ -289,88 +398,96 @@ module Google
289
398
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
290
399
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
291
400
  # @raise [Google::Apis::AuthorizationError] Authorization is required
292
- def set_topic_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
401
+ def set_subscription_iam_policy(resource, set_iam_policy_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
293
402
  command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
294
403
  command.request_representation = Google::Apis::PubsubV1::SetIamPolicyRequest::Representation
295
404
  command.request_object = set_iam_policy_request_object
296
405
  command.response_representation = Google::Apis::PubsubV1::Policy::Representation
297
406
  command.response_class = Google::Apis::PubsubV1::Policy
298
407
  command.params['resource'] = resource unless resource.nil?
299
- command.query['fields'] = fields unless fields.nil?
300
408
  command.query['quotaUser'] = quota_user unless quota_user.nil?
409
+ command.query['fields'] = fields unless fields.nil?
301
410
  execute_or_queue_command(command, &block)
302
411
  end
303
412
 
304
- # Gets the access control policy for a resource.
305
- # Returns an empty policy if the resource exists and does not have a policy
306
- # set.
307
- # @param [String] resource
308
- # REQUIRED: The resource for which the policy is being requested.
309
- # `resource` is usually specified as a path. For example, a Project
310
- # resource is specified as `projects/`project``.
311
- # @param [String] fields
312
- # Selector specifying which fields to include in a partial response.
413
+ # Creates a subscription to a given topic.
414
+ # If the subscription already exists, returns `ALREADY_EXISTS`.
415
+ # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
416
+ # If the name is not provided in the request, the server will assign a random
417
+ # name for this subscription on the same project as the topic, conforming
418
+ # to the
419
+ # [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
420
+ # The generated name is populated in the returned Subscription object.
421
+ # Note that for REST API requests, you must specify a name in the request.
422
+ # @param [String] name
423
+ # The name of the subscription. It must have the format
424
+ # `"projects/`project`/subscriptions/`subscription`"`. ``subscription`` must
425
+ # start with a letter, and contain only letters (`[A-Za-z]`), numbers
426
+ # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
427
+ # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
428
+ # in length, and it must not start with `"goog"`.
429
+ # @param [Google::Apis::PubsubV1::Subscription] subscription_object
313
430
  # @param [String] quota_user
314
431
  # Available to use for quota purposes for server-side applications. Can be any
315
432
  # arbitrary string assigned to a user, but should not exceed 40 characters.
433
+ # @param [String] fields
434
+ # Selector specifying which fields to include in a partial response.
316
435
  # @param [Google::Apis::RequestOptions] options
317
436
  # Request-specific options
318
437
  #
319
438
  # @yield [result, err] Result & error if block supplied
320
- # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
439
+ # @yieldparam result [Google::Apis::PubsubV1::Subscription] parsed result object
321
440
  # @yieldparam err [StandardError] error object if request failed
322
441
  #
323
- # @return [Google::Apis::PubsubV1::Policy]
442
+ # @return [Google::Apis::PubsubV1::Subscription]
324
443
  #
325
444
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
326
445
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
327
446
  # @raise [Google::Apis::AuthorizationError] Authorization is required
328
- def get_project_topic_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
329
- command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
330
- command.response_representation = Google::Apis::PubsubV1::Policy::Representation
331
- command.response_class = Google::Apis::PubsubV1::Policy
332
- command.params['resource'] = resource unless resource.nil?
333
- command.query['fields'] = fields unless fields.nil?
447
+ def create_subscription(name, subscription_object = nil, quota_user: nil, fields: nil, options: nil, &block)
448
+ command = make_simple_command(:put, 'v1/{+name}', options)
449
+ command.request_representation = Google::Apis::PubsubV1::Subscription::Representation
450
+ command.request_object = subscription_object
451
+ command.response_representation = Google::Apis::PubsubV1::Subscription::Representation
452
+ command.response_class = Google::Apis::PubsubV1::Subscription
453
+ command.params['name'] = name unless name.nil?
334
454
  command.query['quotaUser'] = quota_user unless quota_user.nil?
455
+ command.query['fields'] = fields unless fields.nil?
335
456
  execute_or_queue_command(command, &block)
336
457
  end
337
458
 
338
- # Lists the name of the subscriptions for this topic.
339
- # @param [String] topic
340
- # The name of the topic that subscriptions are attached to.
341
- # Format is `projects/`project`/topics/`topic``.
342
- # @param [Fixnum] page_size
343
- # Maximum number of subscription names to return.
344
- # @param [String] page_token
345
- # The value returned by the last `ListTopicSubscriptionsResponse`; indicates
346
- # that this is a continuation of a prior `ListTopicSubscriptions` call, and
347
- # that the system should return the next page of data.
348
- # @param [String] fields
349
- # Selector specifying which fields to include in a partial response.
459
+ # Sets the access control policy on the specified resource. Replaces any
460
+ # existing policy.
461
+ # @param [String] resource
462
+ # REQUIRED: The resource for which the policy is being specified.
463
+ # See the operation documentation for the appropriate value for this field.
464
+ # @param [Google::Apis::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
350
465
  # @param [String] quota_user
351
466
  # Available to use for quota purposes for server-side applications. Can be any
352
467
  # arbitrary string assigned to a user, but should not exceed 40 characters.
468
+ # @param [String] fields
469
+ # Selector specifying which fields to include in a partial response.
353
470
  # @param [Google::Apis::RequestOptions] options
354
471
  # Request-specific options
355
472
  #
356
473
  # @yield [result, err] Result & error if block supplied
357
- # @yieldparam result [Google::Apis::PubsubV1::ListTopicSubscriptionsResponse] parsed result object
474
+ # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
358
475
  # @yieldparam err [StandardError] error object if request failed
359
476
  #
360
- # @return [Google::Apis::PubsubV1::ListTopicSubscriptionsResponse]
477
+ # @return [Google::Apis::PubsubV1::Policy]
361
478
  #
362
479
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
363
480
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
364
481
  # @raise [Google::Apis::AuthorizationError] Authorization is required
365
- def list_topic_subscriptions(topic, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
366
- command = make_simple_command(:get, 'v1/{+topic}/subscriptions', options)
367
- command.response_representation = Google::Apis::PubsubV1::ListTopicSubscriptionsResponse::Representation
368
- command.response_class = Google::Apis::PubsubV1::ListTopicSubscriptionsResponse
369
- command.params['topic'] = topic unless topic.nil?
370
- command.query['pageSize'] = page_size unless page_size.nil?
371
- command.query['pageToken'] = page_token unless page_token.nil?
372
- command.query['fields'] = fields unless fields.nil?
482
+ def set_snapshot_iam_policy(resource, set_iam_policy_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
483
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
484
+ command.request_representation = Google::Apis::PubsubV1::SetIamPolicyRequest::Representation
485
+ command.request_object = set_iam_policy_request_object
486
+ command.response_representation = Google::Apis::PubsubV1::Policy::Representation
487
+ command.response_class = Google::Apis::PubsubV1::Policy
488
+ command.params['resource'] = resource unless resource.nil?
373
489
  command.query['quotaUser'] = quota_user unless quota_user.nil?
490
+ command.query['fields'] = fields unless fields.nil?
374
491
  execute_or_queue_command(command, &block)
375
492
  end
376
493
 
@@ -382,14 +499,13 @@ module Google
382
499
  # may "fail open" without warning.
383
500
  # @param [String] resource
384
501
  # REQUIRED: The resource for which the policy detail is being requested.
385
- # `resource` is usually specified as a path. For example, a Project
386
- # resource is specified as `projects/`project``.
502
+ # See the operation documentation for the appropriate value for this field.
387
503
  # @param [Google::Apis::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
388
- # @param [String] fields
389
- # Selector specifying which fields to include in a partial response.
390
504
  # @param [String] quota_user
391
505
  # Available to use for quota purposes for server-side applications. Can be any
392
506
  # arbitrary string assigned to a user, but should not exceed 40 characters.
507
+ # @param [String] fields
508
+ # Selector specifying which fields to include in a partial response.
393
509
  # @param [Google::Apis::RequestOptions] options
394
510
  # Request-specific options
395
511
  #
@@ -402,210 +518,122 @@ module Google
402
518
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
403
519
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
404
520
  # @raise [Google::Apis::AuthorizationError] Authorization is required
405
- def test_subscription_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
521
+ def test_snapshot_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
406
522
  command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
407
523
  command.request_representation = Google::Apis::PubsubV1::TestIamPermissionsRequest::Representation
408
524
  command.request_object = test_iam_permissions_request_object
409
525
  command.response_representation = Google::Apis::PubsubV1::TestIamPermissionsResponse::Representation
410
526
  command.response_class = Google::Apis::PubsubV1::TestIamPermissionsResponse
411
527
  command.params['resource'] = resource unless resource.nil?
412
- command.query['fields'] = fields unless fields.nil?
413
528
  command.query['quotaUser'] = quota_user unless quota_user.nil?
414
- execute_or_queue_command(command, &block)
415
- end
416
-
417
- # Modifies the `PushConfig` for a specified subscription.
418
- # This may be used to change a push subscription to a pull one (signified by
419
- # an empty `PushConfig`) or vice versa, or change the endpoint URL and other
420
- # attributes of a push subscription. Messages will accumulate for delivery
421
- # continuously through the call regardless of changes to the `PushConfig`.
422
- # @param [String] subscription
423
- # The name of the subscription.
424
- # Format is `projects/`project`/subscriptions/`sub``.
425
- # @param [Google::Apis::PubsubV1::ModifyPushConfigRequest] modify_push_config_request_object
426
- # @param [String] fields
427
- # Selector specifying which fields to include in a partial response.
428
- # @param [String] quota_user
429
- # Available to use for quota purposes for server-side applications. Can be any
430
- # arbitrary string assigned to a user, but should not exceed 40 characters.
431
- # @param [Google::Apis::RequestOptions] options
432
- # Request-specific options
433
- #
434
- # @yield [result, err] Result & error if block supplied
435
- # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
436
- # @yieldparam err [StandardError] error object if request failed
437
- #
438
- # @return [Google::Apis::PubsubV1::Empty]
439
- #
440
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
441
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
442
- # @raise [Google::Apis::AuthorizationError] Authorization is required
443
- def modify_subscription_push_config(subscription, modify_push_config_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
444
- command = make_simple_command(:post, 'v1/{+subscription}:modifyPushConfig', options)
445
- command.request_representation = Google::Apis::PubsubV1::ModifyPushConfigRequest::Representation
446
- command.request_object = modify_push_config_request_object
447
- command.response_representation = Google::Apis::PubsubV1::Empty::Representation
448
- command.response_class = Google::Apis::PubsubV1::Empty
449
- command.params['subscription'] = subscription unless subscription.nil?
450
529
  command.query['fields'] = fields unless fields.nil?
451
- command.query['quotaUser'] = quota_user unless quota_user.nil?
452
530
  execute_or_queue_command(command, &block)
453
531
  end
454
532
 
455
- # Deletes an existing subscription. All messages retained in the subscription
456
- # are immediately dropped. Calls to `Pull` after deletion will return
457
- # `NOT_FOUND`. After a subscription is deleted, a new one may be created with
458
- # the same name, but the new one has no association with the old
459
- # subscription or its topic unless the same topic is specified.
460
- # @param [String] subscription
461
- # The subscription to delete.
462
- # Format is `projects/`project`/subscriptions/`sub``.
463
- # @param [String] fields
464
- # Selector specifying which fields to include in a partial response.
533
+ # Gets the access control policy for a resource.
534
+ # Returns an empty policy if the resource exists and does not have a policy
535
+ # set.
536
+ # @param [String] resource
537
+ # REQUIRED: The resource for which the policy is being requested.
538
+ # See the operation documentation for the appropriate value for this field.
465
539
  # @param [String] quota_user
466
540
  # Available to use for quota purposes for server-side applications. Can be any
467
541
  # arbitrary string assigned to a user, but should not exceed 40 characters.
468
- # @param [Google::Apis::RequestOptions] options
469
- # Request-specific options
470
- #
471
- # @yield [result, err] Result & error if block supplied
472
- # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
473
- # @yieldparam err [StandardError] error object if request failed
474
- #
475
- # @return [Google::Apis::PubsubV1::Empty]
476
- #
477
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
478
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
479
- # @raise [Google::Apis::AuthorizationError] Authorization is required
480
- def delete_subscription(subscription, fields: nil, quota_user: nil, options: nil, &block)
481
- command = make_simple_command(:delete, 'v1/{+subscription}', options)
482
- command.response_representation = Google::Apis::PubsubV1::Empty::Representation
483
- command.response_class = Google::Apis::PubsubV1::Empty
484
- command.params['subscription'] = subscription unless subscription.nil?
485
- command.query['fields'] = fields unless fields.nil?
486
- command.query['quotaUser'] = quota_user unless quota_user.nil?
487
- execute_or_queue_command(command, &block)
488
- end
489
-
490
- # Pulls messages from the server. Returns an empty list if there are no
491
- # messages available in the backlog. The server may return `UNAVAILABLE` if
492
- # there are too many concurrent pull requests pending for the given
493
- # subscription.
494
- # @param [String] subscription
495
- # The subscription from which messages should be pulled.
496
- # Format is `projects/`project`/subscriptions/`sub``.
497
- # @param [Google::Apis::PubsubV1::PullRequest] pull_request_object
498
542
  # @param [String] fields
499
543
  # Selector specifying which fields to include in a partial response.
500
- # @param [String] quota_user
501
- # Available to use for quota purposes for server-side applications. Can be any
502
- # arbitrary string assigned to a user, but should not exceed 40 characters.
503
544
  # @param [Google::Apis::RequestOptions] options
504
545
  # Request-specific options
505
546
  #
506
547
  # @yield [result, err] Result & error if block supplied
507
- # @yieldparam result [Google::Apis::PubsubV1::PullResponse] parsed result object
548
+ # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
508
549
  # @yieldparam err [StandardError] error object if request failed
509
550
  #
510
- # @return [Google::Apis::PubsubV1::PullResponse]
551
+ # @return [Google::Apis::PubsubV1::Policy]
511
552
  #
512
553
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
513
554
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
514
555
  # @raise [Google::Apis::AuthorizationError] Authorization is required
515
- def pull_subscription(subscription, pull_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
516
- command = make_simple_command(:post, 'v1/{+subscription}:pull', options)
517
- command.request_representation = Google::Apis::PubsubV1::PullRequest::Representation
518
- command.request_object = pull_request_object
519
- command.response_representation = Google::Apis::PubsubV1::PullResponse::Representation
520
- command.response_class = Google::Apis::PubsubV1::PullResponse
521
- command.params['subscription'] = subscription unless subscription.nil?
522
- command.query['fields'] = fields unless fields.nil?
556
+ def get_project_snapshot_iam_policy(resource, quota_user: nil, fields: nil, options: nil, &block)
557
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
558
+ command.response_representation = Google::Apis::PubsubV1::Policy::Representation
559
+ command.response_class = Google::Apis::PubsubV1::Policy
560
+ command.params['resource'] = resource unless resource.nil?
523
561
  command.query['quotaUser'] = quota_user unless quota_user.nil?
562
+ command.query['fields'] = fields unless fields.nil?
524
563
  execute_or_queue_command(command, &block)
525
564
  end
526
565
 
527
- # Lists matching subscriptions.
528
- # @param [String] project
529
- # The name of the cloud project that subscriptions belong to.
530
- # Format is `projects/`project``.
531
- # @param [String] page_token
532
- # The value returned by the last `ListSubscriptionsResponse`; indicates that
533
- # this is a continuation of a prior `ListSubscriptions` call, and that the
534
- # system should return the next page of data.
535
- # @param [Fixnum] page_size
536
- # Maximum number of subscriptions to return.
537
- # @param [String] fields
538
- # Selector specifying which fields to include in a partial response.
566
+ # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
567
+ # does not exist. After a topic is deleted, a new topic may be created with
568
+ # the same name; this is an entirely new topic with none of the old
569
+ # configuration or subscriptions. Existing subscriptions to this topic are
570
+ # not deleted, but their `topic` field is set to `_deleted-topic_`.
571
+ # @param [String] topic
572
+ # Name of the topic to delete.
573
+ # Format is `projects/`project`/topics/`topic``.
539
574
  # @param [String] quota_user
540
575
  # Available to use for quota purposes for server-side applications. Can be any
541
576
  # arbitrary string assigned to a user, but should not exceed 40 characters.
577
+ # @param [String] fields
578
+ # Selector specifying which fields to include in a partial response.
542
579
  # @param [Google::Apis::RequestOptions] options
543
580
  # Request-specific options
544
581
  #
545
582
  # @yield [result, err] Result & error if block supplied
546
- # @yieldparam result [Google::Apis::PubsubV1::ListSubscriptionsResponse] parsed result object
583
+ # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
547
584
  # @yieldparam err [StandardError] error object if request failed
548
585
  #
549
- # @return [Google::Apis::PubsubV1::ListSubscriptionsResponse]
586
+ # @return [Google::Apis::PubsubV1::Empty]
550
587
  #
551
588
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
552
589
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
553
590
  # @raise [Google::Apis::AuthorizationError] Authorization is required
554
- def list_subscriptions(project, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
555
- command = make_simple_command(:get, 'v1/{+project}/subscriptions', options)
556
- command.response_representation = Google::Apis::PubsubV1::ListSubscriptionsResponse::Representation
557
- command.response_class = Google::Apis::PubsubV1::ListSubscriptionsResponse
558
- command.params['project'] = project unless project.nil?
559
- command.query['pageToken'] = page_token unless page_token.nil?
560
- command.query['pageSize'] = page_size unless page_size.nil?
561
- command.query['fields'] = fields unless fields.nil?
591
+ def delete_topic(topic, quota_user: nil, fields: nil, options: nil, &block)
592
+ command = make_simple_command(:delete, 'v1/{+topic}', options)
593
+ command.response_representation = Google::Apis::PubsubV1::Empty::Representation
594
+ command.response_class = Google::Apis::PubsubV1::Empty
595
+ command.params['topic'] = topic unless topic.nil?
562
596
  command.query['quotaUser'] = quota_user unless quota_user.nil?
597
+ command.query['fields'] = fields unless fields.nil?
563
598
  execute_or_queue_command(command, &block)
564
599
  end
565
600
 
566
- # Creates a subscription to a given topic.
567
- # If the subscription already exists, returns `ALREADY_EXISTS`.
568
- # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
569
- # If the name is not provided in the request, the server will assign a random
570
- # name for this subscription on the same project as the topic, conforming
571
- # to the
572
- # [resource name format](https://cloud.google.com/pubsub/docs/overview#names).
573
- # The generated name is populated in the returned Subscription object.
574
- # Note that for REST API requests, you must specify a name in the request.
575
- # @param [String] name
576
- # The name of the subscription. It must have the format
577
- # `"projects/`project`/subscriptions/`subscription`"`. ``subscription`` must
578
- # start with a letter, and contain only letters (`[A-Za-z]`), numbers
579
- # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
580
- # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
581
- # in length, and it must not start with `"goog"`.
582
- # @param [Google::Apis::PubsubV1::Subscription] subscription_object
583
- # @param [String] fields
584
- # Selector specifying which fields to include in a partial response.
601
+ # Lists matching topics.
602
+ # @param [String] project
603
+ # The name of the cloud project that topics belong to.
604
+ # Format is `projects/`project``.
605
+ # @param [String] page_token
606
+ # The value returned by the last `ListTopicsResponse`; indicates that this is
607
+ # a continuation of a prior `ListTopics` call, and that the system should
608
+ # return the next page of data.
609
+ # @param [Fixnum] page_size
610
+ # Maximum number of topics to return.
585
611
  # @param [String] quota_user
586
612
  # Available to use for quota purposes for server-side applications. Can be any
587
613
  # arbitrary string assigned to a user, but should not exceed 40 characters.
614
+ # @param [String] fields
615
+ # Selector specifying which fields to include in a partial response.
588
616
  # @param [Google::Apis::RequestOptions] options
589
617
  # Request-specific options
590
618
  #
591
619
  # @yield [result, err] Result & error if block supplied
592
- # @yieldparam result [Google::Apis::PubsubV1::Subscription] parsed result object
620
+ # @yieldparam result [Google::Apis::PubsubV1::ListTopicsResponse] parsed result object
593
621
  # @yieldparam err [StandardError] error object if request failed
594
622
  #
595
- # @return [Google::Apis::PubsubV1::Subscription]
623
+ # @return [Google::Apis::PubsubV1::ListTopicsResponse]
596
624
  #
597
625
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
598
626
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
599
627
  # @raise [Google::Apis::AuthorizationError] Authorization is required
600
- def create_subscription(name, subscription_object = nil, fields: nil, quota_user: nil, options: nil, &block)
601
- command = make_simple_command(:put, 'v1/{+name}', options)
602
- command.request_representation = Google::Apis::PubsubV1::Subscription::Representation
603
- command.request_object = subscription_object
604
- command.response_representation = Google::Apis::PubsubV1::Subscription::Representation
605
- command.response_class = Google::Apis::PubsubV1::Subscription
606
- command.params['name'] = name unless name.nil?
607
- command.query['fields'] = fields unless fields.nil?
628
+ def list_topics(project, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
629
+ command = make_simple_command(:get, 'v1/{+project}/topics', options)
630
+ command.response_representation = Google::Apis::PubsubV1::ListTopicsResponse::Representation
631
+ command.response_class = Google::Apis::PubsubV1::ListTopicsResponse
632
+ command.params['project'] = project unless project.nil?
633
+ command.query['pageToken'] = page_token unless page_token.nil?
634
+ command.query['pageSize'] = page_size unless page_size.nil?
608
635
  command.query['quotaUser'] = quota_user unless quota_user.nil?
636
+ command.query['fields'] = fields unless fields.nil?
609
637
  execute_or_queue_command(command, &block)
610
638
  end
611
639
 
@@ -613,14 +641,13 @@ module Google
613
641
  # existing policy.
614
642
  # @param [String] resource
615
643
  # REQUIRED: The resource for which the policy is being specified.
616
- # `resource` is usually specified as a path. For example, a Project
617
- # resource is specified as `projects/`project``.
644
+ # See the operation documentation for the appropriate value for this field.
618
645
  # @param [Google::Apis::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
619
- # @param [String] fields
620
- # Selector specifying which fields to include in a partial response.
621
646
  # @param [String] quota_user
622
647
  # Available to use for quota purposes for server-side applications. Can be any
623
648
  # arbitrary string assigned to a user, but should not exceed 40 characters.
649
+ # @param [String] fields
650
+ # Selector specifying which fields to include in a partial response.
624
651
  # @param [Google::Apis::RequestOptions] options
625
652
  # Request-specific options
626
653
  #
@@ -633,92 +660,53 @@ module Google
633
660
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
634
661
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
635
662
  # @raise [Google::Apis::AuthorizationError] Authorization is required
636
- def set_subscription_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
663
+ def set_topic_iam_policy(resource, set_iam_policy_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
637
664
  command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
638
665
  command.request_representation = Google::Apis::PubsubV1::SetIamPolicyRequest::Representation
639
666
  command.request_object = set_iam_policy_request_object
640
667
  command.response_representation = Google::Apis::PubsubV1::Policy::Representation
641
668
  command.response_class = Google::Apis::PubsubV1::Policy
642
669
  command.params['resource'] = resource unless resource.nil?
643
- command.query['fields'] = fields unless fields.nil?
644
670
  command.query['quotaUser'] = quota_user unless quota_user.nil?
671
+ command.query['fields'] = fields unless fields.nil?
645
672
  execute_or_queue_command(command, &block)
646
673
  end
647
674
 
648
- # Acknowledges the messages associated with the `ack_ids` in the
649
- # `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
650
- # from the subscription.
651
- # Acknowledging a message whose ack deadline has expired may succeed,
652
- # but such a message may be redelivered later. Acknowledging a message more
653
- # than once will not result in an error.
654
- # @param [String] subscription
655
- # The subscription whose message is being acknowledged.
656
- # Format is `projects/`project`/subscriptions/`sub``.
657
- # @param [Google::Apis::PubsubV1::AcknowledgeRequest] acknowledge_request_object
658
- # @param [String] fields
659
- # Selector specifying which fields to include in a partial response.
675
+ # Creates the given topic with the given name.
676
+ # @param [String] name
677
+ # The name of the topic. It must have the format
678
+ # `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter,
679
+ # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
680
+ # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
681
+ # signs (`%`). It must be between 3 and 255 characters in length, and it
682
+ # must not start with `"goog"`.
683
+ # @param [Google::Apis::PubsubV1::Topic] topic_object
660
684
  # @param [String] quota_user
661
685
  # Available to use for quota purposes for server-side applications. Can be any
662
686
  # arbitrary string assigned to a user, but should not exceed 40 characters.
663
- # @param [Google::Apis::RequestOptions] options
664
- # Request-specific options
665
- #
666
- # @yield [result, err] Result & error if block supplied
667
- # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
668
- # @yieldparam err [StandardError] error object if request failed
669
- #
670
- # @return [Google::Apis::PubsubV1::Empty]
671
- #
672
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
673
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
674
- # @raise [Google::Apis::AuthorizationError] Authorization is required
675
- def acknowledge_subscription(subscription, acknowledge_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
676
- command = make_simple_command(:post, 'v1/{+subscription}:acknowledge', options)
677
- command.request_representation = Google::Apis::PubsubV1::AcknowledgeRequest::Representation
678
- command.request_object = acknowledge_request_object
679
- command.response_representation = Google::Apis::PubsubV1::Empty::Representation
680
- command.response_class = Google::Apis::PubsubV1::Empty
681
- command.params['subscription'] = subscription unless subscription.nil?
682
- command.query['fields'] = fields unless fields.nil?
683
- command.query['quotaUser'] = quota_user unless quota_user.nil?
684
- execute_or_queue_command(command, &block)
685
- end
686
-
687
- # Modifies the ack deadline for a specific message. This method is useful
688
- # to indicate that more time is needed to process a message by the
689
- # subscriber, or to make the message available for redelivery if the
690
- # processing was interrupted. Note that this does not modify the
691
- # subscription-level `ackDeadlineSeconds` used for subsequent messages.
692
- # @param [String] subscription
693
- # The name of the subscription.
694
- # Format is `projects/`project`/subscriptions/`sub``.
695
- # @param [Google::Apis::PubsubV1::ModifyAckDeadlineRequest] modify_ack_deadline_request_object
696
687
  # @param [String] fields
697
688
  # Selector specifying which fields to include in a partial response.
698
- # @param [String] quota_user
699
- # Available to use for quota purposes for server-side applications. Can be any
700
- # arbitrary string assigned to a user, but should not exceed 40 characters.
701
689
  # @param [Google::Apis::RequestOptions] options
702
690
  # Request-specific options
703
691
  #
704
692
  # @yield [result, err] Result & error if block supplied
705
- # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
693
+ # @yieldparam result [Google::Apis::PubsubV1::Topic] parsed result object
706
694
  # @yieldparam err [StandardError] error object if request failed
707
695
  #
708
- # @return [Google::Apis::PubsubV1::Empty]
696
+ # @return [Google::Apis::PubsubV1::Topic]
709
697
  #
710
698
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
711
699
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
712
700
  # @raise [Google::Apis::AuthorizationError] Authorization is required
713
- def modify_subscription_ack_deadline(subscription, modify_ack_deadline_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
714
- command = make_simple_command(:post, 'v1/{+subscription}:modifyAckDeadline', options)
715
- command.request_representation = Google::Apis::PubsubV1::ModifyAckDeadlineRequest::Representation
716
- command.request_object = modify_ack_deadline_request_object
717
- command.response_representation = Google::Apis::PubsubV1::Empty::Representation
718
- command.response_class = Google::Apis::PubsubV1::Empty
719
- command.params['subscription'] = subscription unless subscription.nil?
720
- command.query['fields'] = fields unless fields.nil?
701
+ def create_topic(name, topic_object = nil, quota_user: nil, fields: nil, options: nil, &block)
702
+ command = make_simple_command(:put, 'v1/{+name}', options)
703
+ command.request_representation = Google::Apis::PubsubV1::Topic::Representation
704
+ command.request_object = topic_object
705
+ command.response_representation = Google::Apis::PubsubV1::Topic::Representation
706
+ command.response_class = Google::Apis::PubsubV1::Topic
707
+ command.params['name'] = name unless name.nil?
721
708
  command.query['quotaUser'] = quota_user unless quota_user.nil?
709
+ command.query['fields'] = fields unless fields.nil?
722
710
  execute_or_queue_command(command, &block)
723
711
  end
724
712
 
@@ -727,13 +715,12 @@ module Google
727
715
  # set.
728
716
  # @param [String] resource
729
717
  # REQUIRED: The resource for which the policy is being requested.
730
- # `resource` is usually specified as a path. For example, a Project
731
- # resource is specified as `projects/`project``.
732
- # @param [String] fields
733
- # Selector specifying which fields to include in a partial response.
718
+ # See the operation documentation for the appropriate value for this field.
734
719
  # @param [String] quota_user
735
720
  # Available to use for quota purposes for server-side applications. Can be any
736
721
  # arbitrary string assigned to a user, but should not exceed 40 characters.
722
+ # @param [String] fields
723
+ # Selector specifying which fields to include in a partial response.
737
724
  # @param [Google::Apis::RequestOptions] options
738
725
  # Request-specific options
739
726
  #
@@ -746,80 +733,80 @@ module Google
746
733
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
747
734
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
748
735
  # @raise [Google::Apis::AuthorizationError] Authorization is required
749
- def get_project_subscription_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
736
+ def get_project_topic_iam_policy(resource, quota_user: nil, fields: nil, options: nil, &block)
750
737
  command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
751
738
  command.response_representation = Google::Apis::PubsubV1::Policy::Representation
752
739
  command.response_class = Google::Apis::PubsubV1::Policy
753
740
  command.params['resource'] = resource unless resource.nil?
754
- command.query['fields'] = fields unless fields.nil?
755
741
  command.query['quotaUser'] = quota_user unless quota_user.nil?
742
+ command.query['fields'] = fields unless fields.nil?
756
743
  execute_or_queue_command(command, &block)
757
744
  end
758
745
 
759
- # Gets the configuration details of a subscription.
760
- # @param [String] subscription
761
- # The name of the subscription to get.
762
- # Format is `projects/`project`/subscriptions/`sub``.
763
- # @param [String] fields
764
- # Selector specifying which fields to include in a partial response.
746
+ # Gets the configuration of a topic.
747
+ # @param [String] topic
748
+ # The name of the topic to get.
749
+ # Format is `projects/`project`/topics/`topic``.
765
750
  # @param [String] quota_user
766
751
  # Available to use for quota purposes for server-side applications. Can be any
767
752
  # arbitrary string assigned to a user, but should not exceed 40 characters.
753
+ # @param [String] fields
754
+ # Selector specifying which fields to include in a partial response.
768
755
  # @param [Google::Apis::RequestOptions] options
769
756
  # Request-specific options
770
757
  #
771
758
  # @yield [result, err] Result & error if block supplied
772
- # @yieldparam result [Google::Apis::PubsubV1::Subscription] parsed result object
759
+ # @yieldparam result [Google::Apis::PubsubV1::Topic] parsed result object
773
760
  # @yieldparam err [StandardError] error object if request failed
774
761
  #
775
- # @return [Google::Apis::PubsubV1::Subscription]
762
+ # @return [Google::Apis::PubsubV1::Topic]
776
763
  #
777
764
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
778
765
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
779
766
  # @raise [Google::Apis::AuthorizationError] Authorization is required
780
- def get_subscription(subscription, fields: nil, quota_user: nil, options: nil, &block)
781
- command = make_simple_command(:get, 'v1/{+subscription}', options)
782
- command.response_representation = Google::Apis::PubsubV1::Subscription::Representation
783
- command.response_class = Google::Apis::PubsubV1::Subscription
784
- command.params['subscription'] = subscription unless subscription.nil?
785
- command.query['fields'] = fields unless fields.nil?
767
+ def get_topic(topic, quota_user: nil, fields: nil, options: nil, &block)
768
+ command = make_simple_command(:get, 'v1/{+topic}', options)
769
+ command.response_representation = Google::Apis::PubsubV1::Topic::Representation
770
+ command.response_class = Google::Apis::PubsubV1::Topic
771
+ command.params['topic'] = topic unless topic.nil?
786
772
  command.query['quotaUser'] = quota_user unless quota_user.nil?
773
+ command.query['fields'] = fields unless fields.nil?
787
774
  execute_or_queue_command(command, &block)
788
775
  end
789
776
 
790
- # Sets the access control policy on the specified resource. Replaces any
791
- # existing policy.
792
- # @param [String] resource
793
- # REQUIRED: The resource for which the policy is being specified.
794
- # `resource` is usually specified as a path. For example, a Project
795
- # resource is specified as `projects/`project``.
796
- # @param [Google::Apis::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
797
- # @param [String] fields
798
- # Selector specifying which fields to include in a partial response.
777
+ # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
778
+ # does not exist. The message payload must not be empty; it must contain
779
+ # either a non-empty data field, or at least one attribute.
780
+ # @param [String] topic
781
+ # The messages in the request will be published on this topic.
782
+ # Format is `projects/`project`/topics/`topic``.
783
+ # @param [Google::Apis::PubsubV1::PublishRequest] publish_request_object
799
784
  # @param [String] quota_user
800
785
  # Available to use for quota purposes for server-side applications. Can be any
801
786
  # arbitrary string assigned to a user, but should not exceed 40 characters.
787
+ # @param [String] fields
788
+ # Selector specifying which fields to include in a partial response.
802
789
  # @param [Google::Apis::RequestOptions] options
803
790
  # Request-specific options
804
791
  #
805
792
  # @yield [result, err] Result & error if block supplied
806
- # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
793
+ # @yieldparam result [Google::Apis::PubsubV1::PublishResponse] parsed result object
807
794
  # @yieldparam err [StandardError] error object if request failed
808
795
  #
809
- # @return [Google::Apis::PubsubV1::Policy]
796
+ # @return [Google::Apis::PubsubV1::PublishResponse]
810
797
  #
811
798
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
812
799
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
813
800
  # @raise [Google::Apis::AuthorizationError] Authorization is required
814
- def set_snapshot_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
815
- command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
816
- command.request_representation = Google::Apis::PubsubV1::SetIamPolicyRequest::Representation
817
- command.request_object = set_iam_policy_request_object
818
- command.response_representation = Google::Apis::PubsubV1::Policy::Representation
819
- command.response_class = Google::Apis::PubsubV1::Policy
820
- command.params['resource'] = resource unless resource.nil?
821
- command.query['fields'] = fields unless fields.nil?
801
+ def publish_topic(topic, publish_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
802
+ command = make_simple_command(:post, 'v1/{+topic}:publish', options)
803
+ command.request_representation = Google::Apis::PubsubV1::PublishRequest::Representation
804
+ command.request_object = publish_request_object
805
+ command.response_representation = Google::Apis::PubsubV1::PublishResponse::Representation
806
+ command.response_class = Google::Apis::PubsubV1::PublishResponse
807
+ command.params['topic'] = topic unless topic.nil?
822
808
  command.query['quotaUser'] = quota_user unless quota_user.nil?
809
+ command.query['fields'] = fields unless fields.nil?
823
810
  execute_or_queue_command(command, &block)
824
811
  end
825
812
 
@@ -831,14 +818,13 @@ module Google
831
818
  # may "fail open" without warning.
832
819
  # @param [String] resource
833
820
  # REQUIRED: The resource for which the policy detail is being requested.
834
- # `resource` is usually specified as a path. For example, a Project
835
- # resource is specified as `projects/`project``.
821
+ # See the operation documentation for the appropriate value for this field.
836
822
  # @param [Google::Apis::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
837
- # @param [String] fields
838
- # Selector specifying which fields to include in a partial response.
839
823
  # @param [String] quota_user
840
824
  # Available to use for quota purposes for server-side applications. Can be any
841
825
  # arbitrary string assigned to a user, but should not exceed 40 characters.
826
+ # @param [String] fields
827
+ # Selector specifying which fields to include in a partial response.
842
828
  # @param [Google::Apis::RequestOptions] options
843
829
  # Request-specific options
844
830
  #
@@ -851,49 +837,54 @@ module Google
851
837
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
852
838
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
853
839
  # @raise [Google::Apis::AuthorizationError] Authorization is required
854
- def test_snapshot_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
840
+ def test_topic_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
855
841
  command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
856
842
  command.request_representation = Google::Apis::PubsubV1::TestIamPermissionsRequest::Representation
857
843
  command.request_object = test_iam_permissions_request_object
858
844
  command.response_representation = Google::Apis::PubsubV1::TestIamPermissionsResponse::Representation
859
845
  command.response_class = Google::Apis::PubsubV1::TestIamPermissionsResponse
860
846
  command.params['resource'] = resource unless resource.nil?
861
- command.query['fields'] = fields unless fields.nil?
862
847
  command.query['quotaUser'] = quota_user unless quota_user.nil?
848
+ command.query['fields'] = fields unless fields.nil?
863
849
  execute_or_queue_command(command, &block)
864
850
  end
865
851
 
866
- # Gets the access control policy for a resource.
867
- # Returns an empty policy if the resource exists and does not have a policy
868
- # set.
869
- # @param [String] resource
870
- # REQUIRED: The resource for which the policy is being requested.
871
- # `resource` is usually specified as a path. For example, a Project
872
- # resource is specified as `projects/`project``.
873
- # @param [String] fields
874
- # Selector specifying which fields to include in a partial response.
852
+ # Lists the name of the subscriptions for this topic.
853
+ # @param [String] topic
854
+ # The name of the topic that subscriptions are attached to.
855
+ # Format is `projects/`project`/topics/`topic``.
856
+ # @param [String] page_token
857
+ # The value returned by the last `ListTopicSubscriptionsResponse`; indicates
858
+ # that this is a continuation of a prior `ListTopicSubscriptions` call, and
859
+ # that the system should return the next page of data.
860
+ # @param [Fixnum] page_size
861
+ # Maximum number of subscription names to return.
875
862
  # @param [String] quota_user
876
863
  # Available to use for quota purposes for server-side applications. Can be any
877
864
  # arbitrary string assigned to a user, but should not exceed 40 characters.
865
+ # @param [String] fields
866
+ # Selector specifying which fields to include in a partial response.
878
867
  # @param [Google::Apis::RequestOptions] options
879
868
  # Request-specific options
880
869
  #
881
870
  # @yield [result, err] Result & error if block supplied
882
- # @yieldparam result [Google::Apis::PubsubV1::Policy] parsed result object
871
+ # @yieldparam result [Google::Apis::PubsubV1::ListTopicSubscriptionsResponse] parsed result object
883
872
  # @yieldparam err [StandardError] error object if request failed
884
873
  #
885
- # @return [Google::Apis::PubsubV1::Policy]
874
+ # @return [Google::Apis::PubsubV1::ListTopicSubscriptionsResponse]
886
875
  #
887
876
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
888
877
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
889
878
  # @raise [Google::Apis::AuthorizationError] Authorization is required
890
- def get_project_snapshot_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
891
- command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
892
- command.response_representation = Google::Apis::PubsubV1::Policy::Representation
893
- command.response_class = Google::Apis::PubsubV1::Policy
894
- command.params['resource'] = resource unless resource.nil?
895
- command.query['fields'] = fields unless fields.nil?
879
+ def list_topic_subscriptions(topic, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
880
+ command = make_simple_command(:get, 'v1/{+topic}/subscriptions', options)
881
+ command.response_representation = Google::Apis::PubsubV1::ListTopicSubscriptionsResponse::Representation
882
+ command.response_class = Google::Apis::PubsubV1::ListTopicSubscriptionsResponse
883
+ command.params['topic'] = topic unless topic.nil?
884
+ command.query['pageToken'] = page_token unless page_token.nil?
885
+ command.query['pageSize'] = page_size unless page_size.nil?
896
886
  command.query['quotaUser'] = quota_user unless quota_user.nil?
887
+ command.query['fields'] = fields unless fields.nil?
897
888
  execute_or_queue_command(command, &block)
898
889
  end
899
890