google-api-client 0.8.7 → 0.9.pre1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (397) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +20 -0
  3. data/.rspec +2 -0
  4. data/.rubocop.yml +7 -0
  5. data/.rubocop_todo.yml +63 -0
  6. data/.travis.yml +21 -0
  7. data/.yardopts +12 -0
  8. data/CHANGELOG.md +6 -3
  9. data/CONTRIBUTING.md +31 -0
  10. data/Gemfile +28 -2
  11. data/MIGRATING.md +171 -0
  12. data/README.md +158 -150
  13. data/Rakefile +1 -40
  14. data/api_names.yaml +872 -0
  15. data/api_names_out.yaml +20843 -0
  16. data/bin/generate-api +93 -0
  17. data/generated/google/apis/adexchangebuyer_v1_3.rb +35 -0
  18. data/generated/google/apis/adexchangebuyer_v1_3/classes.rb +1124 -0
  19. data/generated/google/apis/adexchangebuyer_v1_3/representations.rb +375 -0
  20. data/generated/google/apis/adexchangebuyer_v1_3/service.rb +893 -0
  21. data/generated/google/apis/adexchangeseller_v2_0.rb +38 -0
  22. data/generated/google/apis/adexchangeseller_v2_0/classes.rb +792 -0
  23. data/generated/google/apis/adexchangeseller_v2_0/representations.rb +309 -0
  24. data/generated/google/apis/adexchangeseller_v2_0/service.rb +682 -0
  25. data/generated/google/apis/admin_directory_v1.rb +89 -0
  26. data/generated/google/apis/admin_directory_v1/classes.rb +2389 -0
  27. data/generated/google/apis/admin_directory_v1/representations.rb +780 -0
  28. data/generated/google/apis/admin_directory_v1/service.rb +2805 -0
  29. data/generated/google/apis/admin_reports_v1.rb +38 -0
  30. data/generated/google/apis/admin_reports_v1/classes.rb +582 -0
  31. data/generated/google/apis/admin_reports_v1/representations.rb +231 -0
  32. data/generated/google/apis/admin_reports_v1/service.rb +341 -0
  33. data/generated/google/apis/adsense_v1_4.rb +38 -0
  34. data/generated/google/apis/adsense_v1_4/classes.rb +1279 -0
  35. data/generated/google/apis/adsense_v1_4/representations.rb +493 -0
  36. data/generated/google/apis/adsense_v1_4/service.rb +1752 -0
  37. data/generated/google/apis/adsensehost_v4_1.rb +35 -0
  38. data/generated/google/apis/adsensehost_v4_1/classes.rb +834 -0
  39. data/generated/google/apis/adsensehost_v4_1/representations.rb +327 -0
  40. data/generated/google/apis/adsensehost_v4_1/service.rb +1190 -0
  41. data/generated/google/apis/analytics_v3.rb +49 -0
  42. data/generated/google/apis/analytics_v3/classes.rb +5113 -0
  43. data/generated/google/apis/analytics_v3/representations.rb +1661 -0
  44. data/generated/google/apis/analytics_v3/service.rb +3600 -0
  45. data/generated/google/apis/androidenterprise_v1.rb +34 -0
  46. data/generated/google/apis/androidenterprise_v1/classes.rb +1162 -0
  47. data/generated/google/apis/androidenterprise_v1/representations.rb +431 -0
  48. data/generated/google/apis/androidenterprise_v1/service.rb +1979 -0
  49. data/generated/google/apis/androidpublisher_v2.rb +34 -0
  50. data/generated/google/apis/androidpublisher_v2/classes.rb +1374 -0
  51. data/generated/google/apis/androidpublisher_v2/representations.rb +630 -0
  52. data/generated/google/apis/androidpublisher_v2/service.rb +2390 -0
  53. data/generated/google/apis/appsactivity_v1.rb +46 -0
  54. data/generated/google/apis/appsactivity_v1/classes.rb +392 -0
  55. data/generated/google/apis/appsactivity_v1/representations.rb +184 -0
  56. data/generated/google/apis/appsactivity_v1/service.rb +129 -0
  57. data/generated/google/apis/appstate_v1.rb +34 -0
  58. data/generated/google/apis/appstate_v1/classes.rb +154 -0
  59. data/generated/google/apis/appstate_v1/representations.rb +79 -0
  60. data/generated/google/apis/appstate_v1/service.rb +265 -0
  61. data/generated/google/apis/autoscaler_v1beta2.rb +38 -0
  62. data/generated/google/apis/autoscaler_v1beta2/classes.rb +747 -0
  63. data/generated/google/apis/autoscaler_v1beta2/representations.rb +281 -0
  64. data/generated/google/apis/autoscaler_v1beta2/service.rb +488 -0
  65. data/generated/google/apis/bigquery_v2.rb +49 -0
  66. data/generated/google/apis/bigquery_v2/classes.rb +2255 -0
  67. data/generated/google/apis/bigquery_v2/representations.rb +754 -0
  68. data/generated/google/apis/bigquery_v2/service.rb +1003 -0
  69. data/generated/google/apis/blogger_v3.rb +37 -0
  70. data/generated/google/apis/blogger_v3/classes.rb +1354 -0
  71. data/generated/google/apis/blogger_v3/representations.rb +562 -0
  72. data/generated/google/apis/blogger_v3/service.rb +1620 -0
  73. data/generated/google/apis/books_v1.rb +34 -0
  74. data/generated/google/apis/books_v1/classes.rb +3515 -0
  75. data/generated/google/apis/books_v1/representations.rb +1361 -0
  76. data/generated/google/apis/books_v1/service.rb +2170 -0
  77. data/generated/google/apis/calendar_v3.rb +37 -0
  78. data/generated/google/apis/calendar_v3/classes.rb +1702 -0
  79. data/generated/google/apis/calendar_v3/representations.rb +566 -0
  80. data/generated/google/apis/calendar_v3/service.rb +1943 -0
  81. data/generated/google/apis/civicinfo_v2.rb +31 -0
  82. data/generated/google/apis/civicinfo_v2/classes.rb +1057 -0
  83. data/generated/google/apis/civicinfo_v2/representations.rb +374 -0
  84. data/generated/google/apis/civicinfo_v2/service.rb +284 -0
  85. data/generated/google/apis/cloudmonitoring_v2beta2.rb +34 -0
  86. data/generated/google/apis/cloudmonitoring_v2beta2/classes.rb +679 -0
  87. data/generated/google/apis/cloudmonitoring_v2beta2/representations.rb +311 -0
  88. data/generated/google/apis/cloudmonitoring_v2beta2/service.rb +458 -0
  89. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +38 -0
  90. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +139 -0
  91. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +65 -0
  92. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +301 -0
  93. data/generated/google/apis/compute_v1.rb +49 -0
  94. data/generated/google/apis/compute_v1/classes.rb +6391 -0
  95. data/generated/google/apis/compute_v1/representations.rb +2209 -0
  96. data/generated/google/apis/compute_v1/service.rb +6352 -0
  97. data/generated/google/apis/container_v1beta1.rb +35 -0
  98. data/generated/google/apis/container_v1beta1/classes.rb +466 -0
  99. data/generated/google/apis/container_v1beta1/representations.rb +177 -0
  100. data/generated/google/apis/container_v1beta1/service.rb +394 -0
  101. data/generated/google/apis/content_v2.rb +35 -0
  102. data/generated/google/apis/content_v2/classes.rb +3780 -0
  103. data/generated/google/apis/content_v2/representations.rb +1456 -0
  104. data/generated/google/apis/content_v2/service.rb +1706 -0
  105. data/generated/google/apis/coordinate_v1.rb +37 -0
  106. data/generated/google/apis/coordinate_v1/classes.rb +669 -0
  107. data/generated/google/apis/coordinate_v1/representations.rb +285 -0
  108. data/generated/google/apis/coordinate_v1/service.rb +687 -0
  109. data/{lib/google/api_client/auth/compute_service_account.rb → generated/google/apis/customsearch_v1.rb} +13 -10
  110. data/generated/google/apis/customsearch_v1/classes.rb +771 -0
  111. data/generated/google/apis/customsearch_v1/representations.rb +276 -0
  112. data/generated/google/apis/customsearch_v1/service.rb +208 -0
  113. data/generated/google/apis/datastore_v1beta2.rb +40 -0
  114. data/generated/google/apis/datastore_v1beta2/classes.rb +1186 -0
  115. data/generated/google/apis/datastore_v1beta2/representations.rb +526 -0
  116. data/generated/google/apis/datastore_v1beta2/service.rb +300 -0
  117. data/generated/google/apis/deploymentmanager_v2beta2.rb +41 -0
  118. data/generated/google/apis/deploymentmanager_v2beta2/classes.rb +820 -0
  119. data/generated/google/apis/deploymentmanager_v2beta2/representations.rb +303 -0
  120. data/generated/google/apis/deploymentmanager_v2beta2/service.rb +647 -0
  121. data/generated/google/apis/dfareporting_v2_1.rb +37 -0
  122. data/generated/google/apis/dfareporting_v2_1/classes.rb +10755 -0
  123. data/generated/google/apis/dfareporting_v2_1/representations.rb +3438 -0
  124. data/generated/google/apis/dfareporting_v2_1/service.rb +8775 -0
  125. data/generated/google/apis/discovery_v1.rb +32 -0
  126. data/generated/google/apis/discovery_v1/classes.rb +947 -0
  127. data/generated/google/apis/discovery_v1/representations.rb +355 -0
  128. data/generated/google/apis/discovery_v1/service.rb +144 -0
  129. data/generated/google/apis/dns_v1.rb +41 -0
  130. data/generated/google/apis/dns_v1/classes.rb +406 -0
  131. data/generated/google/apis/dns_v1/representations.rb +151 -0
  132. data/generated/google/apis/dns_v1/service.rb +460 -0
  133. data/{spec/google/api_client/request_spec.rb → generated/google/apis/doubleclickbidmanager_v1.rb} +15 -13
  134. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +709 -0
  135. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +297 -0
  136. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +349 -0
  137. data/generated/google/apis/doubleclicksearch_v2.rb +35 -0
  138. data/generated/google/apis/doubleclicksearch_v2/classes.rb +947 -0
  139. data/generated/google/apis/doubleclicksearch_v2/representations.rb +315 -0
  140. data/generated/google/apis/doubleclicksearch_v2/service.rb +490 -0
  141. data/generated/google/apis/drive_v2.rb +55 -0
  142. data/generated/google/apis/drive_v2/classes.rb +2519 -0
  143. data/generated/google/apis/drive_v2/representations.rb +781 -0
  144. data/generated/google/apis/drive_v2/service.rb +2685 -0
  145. data/generated/google/apis/fitness_v1.rb +49 -0
  146. data/generated/google/apis/fitness_v1/classes.rb +809 -0
  147. data/generated/google/apis/fitness_v1/representations.rb +295 -0
  148. data/generated/google/apis/fitness_v1/service.rb +684 -0
  149. data/generated/google/apis/fusiontables_v2.rb +37 -0
  150. data/generated/google/apis/fusiontables_v2/classes.rb +1048 -0
  151. data/generated/google/apis/fusiontables_v2/representations.rb +409 -0
  152. data/generated/google/apis/fusiontables_v2/service.rb +1496 -0
  153. data/generated/google/apis/games_configuration_v1configuration.rb +34 -0
  154. data/generated/google/apis/games_configuration_v1configuration/classes.rb +506 -0
  155. data/generated/google/apis/games_configuration_v1configuration/representations.rb +206 -0
  156. data/generated/google/apis/games_configuration_v1configuration/service.rb +578 -0
  157. data/generated/google/apis/games_v1.rb +40 -0
  158. data/generated/google/apis/games_v1/classes.rb +4578 -0
  159. data/generated/google/apis/games_v1/representations.rb +1570 -0
  160. data/generated/google/apis/games_v1/service.rb +2306 -0
  161. data/generated/google/apis/gan_v1beta1.rb +31 -0
  162. data/generated/google/apis/gan_v1beta1/classes.rb +1428 -0
  163. data/generated/google/apis/gan_v1beta1/representations.rb +428 -0
  164. data/generated/google/apis/gan_v1beta1/service.rb +692 -0
  165. data/generated/google/apis/genomics_v1beta2.rb +46 -0
  166. data/generated/google/apis/genomics_v1beta2/classes.rb +3288 -0
  167. data/generated/google/apis/genomics_v1beta2/representations.rb +1194 -0
  168. data/generated/google/apis/genomics_v1beta2/service.rb +2356 -0
  169. data/generated/google/apis/gmail_v1.rb +49 -0
  170. data/generated/google/apis/gmail_v1/classes.rb +794 -0
  171. data/generated/google/apis/gmail_v1/representations.rb +339 -0
  172. data/generated/google/apis/gmail_v1/service.rb +1502 -0
  173. data/generated/google/apis/groupsmigration_v1.rb +34 -0
  174. data/generated/google/apis/groupsmigration_v1/classes.rb +51 -0
  175. data/generated/google/apis/groupsmigration_v1/representations.rb +38 -0
  176. data/generated/google/apis/groupsmigration_v1/service.rb +111 -0
  177. data/generated/google/apis/groupssettings_v1.rb +34 -0
  178. data/generated/google/apis/groupssettings_v1/classes.rb +221 -0
  179. data/generated/google/apis/groupssettings_v1/representations.rb +64 -0
  180. data/generated/google/apis/groupssettings_v1/service.rb +179 -0
  181. data/generated/google/apis/identitytoolkit_v3.rb +31 -0
  182. data/generated/google/apis/identitytoolkit_v3/classes.rb +1229 -0
  183. data/generated/google/apis/identitytoolkit_v3/representations.rb +422 -0
  184. data/generated/google/apis/identitytoolkit_v3/service.rb +491 -0
  185. data/generated/google/apis/licensing_v1.rb +34 -0
  186. data/generated/google/apis/licensing_v1/classes.rb +132 -0
  187. data/generated/google/apis/licensing_v1/representations.rb +68 -0
  188. data/generated/google/apis/licensing_v1/service.rb +376 -0
  189. data/generated/google/apis/logging_v1beta3.rb +35 -0
  190. data/generated/google/apis/logging_v1beta3/classes.rb +505 -0
  191. data/generated/google/apis/logging_v1beta3/representations.rb +222 -0
  192. data/generated/google/apis/logging_v1beta3/service.rb +670 -0
  193. data/generated/google/apis/manager_v1beta2.rb +50 -0
  194. data/generated/google/apis/manager_v1beta2/classes.rb +1287 -0
  195. data/generated/google/apis/manager_v1beta2/representations.rb +536 -0
  196. data/generated/google/apis/manager_v1beta2/service.rb +380 -0
  197. data/generated/google/apis/mapsengine_v1.rb +38 -0
  198. data/generated/google/apis/mapsengine_v1/classes.rb +2873 -0
  199. data/generated/google/apis/mapsengine_v1/representations.rb +1235 -0
  200. data/generated/google/apis/mapsengine_v1/service.rb +3465 -0
  201. data/generated/google/apis/mirror_v1.rb +37 -0
  202. data/generated/google/apis/mirror_v1/classes.rb +1072 -0
  203. data/generated/google/apis/mirror_v1/representations.rb +350 -0
  204. data/generated/google/apis/mirror_v1/service.rb +1001 -0
  205. data/generated/google/apis/oauth2_v2.rb +43 -0
  206. data/generated/google/apis/oauth2_v2/classes.rb +245 -0
  207. data/generated/google/apis/oauth2_v2/representations.rb +94 -0
  208. data/generated/google/apis/oauth2_v2/service.rb +203 -0
  209. data/generated/google/apis/pagespeedonline_v2.rb +32 -0
  210. data/generated/google/apis/pagespeedonline_v2/classes.rb +614 -0
  211. data/generated/google/apis/pagespeedonline_v2/representations.rb +244 -0
  212. data/generated/google/apis/pagespeedonline_v2/service.rb +120 -0
  213. data/generated/google/apis/plus_domains_v1.rb +61 -0
  214. data/generated/google/apis/plus_domains_v1/classes.rb +2402 -0
  215. data/generated/google/apis/plus_domains_v1/representations.rb +873 -0
  216. data/generated/google/apis/plus_domains_v1/service.rb +924 -0
  217. data/generated/google/apis/plus_v1.rb +43 -0
  218. data/generated/google/apis/plus_v1/classes.rb +2384 -0
  219. data/generated/google/apis/plus_v1/representations.rb +812 -0
  220. data/generated/google/apis/plus_v1/service.rb +616 -0
  221. data/generated/google/apis/prediction_v1_6.rb +44 -0
  222. data/generated/google/apis/prediction_v1_6/classes.rb +751 -0
  223. data/generated/google/apis/prediction_v1_6/representations.rb +327 -0
  224. data/generated/google/apis/prediction_v1_6/service.rb +388 -0
  225. data/generated/google/apis/pubsub_v1beta2.rb +37 -0
  226. data/generated/google/apis/pubsub_v1beta2/classes.rb +824 -0
  227. data/generated/google/apis/pubsub_v1beta2/representations.rb +366 -0
  228. data/generated/google/apis/pubsub_v1beta2/service.rb +778 -0
  229. data/generated/google/apis/qpx_express_v1.rb +31 -0
  230. data/generated/google/apis/qpx_express_v1/classes.rb +1268 -0
  231. data/generated/google/apis/qpx_express_v1/representations.rb +424 -0
  232. data/generated/google/apis/qpx_express_v1/service.rb +101 -0
  233. data/generated/google/apis/replicapool_v1beta2.rb +41 -0
  234. data/generated/google/apis/replicapool_v1beta2/classes.rb +621 -0
  235. data/generated/google/apis/replicapool_v1beta2/representations.rb +235 -0
  236. data/generated/google/apis/replicapool_v1beta2/service.rb +620 -0
  237. data/generated/google/apis/replicapoolupdater_v1beta1.rb +41 -0
  238. data/generated/google/apis/replicapoolupdater_v1beta1/classes.rb +682 -0
  239. data/generated/google/apis/replicapoolupdater_v1beta1/representations.rb +247 -0
  240. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +472 -0
  241. data/generated/google/apis/reseller_v1.rb +37 -0
  242. data/generated/google/apis/reseller_v1/classes.rb +502 -0
  243. data/generated/google/apis/reseller_v1/representations.rb +199 -0
  244. data/generated/google/apis/reseller_v1/service.rb +637 -0
  245. data/generated/google/apis/resourceviews_v1beta2.rb +47 -0
  246. data/generated/google/apis/resourceviews_v1beta2/classes.rb +660 -0
  247. data/generated/google/apis/resourceviews_v1beta2/representations.rb +269 -0
  248. data/generated/google/apis/resourceviews_v1beta2/service.rb +574 -0
  249. data/generated/google/apis/site_verification_v1.rb +37 -0
  250. data/generated/google/apis/site_verification_v1/classes.rb +185 -0
  251. data/generated/google/apis/site_verification_v1/representations.rb +101 -0
  252. data/generated/google/apis/site_verification_v1/service.rb +322 -0
  253. data/generated/google/apis/sqladmin_v1beta4.rb +37 -0
  254. data/generated/google/apis/sqladmin_v1beta4/classes.rb +1817 -0
  255. data/generated/google/apis/sqladmin_v1beta4/representations.rb +688 -0
  256. data/generated/google/apis/sqladmin_v1beta4/service.rb +1534 -0
  257. data/generated/google/apis/storage_v1.rb +43 -0
  258. data/generated/google/apis/storage_v1/classes.rb +1177 -0
  259. data/generated/google/apis/storage_v1/representations.rb +427 -0
  260. data/generated/google/apis/storage_v1/service.rb +1920 -0
  261. data/generated/google/apis/tagmanager_v1.rb +52 -0
  262. data/generated/google/apis/tagmanager_v1/classes.rb +1226 -0
  263. data/generated/google/apis/tagmanager_v1/representations.rb +461 -0
  264. data/generated/google/apis/tagmanager_v1/service.rb +1978 -0
  265. data/generated/google/apis/taskqueue_v1beta2.rb +37 -0
  266. data/generated/google/apis/taskqueue_v1beta2/classes.rb +254 -0
  267. data/generated/google/apis/taskqueue_v1beta2/representations.rb +114 -0
  268. data/generated/google/apis/taskqueue_v1beta2/service.rb +416 -0
  269. data/generated/google/apis/tasks_v1.rb +37 -0
  270. data/generated/google/apis/tasks_v1/classes.rb +296 -0
  271. data/generated/google/apis/tasks_v1/representations.rb +115 -0
  272. data/generated/google/apis/tasks_v1/service.rb +657 -0
  273. data/generated/google/apis/translate_v2.rb +31 -0
  274. data/generated/google/apis/translate_v2/classes.rb +168 -0
  275. data/generated/google/apis/translate_v2/representations.rb +109 -0
  276. data/generated/google/apis/translate_v2/service.rb +185 -0
  277. data/generated/google/apis/urlshortener_v1.rb +34 -0
  278. data/generated/google/apis/urlshortener_v1/classes.rb +246 -0
  279. data/generated/google/apis/urlshortener_v1/representations.rb +111 -0
  280. data/generated/google/apis/urlshortener_v1/service.rb +179 -0
  281. data/generated/google/apis/webmasters_v3.rb +37 -0
  282. data/generated/google/apis/webmasters_v3/classes.rb +563 -0
  283. data/generated/google/apis/webmasters_v3/representations.rb +250 -0
  284. data/generated/google/apis/webmasters_v3/service.rb +587 -0
  285. data/generated/google/apis/youtube_analytics_v1.rb +46 -0
  286. data/generated/google/apis/youtube_analytics_v1/classes.rb +540 -0
  287. data/generated/google/apis/youtube_analytics_v1/representations.rb +242 -0
  288. data/generated/google/apis/youtube_analytics_v1/service.rb +567 -0
  289. data/generated/google/apis/youtube_v3.rb +49 -0
  290. data/generated/google/apis/youtube_v3/classes.rb +7225 -0
  291. data/generated/google/apis/youtube_v3/representations.rb +2529 -0
  292. data/generated/google/apis/youtube_v3/service.rb +4051 -0
  293. data/google-api-client.gemspec +27 -39
  294. data/lib/google/api_client/auth/storage.rb +3 -2
  295. data/lib/google/api_client/auth/storages/file_store.rb +1 -3
  296. data/lib/google/api_client/auth/storages/redis_store.rb +6 -2
  297. data/lib/google/apis.rb +48 -0
  298. data/lib/google/apis/core/api_command.rb +128 -0
  299. data/lib/google/apis/core/base_service.rb +314 -0
  300. data/lib/google/apis/core/batch.rb +222 -0
  301. data/lib/google/apis/core/download.rb +94 -0
  302. data/lib/google/apis/core/hashable.rb +44 -0
  303. data/lib/google/apis/core/http_command.rb +275 -0
  304. data/lib/google/apis/core/json_representation.rb +122 -0
  305. data/lib/google/{api_client/version.rb → apis/core/logging.rb} +12 -8
  306. data/lib/google/apis/core/multipart.rb +173 -0
  307. data/lib/google/apis/core/upload.rb +275 -0
  308. data/lib/google/{api_client → apis}/errors.rb +32 -28
  309. data/lib/google/apis/generator.rb +70 -0
  310. data/lib/google/apis/generator/annotator.rb +271 -0
  311. data/lib/google/apis/generator/helpers.rb +74 -0
  312. data/lib/google/apis/generator/model.rb +130 -0
  313. data/lib/google/apis/generator/template.rb +124 -0
  314. data/lib/google/apis/generator/templates/_class.tmpl +40 -0
  315. data/lib/google/apis/generator/templates/_method.tmpl +90 -0
  316. data/lib/google/apis/generator/templates/_representation.tmpl +51 -0
  317. data/lib/google/apis/generator/templates/_representation_stub.tmpl +15 -0
  318. data/lib/google/apis/generator/templates/_representation_type.tmpl +10 -0
  319. data/lib/google/{api_client/reference.rb → apis/generator/templates/classes.rb.tmpl} +11 -9
  320. data/lib/google/apis/generator/templates/module.rb.tmpl +40 -0
  321. data/lib/google/apis/generator/templates/representations.rb.tmpl +32 -0
  322. data/lib/google/apis/generator/templates/service.rb.tmpl +60 -0
  323. data/lib/google/apis/options.rb +79 -0
  324. data/lib/google/apis/version.rb +39 -0
  325. data/rakelib/metrics.rake +22 -0
  326. data/rakelib/rubocop.rake +10 -0
  327. data/rakelib/spec.rake +11 -0
  328. data/rakelib/yard.rake +11 -0
  329. data/samples/calendar/calendar.rb +43 -0
  330. data/samples/drive/drive.rb +40 -0
  331. data/samples/pubsub/pubsub.rb +52 -0
  332. data/{lib/google/api_client/discovery.rb → samples/translate/translate.rb} +14 -5
  333. data/script/generate +79 -0
  334. data/script/package +8 -0
  335. data/script/release +15 -0
  336. data/spec/fixtures/files/api_names.yaml +3 -0
  337. data/spec/fixtures/files/auth_stored_credentials.json +8 -0
  338. data/spec/fixtures/files/client_secrets.json +1 -0
  339. data/spec/fixtures/files/test.blah +1 -0
  340. data/spec/fixtures/files/test.txt +1 -0
  341. data/spec/fixtures/files/test_api.json +440 -0
  342. data/spec/google/api_client/auth/storage_spec.rb +1 -3
  343. data/spec/google/api_client/auth/storages/file_store_spec.rb +1 -2
  344. data/spec/google/api_client/auth/storages/redis_store_spec.rb +1 -3
  345. data/spec/google/apis/core/api_command_spec.rb +170 -0
  346. data/spec/google/apis/core/batch_spec.rb +128 -0
  347. data/spec/google/apis/core/download_spec.rb +90 -0
  348. data/spec/google/apis/core/hashable_spec.rb +60 -0
  349. data/spec/google/apis/core/http_command_spec.rb +238 -0
  350. data/spec/google/apis/core/json_representation_spec.rb +192 -0
  351. data/spec/google/apis/core/service_spec.rb +247 -0
  352. data/spec/google/apis/core/upload_spec.rb +238 -0
  353. data/{lib/google/api_client/service_account.rb → spec/google/apis/generated_spec.rb} +14 -8
  354. data/spec/google/apis/generator/generator_spec.rb +272 -0
  355. data/spec/google/apis/logging_spec.rb +45 -0
  356. data/spec/google/apis/options_spec.rb +40 -0
  357. data/spec/integration_tests/drive_spec.rb +35 -0
  358. data/spec/integration_tests/pubsub_spec.rb +48 -0
  359. data/spec/integration_tests/url_shortener_spec.rb +31 -0
  360. data/spec/spec_helper.rb +102 -46
  361. metadata +433 -178
  362. data/lib/compat/multi_json.rb +0 -19
  363. data/lib/google/api_client.rb +0 -750
  364. data/lib/google/api_client/auth/file_storage.rb +0 -59
  365. data/lib/google/api_client/auth/jwt_asserter.rb +0 -126
  366. data/lib/google/api_client/auth/key_utils.rb +0 -93
  367. data/lib/google/api_client/auth/pkcs12.rb +0 -41
  368. data/lib/google/api_client/batch.rb +0 -326
  369. data/lib/google/api_client/charset.rb +0 -33
  370. data/lib/google/api_client/discovery/api.rb +0 -310
  371. data/lib/google/api_client/discovery/media.rb +0 -77
  372. data/lib/google/api_client/discovery/method.rb +0 -363
  373. data/lib/google/api_client/discovery/resource.rb +0 -156
  374. data/lib/google/api_client/discovery/schema.rb +0 -117
  375. data/lib/google/api_client/environment.rb +0 -42
  376. data/lib/google/api_client/gzip.rb +0 -28
  377. data/lib/google/api_client/logging.rb +0 -32
  378. data/lib/google/api_client/media.rb +0 -259
  379. data/lib/google/api_client/railtie.rb +0 -18
  380. data/lib/google/api_client/request.rb +0 -350
  381. data/lib/google/api_client/result.rb +0 -255
  382. data/lib/google/api_client/service.rb +0 -233
  383. data/lib/google/api_client/service/batch.rb +0 -110
  384. data/lib/google/api_client/service/request.rb +0 -144
  385. data/lib/google/api_client/service/resource.rb +0 -40
  386. data/lib/google/api_client/service/result.rb +0 -162
  387. data/lib/google/api_client/service/simple_file_store.rb +0 -151
  388. data/lib/google/api_client/service/stub_generator.rb +0 -61
  389. data/spec/google/api_client/batch_spec.rb +0 -248
  390. data/spec/google/api_client/discovery_spec.rb +0 -708
  391. data/spec/google/api_client/gzip_spec.rb +0 -98
  392. data/spec/google/api_client/media_spec.rb +0 -178
  393. data/spec/google/api_client/result_spec.rb +0 -207
  394. data/spec/google/api_client/service_account_spec.rb +0 -169
  395. data/spec/google/api_client/service_spec.rb +0 -618
  396. data/spec/google/api_client/simple_file_store_spec.rb +0 -133
  397. data/spec/google/api_client_spec.rb +0 -352
