google-api-client 0.13.0 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (241) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +3 -0
  3. data/README.md +6 -2
  4. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +46 -46
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +15 -15
  6. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +4 -4
  7. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +404 -435
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +107 -121
  10. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +657 -713
  11. data/generated/google/apis/admin_directory_v1.rb +1 -1
  12. data/generated/google/apis/admin_directory_v1/classes.rb +45 -5
  13. data/generated/google/apis/admin_directory_v1/representations.rb +16 -0
  14. data/generated/google/apis/admin_directory_v1/service.rb +4 -1
  15. data/generated/google/apis/admin_reports_v1.rb +1 -1
  16. data/generated/google/apis/adsense_v1_4.rb +1 -1
  17. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  18. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  19. data/generated/google/apis/analyticsreporting_v4/classes.rb +399 -399
  20. data/generated/google/apis/analyticsreporting_v4/representations.rb +101 -101
  21. data/generated/google/apis/analyticsreporting_v4/service.rb +10 -10
  22. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  23. data/generated/google/apis/appengine_v1.rb +4 -4
  24. data/generated/google/apis/appengine_v1/classes.rb +747 -747
  25. data/generated/google/apis/appengine_v1/representations.rb +158 -158
  26. data/generated/google/apis/appengine_v1/service.rb +214 -214
  27. data/generated/google/apis/appsactivity_v1.rb +1 -1
  28. data/generated/google/apis/appstate_v1.rb +1 -1
  29. data/generated/google/apis/bigquery_v2.rb +1 -1
  30. data/generated/google/apis/bigquery_v2/classes.rb +6 -0
  31. data/generated/google/apis/bigquery_v2/representations.rb +2 -0
  32. data/generated/google/apis/calendar_v3.rb +1 -1
  33. data/generated/google/apis/classroom_v1.rb +7 -7
  34. data/generated/google/apis/classroom_v1/classes.rb +517 -515
  35. data/generated/google/apis/classroom_v1/representations.rb +147 -147
  36. data/generated/google/apis/classroom_v1/service.rb +1144 -1143
  37. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  38. data/generated/google/apis/cloudbuild_v1/classes.rb +435 -386
  39. data/generated/google/apis/cloudbuild_v1/representations.rb +133 -115
  40. data/generated/google/apis/cloudbuild_v1/service.rb +148 -148
  41. data/generated/google/apis/clouddebugger_v2.rb +1 -1
  42. data/generated/google/apis/clouddebugger_v2/classes.rb +708 -708
  43. data/generated/google/apis/clouddebugger_v2/representations.rb +146 -146
  44. data/generated/google/apis/clouddebugger_v2/service.rb +124 -124
  45. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  46. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +142 -142
  47. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +29 -29
  48. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +87 -87
  49. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  50. data/generated/google/apis/cloudfunctions_v1/service.rb +6 -6
  51. data/generated/google/apis/cloudkms_v1.rb +1 -1
  52. data/generated/google/apis/cloudkms_v1/classes.rb +692 -675
  53. data/generated/google/apis/cloudkms_v1/representations.rb +144 -144
  54. data/generated/google/apis/cloudkms_v1/service.rb +276 -276
  55. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  56. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1168 -1168
  57. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +190 -190
  58. data/generated/google/apis/cloudresourcemanager_v1/service.rb +311 -288
  59. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +4 -4
  60. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +406 -406
  61. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +95 -95
  62. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +242 -234
  63. data/generated/google/apis/cloudtrace_v1.rb +4 -4
  64. data/generated/google/apis/cloudtrace_v1/classes.rb +68 -68
  65. data/generated/google/apis/cloudtrace_v1/representations.rb +22 -22
  66. data/generated/google/apis/cloudtrace_v1/service.rb +48 -48
  67. data/generated/google/apis/compute_beta.rb +1 -1
  68. data/generated/google/apis/compute_beta/classes.rb +82 -6
  69. data/generated/google/apis/compute_beta/representations.rb +4 -0
  70. data/generated/google/apis/compute_beta/service.rb +1177 -834
  71. data/generated/google/apis/compute_v1.rb +1 -1
  72. data/generated/google/apis/compute_v1/classes.rb +371 -1
  73. data/generated/google/apis/compute_v1/representations.rb +139 -0
  74. data/generated/google/apis/compute_v1/service.rb +257 -9
  75. data/generated/google/apis/container_v1.rb +1 -1
  76. data/generated/google/apis/container_v1/classes.rb +1122 -826
  77. data/generated/google/apis/container_v1/representations.rb +279 -135
  78. data/generated/google/apis/container_v1/service.rb +440 -98
  79. data/generated/google/apis/content_v2.rb +1 -1
  80. data/generated/google/apis/content_v2/service.rb +3 -1
  81. data/generated/google/apis/customsearch_v1.rb +1 -1
  82. data/generated/google/apis/dataflow_v1b3.rb +4 -4
  83. data/generated/google/apis/dataflow_v1b3/classes.rb +3423 -3423
  84. data/generated/google/apis/dataflow_v1b3/representations.rb +813 -813
  85. data/generated/google/apis/dataflow_v1b3/service.rb +410 -410
  86. data/generated/google/apis/dataproc_v1.rb +1 -1
  87. data/generated/google/apis/dataproc_v1/classes.rb +450 -431
  88. data/generated/google/apis/dataproc_v1/representations.rb +92 -92
  89. data/generated/google/apis/dataproc_v1/service.rb +200 -200
  90. data/generated/google/apis/datastore_v1.rb +4 -4
  91. data/generated/google/apis/datastore_v1/classes.rb +397 -397
  92. data/generated/google/apis/datastore_v1/representations.rb +100 -100
  93. data/generated/google/apis/datastore_v1/service.rb +62 -62
  94. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  95. data/generated/google/apis/deploymentmanager_v2/classes.rb +79 -3
  96. data/generated/google/apis/deploymentmanager_v2/representations.rb +33 -0
  97. data/generated/google/apis/deploymentmanager_v2/service.rb +15 -20
  98. data/generated/google/apis/dns_v1.rb +1 -1
  99. data/generated/google/apis/dns_v2beta1.rb +1 -1
  100. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  101. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +2 -2
  102. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  103. data/generated/google/apis/drive_v2.rb +1 -1
  104. data/generated/google/apis/drive_v2/service.rb +1 -1
  105. data/generated/google/apis/drive_v3.rb +1 -1
  106. data/generated/google/apis/drive_v3/service.rb +1 -1
  107. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  108. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +87 -87
  109. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +27 -27
  110. data/generated/google/apis/firebaserules_v1/classes.rb +271 -271
  111. data/generated/google/apis/firebaserules_v1/representations.rb +82 -82
  112. data/generated/google/apis/firebaserules_v1/service.rb +151 -151
  113. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  114. data/generated/google/apis/games_management_v1management.rb +1 -1
  115. data/generated/google/apis/games_v1.rb +1 -1
  116. data/generated/google/apis/genomics_v1.rb +9 -9
  117. data/generated/google/apis/genomics_v1/classes.rb +2242 -2242
  118. data/generated/google/apis/genomics_v1/representations.rb +306 -306
  119. data/generated/google/apis/genomics_v1/service.rb +1172 -1172
  120. data/generated/google/apis/gmail_v1.rb +1 -1
  121. data/generated/google/apis/iam_v1.rb +1 -1
  122. data/generated/google/apis/iam_v1/classes.rb +243 -243
  123. data/generated/google/apis/iam_v1/representations.rb +79 -79
  124. data/generated/google/apis/iam_v1/service.rb +137 -137
  125. data/generated/google/apis/identitytoolkit_v3.rb +1 -1
  126. data/generated/google/apis/identitytoolkit_v3/classes.rb +18 -0
  127. data/generated/google/apis/identitytoolkit_v3/representations.rb +3 -0
  128. data/generated/google/apis/kgsearch_v1/classes.rb +9 -9
  129. data/generated/google/apis/kgsearch_v1/representations.rb +2 -2
  130. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  131. data/generated/google/apis/language_v1.rb +1 -1
  132. data/generated/google/apis/language_v1/classes.rb +451 -451
  133. data/generated/google/apis/language_v1/representations.rb +103 -103
  134. data/generated/google/apis/language_v1/service.rb +49 -49
  135. data/generated/google/apis/language_v1beta1.rb +1 -1
  136. data/generated/google/apis/language_v1beta1/classes.rb +459 -459
  137. data/generated/google/apis/language_v1beta1/representations.rb +110 -110
  138. data/generated/google/apis/language_v1beta1/service.rb +43 -43
  139. data/generated/google/apis/logging_v2.rb +8 -8
  140. data/generated/google/apis/logging_v2/classes.rb +915 -915
  141. data/generated/google/apis/logging_v2/representations.rb +142 -142
  142. data/generated/google/apis/logging_v2/service.rb +415 -415
  143. data/generated/google/apis/logging_v2beta1.rb +8 -8
  144. data/generated/google/apis/logging_v2beta1/classes.rb +905 -905
  145. data/generated/google/apis/logging_v2beta1/representations.rb +150 -150
  146. data/generated/google/apis/logging_v2beta1/service.rb +221 -221
  147. data/generated/google/apis/manufacturers_v1.rb +1 -1
  148. data/generated/google/apis/manufacturers_v1/classes.rb +334 -315
  149. data/generated/google/apis/manufacturers_v1/representations.rb +99 -87
  150. data/generated/google/apis/manufacturers_v1/service.rb +101 -4
  151. data/generated/google/apis/ml_v1.rb +1 -1
  152. data/generated/google/apis/ml_v1/classes.rb +709 -673
  153. data/generated/google/apis/ml_v1/representations.rb +154 -151
  154. data/generated/google/apis/ml_v1/service.rb +341 -354
  155. data/generated/google/apis/monitoring_v3.rb +6 -6
  156. data/generated/google/apis/monitoring_v3/classes.rb +869 -869
  157. data/generated/google/apis/monitoring_v3/representations.rb +171 -171
  158. data/generated/google/apis/monitoring_v3/service.rb +340 -340
  159. data/generated/google/apis/partners_v2.rb +1 -1
  160. data/generated/google/apis/partners_v2/classes.rb +1569 -1569
  161. data/generated/google/apis/partners_v2/representations.rb +256 -256
  162. data/generated/google/apis/partners_v2/service.rb +530 -530
  163. data/generated/google/apis/people_v1.rb +7 -7
  164. data/generated/google/apis/people_v1/classes.rb +1287 -946
  165. data/generated/google/apis/people_v1/representations.rb +355 -203
  166. data/generated/google/apis/people_v1/service.rb +409 -32
  167. data/generated/google/apis/plus_domains_v1.rb +1 -1
  168. data/generated/google/apis/plus_v1.rb +1 -1
  169. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  170. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +445 -445
  171. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +104 -104
  172. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +241 -241
  173. data/generated/google/apis/pubsub_v1.rb +4 -4
  174. data/generated/google/apis/pubsub_v1/classes.rb +286 -287
  175. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  176. data/generated/google/apis/pubsub_v1/service.rb +178 -178
  177. data/generated/google/apis/runtimeconfig_v1.rb +1 -1
  178. data/generated/google/apis/runtimeconfig_v1/classes.rb +52 -52
  179. data/generated/google/apis/runtimeconfig_v1/representations.rb +15 -15
  180. data/generated/google/apis/runtimeconfig_v1/service.rb +21 -21
  181. data/generated/google/apis/script_v1.rb +4 -4
  182. data/generated/google/apis/script_v1/classes.rb +172 -172
  183. data/generated/google/apis/script_v1/representations.rb +41 -41
  184. data/generated/google/apis/script_v1/service.rb +6 -6
  185. data/generated/google/apis/searchconsole_v1.rb +1 -1
  186. data/generated/google/apis/searchconsole_v1/classes.rb +6 -6
  187. data/generated/google/apis/searchconsole_v1/representations.rb +1 -1
  188. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  189. data/generated/google/apis/servicecontrol_v1/classes.rb +1110 -1110
  190. data/generated/google/apis/servicecontrol_v1/representations.rb +215 -215
  191. data/generated/google/apis/servicecontrol_v1/service.rb +65 -65
  192. data/generated/google/apis/servicemanagement_v1.rb +6 -6
  193. data/generated/google/apis/servicemanagement_v1/classes.rb +3594 -3562
  194. data/generated/google/apis/servicemanagement_v1/representations.rb +564 -562
  195. data/generated/google/apis/servicemanagement_v1/service.rb +253 -253
  196. data/generated/google/apis/serviceuser_v1.rb +1 -1
  197. data/generated/google/apis/serviceuser_v1/classes.rb +2678 -2670
  198. data/generated/google/apis/serviceuser_v1/representations.rb +269 -268
  199. data/generated/google/apis/serviceuser_v1/service.rb +59 -59
  200. data/generated/google/apis/sheets_v4.rb +5 -5
  201. data/generated/google/apis/sheets_v4/classes.rb +5155 -5104
  202. data/generated/google/apis/sheets_v4/representations.rb +957 -940
  203. data/generated/google/apis/sheets_v4/service.rb +175 -175
  204. data/generated/google/apis/slides_v1.rb +1 -1
  205. data/generated/google/apis/slides_v1/classes.rb +2932 -2905
  206. data/generated/google/apis/slides_v1/representations.rb +709 -694
  207. data/generated/google/apis/slides_v1/service.rb +50 -50
  208. data/generated/google/apis/sourcerepo_v1/classes.rb +139 -139
  209. data/generated/google/apis/sourcerepo_v1/representations.rb +40 -40
  210. data/generated/google/apis/sourcerepo_v1/service.rb +61 -61
  211. data/generated/google/apis/spanner_v1.rb +7 -1
  212. data/generated/google/apis/spanner_v1/classes.rb +2362 -2299
  213. data/generated/google/apis/spanner_v1/representations.rb +342 -323
  214. data/generated/google/apis/spanner_v1/service.rb +502 -492
  215. data/generated/google/apis/speech_v1beta1.rb +1 -1
  216. data/generated/google/apis/speech_v1beta1/classes.rb +244 -244
  217. data/generated/google/apis/speech_v1beta1/representations.rb +52 -52
  218. data/generated/google/apis/speech_v1beta1/service.rb +91 -91
  219. data/generated/google/apis/storage_v1.rb +1 -1
  220. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  221. data/generated/google/apis/storagetransfer_v1/classes.rb +784 -781
  222. data/generated/google/apis/storagetransfer_v1/representations.rb +88 -88
  223. data/generated/google/apis/storagetransfer_v1/service.rb +154 -154
  224. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  225. data/generated/google/apis/toolresults_v1beta3/classes.rb +90 -1
  226. data/generated/google/apis/toolresults_v1beta3/representations.rb +18 -0
  227. data/generated/google/apis/translate_v2/classes.rb +107 -107
  228. data/generated/google/apis/translate_v2/representations.rb +49 -49
  229. data/generated/google/apis/translate_v2/service.rb +81 -81
  230. data/generated/google/apis/vision_v1.rb +4 -1
  231. data/generated/google/apis/vision_v1/classes.rb +527 -527
  232. data/generated/google/apis/vision_v1/representations.rb +115 -115
  233. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  234. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  235. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  236. data/generated/google/apis/youtubereporting_v1/classes.rb +124 -124
  237. data/generated/google/apis/youtubereporting_v1/representations.rb +30 -30
  238. data/generated/google/apis/youtubereporting_v1/service.rb +113 -113
  239. data/lib/google/apis/version.rb +1 -1
  240. data/samples/cli/lib/samples/analytics.rb +2 -2
  241. metadata +2 -2
