google-api-client 0.8.7 → 0.9.pre1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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