google-api-client 0.13.0 → 0.13.1

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