@@ -47,16 +47,292 @@ module Google
47
47
  @batch_path = 'batch'
48
48
  end
49
49
 
50
+ # Delete an existing contact group owned by the authenticated user by
51
+ # specifying a contact group resource name.
52
+ # @param [String] resource_name
53
+ # The resource name of the contact group to delete.
54
+ # @param [Boolean] delete_contacts
55
+ # Set to true to also delete the contacts in the specified group.
56
+ # @param [String] quota_user
57
+ # Available to use for quota purposes for server-side applications. Can be any
58
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
59
+ # @param [String] fields
60
+ # Selector specifying which fields to include in a partial response.
61
+ # @param [Google::Apis::RequestOptions] options
62
+ # Request-specific options
63
+ #
64
+ # @yield [result, err] Result & error if block supplied
65
+ # @yieldparam result [Google::Apis::PeopleV1::Empty] parsed result object
66
+ # @yieldparam err [StandardError] error object if request failed
67
+ #
68
+ # @return [Google::Apis::PeopleV1::Empty]
69
+ #
70
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
71
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
72
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
73
+ def delete_contact_group(resource_name, delete_contacts: nil, quota_user: nil, fields: nil, options: nil, &block)
74
+ command = make_simple_command(:delete, 'v1/{+resourceName}', options)
75
+ command.response_representation = Google::Apis::PeopleV1::Empty::Representation
76
+ command.response_class = Google::Apis::PeopleV1::Empty
77
+ command.params['resourceName'] = resource_name unless resource_name.nil?
78
+ command.query['deleteContacts'] = delete_contacts unless delete_contacts.nil?
79
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
80
+ command.query['fields'] = fields unless fields.nil?
81
+ execute_or_queue_command(command, &block)
82
+ end
83
+
84
+ # Get a list of contact groups owned by the authenticated user by specifying
85
+ # a list of contact group resource names.
86
+ # @param [Array<String>, String] resource_names
87
+ # The resource names of the contact groups to get.
88
+ # @param [Fixnum] max_members
89
+ # Specifies the maximum number of members to return for each group.
90
+ # @param [String] quota_user
91
+ # Available to use for quota purposes for server-side applications. Can be any
92
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
93
+ # @param [String] fields
94
+ # Selector specifying which fields to include in a partial response.
95
+ # @param [Google::Apis::RequestOptions] options
96
+ # Request-specific options
97
+ #
98
+ # @yield [result, err] Result & error if block supplied
99
+ # @yieldparam result [Google::Apis::PeopleV1::BatchGetContactGroupsResponse] parsed result object
100
+ # @yieldparam err [StandardError] error object if request failed
101
+ #
102
+ # @return [Google::Apis::PeopleV1::BatchGetContactGroupsResponse]
103
+ #
104
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
105
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
106
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
107
+ def batch_contact_group_get(resource_names: nil, max_members: nil, quota_user: nil, fields: nil, options: nil, &block)
108
+ command = make_simple_command(:get, 'v1/contactGroups:batchGet', options)
109
+ command.response_representation = Google::Apis::PeopleV1::BatchGetContactGroupsResponse::Representation
110
+ command.response_class = Google::Apis::PeopleV1::BatchGetContactGroupsResponse
111
+ command.query['resourceNames'] = resource_names unless resource_names.nil?
112
+ command.query['maxMembers'] = max_members unless max_members.nil?
113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
114
+ command.query['fields'] = fields unless fields.nil?
115
+ execute_or_queue_command(command, &block)
116
+ end
117
+
118
+ # List all contact groups owned by the authenticated user. Members of the
119
+ # contact groups are not populated.
120
+ # @param [String] sync_token
121
+ # A sync token, returned by a previous call to `contactgroups.list`.
122
+ # Only resources changed since the sync token was created will be returned.
123
+ # @param [String] page_token
124
+ # The next_page_token value returned from a previous call to
125
+ # [ListContactGroups](/people/api/rest/v1/contactgroups/list).
126
+ # Requests the next page of resources.
127
+ # @param [Fixnum] page_size
128
+ # The maximum number of resources to return.
129
+ # @param [String] quota_user
130
+ # Available to use for quota purposes for server-side applications. Can be any
131
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
132
+ # @param [String] fields
133
+ # Selector specifying which fields to include in a partial response.
134
+ # @param [Google::Apis::RequestOptions] options
135
+ # Request-specific options
136
+ #
137
+ # @yield [result, err] Result & error if block supplied
138
+ # @yieldparam result [Google::Apis::PeopleV1::ListContactGroupsResponse] parsed result object
139
+ # @yieldparam err [StandardError] error object if request failed
140
+ #
141
+ # @return [Google::Apis::PeopleV1::ListContactGroupsResponse]
142
+ #
143
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
144
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
145
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
146
+ def list_contact_groups(sync_token: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
147
+ command = make_simple_command(:get, 'v1/contactGroups', options)
148
+ command.response_representation = Google::Apis::PeopleV1::ListContactGroupsResponse::Representation
149
+ command.response_class = Google::Apis::PeopleV1::ListContactGroupsResponse
150
+ command.query['syncToken'] = sync_token unless sync_token.nil?
151
+ command.query['pageToken'] = page_token unless page_token.nil?
152
+ command.query['pageSize'] = page_size unless page_size.nil?
153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
154
+ command.query['fields'] = fields unless fields.nil?
155
+ execute_or_queue_command(command, &block)
156
+ end
157
+
158
+ # Create a new contact group owned by the authenticated user.
159
+ # @param [Google::Apis::PeopleV1::CreateContactGroupRequest] create_contact_group_request_object
160
+ # @param [String] quota_user
161
+ # Available to use for quota purposes for server-side applications. Can be any
162
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
163
+ # @param [String] fields
164
+ # Selector specifying which fields to include in a partial response.
165
+ # @param [Google::Apis::RequestOptions] options
166
+ # Request-specific options
167
+ #
168
+ # @yield [result, err] Result & error if block supplied
169
+ # @yieldparam result [Google::Apis::PeopleV1::ContactGroup] parsed result object
170
+ # @yieldparam err [StandardError] error object if request failed
171
+ #
172
+ # @return [Google::Apis::PeopleV1::ContactGroup]
173
+ #
174
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
175
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
176
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
177
+ def create_contact_group(create_contact_group_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
178
+ command = make_simple_command(:post, 'v1/contactGroups', options)
179
+ command.request_representation = Google::Apis::PeopleV1::CreateContactGroupRequest::Representation
180
+ command.request_object = create_contact_group_request_object
181
+ command.response_representation = Google::Apis::PeopleV1::ContactGroup::Representation
182
+ command.response_class = Google::Apis::PeopleV1::ContactGroup
183
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
184
+ command.query['fields'] = fields unless fields.nil?
185
+ execute_or_queue_command(command, &block)
186
+ end
187
+
188
+ # Get a specific contact group owned by the authenticated user by specifying
189
+ # a contact group resource name.
190
+ # @param [String] resource_name
191
+ # The resource name of the contact group to get.
192
+ # @param [Fixnum] max_members
193
+ # Specifies the maximum number of members to return.
194
+ # @param [String] quota_user
195
+ # Available to use for quota purposes for server-side applications. Can be any
196
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
197
+ # @param [String] fields
198
+ # Selector specifying which fields to include in a partial response.
199
+ # @param [Google::Apis::RequestOptions] options
200
+ # Request-specific options
201
+ #
202
+ # @yield [result, err] Result & error if block supplied
203
+ # @yieldparam result [Google::Apis::PeopleV1::ContactGroup] parsed result object
204
+ # @yieldparam err [StandardError] error object if request failed
205
+ #
206
+ # @return [Google::Apis::PeopleV1::ContactGroup]
207
+ #
208
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
209
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
210
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
211
+ def get_contact_group(resource_name, max_members: nil, quota_user: nil, fields: nil, options: nil, &block)
212
+ command = make_simple_command(:get, 'v1/{+resourceName}', options)
213
+ command.response_representation = Google::Apis::PeopleV1::ContactGroup::Representation
214
+ command.response_class = Google::Apis::PeopleV1::ContactGroup
215
+ command.params['resourceName'] = resource_name unless resource_name.nil?
216
+ command.query['maxMembers'] = max_members unless max_members.nil?
217
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
218
+ command.query['fields'] = fields unless fields.nil?
219
+ execute_or_queue_command(command, &block)
220
+ end
221
+
222
+ # Update the name of an existing contact group owned by the authenticated
223
+ # user.
224
+ # @param [String] resource_name
225
+ # The resource name for the contact group, assigned by the server. An ASCII
226
+ # string, in the form of `contactGroups/<contact_group_id>`.
227
+ # @param [Google::Apis::PeopleV1::UpdateContactGroupRequest] update_contact_group_request_object
228
+ # @param [String] quota_user
229
+ # Available to use for quota purposes for server-side applications. Can be any
230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
231
+ # @param [String] fields
232
+ # Selector specifying which fields to include in a partial response.
233
+ # @param [Google::Apis::RequestOptions] options
234
+ # Request-specific options
235
+ #
236
+ # @yield [result, err] Result & error if block supplied
237
+ # @yieldparam result [Google::Apis::PeopleV1::ContactGroup] parsed result object
238
+ # @yieldparam err [StandardError] error object if request failed
239
+ #
240
+ # @return [Google::Apis::PeopleV1::ContactGroup]
241
+ #
242
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
243
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
244
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
245
+ def update_contact_group(resource_name, update_contact_group_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
246
+ command = make_simple_command(:put, 'v1/{+resourceName}', options)
247
+ command.request_representation = Google::Apis::PeopleV1::UpdateContactGroupRequest::Representation
248
+ command.request_object = update_contact_group_request_object
249
+ command.response_representation = Google::Apis::PeopleV1::ContactGroup::Representation
250
+ command.response_class = Google::Apis::PeopleV1::ContactGroup
251
+ command.params['resourceName'] = resource_name unless resource_name.nil?
252
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
253
+ command.query['fields'] = fields unless fields.nil?
254
+ execute_or_queue_command(command, &block)
255
+ end
256
+
257
+ # Modify the members of a contact group owned by the authenticated user.
258
+ # @param [String] resource_name
259
+ # The resource name of the contact group to modify.
260
+ # @param [Google::Apis::PeopleV1::ModifyContactGroupMembersRequest] modify_contact_group_members_request_object
261
+ # @param [String] quota_user
262
+ # Available to use for quota purposes for server-side applications. Can be any
263
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
264
+ # @param [String] fields
265
+ # Selector specifying which fields to include in a partial response.
266
+ # @param [Google::Apis::RequestOptions] options
267
+ # Request-specific options
268
+ #
269
+ # @yield [result, err] Result & error if block supplied
270
+ # @yieldparam result [Google::Apis::PeopleV1::ModifyContactGroupMembersResponse] parsed result object
271
+ # @yieldparam err [StandardError] error object if request failed
272
+ #
273
+ # @return [Google::Apis::PeopleV1::ModifyContactGroupMembersResponse]
274
+ #
275
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
276
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
277
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
278
+ def modify_contact_group_members(resource_name, modify_contact_group_members_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
279
+ command = make_simple_command(:post, 'v1/{+resourceName}/members:modify', options)
280
+ command.request_representation = Google::Apis::PeopleV1::ModifyContactGroupMembersRequest::Representation
281
+ command.request_object = modify_contact_group_members_request_object
282
+ command.response_representation = Google::Apis::PeopleV1::ModifyContactGroupMembersResponse::Representation
283
+ command.response_class = Google::Apis::PeopleV1::ModifyContactGroupMembersResponse
284
+ command.params['resourceName'] = resource_name unless resource_name.nil?
285
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
286
+ command.query['fields'] = fields unless fields.nil?
287
+ execute_or_queue_command(command, &block)
288
+ end
289
+
290
+ # Delete a contact person. Any non-contact data will not be deleted.
291
+ # @param [String] resource_name
292
+ # The resource name of the contact to delete.
293
+ # @param [String] quota_user
294
+ # Available to use for quota purposes for server-side applications. Can be any
295
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
296
+ # @param [String] fields
297
+ # Selector specifying which fields to include in a partial response.
298
+ # @param [Google::Apis::RequestOptions] options
299
+ # Request-specific options
300
+ #
301
+ # @yield [result, err] Result & error if block supplied
302
+ # @yieldparam result [Google::Apis::PeopleV1::Empty] parsed result object
303
+ # @yieldparam err [StandardError] error object if request failed
304
+ #
305
+ # @return [Google::Apis::PeopleV1::Empty]
306
+ #
307
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
308
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
309
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
310
+ def delete_person_contact(resource_name, quota_user: nil, fields: nil, options: nil, &block)
311
+ command = make_simple_command(:delete, 'v1/{+resourceName}:deleteContact', options)
312
+ command.response_representation = Google::Apis::PeopleV1::Empty::Representation
313
+ command.response_class = Google::Apis::PeopleV1::Empty
314
+ command.params['resourceName'] = resource_name unless resource_name.nil?
315
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
316
+ command.query['fields'] = fields unless fields.nil?
317
+ execute_or_queue_command(command, &block)
318
+ end
319
+
50
320
  # Provides information about a list of specific people by specifying a list
51
321
  # of requested resource names. Use `people/me` to indicate the authenticated
52
322
  # user.
323
+ # <br>
324
+ # The request throws a 400 error if 'personFields' is not specified.
325
+ # @param [String] request_mask_include_field
326
+ # **Required.** Comma-separated list of person fields to be included in the
327
+ # response. Each path should start with `person.`: for example,
328
+ # `person.names` or `person.photos`.
53
329
  # @param [Array<String>, String] resource_names
54
330
  # The resource name, such as one returned by
55
331
  # [`people.connections.list`](/people/api/rest/v1/people.connections/list),
56
332
  # of one of the people to provide information about. You can include this
57
333
  # parameter up to 50 times in one request.
58
334
  # @param [String] person_fields
59
- # Required. A field mask to restrict which fields on each person are
335
+ # **Required.** A field mask to restrict which fields on each person are
60
336
  # returned. Valid values are:
61
337
  # * addresses
62
338
  # * ageRanges
@@ -85,10 +361,6 @@ module Google
85
361
  # * skills
86
362
  # * taglines
87
363
  # * urls
88
- # @param [String] request_mask_include_field
89
- # Required. Comma-separated list of person fields to be included in the
90
- # response. Each path should start with `person.`: for example,
91
- # `person.names` or `person.photos`.
92
364
  # @param [String] quota_user
93
365
  # Available to use for quota purposes for server-side applications. Can be any
94
366
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -106,13 +378,13 @@ module Google
106
378
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
107
379
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
108
380
  # @raise [Google::Apis::AuthorizationError] Authorization is required
109
- def get_people(resource_names: nil, person_fields: nil, request_mask_include_field: nil, quota_user: nil, fields: nil, options: nil, &block)
381
+ def get_people(request_mask_include_field: nil, resource_names: nil, person_fields: nil, quota_user: nil, fields: nil, options: nil, &block)
110
382
  command = make_simple_command(:get, 'v1/people:batchGet', options)
111
383
  command.response_representation = Google::Apis::PeopleV1::GetPeopleResponse::Representation
112
384
  command.response_class = Google::Apis::PeopleV1::GetPeopleResponse
385
+ command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil?
113
386
  command.query['resourceNames'] = resource_names unless resource_names.nil?
114
387
  command.query['personFields'] = person_fields unless person_fields.nil?
115
- command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil?
116
388
  command.query['quotaUser'] = quota_user unless quota_user.nil?
117
389
  command.query['fields'] = fields unless fields.nil?
118
390
  execute_or_queue_command(command, &block)
@@ -120,15 +392,18 @@ module Google
120
392
 
121
393
  # Provides information about a person by specifying a resource name. Use
122
394
  # `people/me` to indicate the authenticated user.
395
+ # <br>
396
+ # The request throws a 400 error if 'personFields' is not specified.
123
397
  # @param [String] resource_name
124
398
  # The resource name of the person to provide information about.
125
399
  # - To get information about the authenticated user, specify `people/me`.
126
- # - To get information about any user, specify the resource name that
127
- # identifies the user, such as the resource names returned by
400
+ # - To get information about a google account, specify `people/<account_id>`.
401
+ # - To get information about a contact, specify the resource name that
402
+ # identifies the contact as returned by
128
403
  # [`people.connections.list`](/people/api/rest/v1/people.connections/list).
129
404
  # @param [String] person_fields
130
- # Required. A field mask to restrict which fields on the person are returned.
131
- # Valid values are:
405
+ # **Required.** A field mask to restrict which fields on the person are
406
+ # returned. Valid values are:
132
407
  # * addresses
133
408
  # * ageRanges
134
409
  # * biographies
@@ -157,7 +432,7 @@ module Google
157
432
  # * taglines
158
433
  # * urls
159
434
  # @param [String] request_mask_include_field
160
- # Required. Comma-separated list of person fields to be included in the
435
+ # **Required.** Comma-separated list of person fields to be included in the
161
436
  # response. Each path should start with `person.`: for example,
162
437
  # `person.names` or `person.photos`.
163
438
  # @param [String] quota_user
@@ -189,30 +464,117 @@ module Google
189
464
  execute_or_queue_command(command, &block)
190
465
  end
191
466
 
467
+ # Update contact data for an existing contact person. Any non-contact data
468
+ # will not be modified.
469
+ # The request throws a 400 error if `updatePersonFields` is not specified.
470
+ # <br>
471
+ # The request throws a 400 error if `person.metadata.sources` is not
472
+ # specified for the contact to be updated.
473
+ # <br>
474
+ # The request throws a 412 error if `person.metadata.sources.etag` is
475
+ # different than the contact's etag, which indicates the contact has changed
476
+ # since its data was read. Clients should get the latest person and re-apply
477
+ # their updates to the latest person.
478
+ # @param [String] resource_name
479
+ # The resource name for the person, assigned by the server. An ASCII string
480
+ # with a max length of 27 characters, in the form of `people/<person_id>`.
481
+ # @param [Google::Apis::PeopleV1::Person] person_object
482
+ # @param [String] update_person_fields
483
+ # **Required.** A field mask to restrict which fields on the person are
484
+ # updated. Valid values are:
485
+ # * addresses
486
+ # * biographies
487
+ # * birthdays
488
+ # * braggingRights
489
+ # * emailAddresses
490
+ # * events
491
+ # * genders
492
+ # * imClients
493
+ # * interests
494
+ # * locales
495
+ # * names
496
+ # * nicknames
497
+ # * occupations
498
+ # * organizations
499
+ # * phoneNumbers
500
+ # * relations
501
+ # * residences
502
+ # * skills
503
+ # * urls
504
+ # @param [String] quota_user
505
+ # Available to use for quota purposes for server-side applications. Can be any
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.
509
+ # @param [Google::Apis::RequestOptions] options
510
+ # Request-specific options
511
+ #
512
+ # @yield [result, err] Result & error if block supplied
513
+ # @yieldparam result [Google::Apis::PeopleV1::Person] parsed result object
514
+ # @yieldparam err [StandardError] error object if request failed
515
+ #
516
+ # @return [Google::Apis::PeopleV1::Person]
517
+ #
518
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
519
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
520
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
521
+ def update_person_contact(resource_name, person_object = nil, update_person_fields: nil, quota_user: nil, fields: nil, options: nil, &block)
522
+ command = make_simple_command(:patch, 'v1/{+resourceName}:updateContact', options)
523
+ command.request_representation = Google::Apis::PeopleV1::Person::Representation
524
+ command.request_object = person_object
525
+ command.response_representation = Google::Apis::PeopleV1::Person::Representation
526
+ command.response_class = Google::Apis::PeopleV1::Person
527
+ command.params['resourceName'] = resource_name unless resource_name.nil?
528
+ command.query['updatePersonFields'] = update_person_fields unless update_person_fields.nil?
529
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
530
+ command.query['fields'] = fields unless fields.nil?
531
+ execute_or_queue_command(command, &block)
532
+ end
533
+
534
+ # Create a new contact and return the person resource for that contact.
535
+ # @param [Google::Apis::PeopleV1::Person] person_object
536
+ # @param [String] parent
537
+ # The resource name of the owning person resource.
538
+ # @param [String] quota_user
539
+ # Available to use for quota purposes for server-side applications. Can be any
540
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
541
+ # @param [String] fields
542
+ # Selector specifying which fields to include in a partial response.
543
+ # @param [Google::Apis::RequestOptions] options
544
+ # Request-specific options
545
+ #
546
+ # @yield [result, err] Result & error if block supplied
547
+ # @yieldparam result [Google::Apis::PeopleV1::Person] parsed result object
548
+ # @yieldparam err [StandardError] error object if request failed
549
+ #
550
+ # @return [Google::Apis::PeopleV1::Person]
551
+ #
552
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
553
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
554
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
555
+ def create_person_contact(person_object = nil, parent: nil, quota_user: nil, fields: nil, options: nil, &block)
556
+ command = make_simple_command(:post, 'v1/people:createContact', options)
557
+ command.request_representation = Google::Apis::PeopleV1::Person::Representation
558
+ command.request_object = person_object
559
+ command.response_representation = Google::Apis::PeopleV1::Person::Representation
560
+ command.response_class = Google::Apis::PeopleV1::Person
561
+ command.query['parent'] = parent unless parent.nil?
562
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
563
+ command.query['fields'] = fields unless fields.nil?
564
+ execute_or_queue_command(command, &block)
565
+ end
566
+
192
567
  # Provides a list of the authenticated user's contacts merged with any
193
- # linked profiles.
568
+ # connected profiles.
569
+ # <br>
570
+ # The request throws a 400 error if 'personFields' is not specified.
194
571
  # @param [String] resource_name
195
572
  # The resource name to return connections for. Only `people/me` is valid.
196
- # @param [String] sort_order
197
- # The order in which the connections should be sorted. Defaults to
198
- # `LAST_MODIFIED_ASCENDING`.
199
- # @param [Boolean] request_sync_token
200
- # Whether the response should include a sync token, which can be used to get
201
- # all changes since the last request.
202
- # @param [String] page_token
203
- # The token of the page to be returned.
204
- # @param [Fixnum] page_size
205
- # The number of connections to include in the response. Valid values are
206
- # between 1 and 2000, inclusive. Defaults to 100.
207
- # @param [String] request_mask_include_field
208
- # Required. Comma-separated list of person fields to be included in the
209
- # response. Each path should start with `person.`: for example,
210
- # `person.names` or `person.photos`.
211
573
  # @param [String] sync_token
212
574
  # A sync token, returned by a previous call to `people.connections.list`.
213
575
  # Only resources changed since the sync token was created will be returned.
214
576
  # @param [String] person_fields
215
- # Required. A field mask to restrict which fields on each person are
577
+ # **Required.** A field mask to restrict which fields on each person are
216
578
  # returned. Valid values are:
217
579
  # * addresses
218
580
  # * ageRanges
@@ -241,6 +603,21 @@ module Google
241
603
  # * skills
242
604
  # * taglines
243
605
  # * urls
606
+ # @param [String] sort_order
607
+ # The order in which the connections should be sorted. Defaults to
608
+ # `LAST_MODIFIED_ASCENDING`.
609
+ # @param [Boolean] request_sync_token
610
+ # Whether the response should include a sync token, which can be used to get
611
+ # all changes since the last request.
612
+ # @param [String] page_token
613
+ # The token of the page to be returned.
614
+ # @param [Fixnum] page_size
615
+ # The number of connections to include in the response. Valid values are
616
+ # between 1 and 2000, inclusive. Defaults to 100.
617
+ # @param [String] request_mask_include_field
618
+ # **Required.** Comma-separated list of person fields to be included in the
619
+ # response. Each path should start with `person.`: for example,
620
+ # `person.names` or `person.photos`.
244
621
  # @param [String] quota_user
245
622
  # Available to use for quota purposes for server-side applications. Can be any
246
623
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -258,18 +635,18 @@ module Google
258
635
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
259
636
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
260
637
  # @raise [Google::Apis::AuthorizationError] Authorization is required
261
- def list_person_connections(resource_name, sort_order: nil, request_sync_token: nil, page_token: nil, page_size: nil, request_mask_include_field: nil, sync_token: nil, person_fields: nil, quota_user: nil, fields: nil, options: nil, &block)
638
+ def list_person_connections(resource_name, sync_token: nil, person_fields: nil, sort_order: nil, request_sync_token: nil, page_token: nil, page_size: nil, request_mask_include_field: nil, quota_user: nil, fields: nil, options: nil, &block)
262
639
  command = make_simple_command(:get, 'v1/{+resourceName}/connections', options)
263
640
  command.response_representation = Google::Apis::PeopleV1::ListConnectionsResponse::Representation
264
641
  command.response_class = Google::Apis::PeopleV1::ListConnectionsResponse
265
642
  command.params['resourceName'] = resource_name unless resource_name.nil?
643
+ command.query['syncToken'] = sync_token unless sync_token.nil?
644
+ command.query['personFields'] = person_fields unless person_fields.nil?
266
645
  command.query['sortOrder'] = sort_order unless sort_order.nil?
267
646
  command.query['requestSyncToken'] = request_sync_token unless request_sync_token.nil?
268
647
  command.query['pageToken'] = page_token unless page_token.nil?
269
648
  command.query['pageSize'] = page_size unless page_size.nil?
270
649
  command.query['requestMask.includeField'] = request_mask_include_field unless request_mask_include_field.nil?
271
- command.query['syncToken'] = sync_token unless sync_token.nil?
272
- command.query['personFields'] = person_fields unless person_fields.nil?
273
650
  command.query['quotaUser'] = quota_user unless quota_user.nil?
274
651
  command.query['fields'] = fields unless fields.nil?
275
652
  execute_or_queue_command(command, &block)