@@ -0,0 +1,350 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'date'
16
+ require 'google/apis/core/base_service'
17
+ require 'google/apis/core/json_representation'
18
+ require 'google/apis/core/hashable'
19
+ require 'google/apis/errors'
20
+
21
+ module Google
22
+ module Apis
23
+ module MirrorV1
24
+
25
+ class Account
26
+ class Representation < Google::Apis::Core::JsonRepresentation; end
27
+ end
28
+
29
+ class Attachment
30
+ class Representation < Google::Apis::Core::JsonRepresentation; end
31
+ end
32
+
33
+ class ListAttachmentsResponse
34
+ class Representation < Google::Apis::Core::JsonRepresentation; end
35
+ end
36
+
37
+ class AuthToken
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+ end
40
+
41
+ class Command
42
+ class Representation < Google::Apis::Core::JsonRepresentation; end
43
+ end
44
+
45
+ class Contact
46
+ class Representation < Google::Apis::Core::JsonRepresentation; end
47
+ end
48
+
49
+ class ListContactsResponse
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+ end
52
+
53
+ class Location
54
+ class Representation < Google::Apis::Core::JsonRepresentation; end
55
+ end
56
+
57
+ class ListLocationsResponse
58
+ class Representation < Google::Apis::Core::JsonRepresentation; end
59
+ end
60
+
61
+ class MenuItem
62
+ class Representation < Google::Apis::Core::JsonRepresentation; end
63
+ end
64
+
65
+ class MenuValue
66
+ class Representation < Google::Apis::Core::JsonRepresentation; end
67
+ end
68
+
69
+ class Notification
70
+ class Representation < Google::Apis::Core::JsonRepresentation; end
71
+ end
72
+
73
+ class NotificationConfig
74
+ class Representation < Google::Apis::Core::JsonRepresentation; end
75
+ end
76
+
77
+ class Setting
78
+ class Representation < Google::Apis::Core::JsonRepresentation; end
79
+ end
80
+
81
+ class Subscription
82
+ class Representation < Google::Apis::Core::JsonRepresentation; end
83
+ end
84
+
85
+ class ListSubscriptionsResponse
86
+ class Representation < Google::Apis::Core::JsonRepresentation; end
87
+ end
88
+
89
+ class TimelineItem
90
+ class Representation < Google::Apis::Core::JsonRepresentation; end
91
+ end
92
+
93
+ class ListTimelineResponse
94
+ class Representation < Google::Apis::Core::JsonRepresentation; end
95
+ end
96
+
97
+ class UserAction
98
+ class Representation < Google::Apis::Core::JsonRepresentation; end
99
+ end
100
+
101
+ class UserData
102
+ class Representation < Google::Apis::Core::JsonRepresentation; end
103
+ end
104
+
105
+ class Account
106
+ # @private
107
+ class Representation < Google::Apis::Core::JsonRepresentation
108
+ collection :auth_tokens, as: 'authTokens', class: Google::Apis::MirrorV1::AuthToken, decorator: Google::Apis::MirrorV1::AuthToken::Representation
109
+
110
+ collection :features, as: 'features'
111
+ property :password, as: 'password'
112
+ collection :user_data, as: 'userData', class: Google::Apis::MirrorV1::UserData, decorator: Google::Apis::MirrorV1::UserData::Representation
113
+
114
+ end
115
+ end
116
+
117
+ class Attachment
118
+ # @private
119
+ class Representation < Google::Apis::Core::JsonRepresentation
120
+ property :content_type, as: 'contentType'
121
+ property :content_url, as: 'contentUrl'
122
+ property :id, as: 'id'
123
+ property :is_processing_content, as: 'isProcessingContent'
124
+ end
125
+ end
126
+
127
+ class ListAttachmentsResponse
128
+ # @private
129
+ class Representation < Google::Apis::Core::JsonRepresentation
130
+ collection :items, as: 'items', class: Google::Apis::MirrorV1::Attachment, decorator: Google::Apis::MirrorV1::Attachment::Representation
131
+
132
+ property :kind, as: 'kind'
133
+ end
134
+ end
135
+
136
+ class AuthToken
137
+ # @private
138
+ class Representation < Google::Apis::Core::JsonRepresentation
139
+ property :auth_token, as: 'authToken'
140
+ property :type, as: 'type'
141
+ end
142
+ end
143
+
144
+ class Command
145
+ # @private
146
+ class Representation < Google::Apis::Core::JsonRepresentation
147
+ property :type, as: 'type'
148
+ end
149
+ end
150
+
151
+ class Contact
152
+ # @private
153
+ class Representation < Google::Apis::Core::JsonRepresentation
154
+ collection :accept_commands, as: 'acceptCommands', class: Google::Apis::MirrorV1::Command, decorator: Google::Apis::MirrorV1::Command::Representation
155
+
156
+ collection :accept_types, as: 'acceptTypes'
157
+ property :display_name, as: 'displayName'
158
+ property :id, as: 'id'
159
+ collection :image_urls, as: 'imageUrls'
160
+ property :kind, as: 'kind'
161
+ property :phone_number, as: 'phoneNumber'
162
+ property :priority, as: 'priority'
163
+ collection :sharing_features, as: 'sharingFeatures'
164
+ property :source, as: 'source'
165
+ property :speakable_name, as: 'speakableName'
166
+ property :type, as: 'type'
167
+ end
168
+ end
169
+
170
+ class ListContactsResponse
171
+ # @private
172
+ class Representation < Google::Apis::Core::JsonRepresentation
173
+ collection :items, as: 'items', class: Google::Apis::MirrorV1::Contact, decorator: Google::Apis::MirrorV1::Contact::Representation
174
+
175
+ property :kind, as: 'kind'
176
+ end
177
+ end
178
+
179
+ class Location
180
+ # @private
181
+ class Representation < Google::Apis::Core::JsonRepresentation
182
+ property :accuracy, as: 'accuracy'
183
+ property :address, as: 'address'
184
+ property :display_name, as: 'displayName'
185
+ property :id, as: 'id'
186
+ property :kind, as: 'kind'
187
+ property :latitude, as: 'latitude'
188
+ property :longitude, as: 'longitude'
189
+ property :timestamp, as: 'timestamp', type: DateTime
190
+
191
+ end
192
+ end
193
+
194
+ class ListLocationsResponse
195
+ # @private
196
+ class Representation < Google::Apis::Core::JsonRepresentation
197
+ collection :items, as: 'items', class: Google::Apis::MirrorV1::Location, decorator: Google::Apis::MirrorV1::Location::Representation
198
+
199
+ property :kind, as: 'kind'
200
+ end
201
+ end
202
+
203
+ class MenuItem
204
+ # @private
205
+ class Representation < Google::Apis::Core::JsonRepresentation
206
+ property :action, as: 'action'
207
+ property :contextual_command, as: 'contextual_command'
208
+ property :id, as: 'id'
209
+ property :payload, as: 'payload'
210
+ property :remove_when_selected, as: 'removeWhenSelected'
211
+ collection :values, as: 'values', class: Google::Apis::MirrorV1::MenuValue, decorator: Google::Apis::MirrorV1::MenuValue::Representation
212
+
213
+ end
214
+ end
215
+
216
+ class MenuValue
217
+ # @private
218
+ class Representation < Google::Apis::Core::JsonRepresentation
219
+ property :display_name, as: 'displayName'
220
+ property :icon_url, as: 'iconUrl'
221
+ property :state, as: 'state'
222
+ end
223
+ end
224
+
225
+ class Notification
226
+ # @private
227
+ class Representation < Google::Apis::Core::JsonRepresentation
228
+ property :collection, as: 'collection'
229
+ property :item_id, as: 'itemId'
230
+ property :operation, as: 'operation'
231
+ collection :user_actions, as: 'userActions', class: Google::Apis::MirrorV1::UserAction, decorator: Google::Apis::MirrorV1::UserAction::Representation
232
+
233
+ property :user_token, as: 'userToken'
234
+ property :verify_token, as: 'verifyToken'
235
+ end
236
+ end
237
+
238
+ class NotificationConfig
239
+ # @private
240
+ class Representation < Google::Apis::Core::JsonRepresentation
241
+ property :delivery_time, as: 'deliveryTime', type: DateTime
242
+
243
+ property :level, as: 'level'
244
+ end
245
+ end
246
+
247
+ class Setting
248
+ # @private
249
+ class Representation < Google::Apis::Core::JsonRepresentation
250
+ property :id, as: 'id'
251
+ property :kind, as: 'kind'
252
+ property :value, as: 'value'
253
+ end
254
+ end
255
+
256
+ class Subscription
257
+ # @private
258
+ class Representation < Google::Apis::Core::JsonRepresentation
259
+ property :callback_url, as: 'callbackUrl'
260
+ property :collection, as: 'collection'
261
+ property :id, as: 'id'
262
+ property :kind, as: 'kind'
263
+ property :notification, as: 'notification', class: Google::Apis::MirrorV1::Notification, decorator: Google::Apis::MirrorV1::Notification::Representation
264
+
265
+ collection :operation, as: 'operation'
266
+ property :updated, as: 'updated', type: DateTime
267
+
268
+ property :user_token, as: 'userToken'
269
+ property :verify_token, as: 'verifyToken'
270
+ end
271
+ end
272
+
273
+ class ListSubscriptionsResponse
274
+ # @private
275
+ class Representation < Google::Apis::Core::JsonRepresentation
276
+ collection :items, as: 'items', class: Google::Apis::MirrorV1::Subscription, decorator: Google::Apis::MirrorV1::Subscription::Representation
277
+
278
+ property :kind, as: 'kind'
279
+ end
280
+ end
281
+
282
+ class TimelineItem
283
+ # @private
284
+ class Representation < Google::Apis::Core::JsonRepresentation
285
+ collection :attachments, as: 'attachments', class: Google::Apis::MirrorV1::Attachment, decorator: Google::Apis::MirrorV1::Attachment::Representation
286
+
287
+ property :bundle_id, as: 'bundleId'
288
+ property :canonical_url, as: 'canonicalUrl'
289
+ property :created, as: 'created', type: DateTime
290
+
291
+ property :creator, as: 'creator', class: Google::Apis::MirrorV1::Contact, decorator: Google::Apis::MirrorV1::Contact::Representation
292
+
293
+ property :display_time, as: 'displayTime', type: DateTime
294
+
295
+ property :etag, as: 'etag'
296
+ property :html, as: 'html'
297
+ property :id, as: 'id'
298
+ property :in_reply_to, as: 'inReplyTo'
299
+ property :is_bundle_cover, as: 'isBundleCover'
300
+ property :is_deleted, as: 'isDeleted'
301
+ property :is_pinned, as: 'isPinned'
302
+ property :kind, as: 'kind'
303
+ property :location, as: 'location', class: Google::Apis::MirrorV1::Location, decorator: Google::Apis::MirrorV1::Location::Representation
304
+
305
+ collection :menu_items, as: 'menuItems', class: Google::Apis::MirrorV1::MenuItem, decorator: Google::Apis::MirrorV1::MenuItem::Representation
306
+
307
+ property :notification, as: 'notification', class: Google::Apis::MirrorV1::NotificationConfig, decorator: Google::Apis::MirrorV1::NotificationConfig::Representation
308
+
309
+ property :pin_score, as: 'pinScore'
310
+ collection :recipients, as: 'recipients', class: Google::Apis::MirrorV1::Contact, decorator: Google::Apis::MirrorV1::Contact::Representation
311
+
312
+ property :self_link, as: 'selfLink'
313
+ property :source_item_id, as: 'sourceItemId'
314
+ property :speakable_text, as: 'speakableText'
315
+ property :speakable_type, as: 'speakableType'
316
+ property :text, as: 'text'
317
+ property :title, as: 'title'
318
+ property :updated, as: 'updated', type: DateTime
319
+
320
+ end
321
+ end
322
+
323
+ class ListTimelineResponse
324
+ # @private
325
+ class Representation < Google::Apis::Core::JsonRepresentation
326
+ collection :items, as: 'items', class: Google::Apis::MirrorV1::TimelineItem, decorator: Google::Apis::MirrorV1::TimelineItem::Representation
327
+
328
+ property :kind, as: 'kind'
329
+ property :next_page_token, as: 'nextPageToken'
330
+ end
331
+ end
332
+
333
+ class UserAction
334
+ # @private
335
+ class Representation < Google::Apis::Core::JsonRepresentation
336
+ property :payload, as: 'payload'
337
+ property :type, as: 'type'
338
+ end
339
+ end
340
+
341
+ class UserData
342
+ # @private
343
+ class Representation < Google::Apis::Core::JsonRepresentation
344
+ property :key, as: 'key'
345
+ property :value, as: 'value'
346
+ end
347
+ end
348
+ end
349
+ end
350
+ end
@@ -0,0 +1,1001 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module MirrorV1
23
+ # Google Mirror API
24
+ #
25
+ # API for interacting with Glass users via the timeline.
26
+ #
27
+ # @example
28
+ # require 'google/apis/mirror_v1'
29
+ #
30
+ # Mirror = Google::Apis::MirrorV1 # Alias the module
31
+ # service = Mirror::MirrorService.new
32
+ #
33
+ # @see https://developers.google.com/glass
34
+ class MirrorService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ # Overrides userIp if both are provided.
44
+ attr_accessor :quota_user
45
+
46
+ # @return [String]
47
+ # IP address of the site where the request originates. Use this if you want to
48
+ # enforce per-user limits.
49
+ attr_accessor :user_ip
50
+
51
+ def initialize
52
+ super('https://www.googleapis.com/', 'mirror/v1/')
53
+ end
54
+
55
+ # Inserts a new account for a user
56
+ # @param [String] user_token
57
+ # The ID for the user.
58
+ # @param [String] account_type
59
+ # Account type to be passed to Android Account Manager.
60
+ # @param [String] account_name
61
+ # The name of the account to be passed to the Android Account Manager.
62
+ # @param [Google::Apis::MirrorV1::Account] account_object
63
+ # @param [String] fields
64
+ # Selector specifying which fields to include in a partial response.
65
+ # @param [String] quota_user
66
+ # Available to use for quota purposes for server-side applications. Can be any
67
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
68
+ # Overrides userIp if both are provided.
69
+ # @param [String] user_ip
70
+ # IP address of the site where the request originates. Use this if you want to
71
+ # enforce per-user limits.
72
+ # @param [Google::Apis::RequestOptions] options
73
+ # Request-specific options
74
+ #
75
+ # @yield [result, err] Result & error if block supplied
76
+ # @yieldparam result [Google::Apis::MirrorV1::Account] parsed result object
77
+ # @yieldparam err [StandardError] error object if request failed
78
+ #
79
+ # @return [Google::Apis::MirrorV1::Account]
80
+ #
81
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
82
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
83
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
84
+ def insert_account(user_token, account_type, account_name, account_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
85
+ path = 'accounts/{userToken}/{accountType}/{accountName}'
86
+ command = make_simple_command(:post, path, options)
87
+ command.request_representation = Google::Apis::MirrorV1::Account::Representation
88
+ command.request_object = account_object
89
+ command.response_representation = Google::Apis::MirrorV1::Account::Representation
90
+ command.response_class = Google::Apis::MirrorV1::Account
91
+ command.params['userToken'] = user_token unless user_token.nil?
92
+ command.params['accountType'] = account_type unless account_type.nil?
93
+ command.params['accountName'] = account_name unless account_name.nil?
94
+ command.query['fields'] = fields unless fields.nil?
95
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
96
+ command.query['userIp'] = user_ip unless user_ip.nil?
97
+ execute_or_queue_command(command, &block)
98
+ end
99
+
100
+ # Deletes a contact.
101
+ # @param [String] id
102
+ # The ID of the contact.
103
+ # @param [String] fields
104
+ # Selector specifying which fields to include in a partial response.
105
+ # @param [String] quota_user
106
+ # Available to use for quota purposes for server-side applications. Can be any
107
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
108
+ # Overrides userIp if both are provided.
109
+ # @param [String] user_ip
110
+ # IP address of the site where the request originates. Use this if you want to
111
+ # enforce per-user limits.
112
+ # @param [Google::Apis::RequestOptions] options
113
+ # Request-specific options
114
+ #
115
+ # @yield [result, err] Result & error if block supplied
116
+ # @yieldparam result [NilClass] No result returned for this method
117
+ # @yieldparam err [StandardError] error object if request failed
118
+ #
119
+ # @return [void]
120
+ #
121
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
122
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
123
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
124
+ def delete_contact(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
125
+ path = 'contacts/{id}'
126
+ command = make_simple_command(:delete, path, options)
127
+ command.params['id'] = id unless id.nil?
128
+ command.query['fields'] = fields unless fields.nil?
129
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
130
+ command.query['userIp'] = user_ip unless user_ip.nil?
131
+ execute_or_queue_command(command, &block)
132
+ end
133
+
134
+ # Gets a single contact by ID.
135
+ # @param [String] id
136
+ # The ID of the contact.
137
+ # @param [String] fields
138
+ # Selector specifying which fields to include in a partial response.
139
+ # @param [String] quota_user
140
+ # Available to use for quota purposes for server-side applications. Can be any
141
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
142
+ # Overrides userIp if both are provided.
143
+ # @param [String] user_ip
144
+ # IP address of the site where the request originates. Use this if you want to
145
+ # enforce per-user limits.
146
+ # @param [Google::Apis::RequestOptions] options
147
+ # Request-specific options
148
+ #
149
+ # @yield [result, err] Result & error if block supplied
150
+ # @yieldparam result [Google::Apis::MirrorV1::Contact] parsed result object
151
+ # @yieldparam err [StandardError] error object if request failed
152
+ #
153
+ # @return [Google::Apis::MirrorV1::Contact]
154
+ #
155
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
156
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
157
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
158
+ def get_contact(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
159
+ path = 'contacts/{id}'
160
+ command = make_simple_command(:get, path, options)
161
+ command.response_representation = Google::Apis::MirrorV1::Contact::Representation
162
+ command.response_class = Google::Apis::MirrorV1::Contact
163
+ command.params['id'] = id unless id.nil?
164
+ command.query['fields'] = fields unless fields.nil?
165
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
166
+ command.query['userIp'] = user_ip unless user_ip.nil?
167
+ execute_or_queue_command(command, &block)
168
+ end
169
+
170
+ # Inserts a new contact.
171
+ # @param [Google::Apis::MirrorV1::Contact] contact_object
172
+ # @param [String] fields
173
+ # Selector specifying which fields to include in a partial response.
174
+ # @param [String] quota_user
175
+ # Available to use for quota purposes for server-side applications. Can be any
176
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
177
+ # Overrides userIp if both are provided.
178
+ # @param [String] user_ip
179
+ # IP address of the site where the request originates. Use this if you want to
180
+ # enforce per-user limits.
181
+ # @param [Google::Apis::RequestOptions] options
182
+ # Request-specific options
183
+ #
184
+ # @yield [result, err] Result & error if block supplied
185
+ # @yieldparam result [Google::Apis::MirrorV1::Contact] parsed result object
186
+ # @yieldparam err [StandardError] error object if request failed
187
+ #
188
+ # @return [Google::Apis::MirrorV1::Contact]
189
+ #
190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
193
+ def insert_contact(contact_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
194
+ path = 'contacts'
195
+ command = make_simple_command(:post, path, options)
196
+ command.request_representation = Google::Apis::MirrorV1::Contact::Representation
197
+ command.request_object = contact_object
198
+ command.response_representation = Google::Apis::MirrorV1::Contact::Representation
199
+ command.response_class = Google::Apis::MirrorV1::Contact
200
+ command.query['fields'] = fields unless fields.nil?
201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
202
+ command.query['userIp'] = user_ip unless user_ip.nil?
203
+ execute_or_queue_command(command, &block)
204
+ end
205
+
206
+ # Retrieves a list of contacts for the authenticated user.
207
+ # @param [String] fields
208
+ # Selector specifying which fields to include in a partial response.
209
+ # @param [String] quota_user
210
+ # Available to use for quota purposes for server-side applications. Can be any
211
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
212
+ # Overrides userIp if both are provided.
213
+ # @param [String] user_ip
214
+ # IP address of the site where the request originates. Use this if you want to
215
+ # enforce per-user limits.
216
+ # @param [Google::Apis::RequestOptions] options
217
+ # Request-specific options
218
+ #
219
+ # @yield [result, err] Result & error if block supplied
220
+ # @yieldparam result [Google::Apis::MirrorV1::ListContactsResponse] parsed result object
221
+ # @yieldparam err [StandardError] error object if request failed
222
+ #
223
+ # @return [Google::Apis::MirrorV1::ListContactsResponse]
224
+ #
225
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
226
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
227
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
228
+ def list_contacts(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
229
+ path = 'contacts'
230
+ command = make_simple_command(:get, path, options)
231
+ command.response_representation = Google::Apis::MirrorV1::ListContactsResponse::Representation
232
+ command.response_class = Google::Apis::MirrorV1::ListContactsResponse
233
+ command.query['fields'] = fields unless fields.nil?
234
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
235
+ command.query['userIp'] = user_ip unless user_ip.nil?
236
+ execute_or_queue_command(command, &block)
237
+ end
238
+
239
+ # Updates a contact in place. This method supports patch semantics.
240
+ # @param [String] id
241
+ # The ID of the contact.
242
+ # @param [Google::Apis::MirrorV1::Contact] contact_object
243
+ # @param [String] fields
244
+ # Selector specifying which fields to include in a partial response.
245
+ # @param [String] quota_user
246
+ # Available to use for quota purposes for server-side applications. Can be any
247
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
248
+ # Overrides userIp if both are provided.
249
+ # @param [String] user_ip
250
+ # IP address of the site where the request originates. Use this if you want to
251
+ # enforce per-user limits.
252
+ # @param [Google::Apis::RequestOptions] options
253
+ # Request-specific options
254
+ #
255
+ # @yield [result, err] Result & error if block supplied
256
+ # @yieldparam result [Google::Apis::MirrorV1::Contact] parsed result object
257
+ # @yieldparam err [StandardError] error object if request failed
258
+ #
259
+ # @return [Google::Apis::MirrorV1::Contact]
260
+ #
261
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
262
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
263
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
264
+ def patch_contact(id, contact_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
265
+ path = 'contacts/{id}'
266
+ command = make_simple_command(:patch, path, options)
267
+ command.request_representation = Google::Apis::MirrorV1::Contact::Representation
268
+ command.request_object = contact_object
269
+ command.response_representation = Google::Apis::MirrorV1::Contact::Representation
270
+ command.response_class = Google::Apis::MirrorV1::Contact
271
+ command.params['id'] = id unless id.nil?
272
+ command.query['fields'] = fields unless fields.nil?
273
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
274
+ command.query['userIp'] = user_ip unless user_ip.nil?
275
+ execute_or_queue_command(command, &block)
276
+ end
277
+
278
+ # Updates a contact in place.
279
+ # @param [String] id
280
+ # The ID of the contact.
281
+ # @param [Google::Apis::MirrorV1::Contact] contact_object
282
+ # @param [String] fields
283
+ # Selector specifying which fields to include in a partial response.
284
+ # @param [String] quota_user
285
+ # Available to use for quota purposes for server-side applications. Can be any
286
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
287
+ # Overrides userIp if both are provided.
288
+ # @param [String] user_ip
289
+ # IP address of the site where the request originates. Use this if you want to
290
+ # enforce per-user limits.
291
+ # @param [Google::Apis::RequestOptions] options
292
+ # Request-specific options
293
+ #
294
+ # @yield [result, err] Result & error if block supplied
295
+ # @yieldparam result [Google::Apis::MirrorV1::Contact] parsed result object
296
+ # @yieldparam err [StandardError] error object if request failed
297
+ #
298
+ # @return [Google::Apis::MirrorV1::Contact]
299
+ #
300
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
301
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
302
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
303
+ def update_contact(id, contact_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
304
+ path = 'contacts/{id}'
305
+ command = make_simple_command(:put, path, options)
306
+ command.request_representation = Google::Apis::MirrorV1::Contact::Representation
307
+ command.request_object = contact_object
308
+ command.response_representation = Google::Apis::MirrorV1::Contact::Representation
309
+ command.response_class = Google::Apis::MirrorV1::Contact
310
+ command.params['id'] = id unless id.nil?
311
+ command.query['fields'] = fields unless fields.nil?
312
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
313
+ command.query['userIp'] = user_ip unless user_ip.nil?
314
+ execute_or_queue_command(command, &block)
315
+ end
316
+
317
+ # Gets a single location by ID.
318
+ # @param [String] id
319
+ # The ID of the location or latest for the last known location.
320
+ # @param [String] fields
321
+ # Selector specifying which fields to include in a partial response.
322
+ # @param [String] quota_user
323
+ # Available to use for quota purposes for server-side applications. Can be any
324
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
325
+ # Overrides userIp if both are provided.
326
+ # @param [String] user_ip
327
+ # IP address of the site where the request originates. Use this if you want to
328
+ # enforce per-user limits.
329
+ # @param [Google::Apis::RequestOptions] options
330
+ # Request-specific options
331
+ #
332
+ # @yield [result, err] Result & error if block supplied
333
+ # @yieldparam result [Google::Apis::MirrorV1::Location] parsed result object
334
+ # @yieldparam err [StandardError] error object if request failed
335
+ #
336
+ # @return [Google::Apis::MirrorV1::Location]
337
+ #
338
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
339
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
340
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
341
+ def get_location(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
342
+ path = 'locations/{id}'
343
+ command = make_simple_command(:get, path, options)
344
+ command.response_representation = Google::Apis::MirrorV1::Location::Representation
345
+ command.response_class = Google::Apis::MirrorV1::Location
346
+ command.params['id'] = id unless id.nil?
347
+ command.query['fields'] = fields unless fields.nil?
348
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
349
+ command.query['userIp'] = user_ip unless user_ip.nil?
350
+ execute_or_queue_command(command, &block)
351
+ end
352
+
353
+ # Retrieves a list of locations for the user.
354
+ # @param [String] fields
355
+ # Selector specifying which fields to include in a partial response.
356
+ # @param [String] quota_user
357
+ # Available to use for quota purposes for server-side applications. Can be any
358
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
359
+ # Overrides userIp if both are provided.
360
+ # @param [String] user_ip
361
+ # IP address of the site where the request originates. Use this if you want to
362
+ # enforce per-user limits.
363
+ # @param [Google::Apis::RequestOptions] options
364
+ # Request-specific options
365
+ #
366
+ # @yield [result, err] Result & error if block supplied
367
+ # @yieldparam result [Google::Apis::MirrorV1::ListLocationsResponse] parsed result object
368
+ # @yieldparam err [StandardError] error object if request failed
369
+ #
370
+ # @return [Google::Apis::MirrorV1::ListLocationsResponse]
371
+ #
372
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
373
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
374
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
375
+ def list_locations(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
376
+ path = 'locations'
377
+ command = make_simple_command(:get, path, options)
378
+ command.response_representation = Google::Apis::MirrorV1::ListLocationsResponse::Representation
379
+ command.response_class = Google::Apis::MirrorV1::ListLocationsResponse
380
+ command.query['fields'] = fields unless fields.nil?
381
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
382
+ command.query['userIp'] = user_ip unless user_ip.nil?
383
+ execute_or_queue_command(command, &block)
384
+ end
385
+
386
+ # Gets a single setting by ID.
387
+ # @param [String] id
388
+ # The ID of the setting. The following IDs are valid:
389
+ # - locale - The key to the user’s language/locale (BCP 47 identifier) that
390
+ # Glassware should use to render localized content.
391
+ # - timezone - The key to the user’s current time zone region as defined in the
392
+ # tz database. Example: America/Los_Angeles.
393
+ # @param [String] fields
394
+ # Selector specifying which fields to include in a partial response.
395
+ # @param [String] quota_user
396
+ # Available to use for quota purposes for server-side applications. Can be any
397
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
398
+ # Overrides userIp if both are provided.
399
+ # @param [String] user_ip
400
+ # IP address of the site where the request originates. Use this if you want to
401
+ # enforce per-user limits.
402
+ # @param [Google::Apis::RequestOptions] options
403
+ # Request-specific options
404
+ #
405
+ # @yield [result, err] Result & error if block supplied
406
+ # @yieldparam result [Google::Apis::MirrorV1::Setting] parsed result object
407
+ # @yieldparam err [StandardError] error object if request failed
408
+ #
409
+ # @return [Google::Apis::MirrorV1::Setting]
410
+ #
411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
414
+ def get_setting(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
415
+ path = 'settings/{id}'
416
+ command = make_simple_command(:get, path, options)
417
+ command.response_representation = Google::Apis::MirrorV1::Setting::Representation
418
+ command.response_class = Google::Apis::MirrorV1::Setting
419
+ command.params['id'] = id unless id.nil?
420
+ command.query['fields'] = fields unless fields.nil?
421
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
422
+ command.query['userIp'] = user_ip unless user_ip.nil?
423
+ execute_or_queue_command(command, &block)
424
+ end
425
+
426
+ # Deletes a subscription.
427
+ # @param [String] id
428
+ # The ID of the subscription.
429
+ # @param [String] fields
430
+ # Selector specifying which fields to include in a partial response.
431
+ # @param [String] quota_user
432
+ # Available to use for quota purposes for server-side applications. Can be any
433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
434
+ # Overrides userIp if both are provided.
435
+ # @param [String] user_ip
436
+ # IP address of the site where the request originates. Use this if you want to
437
+ # enforce per-user limits.
438
+ # @param [Google::Apis::RequestOptions] options
439
+ # Request-specific options
440
+ #
441
+ # @yield [result, err] Result & error if block supplied
442
+ # @yieldparam result [NilClass] No result returned for this method
443
+ # @yieldparam err [StandardError] error object if request failed
444
+ #
445
+ # @return [void]
446
+ #
447
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
448
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
449
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
450
+ def delete_subscription(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
451
+ path = 'subscriptions/{id}'
452
+ command = make_simple_command(:delete, path, options)
453
+ command.params['id'] = id unless id.nil?
454
+ command.query['fields'] = fields unless fields.nil?
455
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
456
+ command.query['userIp'] = user_ip unless user_ip.nil?
457
+ execute_or_queue_command(command, &block)
458
+ end
459
+
460
+ # Creates a new subscription.
461
+ # @param [Google::Apis::MirrorV1::Subscription] subscription_object
462
+ # @param [String] fields
463
+ # Selector specifying which fields to include in a partial response.
464
+ # @param [String] quota_user
465
+ # Available to use for quota purposes for server-side applications. Can be any
466
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
467
+ # Overrides userIp if both are provided.
468
+ # @param [String] user_ip
469
+ # IP address of the site where the request originates. Use this if you want to
470
+ # enforce per-user limits.
471
+ # @param [Google::Apis::RequestOptions] options
472
+ # Request-specific options
473
+ #
474
+ # @yield [result, err] Result & error if block supplied
475
+ # @yieldparam result [Google::Apis::MirrorV1::Subscription] parsed result object
476
+ # @yieldparam err [StandardError] error object if request failed
477
+ #
478
+ # @return [Google::Apis::MirrorV1::Subscription]
479
+ #
480
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
481
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
482
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
483
+ def insert_subscription(subscription_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
484
+ path = 'subscriptions'
485
+ command = make_simple_command(:post, path, options)
486
+ command.request_representation = Google::Apis::MirrorV1::Subscription::Representation
487
+ command.request_object = subscription_object
488
+ command.response_representation = Google::Apis::MirrorV1::Subscription::Representation
489
+ command.response_class = Google::Apis::MirrorV1::Subscription
490
+ command.query['fields'] = fields unless fields.nil?
491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
492
+ command.query['userIp'] = user_ip unless user_ip.nil?
493
+ execute_or_queue_command(command, &block)
494
+ end
495
+
496
+ # Retrieves a list of subscriptions for the authenticated user and service.
497
+ # @param [String] fields
498
+ # Selector specifying which fields to include in a partial response.
499
+ # @param [String] quota_user
500
+ # Available to use for quota purposes for server-side applications. Can be any
501
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
502
+ # Overrides userIp if both are provided.
503
+ # @param [String] user_ip
504
+ # IP address of the site where the request originates. Use this if you want to
505
+ # enforce per-user limits.
506
+ # @param [Google::Apis::RequestOptions] options
507
+ # Request-specific options
508
+ #
509
+ # @yield [result, err] Result & error if block supplied
510
+ # @yieldparam result [Google::Apis::MirrorV1::ListSubscriptionsResponse] parsed result object
511
+ # @yieldparam err [StandardError] error object if request failed
512
+ #
513
+ # @return [Google::Apis::MirrorV1::ListSubscriptionsResponse]
514
+ #
515
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
516
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
517
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
518
+ def list_subscriptions(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
519
+ path = 'subscriptions'
520
+ command = make_simple_command(:get, path, options)
521
+ command.response_representation = Google::Apis::MirrorV1::ListSubscriptionsResponse::Representation
522
+ command.response_class = Google::Apis::MirrorV1::ListSubscriptionsResponse
523
+ command.query['fields'] = fields unless fields.nil?
524
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
525
+ command.query['userIp'] = user_ip unless user_ip.nil?
526
+ execute_or_queue_command(command, &block)
527
+ end
528
+
529
+ # Updates an existing subscription in place.
530
+ # @param [String] id
531
+ # The ID of the subscription.
532
+ # @param [Google::Apis::MirrorV1::Subscription] subscription_object
533
+ # @param [String] fields
534
+ # Selector specifying which fields to include in a partial response.
535
+ # @param [String] quota_user
536
+ # Available to use for quota purposes for server-side applications. Can be any
537
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
538
+ # Overrides userIp if both are provided.
539
+ # @param [String] user_ip
540
+ # IP address of the site where the request originates. Use this if you want to
541
+ # enforce per-user limits.
542
+ # @param [Google::Apis::RequestOptions] options
543
+ # Request-specific options
544
+ #
545
+ # @yield [result, err] Result & error if block supplied
546
+ # @yieldparam result [Google::Apis::MirrorV1::Subscription] parsed result object
547
+ # @yieldparam err [StandardError] error object if request failed
548
+ #
549
+ # @return [Google::Apis::MirrorV1::Subscription]
550
+ #
551
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
552
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
553
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
554
+ def update_subscription(id, subscription_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
555
+ path = 'subscriptions/{id}'
556
+ command = make_simple_command(:put, path, options)
557
+ command.request_representation = Google::Apis::MirrorV1::Subscription::Representation
558
+ command.request_object = subscription_object
559
+ command.response_representation = Google::Apis::MirrorV1::Subscription::Representation
560
+ command.response_class = Google::Apis::MirrorV1::Subscription
561
+ command.params['id'] = id unless id.nil?
562
+ command.query['fields'] = fields unless fields.nil?
563
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
564
+ command.query['userIp'] = user_ip unless user_ip.nil?
565
+ execute_or_queue_command(command, &block)
566
+ end
567
+
568
+ # Deletes a timeline item.
569
+ # @param [String] id
570
+ # The ID of the timeline item.
571
+ # @param [String] fields
572
+ # Selector specifying which fields to include in a partial response.
573
+ # @param [String] quota_user
574
+ # Available to use for quota purposes for server-side applications. Can be any
575
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
576
+ # Overrides userIp if both are provided.
577
+ # @param [String] user_ip
578
+ # IP address of the site where the request originates. Use this if you want to
579
+ # enforce per-user limits.
580
+ # @param [Google::Apis::RequestOptions] options
581
+ # Request-specific options
582
+ #
583
+ # @yield [result, err] Result & error if block supplied
584
+ # @yieldparam result [NilClass] No result returned for this method
585
+ # @yieldparam err [StandardError] error object if request failed
586
+ #
587
+ # @return [void]
588
+ #
589
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
590
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
591
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
592
+ def delete_timeline(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
593
+ path = 'timeline/{id}'
594
+ command = make_simple_command(:delete, path, options)
595
+ command.params['id'] = id unless id.nil?
596
+ command.query['fields'] = fields unless fields.nil?
597
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
598
+ command.query['userIp'] = user_ip unless user_ip.nil?
599
+ execute_or_queue_command(command, &block)
600
+ end
601
+
602
+ # Gets a single timeline item by ID.
603
+ # @param [String] id
604
+ # The ID of the timeline item.
605
+ # @param [String] fields
606
+ # Selector specifying which fields to include in a partial response.
607
+ # @param [String] quota_user
608
+ # Available to use for quota purposes for server-side applications. Can be any
609
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
610
+ # Overrides userIp if both are provided.
611
+ # @param [String] user_ip
612
+ # IP address of the site where the request originates. Use this if you want to
613
+ # enforce per-user limits.
614
+ # @param [Google::Apis::RequestOptions] options
615
+ # Request-specific options
616
+ #
617
+ # @yield [result, err] Result & error if block supplied
618
+ # @yieldparam result [Google::Apis::MirrorV1::TimelineItem] parsed result object
619
+ # @yieldparam err [StandardError] error object if request failed
620
+ #
621
+ # @return [Google::Apis::MirrorV1::TimelineItem]
622
+ #
623
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
624
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
625
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
626
+ def get_timeline(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
627
+ path = 'timeline/{id}'
628
+ command = make_simple_command(:get, path, options)
629
+ command.response_representation = Google::Apis::MirrorV1::TimelineItem::Representation
630
+ command.response_class = Google::Apis::MirrorV1::TimelineItem
631
+ command.params['id'] = id unless id.nil?
632
+ command.query['fields'] = fields unless fields.nil?
633
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
634
+ command.query['userIp'] = user_ip unless user_ip.nil?
635
+ execute_or_queue_command(command, &block)
636
+ end
637
+
638
+ # Inserts a new item into the timeline.
639
+ # @param [Google::Apis::MirrorV1::TimelineItem] timeline_item_object
640
+ # @param [String] fields
641
+ # Selector specifying which fields to include in a partial response.
642
+ # @param [String] quota_user
643
+ # Available to use for quota purposes for server-side applications. Can be any
644
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
645
+ # Overrides userIp if both are provided.
646
+ # @param [String] user_ip
647
+ # IP address of the site where the request originates. Use this if you want to
648
+ # enforce per-user limits.
649
+ # @param [IO, String] upload_source
650
+ # IO stream or filename containing content to upload
651
+ # @param [String] content_type
652
+ # Content type of the uploaded content.
653
+ # @param [Google::Apis::RequestOptions] options
654
+ # Request-specific options
655
+ #
656
+ # @yield [result, err] Result & error if block supplied
657
+ # @yieldparam result [Google::Apis::MirrorV1::TimelineItem] parsed result object
658
+ # @yieldparam err [StandardError] error object if request failed
659
+ #
660
+ # @return [Google::Apis::MirrorV1::TimelineItem]
661
+ #
662
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
663
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
664
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
665
+ def insert_timeline(timeline_item_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
666
+ path = 'timeline'
667
+ if upload_source.nil?
668
+ command = make_simple_command(:post, path, options)
669
+ else
670
+ command = make_upload_command(:post, path, options)
671
+ command.upload_source = upload_source
672
+ command.upload_content_type = content_type
673
+ end
674
+ command.request_representation = Google::Apis::MirrorV1::TimelineItem::Representation
675
+ command.request_object = timeline_item_object
676
+ command.response_representation = Google::Apis::MirrorV1::TimelineItem::Representation
677
+ command.response_class = Google::Apis::MirrorV1::TimelineItem
678
+ command.query['fields'] = fields unless fields.nil?
679
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
680
+ command.query['userIp'] = user_ip unless user_ip.nil?
681
+ execute_or_queue_command(command, &block)
682
+ end
683
+
684
+ # Retrieves a list of timeline items for the authenticated user.
685
+ # @param [String] bundle_id
686
+ # If provided, only items with the given bundleId will be returned.
687
+ # @param [Boolean] include_deleted
688
+ # If true, tombstone records for deleted items will be returned.
689
+ # @param [Fixnum] max_results
690
+ # The maximum number of items to include in the response, used for paging.
691
+ # @param [String] order_by
692
+ # Controls the order in which timeline items are returned.
693
+ # @param [String] page_token
694
+ # Token for the page of results to return.
695
+ # @param [Boolean] pinned_only
696
+ # If true, only pinned items will be returned.
697
+ # @param [String] source_item_id
698
+ # If provided, only items with the given sourceItemId will be returned.
699
+ # @param [String] fields
700
+ # Selector specifying which fields to include in a partial response.
701
+ # @param [String] quota_user
702
+ # Available to use for quota purposes for server-side applications. Can be any
703
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
704
+ # Overrides userIp if both are provided.
705
+ # @param [String] user_ip
706
+ # IP address of the site where the request originates. Use this if you want to
707
+ # enforce per-user limits.
708
+ # @param [Google::Apis::RequestOptions] options
709
+ # Request-specific options
710
+ #
711
+ # @yield [result, err] Result & error if block supplied
712
+ # @yieldparam result [Google::Apis::MirrorV1::ListTimelineResponse] parsed result object
713
+ # @yieldparam err [StandardError] error object if request failed
714
+ #
715
+ # @return [Google::Apis::MirrorV1::ListTimelineResponse]
716
+ #
717
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
718
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
719
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
720
+ def list_timelines(bundle_id: nil, include_deleted: nil, max_results: nil, order_by: nil, page_token: nil, pinned_only: nil, source_item_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
721
+ path = 'timeline'
722
+ command = make_simple_command(:get, path, options)
723
+ command.response_representation = Google::Apis::MirrorV1::ListTimelineResponse::Representation
724
+ command.response_class = Google::Apis::MirrorV1::ListTimelineResponse
725
+ command.query['bundleId'] = bundle_id unless bundle_id.nil?
726
+ command.query['includeDeleted'] = include_deleted unless include_deleted.nil?
727
+ command.query['maxResults'] = max_results unless max_results.nil?
728
+ command.query['orderBy'] = order_by unless order_by.nil?
729
+ command.query['pageToken'] = page_token unless page_token.nil?
730
+ command.query['pinnedOnly'] = pinned_only unless pinned_only.nil?
731
+ command.query['sourceItemId'] = source_item_id unless source_item_id.nil?
732
+ command.query['fields'] = fields unless fields.nil?
733
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
734
+ command.query['userIp'] = user_ip unless user_ip.nil?
735
+ execute_or_queue_command(command, &block)
736
+ end
737
+
738
+ # Updates a timeline item in place. This method supports patch semantics.
739
+ # @param [String] id
740
+ # The ID of the timeline item.
741
+ # @param [Google::Apis::MirrorV1::TimelineItem] timeline_item_object
742
+ # @param [String] fields
743
+ # Selector specifying which fields to include in a partial response.
744
+ # @param [String] quota_user
745
+ # Available to use for quota purposes for server-side applications. Can be any
746
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
747
+ # Overrides userIp if both are provided.
748
+ # @param [String] user_ip
749
+ # IP address of the site where the request originates. Use this if you want to
750
+ # enforce per-user limits.
751
+ # @param [Google::Apis::RequestOptions] options
752
+ # Request-specific options
753
+ #
754
+ # @yield [result, err] Result & error if block supplied
755
+ # @yieldparam result [Google::Apis::MirrorV1::TimelineItem] parsed result object
756
+ # @yieldparam err [StandardError] error object if request failed
757
+ #
758
+ # @return [Google::Apis::MirrorV1::TimelineItem]
759
+ #
760
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
761
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
762
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
763
+ def patch_timeline(id, timeline_item_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
764
+ path = 'timeline/{id}'
765
+ command = make_simple_command(:patch, path, options)
766
+ command.request_representation = Google::Apis::MirrorV1::TimelineItem::Representation
767
+ command.request_object = timeline_item_object
768
+ command.response_representation = Google::Apis::MirrorV1::TimelineItem::Representation
769
+ command.response_class = Google::Apis::MirrorV1::TimelineItem
770
+ command.params['id'] = id unless id.nil?
771
+ command.query['fields'] = fields unless fields.nil?
772
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
773
+ command.query['userIp'] = user_ip unless user_ip.nil?
774
+ execute_or_queue_command(command, &block)
775
+ end
776
+
777
+ # Updates a timeline item in place.
778
+ # @param [String] id
779
+ # The ID of the timeline item.
780
+ # @param [Google::Apis::MirrorV1::TimelineItem] timeline_item_object
781
+ # @param [String] fields
782
+ # Selector specifying which fields to include in a partial response.
783
+ # @param [String] quota_user
784
+ # Available to use for quota purposes for server-side applications. Can be any
785
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
786
+ # Overrides userIp if both are provided.
787
+ # @param [String] user_ip
788
+ # IP address of the site where the request originates. Use this if you want to
789
+ # enforce per-user limits.
790
+ # @param [IO, String] upload_source
791
+ # IO stream or filename containing content to upload
792
+ # @param [String] content_type
793
+ # Content type of the uploaded content.
794
+ # @param [Google::Apis::RequestOptions] options
795
+ # Request-specific options
796
+ #
797
+ # @yield [result, err] Result & error if block supplied
798
+ # @yieldparam result [Google::Apis::MirrorV1::TimelineItem] parsed result object
799
+ # @yieldparam err [StandardError] error object if request failed
800
+ #
801
+ # @return [Google::Apis::MirrorV1::TimelineItem]
802
+ #
803
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
804
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
805
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
806
+ def update_timeline(id, timeline_item_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
807
+ path = 'timeline/{id}'
808
+ if upload_source.nil?
809
+ command = make_simple_command(:put, path, options)
810
+ else
811
+ command = make_upload_command(:put, path, options)
812
+ command.upload_source = upload_source
813
+ command.upload_content_type = content_type
814
+ end
815
+ command.request_representation = Google::Apis::MirrorV1::TimelineItem::Representation
816
+ command.request_object = timeline_item_object
817
+ command.response_representation = Google::Apis::MirrorV1::TimelineItem::Representation
818
+ command.response_class = Google::Apis::MirrorV1::TimelineItem
819
+ command.params['id'] = id unless id.nil?
820
+ command.query['fields'] = fields unless fields.nil?
821
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
822
+ command.query['userIp'] = user_ip unless user_ip.nil?
823
+ execute_or_queue_command(command, &block)
824
+ end
825
+
826
+ # Deletes an attachment from a timeline item.
827
+ # @param [String] item_id
828
+ # The ID of the timeline item the attachment belongs to.
829
+ # @param [String] attachment_id
830
+ # The ID of the attachment.
831
+ # @param [String] fields
832
+ # Selector specifying which fields to include in a partial response.
833
+ # @param [String] quota_user
834
+ # Available to use for quota purposes for server-side applications. Can be any
835
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
836
+ # Overrides userIp if both are provided.
837
+ # @param [String] user_ip
838
+ # IP address of the site where the request originates. Use this if you want to
839
+ # enforce per-user limits.
840
+ # @param [Google::Apis::RequestOptions] options
841
+ # Request-specific options
842
+ #
843
+ # @yield [result, err] Result & error if block supplied
844
+ # @yieldparam result [NilClass] No result returned for this method
845
+ # @yieldparam err [StandardError] error object if request failed
846
+ #
847
+ # @return [void]
848
+ #
849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
852
+ def delete_timeline_attachment(item_id, attachment_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
853
+ path = 'timeline/{itemId}/attachments/{attachmentId}'
854
+ command = make_simple_command(:delete, path, options)
855
+ command.params['itemId'] = item_id unless item_id.nil?
856
+ command.params['attachmentId'] = attachment_id unless attachment_id.nil?
857
+ command.query['fields'] = fields unless fields.nil?
858
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
859
+ command.query['userIp'] = user_ip unless user_ip.nil?
860
+ execute_or_queue_command(command, &block)
861
+ end
862
+
863
+ # Retrieves an attachment on a timeline item by item ID and attachment ID.
864
+ # @param [String] item_id
865
+ # The ID of the timeline item the attachment belongs to.
866
+ # @param [String] attachment_id
867
+ # The ID of the attachment.
868
+ # @param [String] fields
869
+ # Selector specifying which fields to include in a partial response.
870
+ # @param [String] quota_user
871
+ # Available to use for quota purposes for server-side applications. Can be any
872
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
873
+ # Overrides userIp if both are provided.
874
+ # @param [String] user_ip
875
+ # IP address of the site where the request originates. Use this if you want to
876
+ # enforce per-user limits.
877
+ # @param [IO, String] download_dest
878
+ # IO stream or filename to receive content download
879
+ # @param [Google::Apis::RequestOptions] options
880
+ # Request-specific options
881
+ #
882
+ # @yield [result, err] Result & error if block supplied
883
+ # @yieldparam result [Google::Apis::MirrorV1::Attachment] parsed result object
884
+ # @yieldparam err [StandardError] error object if request failed
885
+ #
886
+ # @return [Google::Apis::MirrorV1::Attachment]
887
+ #
888
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
889
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
890
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
891
+ def get_timeline_attachment(item_id, attachment_id, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
892
+ path = 'timeline/{itemId}/attachments/{attachmentId}'
893
+ if download_dest.nil?
894
+ command = make_simple_command(:get, path, options)
895
+ else
896
+ command = make_download_command(:get, path, options)
897
+ command.download_dest = download_dest
898
+ end
899
+ command.response_representation = Google::Apis::MirrorV1::Attachment::Representation
900
+ command.response_class = Google::Apis::MirrorV1::Attachment
901
+ command.params['itemId'] = item_id unless item_id.nil?
902
+ command.params['attachmentId'] = attachment_id unless attachment_id.nil?
903
+ command.query['fields'] = fields unless fields.nil?
904
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
905
+ command.query['userIp'] = user_ip unless user_ip.nil?
906
+ execute_or_queue_command(command, &block)
907
+ end
908
+
909
+ # Adds a new attachment to a timeline item.
910
+ # @param [String] item_id
911
+ # The ID of the timeline item the attachment belongs to.
912
+ # @param [String] fields
913
+ # Selector specifying which fields to include in a partial response.
914
+ # @param [String] quota_user
915
+ # Available to use for quota purposes for server-side applications. Can be any
916
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
917
+ # Overrides userIp if both are provided.
918
+ # @param [String] user_ip
919
+ # IP address of the site where the request originates. Use this if you want to
920
+ # enforce per-user limits.
921
+ # @param [IO, String] upload_source
922
+ # IO stream or filename containing content to upload
923
+ # @param [String] content_type
924
+ # Content type of the uploaded content.
925
+ # @param [Google::Apis::RequestOptions] options
926
+ # Request-specific options
927
+ #
928
+ # @yield [result, err] Result & error if block supplied
929
+ # @yieldparam result [Google::Apis::MirrorV1::Attachment] parsed result object
930
+ # @yieldparam err [StandardError] error object if request failed
931
+ #
932
+ # @return [Google::Apis::MirrorV1::Attachment]
933
+ #
934
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
935
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
936
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
937
+ def insert_timeline_attachment(item_id, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
938
+ path = 'timeline/{itemId}/attachments'
939
+ if upload_source.nil?
940
+ command = make_simple_command(:post, path, options)
941
+ else
942
+ command = make_upload_command(:post, path, options)
943
+ command.upload_source = upload_source
944
+ command.upload_content_type = content_type
945
+ end
946
+ command.response_representation = Google::Apis::MirrorV1::Attachment::Representation
947
+ command.response_class = Google::Apis::MirrorV1::Attachment
948
+ command.params['itemId'] = item_id unless item_id.nil?
949
+ command.query['fields'] = fields unless fields.nil?
950
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
951
+ command.query['userIp'] = user_ip unless user_ip.nil?
952
+ execute_or_queue_command(command, &block)
953
+ end
954
+
955
+ # Returns a list of attachments for a timeline item.
956
+ # @param [String] item_id
957
+ # The ID of the timeline item whose attachments should be listed.
958
+ # @param [String] fields
959
+ # Selector specifying which fields to include in a partial response.
960
+ # @param [String] quota_user
961
+ # Available to use for quota purposes for server-side applications. Can be any
962
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
963
+ # Overrides userIp if both are provided.
964
+ # @param [String] user_ip
965
+ # IP address of the site where the request originates. Use this if you want to
966
+ # enforce per-user limits.
967
+ # @param [Google::Apis::RequestOptions] options
968
+ # Request-specific options
969
+ #
970
+ # @yield [result, err] Result & error if block supplied
971
+ # @yieldparam result [Google::Apis::MirrorV1::ListAttachmentsResponse] parsed result object
972
+ # @yieldparam err [StandardError] error object if request failed
973
+ #
974
+ # @return [Google::Apis::MirrorV1::ListAttachmentsResponse]
975
+ #
976
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
977
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
978
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
979
+ def list_timeline_attachments(item_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
980
+ path = 'timeline/{itemId}/attachments'
981
+ command = make_simple_command(:get, path, options)
982
+ command.response_representation = Google::Apis::MirrorV1::ListAttachmentsResponse::Representation
983
+ command.response_class = Google::Apis::MirrorV1::ListAttachmentsResponse
984
+ command.params['itemId'] = item_id unless item_id.nil?
985
+ command.query['fields'] = fields unless fields.nil?
986
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
987
+ command.query['userIp'] = user_ip unless user_ip.nil?
988
+ execute_or_queue_command(command, &block)
989
+ end
990
+
991
+ protected
992
+
993
+ def apply_command_defaults(command)
994
+ command.query['key'] = key unless key.nil?
995
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
996
+ command.query['userIp'] = user_ip unless user_ip.nil?
997
+ end
998
+ end
999
+ end
1000
+ end
1001
+ end