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,3465 @@
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 MapsengineV1
23
+ # Google Maps Engine API
24
+ #
25
+ # The Google Maps Engine API allows developers to store and query geospatial
26
+ # vector and raster data.
27
+ #
28
+ # @example
29
+ # require 'google/apis/mapsengine_v1'
30
+ #
31
+ # Mapsengine = Google::Apis::MapsengineV1 # Alias the module
32
+ # service = Mapsengine::MapsEngineService.new
33
+ #
34
+ # @see https://developers.google.com/maps-engine/
35
+ class MapsEngineService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ # Overrides userIp if both are provided.
45
+ attr_accessor :quota_user
46
+
47
+ # @return [String]
48
+ # IP address of the site where the request originates. Use this if you want to
49
+ # enforce per-user limits.
50
+ attr_accessor :user_ip
51
+
52
+ def initialize
53
+ super('https://www.googleapis.com/', 'mapsengine/v1/')
54
+ end
55
+
56
+ # Return metadata for a particular asset.
57
+ # @param [String] id
58
+ # The ID of the asset.
59
+ # @param [String] fields
60
+ # Selector specifying which fields to include in a partial response.
61
+ # @param [String] quota_user
62
+ # Available to use for quota purposes for server-side applications. Can be any
63
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
64
+ # Overrides userIp if both are provided.
65
+ # @param [String] user_ip
66
+ # IP address of the site where the request originates. Use this if you want to
67
+ # enforce per-user limits.
68
+ # @param [Google::Apis::RequestOptions] options
69
+ # Request-specific options
70
+ #
71
+ # @yield [result, err] Result & error if block supplied
72
+ # @yieldparam result [Google::Apis::MapsengineV1::Asset] parsed result object
73
+ # @yieldparam err [StandardError] error object if request failed
74
+ #
75
+ # @return [Google::Apis::MapsengineV1::Asset]
76
+ #
77
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
78
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
79
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
80
+ def get_asset(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
81
+ path = 'assets/{id}'
82
+ command = make_simple_command(:get, path, options)
83
+ command.response_representation = Google::Apis::MapsengineV1::Asset::Representation
84
+ command.response_class = Google::Apis::MapsengineV1::Asset
85
+ command.params['id'] = id unless id.nil?
86
+ command.query['fields'] = fields unless fields.nil?
87
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
88
+ command.query['userIp'] = user_ip unless user_ip.nil?
89
+ execute_or_queue_command(command, &block)
90
+ end
91
+
92
+ # Return all assets readable by the current user.
93
+ # @param [String] bbox
94
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
95
+ # which intersect this bounding box will be returned.
96
+ # @param [DateTime] created_after
97
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
98
+ # assets will have been created at or after this time.
99
+ # @param [DateTime] created_before
100
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
101
+ # assets will have been created at or before this time.
102
+ # @param [String] creator_email
103
+ # An email address representing a user. Returned assets that have been created
104
+ # by the user associated with the provided email address.
105
+ # @param [Fixnum] max_results
106
+ # The maximum number of items to include in a single response page. The maximum
107
+ # supported value is 100.
108
+ # @param [DateTime] modified_after
109
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
110
+ # assets will have been modified at or after this time.
111
+ # @param [DateTime] modified_before
112
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
113
+ # assets will have been modified at or before this time.
114
+ # @param [String] page_token
115
+ # The continuation token, used to page through large result sets. To get the
116
+ # next page of results, set this parameter to the value of nextPageToken from
117
+ # the previous response.
118
+ # @param [String] project_id
119
+ # The ID of a Maps Engine project, used to filter the response. To list all
120
+ # available projects with their IDs, send a Projects: list request. You can also
121
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
122
+ # signed in to mapsengine.google.com.
123
+ # @param [String] role
124
+ # The role parameter indicates that the response should only contain assets
125
+ # where the current user has the specified level of access.
126
+ # @param [String] search
127
+ # An unstructured search string used to filter the set of results based on asset
128
+ # metadata.
129
+ # @param [String] tags
130
+ # A comma separated list of tags. Returned assets will contain all the tags from
131
+ # the list.
132
+ # @param [String] type
133
+ # A comma separated list of asset types. Returned assets will have one of the
134
+ # types from the provided list. Supported values are 'map', 'layer', '
135
+ # rasterCollection' and 'table'.
136
+ # @param [String] fields
137
+ # Selector specifying which fields to include in a partial response.
138
+ # @param [String] quota_user
139
+ # Available to use for quota purposes for server-side applications. Can be any
140
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
141
+ # Overrides userIp if both are provided.
142
+ # @param [String] user_ip
143
+ # IP address of the site where the request originates. Use this if you want to
144
+ # enforce per-user limits.
145
+ # @param [Google::Apis::RequestOptions] options
146
+ # Request-specific options
147
+ #
148
+ # @yield [result, err] Result & error if block supplied
149
+ # @yieldparam result [Google::Apis::MapsengineV1::ListAssetsResponse] parsed result object
150
+ # @yieldparam err [StandardError] error object if request failed
151
+ #
152
+ # @return [Google::Apis::MapsengineV1::ListAssetsResponse]
153
+ #
154
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
155
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
156
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
157
+ def list_assets(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, project_id: nil, role: nil, search: nil, tags: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
158
+ path = 'assets'
159
+ command = make_simple_command(:get, path, options)
160
+ command.response_representation = Google::Apis::MapsengineV1::ListAssetsResponse::Representation
161
+ command.response_class = Google::Apis::MapsengineV1::ListAssetsResponse
162
+ command.query['bbox'] = bbox unless bbox.nil?
163
+ command.query['createdAfter'] = created_after unless created_after.nil?
164
+ command.query['createdBefore'] = created_before unless created_before.nil?
165
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
166
+ command.query['maxResults'] = max_results unless max_results.nil?
167
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
168
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
169
+ command.query['pageToken'] = page_token unless page_token.nil?
170
+ command.query['projectId'] = project_id unless project_id.nil?
171
+ command.query['role'] = role unless role.nil?
172
+ command.query['search'] = search unless search.nil?
173
+ command.query['tags'] = tags unless tags.nil?
174
+ command.query['type'] = type unless type.nil?
175
+ command.query['fields'] = fields unless fields.nil?
176
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
177
+ command.query['userIp'] = user_ip unless user_ip.nil?
178
+ execute_or_queue_command(command, &block)
179
+ end
180
+
181
+ # Return all parent ids of the specified asset.
182
+ # @param [String] id
183
+ # The ID of the asset whose parents will be listed.
184
+ # @param [Fixnum] max_results
185
+ # The maximum number of items to include in a single response page. The maximum
186
+ # supported value is 50.
187
+ # @param [String] page_token
188
+ # The continuation token, used to page through large result sets. To get the
189
+ # next page of results, set this parameter to the value of nextPageToken from
190
+ # the previous response.
191
+ # @param [String] fields
192
+ # Selector specifying which fields to include in a partial response.
193
+ # @param [String] quota_user
194
+ # Available to use for quota purposes for server-side applications. Can be any
195
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
196
+ # Overrides userIp if both are provided.
197
+ # @param [String] user_ip
198
+ # IP address of the site where the request originates. Use this if you want to
199
+ # enforce per-user limits.
200
+ # @param [Google::Apis::RequestOptions] options
201
+ # Request-specific options
202
+ #
203
+ # @yield [result, err] Result & error if block supplied
204
+ # @yieldparam result [Google::Apis::MapsengineV1::ListParentsResponse] parsed result object
205
+ # @yieldparam err [StandardError] error object if request failed
206
+ #
207
+ # @return [Google::Apis::MapsengineV1::ListParentsResponse]
208
+ #
209
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
210
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
211
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
212
+ def list_asset_parents(id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
213
+ path = 'assets/{id}/parents'
214
+ command = make_simple_command(:get, path, options)
215
+ command.response_representation = Google::Apis::MapsengineV1::ListParentsResponse::Representation
216
+ command.response_class = Google::Apis::MapsengineV1::ListParentsResponse
217
+ command.params['id'] = id unless id.nil?
218
+ command.query['maxResults'] = max_results unless max_results.nil?
219
+ command.query['pageToken'] = page_token unless page_token.nil?
220
+ command.query['fields'] = fields unless fields.nil?
221
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
222
+ command.query['userIp'] = user_ip unless user_ip.nil?
223
+ execute_or_queue_command(command, &block)
224
+ end
225
+
226
+ # Return all of the permissions for the specified asset.
227
+ # @param [String] id
228
+ # The ID of the asset whose permissions will be listed.
229
+ # @param [String] fields
230
+ # Selector specifying which fields to include in a partial response.
231
+ # @param [String] quota_user
232
+ # Available to use for quota purposes for server-side applications. Can be any
233
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
234
+ # Overrides userIp if both are provided.
235
+ # @param [String] user_ip
236
+ # IP address of the site where the request originates. Use this if you want to
237
+ # enforce per-user limits.
238
+ # @param [Google::Apis::RequestOptions] options
239
+ # Request-specific options
240
+ #
241
+ # @yield [result, err] Result & error if block supplied
242
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
243
+ # @yieldparam err [StandardError] error object if request failed
244
+ #
245
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
246
+ #
247
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
248
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
249
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
250
+ def list_asset_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
251
+ path = 'assets/{id}/permissions'
252
+ command = make_simple_command(:get, path, options)
253
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
254
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
255
+ command.params['id'] = id unless id.nil?
256
+ command.query['fields'] = fields unless fields.nil?
257
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
258
+ command.query['userIp'] = user_ip unless user_ip.nil?
259
+ execute_or_queue_command(command, &block)
260
+ end
261
+
262
+ # Cancel processing on a layer asset.
263
+ # @param [String] id
264
+ # The ID of the layer.
265
+ # @param [String] fields
266
+ # Selector specifying which fields to include in a partial response.
267
+ # @param [String] quota_user
268
+ # Available to use for quota purposes for server-side applications. Can be any
269
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
270
+ # Overrides userIp if both are provided.
271
+ # @param [String] user_ip
272
+ # IP address of the site where the request originates. Use this if you want to
273
+ # enforce per-user limits.
274
+ # @param [Google::Apis::RequestOptions] options
275
+ # Request-specific options
276
+ #
277
+ # @yield [result, err] Result & error if block supplied
278
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
279
+ # @yieldparam err [StandardError] error object if request failed
280
+ #
281
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
282
+ #
283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
286
+ def cancel_processing_layer(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
287
+ path = 'layers/{id}/cancelProcessing'
288
+ command = make_simple_command(:post, path, options)
289
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
290
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
291
+ command.params['id'] = id unless id.nil?
292
+ command.query['fields'] = fields unless fields.nil?
293
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
294
+ command.query['userIp'] = user_ip unless user_ip.nil?
295
+ execute_or_queue_command(command, &block)
296
+ end
297
+
298
+ # Create a layer asset.
299
+ # @param [Google::Apis::MapsengineV1::Layer] layer_object
300
+ # @param [Boolean] process
301
+ # Whether to queue the created layer for processing.
302
+ # @param [String] fields
303
+ # Selector specifying which fields to include in a partial response.
304
+ # @param [String] quota_user
305
+ # Available to use for quota purposes for server-side applications. Can be any
306
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
307
+ # Overrides userIp if both are provided.
308
+ # @param [String] user_ip
309
+ # IP address of the site where the request originates. Use this if you want to
310
+ # enforce per-user limits.
311
+ # @param [Google::Apis::RequestOptions] options
312
+ # Request-specific options
313
+ #
314
+ # @yield [result, err] Result & error if block supplied
315
+ # @yieldparam result [Google::Apis::MapsengineV1::Layer] parsed result object
316
+ # @yieldparam err [StandardError] error object if request failed
317
+ #
318
+ # @return [Google::Apis::MapsengineV1::Layer]
319
+ #
320
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
321
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
322
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
323
+ def create_layer(layer_object = nil, process: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
324
+ path = 'layers'
325
+ command = make_simple_command(:post, path, options)
326
+ command.request_representation = Google::Apis::MapsengineV1::Layer::Representation
327
+ command.request_object = layer_object
328
+ command.response_representation = Google::Apis::MapsengineV1::Layer::Representation
329
+ command.response_class = Google::Apis::MapsengineV1::Layer
330
+ command.query['process'] = process unless process.nil?
331
+ command.query['fields'] = fields unless fields.nil?
332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
333
+ command.query['userIp'] = user_ip unless user_ip.nil?
334
+ execute_or_queue_command(command, &block)
335
+ end
336
+
337
+ # Delete a layer.
338
+ # @param [String] id
339
+ # The ID of the layer. Only the layer creator or project owner are permitted to
340
+ # delete. If the layer is published, or included in a map, the request will fail.
341
+ # Unpublish the layer, and remove it from all maps prior to deleting.
342
+ # @param [String] fields
343
+ # Selector specifying which fields to include in a partial response.
344
+ # @param [String] quota_user
345
+ # Available to use for quota purposes for server-side applications. Can be any
346
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
347
+ # Overrides userIp if both are provided.
348
+ # @param [String] user_ip
349
+ # IP address of the site where the request originates. Use this if you want to
350
+ # enforce per-user limits.
351
+ # @param [Google::Apis::RequestOptions] options
352
+ # Request-specific options
353
+ #
354
+ # @yield [result, err] Result & error if block supplied
355
+ # @yieldparam result [NilClass] No result returned for this method
356
+ # @yieldparam err [StandardError] error object if request failed
357
+ #
358
+ # @return [void]
359
+ #
360
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
361
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
362
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
363
+ def delete_layer(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
364
+ path = 'layers/{id}'
365
+ command = make_simple_command(:delete, path, options)
366
+ command.params['id'] = id unless id.nil?
367
+ command.query['fields'] = fields unless fields.nil?
368
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
369
+ command.query['userIp'] = user_ip unless user_ip.nil?
370
+ execute_or_queue_command(command, &block)
371
+ end
372
+
373
+ # Return metadata for a particular layer.
374
+ # @param [String] id
375
+ # The ID of the layer.
376
+ # @param [String] version
377
+ # Deprecated: The version parameter indicates which version of the layer should
378
+ # be returned. When version is set to published, the published version of the
379
+ # layer will be returned. Please use the layers.getPublished endpoint instead.
380
+ # @param [String] fields
381
+ # Selector specifying which fields to include in a partial response.
382
+ # @param [String] quota_user
383
+ # Available to use for quota purposes for server-side applications. Can be any
384
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
385
+ # Overrides userIp if both are provided.
386
+ # @param [String] user_ip
387
+ # IP address of the site where the request originates. Use this if you want to
388
+ # enforce per-user limits.
389
+ # @param [Google::Apis::RequestOptions] options
390
+ # Request-specific options
391
+ #
392
+ # @yield [result, err] Result & error if block supplied
393
+ # @yieldparam result [Google::Apis::MapsengineV1::Layer] parsed result object
394
+ # @yieldparam err [StandardError] error object if request failed
395
+ #
396
+ # @return [Google::Apis::MapsengineV1::Layer]
397
+ #
398
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
399
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
400
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
401
+ def get_layer(id, version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
402
+ path = 'layers/{id}'
403
+ command = make_simple_command(:get, path, options)
404
+ command.response_representation = Google::Apis::MapsengineV1::Layer::Representation
405
+ command.response_class = Google::Apis::MapsengineV1::Layer
406
+ command.params['id'] = id unless id.nil?
407
+ command.query['version'] = version unless version.nil?
408
+ command.query['fields'] = fields unless fields.nil?
409
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
410
+ command.query['userIp'] = user_ip unless user_ip.nil?
411
+ execute_or_queue_command(command, &block)
412
+ end
413
+
414
+ # Return the published metadata for a particular layer.
415
+ # @param [String] id
416
+ # The ID of the layer.
417
+ # @param [String] fields
418
+ # Selector specifying which fields to include in a partial response.
419
+ # @param [String] quota_user
420
+ # Available to use for quota purposes for server-side applications. Can be any
421
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
422
+ # Overrides userIp if both are provided.
423
+ # @param [String] user_ip
424
+ # IP address of the site where the request originates. Use this if you want to
425
+ # enforce per-user limits.
426
+ # @param [Google::Apis::RequestOptions] options
427
+ # Request-specific options
428
+ #
429
+ # @yield [result, err] Result & error if block supplied
430
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishedLayer] parsed result object
431
+ # @yieldparam err [StandardError] error object if request failed
432
+ #
433
+ # @return [Google::Apis::MapsengineV1::PublishedLayer]
434
+ #
435
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
436
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
437
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
438
+ def get_published_layer(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
439
+ path = 'layers/{id}/published'
440
+ command = make_simple_command(:get, path, options)
441
+ command.response_representation = Google::Apis::MapsengineV1::PublishedLayer::Representation
442
+ command.response_class = Google::Apis::MapsengineV1::PublishedLayer
443
+ command.params['id'] = id unless id.nil?
444
+ command.query['fields'] = fields unless fields.nil?
445
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
446
+ command.query['userIp'] = user_ip unless user_ip.nil?
447
+ execute_or_queue_command(command, &block)
448
+ end
449
+
450
+ # Return all layers readable by the current user.
451
+ # @param [String] bbox
452
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
453
+ # which intersect this bounding box will be returned.
454
+ # @param [DateTime] created_after
455
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
456
+ # assets will have been created at or after this time.
457
+ # @param [DateTime] created_before
458
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
459
+ # assets will have been created at or before this time.
460
+ # @param [String] creator_email
461
+ # An email address representing a user. Returned assets that have been created
462
+ # by the user associated with the provided email address.
463
+ # @param [Fixnum] max_results
464
+ # The maximum number of items to include in a single response page. The maximum
465
+ # supported value is 100.
466
+ # @param [DateTime] modified_after
467
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
468
+ # assets will have been modified at or after this time.
469
+ # @param [DateTime] modified_before
470
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
471
+ # assets will have been modified at or before this time.
472
+ # @param [String] page_token
473
+ # The continuation token, used to page through large result sets. To get the
474
+ # next page of results, set this parameter to the value of nextPageToken from
475
+ # the previous response.
476
+ # @param [String] processing_status
477
+ # @param [String] project_id
478
+ # The ID of a Maps Engine project, used to filter the response. To list all
479
+ # available projects with their IDs, send a Projects: list request. You can also
480
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
481
+ # signed in to mapsengine.google.com.
482
+ # @param [String] role
483
+ # The role parameter indicates that the response should only contain assets
484
+ # where the current user has the specified level of access.
485
+ # @param [String] search
486
+ # An unstructured search string used to filter the set of results based on asset
487
+ # metadata.
488
+ # @param [String] tags
489
+ # A comma separated list of tags. Returned assets will contain all the tags from
490
+ # the list.
491
+ # @param [String] fields
492
+ # Selector specifying which fields to include in a partial response.
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # Overrides userIp if both are provided.
497
+ # @param [String] user_ip
498
+ # IP address of the site where the request originates. Use this if you want to
499
+ # enforce per-user limits.
500
+ # @param [Google::Apis::RequestOptions] options
501
+ # Request-specific options
502
+ #
503
+ # @yield [result, err] Result & error if block supplied
504
+ # @yieldparam result [Google::Apis::MapsengineV1::ListLayersResponse] parsed result object
505
+ # @yieldparam err [StandardError] error object if request failed
506
+ #
507
+ # @return [Google::Apis::MapsengineV1::ListLayersResponse]
508
+ #
509
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
510
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
511
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
512
+ def list_layers(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, processing_status: nil, project_id: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
513
+ path = 'layers'
514
+ command = make_simple_command(:get, path, options)
515
+ command.response_representation = Google::Apis::MapsengineV1::ListLayersResponse::Representation
516
+ command.response_class = Google::Apis::MapsengineV1::ListLayersResponse
517
+ command.query['bbox'] = bbox unless bbox.nil?
518
+ command.query['createdAfter'] = created_after unless created_after.nil?
519
+ command.query['createdBefore'] = created_before unless created_before.nil?
520
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
521
+ command.query['maxResults'] = max_results unless max_results.nil?
522
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
523
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
524
+ command.query['pageToken'] = page_token unless page_token.nil?
525
+ command.query['processingStatus'] = processing_status unless processing_status.nil?
526
+ command.query['projectId'] = project_id unless project_id.nil?
527
+ command.query['role'] = role unless role.nil?
528
+ command.query['search'] = search unless search.nil?
529
+ command.query['tags'] = tags unless tags.nil?
530
+ command.query['fields'] = fields unless fields.nil?
531
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
532
+ command.query['userIp'] = user_ip unless user_ip.nil?
533
+ execute_or_queue_command(command, &block)
534
+ end
535
+
536
+ # Return all published layers readable by the current user.
537
+ # @param [Fixnum] max_results
538
+ # The maximum number of items to include in a single response page. The maximum
539
+ # supported value is 100.
540
+ # @param [String] page_token
541
+ # The continuation token, used to page through large result sets. To get the
542
+ # next page of results, set this parameter to the value of nextPageToken from
543
+ # the previous response.
544
+ # @param [String] project_id
545
+ # The ID of a Maps Engine project, used to filter the response. To list all
546
+ # available projects with their IDs, send a Projects: list request. You can also
547
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
548
+ # signed in to mapsengine.google.com.
549
+ # @param [String] fields
550
+ # Selector specifying which fields to include in a partial response.
551
+ # @param [String] quota_user
552
+ # Available to use for quota purposes for server-side applications. Can be any
553
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
554
+ # Overrides userIp if both are provided.
555
+ # @param [String] user_ip
556
+ # IP address of the site where the request originates. Use this if you want to
557
+ # enforce per-user limits.
558
+ # @param [Google::Apis::RequestOptions] options
559
+ # Request-specific options
560
+ #
561
+ # @yield [result, err] Result & error if block supplied
562
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPublishedLayersResponse] parsed result object
563
+ # @yieldparam err [StandardError] error object if request failed
564
+ #
565
+ # @return [Google::Apis::MapsengineV1::ListPublishedLayersResponse]
566
+ #
567
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
568
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
569
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
570
+ def list_published_layer(max_results: nil, page_token: nil, project_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
571
+ path = 'layers/published'
572
+ command = make_simple_command(:get, path, options)
573
+ command.response_representation = Google::Apis::MapsengineV1::ListPublishedLayersResponse::Representation
574
+ command.response_class = Google::Apis::MapsengineV1::ListPublishedLayersResponse
575
+ command.query['maxResults'] = max_results unless max_results.nil?
576
+ command.query['pageToken'] = page_token unless page_token.nil?
577
+ command.query['projectId'] = project_id unless project_id.nil?
578
+ command.query['fields'] = fields unless fields.nil?
579
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
580
+ command.query['userIp'] = user_ip unless user_ip.nil?
581
+ execute_or_queue_command(command, &block)
582
+ end
583
+
584
+ # Mutate a layer asset.
585
+ # @param [String] id
586
+ # The ID of the layer.
587
+ # @param [Google::Apis::MapsengineV1::Layer] layer_object
588
+ # @param [String] fields
589
+ # Selector specifying which fields to include in a partial response.
590
+ # @param [String] quota_user
591
+ # Available to use for quota purposes for server-side applications. Can be any
592
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
593
+ # Overrides userIp if both are provided.
594
+ # @param [String] user_ip
595
+ # IP address of the site where the request originates. Use this if you want to
596
+ # enforce per-user limits.
597
+ # @param [Google::Apis::RequestOptions] options
598
+ # Request-specific options
599
+ #
600
+ # @yield [result, err] Result & error if block supplied
601
+ # @yieldparam result [NilClass] No result returned for this method
602
+ # @yieldparam err [StandardError] error object if request failed
603
+ #
604
+ # @return [void]
605
+ #
606
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
607
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
608
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
609
+ def patch_layer(id, layer_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
610
+ path = 'layers/{id}'
611
+ command = make_simple_command(:patch, path, options)
612
+ command.request_representation = Google::Apis::MapsengineV1::Layer::Representation
613
+ command.request_object = layer_object
614
+ command.params['id'] = id unless id.nil?
615
+ command.query['fields'] = fields unless fields.nil?
616
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
617
+ command.query['userIp'] = user_ip unless user_ip.nil?
618
+ execute_or_queue_command(command, &block)
619
+ end
620
+
621
+ # Process a layer asset.
622
+ # @param [String] id
623
+ # The ID of the layer.
624
+ # @param [String] fields
625
+ # Selector specifying which fields to include in a partial response.
626
+ # @param [String] quota_user
627
+ # Available to use for quota purposes for server-side applications. Can be any
628
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
629
+ # Overrides userIp if both are provided.
630
+ # @param [String] user_ip
631
+ # IP address of the site where the request originates. Use this if you want to
632
+ # enforce per-user limits.
633
+ # @param [Google::Apis::RequestOptions] options
634
+ # Request-specific options
635
+ #
636
+ # @yield [result, err] Result & error if block supplied
637
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
638
+ # @yieldparam err [StandardError] error object if request failed
639
+ #
640
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
641
+ #
642
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
643
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
644
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
645
+ def process_layer(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
646
+ path = 'layers/{id}/process'
647
+ command = make_simple_command(:post, path, options)
648
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
649
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
650
+ command.params['id'] = id unless id.nil?
651
+ command.query['fields'] = fields unless fields.nil?
652
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
653
+ command.query['userIp'] = user_ip unless user_ip.nil?
654
+ execute_or_queue_command(command, &block)
655
+ end
656
+
657
+ # Publish a layer asset.
658
+ # @param [String] id
659
+ # The ID of the layer.
660
+ # @param [Boolean] force
661
+ # If set to true, the API will allow publication of the layer even if it's out
662
+ # of date. If not true, you'll need to reprocess any out-of-date layer before
663
+ # publishing.
664
+ # @param [String] fields
665
+ # Selector specifying which fields to include in a partial response.
666
+ # @param [String] quota_user
667
+ # Available to use for quota purposes for server-side applications. Can be any
668
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
669
+ # Overrides userIp if both are provided.
670
+ # @param [String] user_ip
671
+ # IP address of the site where the request originates. Use this if you want to
672
+ # enforce per-user limits.
673
+ # @param [Google::Apis::RequestOptions] options
674
+ # Request-specific options
675
+ #
676
+ # @yield [result, err] Result & error if block supplied
677
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishResponse] parsed result object
678
+ # @yieldparam err [StandardError] error object if request failed
679
+ #
680
+ # @return [Google::Apis::MapsengineV1::PublishResponse]
681
+ #
682
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
683
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
684
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
685
+ def publish_layer(id, force: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
686
+ path = 'layers/{id}/publish'
687
+ command = make_simple_command(:post, path, options)
688
+ command.response_representation = Google::Apis::MapsengineV1::PublishResponse::Representation
689
+ command.response_class = Google::Apis::MapsengineV1::PublishResponse
690
+ command.params['id'] = id unless id.nil?
691
+ command.query['force'] = force unless force.nil?
692
+ command.query['fields'] = fields unless fields.nil?
693
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
694
+ command.query['userIp'] = user_ip unless user_ip.nil?
695
+ execute_or_queue_command(command, &block)
696
+ end
697
+
698
+ # Unpublish a layer asset.
699
+ # @param [String] id
700
+ # The ID of the layer.
701
+ # @param [String] fields
702
+ # Selector specifying which fields to include in a partial response.
703
+ # @param [String] quota_user
704
+ # Available to use for quota purposes for server-side applications. Can be any
705
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
706
+ # Overrides userIp if both are provided.
707
+ # @param [String] user_ip
708
+ # IP address of the site where the request originates. Use this if you want to
709
+ # enforce per-user limits.
710
+ # @param [Google::Apis::RequestOptions] options
711
+ # Request-specific options
712
+ #
713
+ # @yield [result, err] Result & error if block supplied
714
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishResponse] parsed result object
715
+ # @yieldparam err [StandardError] error object if request failed
716
+ #
717
+ # @return [Google::Apis::MapsengineV1::PublishResponse]
718
+ #
719
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
720
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
721
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
722
+ def unpublish_layer(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
723
+ path = 'layers/{id}/unpublish'
724
+ command = make_simple_command(:post, path, options)
725
+ command.response_representation = Google::Apis::MapsengineV1::PublishResponse::Representation
726
+ command.response_class = Google::Apis::MapsengineV1::PublishResponse
727
+ command.params['id'] = id unless id.nil?
728
+ command.query['fields'] = fields unless fields.nil?
729
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
730
+ command.query['userIp'] = user_ip unless user_ip.nil?
731
+ execute_or_queue_command(command, &block)
732
+ end
733
+
734
+ # Return all parent ids of the specified layer.
735
+ # @param [String] id
736
+ # The ID of the layer whose parents will be listed.
737
+ # @param [Fixnum] max_results
738
+ # The maximum number of items to include in a single response page. The maximum
739
+ # supported value is 50.
740
+ # @param [String] page_token
741
+ # The continuation token, used to page through large result sets. To get the
742
+ # next page of results, set this parameter to the value of nextPageToken from
743
+ # the previous response.
744
+ # @param [String] fields
745
+ # Selector specifying which fields to include in a partial response.
746
+ # @param [String] quota_user
747
+ # Available to use for quota purposes for server-side applications. Can be any
748
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
749
+ # Overrides userIp if both are provided.
750
+ # @param [String] user_ip
751
+ # IP address of the site where the request originates. Use this if you want to
752
+ # enforce per-user limits.
753
+ # @param [Google::Apis::RequestOptions] options
754
+ # Request-specific options
755
+ #
756
+ # @yield [result, err] Result & error if block supplied
757
+ # @yieldparam result [Google::Apis::MapsengineV1::ListParentsResponse] parsed result object
758
+ # @yieldparam err [StandardError] error object if request failed
759
+ #
760
+ # @return [Google::Apis::MapsengineV1::ListParentsResponse]
761
+ #
762
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
763
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
764
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
765
+ def list_layer_parents(id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
766
+ path = 'layers/{id}/parents'
767
+ command = make_simple_command(:get, path, options)
768
+ command.response_representation = Google::Apis::MapsengineV1::ListParentsResponse::Representation
769
+ command.response_class = Google::Apis::MapsengineV1::ListParentsResponse
770
+ command.params['id'] = id unless id.nil?
771
+ command.query['maxResults'] = max_results unless max_results.nil?
772
+ command.query['pageToken'] = page_token unless page_token.nil?
773
+ command.query['fields'] = fields unless fields.nil?
774
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
775
+ command.query['userIp'] = user_ip unless user_ip.nil?
776
+ execute_or_queue_command(command, &block)
777
+ end
778
+
779
+ # Remove permission entries from an already existing asset.
780
+ # @param [String] id
781
+ # The ID of the asset from which permissions will be removed.
782
+ # @param [Google::Apis::MapsengineV1::BatchDeletePermissionsRequest] batch_delete_permissions_request_object
783
+ # @param [String] fields
784
+ # Selector specifying which fields to include in a partial response.
785
+ # @param [String] quota_user
786
+ # Available to use for quota purposes for server-side applications. Can be any
787
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
788
+ # Overrides userIp if both are provided.
789
+ # @param [String] user_ip
790
+ # IP address of the site where the request originates. Use this if you want to
791
+ # enforce per-user limits.
792
+ # @param [Google::Apis::RequestOptions] options
793
+ # Request-specific options
794
+ #
795
+ # @yield [result, err] Result & error if block supplied
796
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse] parsed result object
797
+ # @yieldparam err [StandardError] error object if request failed
798
+ #
799
+ # @return [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse]
800
+ #
801
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
802
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
803
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
804
+ def batch_delete_layer_permission(id, batch_delete_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
805
+ path = 'layers/{id}/permissions/batchDelete'
806
+ command = make_simple_command(:post, path, options)
807
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsRequest::Representation
808
+ command.request_object = batch_delete_permissions_request_object
809
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse::Representation
810
+ command.response_class = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse
811
+ command.params['id'] = id unless id.nil?
812
+ command.query['fields'] = fields unless fields.nil?
813
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
814
+ command.query['userIp'] = user_ip unless user_ip.nil?
815
+ execute_or_queue_command(command, &block)
816
+ end
817
+
818
+ # Add or update permission entries to an already existing asset.
819
+ # An asset can hold up to 20 different permission entries. Each batchInsert
820
+ # request is atomic.
821
+ # @param [String] id
822
+ # The ID of the asset to which permissions will be added.
823
+ # @param [Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest] batch_update_permissions_request_object
824
+ # @param [String] fields
825
+ # Selector specifying which fields to include in a partial response.
826
+ # @param [String] quota_user
827
+ # Available to use for quota purposes for server-side applications. Can be any
828
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
829
+ # Overrides userIp if both are provided.
830
+ # @param [String] user_ip
831
+ # IP address of the site where the request originates. Use this if you want to
832
+ # enforce per-user limits.
833
+ # @param [Google::Apis::RequestOptions] options
834
+ # Request-specific options
835
+ #
836
+ # @yield [result, err] Result & error if block supplied
837
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse] parsed result object
838
+ # @yieldparam err [StandardError] error object if request failed
839
+ #
840
+ # @return [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse]
841
+ #
842
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
843
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
844
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
845
+ def batch_update_layer_permission(id, batch_update_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
846
+ path = 'layers/{id}/permissions/batchUpdate'
847
+ command = make_simple_command(:post, path, options)
848
+ command.request_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest::Representation
849
+ command.request_object = batch_update_permissions_request_object
850
+ command.response_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse::Representation
851
+ command.response_class = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse
852
+ command.params['id'] = id unless id.nil?
853
+ command.query['fields'] = fields unless fields.nil?
854
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
855
+ command.query['userIp'] = user_ip unless user_ip.nil?
856
+ execute_or_queue_command(command, &block)
857
+ end
858
+
859
+ # Return all of the permissions for the specified asset.
860
+ # @param [String] id
861
+ # The ID of the asset whose permissions will be listed.
862
+ # @param [String] fields
863
+ # Selector specifying which fields to include in a partial response.
864
+ # @param [String] quota_user
865
+ # Available to use for quota purposes for server-side applications. Can be any
866
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
867
+ # Overrides userIp if both are provided.
868
+ # @param [String] user_ip
869
+ # IP address of the site where the request originates. Use this if you want to
870
+ # enforce per-user limits.
871
+ # @param [Google::Apis::RequestOptions] options
872
+ # Request-specific options
873
+ #
874
+ # @yield [result, err] Result & error if block supplied
875
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
876
+ # @yieldparam err [StandardError] error object if request failed
877
+ #
878
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
879
+ #
880
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
881
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
882
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
883
+ def list_layer_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
884
+ path = 'layers/{id}/permissions'
885
+ command = make_simple_command(:get, path, options)
886
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
887
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
888
+ command.params['id'] = id unless id.nil?
889
+ command.query['fields'] = fields unless fields.nil?
890
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
891
+ command.query['userIp'] = user_ip unless user_ip.nil?
892
+ execute_or_queue_command(command, &block)
893
+ end
894
+
895
+ # Create a map asset.
896
+ # @param [Google::Apis::MapsengineV1::Map] map_object
897
+ # @param [String] fields
898
+ # Selector specifying which fields to include in a partial response.
899
+ # @param [String] quota_user
900
+ # Available to use for quota purposes for server-side applications. Can be any
901
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
902
+ # Overrides userIp if both are provided.
903
+ # @param [String] user_ip
904
+ # IP address of the site where the request originates. Use this if you want to
905
+ # enforce per-user limits.
906
+ # @param [Google::Apis::RequestOptions] options
907
+ # Request-specific options
908
+ #
909
+ # @yield [result, err] Result & error if block supplied
910
+ # @yieldparam result [Google::Apis::MapsengineV1::Map] parsed result object
911
+ # @yieldparam err [StandardError] error object if request failed
912
+ #
913
+ # @return [Google::Apis::MapsengineV1::Map]
914
+ #
915
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
916
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
917
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
918
+ def create_map(map_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
919
+ path = 'maps'
920
+ command = make_simple_command(:post, path, options)
921
+ command.request_representation = Google::Apis::MapsengineV1::Map::Representation
922
+ command.request_object = map_object
923
+ command.response_representation = Google::Apis::MapsengineV1::Map::Representation
924
+ command.response_class = Google::Apis::MapsengineV1::Map
925
+ command.query['fields'] = fields unless fields.nil?
926
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
927
+ command.query['userIp'] = user_ip unless user_ip.nil?
928
+ execute_or_queue_command(command, &block)
929
+ end
930
+
931
+ # Delete a map.
932
+ # @param [String] id
933
+ # The ID of the map. Only the map creator or project owner are permitted to
934
+ # delete. If the map is published the request will fail. Unpublish the map prior
935
+ # to deleting.
936
+ # @param [String] fields
937
+ # Selector specifying which fields to include in a partial response.
938
+ # @param [String] quota_user
939
+ # Available to use for quota purposes for server-side applications. Can be any
940
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
941
+ # Overrides userIp if both are provided.
942
+ # @param [String] user_ip
943
+ # IP address of the site where the request originates. Use this if you want to
944
+ # enforce per-user limits.
945
+ # @param [Google::Apis::RequestOptions] options
946
+ # Request-specific options
947
+ #
948
+ # @yield [result, err] Result & error if block supplied
949
+ # @yieldparam result [NilClass] No result returned for this method
950
+ # @yieldparam err [StandardError] error object if request failed
951
+ #
952
+ # @return [void]
953
+ #
954
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
955
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
956
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
957
+ def delete_map(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
958
+ path = 'maps/{id}'
959
+ command = make_simple_command(:delete, path, options)
960
+ command.params['id'] = id unless id.nil?
961
+ command.query['fields'] = fields unless fields.nil?
962
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
963
+ command.query['userIp'] = user_ip unless user_ip.nil?
964
+ execute_or_queue_command(command, &block)
965
+ end
966
+
967
+ # Return metadata for a particular map.
968
+ # @param [String] id
969
+ # The ID of the map.
970
+ # @param [String] version
971
+ # Deprecated: The version parameter indicates which version of the map should be
972
+ # returned. When version is set to published, the published version of the map
973
+ # will be returned. Please use the maps.getPublished endpoint instead.
974
+ # @param [String] fields
975
+ # Selector specifying which fields to include in a partial response.
976
+ # @param [String] quota_user
977
+ # Available to use for quota purposes for server-side applications. Can be any
978
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
979
+ # Overrides userIp if both are provided.
980
+ # @param [String] user_ip
981
+ # IP address of the site where the request originates. Use this if you want to
982
+ # enforce per-user limits.
983
+ # @param [Google::Apis::RequestOptions] options
984
+ # Request-specific options
985
+ #
986
+ # @yield [result, err] Result & error if block supplied
987
+ # @yieldparam result [Google::Apis::MapsengineV1::Map] parsed result object
988
+ # @yieldparam err [StandardError] error object if request failed
989
+ #
990
+ # @return [Google::Apis::MapsengineV1::Map]
991
+ #
992
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
993
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
994
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
995
+ def get_map(id, version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
996
+ path = 'maps/{id}'
997
+ command = make_simple_command(:get, path, options)
998
+ command.response_representation = Google::Apis::MapsengineV1::Map::Representation
999
+ command.response_class = Google::Apis::MapsengineV1::Map
1000
+ command.params['id'] = id unless id.nil?
1001
+ command.query['version'] = version unless version.nil?
1002
+ command.query['fields'] = fields unless fields.nil?
1003
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1004
+ command.query['userIp'] = user_ip unless user_ip.nil?
1005
+ execute_or_queue_command(command, &block)
1006
+ end
1007
+
1008
+ # Return the published metadata for a particular map.
1009
+ # @param [String] id
1010
+ # The ID of the map.
1011
+ # @param [String] fields
1012
+ # Selector specifying which fields to include in a partial response.
1013
+ # @param [String] quota_user
1014
+ # Available to use for quota purposes for server-side applications. Can be any
1015
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1016
+ # Overrides userIp if both are provided.
1017
+ # @param [String] user_ip
1018
+ # IP address of the site where the request originates. Use this if you want to
1019
+ # enforce per-user limits.
1020
+ # @param [Google::Apis::RequestOptions] options
1021
+ # Request-specific options
1022
+ #
1023
+ # @yield [result, err] Result & error if block supplied
1024
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishedMap] parsed result object
1025
+ # @yieldparam err [StandardError] error object if request failed
1026
+ #
1027
+ # @return [Google::Apis::MapsengineV1::PublishedMap]
1028
+ #
1029
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1030
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1031
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1032
+ def get_published_map(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1033
+ path = 'maps/{id}/published'
1034
+ command = make_simple_command(:get, path, options)
1035
+ command.response_representation = Google::Apis::MapsengineV1::PublishedMap::Representation
1036
+ command.response_class = Google::Apis::MapsengineV1::PublishedMap
1037
+ command.params['id'] = id unless id.nil?
1038
+ command.query['fields'] = fields unless fields.nil?
1039
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1040
+ command.query['userIp'] = user_ip unless user_ip.nil?
1041
+ execute_or_queue_command(command, &block)
1042
+ end
1043
+
1044
+ # Return all maps readable by the current user.
1045
+ # @param [String] bbox
1046
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
1047
+ # which intersect this bounding box will be returned.
1048
+ # @param [DateTime] created_after
1049
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1050
+ # assets will have been created at or after this time.
1051
+ # @param [DateTime] created_before
1052
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1053
+ # assets will have been created at or before this time.
1054
+ # @param [String] creator_email
1055
+ # An email address representing a user. Returned assets that have been created
1056
+ # by the user associated with the provided email address.
1057
+ # @param [Fixnum] max_results
1058
+ # The maximum number of items to include in a single response page. The maximum
1059
+ # supported value is 100.
1060
+ # @param [DateTime] modified_after
1061
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1062
+ # assets will have been modified at or after this time.
1063
+ # @param [DateTime] modified_before
1064
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1065
+ # assets will have been modified at or before this time.
1066
+ # @param [String] page_token
1067
+ # The continuation token, used to page through large result sets. To get the
1068
+ # next page of results, set this parameter to the value of nextPageToken from
1069
+ # the previous response.
1070
+ # @param [String] processing_status
1071
+ # @param [String] project_id
1072
+ # The ID of a Maps Engine project, used to filter the response. To list all
1073
+ # available projects with their IDs, send a Projects: list request. You can also
1074
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
1075
+ # signed in to mapsengine.google.com.
1076
+ # @param [String] role
1077
+ # The role parameter indicates that the response should only contain assets
1078
+ # where the current user has the specified level of access.
1079
+ # @param [String] search
1080
+ # An unstructured search string used to filter the set of results based on asset
1081
+ # metadata.
1082
+ # @param [String] tags
1083
+ # A comma separated list of tags. Returned assets will contain all the tags from
1084
+ # the list.
1085
+ # @param [String] fields
1086
+ # Selector specifying which fields to include in a partial response.
1087
+ # @param [String] quota_user
1088
+ # Available to use for quota purposes for server-side applications. Can be any
1089
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1090
+ # Overrides userIp if both are provided.
1091
+ # @param [String] user_ip
1092
+ # IP address of the site where the request originates. Use this if you want to
1093
+ # enforce per-user limits.
1094
+ # @param [Google::Apis::RequestOptions] options
1095
+ # Request-specific options
1096
+ #
1097
+ # @yield [result, err] Result & error if block supplied
1098
+ # @yieldparam result [Google::Apis::MapsengineV1::ListMapsResponse] parsed result object
1099
+ # @yieldparam err [StandardError] error object if request failed
1100
+ #
1101
+ # @return [Google::Apis::MapsengineV1::ListMapsResponse]
1102
+ #
1103
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1104
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1105
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1106
+ def list_maps(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, processing_status: nil, project_id: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1107
+ path = 'maps'
1108
+ command = make_simple_command(:get, path, options)
1109
+ command.response_representation = Google::Apis::MapsengineV1::ListMapsResponse::Representation
1110
+ command.response_class = Google::Apis::MapsengineV1::ListMapsResponse
1111
+ command.query['bbox'] = bbox unless bbox.nil?
1112
+ command.query['createdAfter'] = created_after unless created_after.nil?
1113
+ command.query['createdBefore'] = created_before unless created_before.nil?
1114
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
1115
+ command.query['maxResults'] = max_results unless max_results.nil?
1116
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
1117
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
1118
+ command.query['pageToken'] = page_token unless page_token.nil?
1119
+ command.query['processingStatus'] = processing_status unless processing_status.nil?
1120
+ command.query['projectId'] = project_id unless project_id.nil?
1121
+ command.query['role'] = role unless role.nil?
1122
+ command.query['search'] = search unless search.nil?
1123
+ command.query['tags'] = tags unless tags.nil?
1124
+ command.query['fields'] = fields unless fields.nil?
1125
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1126
+ command.query['userIp'] = user_ip unless user_ip.nil?
1127
+ execute_or_queue_command(command, &block)
1128
+ end
1129
+
1130
+ # Return all published maps readable by the current user.
1131
+ # @param [Fixnum] max_results
1132
+ # The maximum number of items to include in a single response page. The maximum
1133
+ # supported value is 100.
1134
+ # @param [String] page_token
1135
+ # The continuation token, used to page through large result sets. To get the
1136
+ # next page of results, set this parameter to the value of nextPageToken from
1137
+ # the previous response.
1138
+ # @param [String] project_id
1139
+ # The ID of a Maps Engine project, used to filter the response. To list all
1140
+ # available projects with their IDs, send a Projects: list request. You can also
1141
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
1142
+ # signed in to mapsengine.google.com.
1143
+ # @param [String] fields
1144
+ # Selector specifying which fields to include in a partial response.
1145
+ # @param [String] quota_user
1146
+ # Available to use for quota purposes for server-side applications. Can be any
1147
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1148
+ # Overrides userIp if both are provided.
1149
+ # @param [String] user_ip
1150
+ # IP address of the site where the request originates. Use this if you want to
1151
+ # enforce per-user limits.
1152
+ # @param [Google::Apis::RequestOptions] options
1153
+ # Request-specific options
1154
+ #
1155
+ # @yield [result, err] Result & error if block supplied
1156
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPublishedMapsResponse] parsed result object
1157
+ # @yieldparam err [StandardError] error object if request failed
1158
+ #
1159
+ # @return [Google::Apis::MapsengineV1::ListPublishedMapsResponse]
1160
+ #
1161
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1162
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1163
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1164
+ def list_published_map(max_results: nil, page_token: nil, project_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1165
+ path = 'maps/published'
1166
+ command = make_simple_command(:get, path, options)
1167
+ command.response_representation = Google::Apis::MapsengineV1::ListPublishedMapsResponse::Representation
1168
+ command.response_class = Google::Apis::MapsengineV1::ListPublishedMapsResponse
1169
+ command.query['maxResults'] = max_results unless max_results.nil?
1170
+ command.query['pageToken'] = page_token unless page_token.nil?
1171
+ command.query['projectId'] = project_id unless project_id.nil?
1172
+ command.query['fields'] = fields unless fields.nil?
1173
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1174
+ command.query['userIp'] = user_ip unless user_ip.nil?
1175
+ execute_or_queue_command(command, &block)
1176
+ end
1177
+
1178
+ # Mutate a map asset.
1179
+ # @param [String] id
1180
+ # The ID of the map.
1181
+ # @param [Google::Apis::MapsengineV1::Map] map_object
1182
+ # @param [String] fields
1183
+ # Selector specifying which fields to include in a partial response.
1184
+ # @param [String] quota_user
1185
+ # Available to use for quota purposes for server-side applications. Can be any
1186
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1187
+ # Overrides userIp if both are provided.
1188
+ # @param [String] user_ip
1189
+ # IP address of the site where the request originates. Use this if you want to
1190
+ # enforce per-user limits.
1191
+ # @param [Google::Apis::RequestOptions] options
1192
+ # Request-specific options
1193
+ #
1194
+ # @yield [result, err] Result & error if block supplied
1195
+ # @yieldparam result [NilClass] No result returned for this method
1196
+ # @yieldparam err [StandardError] error object if request failed
1197
+ #
1198
+ # @return [void]
1199
+ #
1200
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1201
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1202
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1203
+ def patch_map(id, map_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1204
+ path = 'maps/{id}'
1205
+ command = make_simple_command(:patch, path, options)
1206
+ command.request_representation = Google::Apis::MapsengineV1::Map::Representation
1207
+ command.request_object = map_object
1208
+ command.params['id'] = id unless id.nil?
1209
+ command.query['fields'] = fields unless fields.nil?
1210
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1211
+ command.query['userIp'] = user_ip unless user_ip.nil?
1212
+ execute_or_queue_command(command, &block)
1213
+ end
1214
+
1215
+ # Publish a map asset.
1216
+ # @param [String] id
1217
+ # The ID of the map.
1218
+ # @param [Boolean] force
1219
+ # If set to true, the API will allow publication of the map even if it's out of
1220
+ # date. If false, the map must have a processingStatus of complete before
1221
+ # publishing.
1222
+ # @param [String] fields
1223
+ # Selector specifying which fields to include in a partial response.
1224
+ # @param [String] quota_user
1225
+ # Available to use for quota purposes for server-side applications. Can be any
1226
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1227
+ # Overrides userIp if both are provided.
1228
+ # @param [String] user_ip
1229
+ # IP address of the site where the request originates. Use this if you want to
1230
+ # enforce per-user limits.
1231
+ # @param [Google::Apis::RequestOptions] options
1232
+ # Request-specific options
1233
+ #
1234
+ # @yield [result, err] Result & error if block supplied
1235
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishResponse] parsed result object
1236
+ # @yieldparam err [StandardError] error object if request failed
1237
+ #
1238
+ # @return [Google::Apis::MapsengineV1::PublishResponse]
1239
+ #
1240
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1241
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1242
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1243
+ def publish_map(id, force: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1244
+ path = 'maps/{id}/publish'
1245
+ command = make_simple_command(:post, path, options)
1246
+ command.response_representation = Google::Apis::MapsengineV1::PublishResponse::Representation
1247
+ command.response_class = Google::Apis::MapsengineV1::PublishResponse
1248
+ command.params['id'] = id unless id.nil?
1249
+ command.query['force'] = force unless force.nil?
1250
+ command.query['fields'] = fields unless fields.nil?
1251
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1252
+ command.query['userIp'] = user_ip unless user_ip.nil?
1253
+ execute_or_queue_command(command, &block)
1254
+ end
1255
+
1256
+ # Unpublish a map asset.
1257
+ # @param [String] id
1258
+ # The ID of the map.
1259
+ # @param [String] fields
1260
+ # Selector specifying which fields to include in a partial response.
1261
+ # @param [String] quota_user
1262
+ # Available to use for quota purposes for server-side applications. Can be any
1263
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1264
+ # Overrides userIp if both are provided.
1265
+ # @param [String] user_ip
1266
+ # IP address of the site where the request originates. Use this if you want to
1267
+ # enforce per-user limits.
1268
+ # @param [Google::Apis::RequestOptions] options
1269
+ # Request-specific options
1270
+ #
1271
+ # @yield [result, err] Result & error if block supplied
1272
+ # @yieldparam result [Google::Apis::MapsengineV1::PublishResponse] parsed result object
1273
+ # @yieldparam err [StandardError] error object if request failed
1274
+ #
1275
+ # @return [Google::Apis::MapsengineV1::PublishResponse]
1276
+ #
1277
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1278
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1279
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1280
+ def unpublish_map(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1281
+ path = 'maps/{id}/unpublish'
1282
+ command = make_simple_command(:post, path, options)
1283
+ command.response_representation = Google::Apis::MapsengineV1::PublishResponse::Representation
1284
+ command.response_class = Google::Apis::MapsengineV1::PublishResponse
1285
+ command.params['id'] = id unless id.nil?
1286
+ command.query['fields'] = fields unless fields.nil?
1287
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1288
+ command.query['userIp'] = user_ip unless user_ip.nil?
1289
+ execute_or_queue_command(command, &block)
1290
+ end
1291
+
1292
+ # Remove permission entries from an already existing asset.
1293
+ # @param [String] id
1294
+ # The ID of the asset from which permissions will be removed.
1295
+ # @param [Google::Apis::MapsengineV1::BatchDeletePermissionsRequest] batch_delete_permissions_request_object
1296
+ # @param [String] fields
1297
+ # Selector specifying which fields to include in a partial response.
1298
+ # @param [String] quota_user
1299
+ # Available to use for quota purposes for server-side applications. Can be any
1300
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1301
+ # Overrides userIp if both are provided.
1302
+ # @param [String] user_ip
1303
+ # IP address of the site where the request originates. Use this if you want to
1304
+ # enforce per-user limits.
1305
+ # @param [Google::Apis::RequestOptions] options
1306
+ # Request-specific options
1307
+ #
1308
+ # @yield [result, err] Result & error if block supplied
1309
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse] parsed result object
1310
+ # @yieldparam err [StandardError] error object if request failed
1311
+ #
1312
+ # @return [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse]
1313
+ #
1314
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1315
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1316
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1317
+ def batch_delete_map_permission(id, batch_delete_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1318
+ path = 'maps/{id}/permissions/batchDelete'
1319
+ command = make_simple_command(:post, path, options)
1320
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsRequest::Representation
1321
+ command.request_object = batch_delete_permissions_request_object
1322
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse::Representation
1323
+ command.response_class = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse
1324
+ command.params['id'] = id unless id.nil?
1325
+ command.query['fields'] = fields unless fields.nil?
1326
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1327
+ command.query['userIp'] = user_ip unless user_ip.nil?
1328
+ execute_or_queue_command(command, &block)
1329
+ end
1330
+
1331
+ # Add or update permission entries to an already existing asset.
1332
+ # An asset can hold up to 20 different permission entries. Each batchInsert
1333
+ # request is atomic.
1334
+ # @param [String] id
1335
+ # The ID of the asset to which permissions will be added.
1336
+ # @param [Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest] batch_update_permissions_request_object
1337
+ # @param [String] fields
1338
+ # Selector specifying which fields to include in a partial response.
1339
+ # @param [String] quota_user
1340
+ # Available to use for quota purposes for server-side applications. Can be any
1341
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1342
+ # Overrides userIp if both are provided.
1343
+ # @param [String] user_ip
1344
+ # IP address of the site where the request originates. Use this if you want to
1345
+ # enforce per-user limits.
1346
+ # @param [Google::Apis::RequestOptions] options
1347
+ # Request-specific options
1348
+ #
1349
+ # @yield [result, err] Result & error if block supplied
1350
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse] parsed result object
1351
+ # @yieldparam err [StandardError] error object if request failed
1352
+ #
1353
+ # @return [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse]
1354
+ #
1355
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1356
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1357
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1358
+ def batch_update_map_permission(id, batch_update_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1359
+ path = 'maps/{id}/permissions/batchUpdate'
1360
+ command = make_simple_command(:post, path, options)
1361
+ command.request_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest::Representation
1362
+ command.request_object = batch_update_permissions_request_object
1363
+ command.response_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse::Representation
1364
+ command.response_class = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse
1365
+ command.params['id'] = id unless id.nil?
1366
+ command.query['fields'] = fields unless fields.nil?
1367
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1368
+ command.query['userIp'] = user_ip unless user_ip.nil?
1369
+ execute_or_queue_command(command, &block)
1370
+ end
1371
+
1372
+ # Return all of the permissions for the specified asset.
1373
+ # @param [String] id
1374
+ # The ID of the asset whose permissions will be listed.
1375
+ # @param [String] fields
1376
+ # Selector specifying which fields to include in a partial response.
1377
+ # @param [String] quota_user
1378
+ # Available to use for quota purposes for server-side applications. Can be any
1379
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1380
+ # Overrides userIp if both are provided.
1381
+ # @param [String] user_ip
1382
+ # IP address of the site where the request originates. Use this if you want to
1383
+ # enforce per-user limits.
1384
+ # @param [Google::Apis::RequestOptions] options
1385
+ # Request-specific options
1386
+ #
1387
+ # @yield [result, err] Result & error if block supplied
1388
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
1389
+ # @yieldparam err [StandardError] error object if request failed
1390
+ #
1391
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
1392
+ #
1393
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1394
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1395
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1396
+ def list_map_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1397
+ path = 'maps/{id}/permissions'
1398
+ command = make_simple_command(:get, path, options)
1399
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
1400
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
1401
+ command.params['id'] = id unless id.nil?
1402
+ command.query['fields'] = fields unless fields.nil?
1403
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1404
+ command.query['userIp'] = user_ip unless user_ip.nil?
1405
+ execute_or_queue_command(command, &block)
1406
+ end
1407
+
1408
+ # Return all projects readable by the current user.
1409
+ # @param [String] fields
1410
+ # Selector specifying which fields to include in a partial response.
1411
+ # @param [String] quota_user
1412
+ # Available to use for quota purposes for server-side applications. Can be any
1413
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1414
+ # Overrides userIp if both are provided.
1415
+ # @param [String] user_ip
1416
+ # IP address of the site where the request originates. Use this if you want to
1417
+ # enforce per-user limits.
1418
+ # @param [Google::Apis::RequestOptions] options
1419
+ # Request-specific options
1420
+ #
1421
+ # @yield [result, err] Result & error if block supplied
1422
+ # @yieldparam result [Google::Apis::MapsengineV1::ListProjectsResponse] parsed result object
1423
+ # @yieldparam err [StandardError] error object if request failed
1424
+ #
1425
+ # @return [Google::Apis::MapsengineV1::ListProjectsResponse]
1426
+ #
1427
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1428
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1429
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1430
+ def list_projects(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1431
+ path = 'projects'
1432
+ command = make_simple_command(:get, path, options)
1433
+ command.response_representation = Google::Apis::MapsengineV1::ListProjectsResponse::Representation
1434
+ command.response_class = Google::Apis::MapsengineV1::ListProjectsResponse
1435
+ command.query['fields'] = fields unless fields.nil?
1436
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1437
+ command.query['userIp'] = user_ip unless user_ip.nil?
1438
+ execute_or_queue_command(command, &block)
1439
+ end
1440
+
1441
+ # Create an icon.
1442
+ # @param [String] project_id
1443
+ # The ID of the project.
1444
+ # @param [Google::Apis::MapsengineV1::Icon] icon_object
1445
+ # @param [String] fields
1446
+ # Selector specifying which fields to include in a partial response.
1447
+ # @param [String] quota_user
1448
+ # Available to use for quota purposes for server-side applications. Can be any
1449
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1450
+ # Overrides userIp if both are provided.
1451
+ # @param [String] user_ip
1452
+ # IP address of the site where the request originates. Use this if you want to
1453
+ # enforce per-user limits.
1454
+ # @param [IO, String] upload_source
1455
+ # IO stream or filename containing content to upload
1456
+ # @param [String] content_type
1457
+ # Content type of the uploaded content.
1458
+ # @param [Google::Apis::RequestOptions] options
1459
+ # Request-specific options
1460
+ #
1461
+ # @yield [result, err] Result & error if block supplied
1462
+ # @yieldparam result [Google::Apis::MapsengineV1::Icon] parsed result object
1463
+ # @yieldparam err [StandardError] error object if request failed
1464
+ #
1465
+ # @return [Google::Apis::MapsengineV1::Icon]
1466
+ #
1467
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1468
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1469
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1470
+ def create_project_icon(project_id, icon_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
1471
+ path = 'projects/{projectId}/icons'
1472
+ if upload_source.nil?
1473
+ command = make_simple_command(:post, path, options)
1474
+ else
1475
+ command = make_upload_command(:post, path, options)
1476
+ command.upload_source = upload_source
1477
+ command.upload_content_type = content_type
1478
+ end
1479
+ command.request_representation = Google::Apis::MapsengineV1::Icon::Representation
1480
+ command.request_object = icon_object
1481
+ command.response_representation = Google::Apis::MapsengineV1::Icon::Representation
1482
+ command.response_class = Google::Apis::MapsengineV1::Icon
1483
+ command.params['projectId'] = project_id unless project_id.nil?
1484
+ command.query['fields'] = fields unless fields.nil?
1485
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1486
+ command.query['userIp'] = user_ip unless user_ip.nil?
1487
+ execute_or_queue_command(command, &block)
1488
+ end
1489
+
1490
+ # Return an icon or its associated metadata
1491
+ # @param [String] project_id
1492
+ # The ID of the project.
1493
+ # @param [String] id
1494
+ # The ID of the icon.
1495
+ # @param [String] fields
1496
+ # Selector specifying which fields to include in a partial response.
1497
+ # @param [String] quota_user
1498
+ # Available to use for quota purposes for server-side applications. Can be any
1499
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1500
+ # Overrides userIp if both are provided.
1501
+ # @param [String] user_ip
1502
+ # IP address of the site where the request originates. Use this if you want to
1503
+ # enforce per-user limits.
1504
+ # @param [IO, String] download_dest
1505
+ # IO stream or filename to receive content download
1506
+ # @param [Google::Apis::RequestOptions] options
1507
+ # Request-specific options
1508
+ #
1509
+ # @yield [result, err] Result & error if block supplied
1510
+ # @yieldparam result [Google::Apis::MapsengineV1::Icon] parsed result object
1511
+ # @yieldparam err [StandardError] error object if request failed
1512
+ #
1513
+ # @return [Google::Apis::MapsengineV1::Icon]
1514
+ #
1515
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1516
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1517
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1518
+ def get_project_icon(project_id, id, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1519
+ path = 'projects/{projectId}/icons/{id}'
1520
+ if download_dest.nil?
1521
+ command = make_simple_command(:get, path, options)
1522
+ else
1523
+ command = make_download_command(:get, path, options)
1524
+ command.download_dest = download_dest
1525
+ end
1526
+ command.response_representation = Google::Apis::MapsengineV1::Icon::Representation
1527
+ command.response_class = Google::Apis::MapsengineV1::Icon
1528
+ command.params['projectId'] = project_id unless project_id.nil?
1529
+ command.params['id'] = id unless id.nil?
1530
+ command.query['fields'] = fields unless fields.nil?
1531
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1532
+ command.query['userIp'] = user_ip unless user_ip.nil?
1533
+ execute_or_queue_command(command, &block)
1534
+ end
1535
+
1536
+ # Return all icons in the current project
1537
+ # @param [String] project_id
1538
+ # The ID of the project.
1539
+ # @param [Fixnum] max_results
1540
+ # The maximum number of items to include in a single response page. The maximum
1541
+ # supported value is 50.
1542
+ # @param [String] page_token
1543
+ # The continuation token, used to page through large result sets. To get the
1544
+ # next page of results, set this parameter to the value of nextPageToken from
1545
+ # the previous response.
1546
+ # @param [String] fields
1547
+ # Selector specifying which fields to include in a partial response.
1548
+ # @param [String] quota_user
1549
+ # Available to use for quota purposes for server-side applications. Can be any
1550
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1551
+ # Overrides userIp if both are provided.
1552
+ # @param [String] user_ip
1553
+ # IP address of the site where the request originates. Use this if you want to
1554
+ # enforce per-user limits.
1555
+ # @param [Google::Apis::RequestOptions] options
1556
+ # Request-specific options
1557
+ #
1558
+ # @yield [result, err] Result & error if block supplied
1559
+ # @yieldparam result [Google::Apis::MapsengineV1::ListIconsResponse] parsed result object
1560
+ # @yieldparam err [StandardError] error object if request failed
1561
+ #
1562
+ # @return [Google::Apis::MapsengineV1::ListIconsResponse]
1563
+ #
1564
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1565
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1566
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1567
+ def list_project_icons(project_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1568
+ path = 'projects/{projectId}/icons'
1569
+ command = make_simple_command(:get, path, options)
1570
+ command.response_representation = Google::Apis::MapsengineV1::ListIconsResponse::Representation
1571
+ command.response_class = Google::Apis::MapsengineV1::ListIconsResponse
1572
+ command.params['projectId'] = project_id unless project_id.nil?
1573
+ command.query['maxResults'] = max_results unless max_results.nil?
1574
+ command.query['pageToken'] = page_token unless page_token.nil?
1575
+ command.query['fields'] = fields unless fields.nil?
1576
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1577
+ command.query['userIp'] = user_ip unless user_ip.nil?
1578
+ execute_or_queue_command(command, &block)
1579
+ end
1580
+
1581
+ # Cancel processing on a raster collection asset.
1582
+ # @param [String] id
1583
+ # The ID of the raster collection.
1584
+ # @param [String] fields
1585
+ # Selector specifying which fields to include in a partial response.
1586
+ # @param [String] quota_user
1587
+ # Available to use for quota purposes for server-side applications. Can be any
1588
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1589
+ # Overrides userIp if both are provided.
1590
+ # @param [String] user_ip
1591
+ # IP address of the site where the request originates. Use this if you want to
1592
+ # enforce per-user limits.
1593
+ # @param [Google::Apis::RequestOptions] options
1594
+ # Request-specific options
1595
+ #
1596
+ # @yield [result, err] Result & error if block supplied
1597
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
1598
+ # @yieldparam err [StandardError] error object if request failed
1599
+ #
1600
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
1601
+ #
1602
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1603
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1604
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1605
+ def cancel_processing_raster_collection(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1606
+ path = 'rasterCollections/{id}/cancelProcessing'
1607
+ command = make_simple_command(:post, path, options)
1608
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
1609
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
1610
+ command.params['id'] = id unless id.nil?
1611
+ command.query['fields'] = fields unless fields.nil?
1612
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1613
+ command.query['userIp'] = user_ip unless user_ip.nil?
1614
+ execute_or_queue_command(command, &block)
1615
+ end
1616
+
1617
+ # Create a raster collection asset.
1618
+ # @param [Google::Apis::MapsengineV1::RasterCollection] raster_collection_object
1619
+ # @param [String] fields
1620
+ # Selector specifying which fields to include in a partial response.
1621
+ # @param [String] quota_user
1622
+ # Available to use for quota purposes for server-side applications. Can be any
1623
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1624
+ # Overrides userIp if both are provided.
1625
+ # @param [String] user_ip
1626
+ # IP address of the site where the request originates. Use this if you want to
1627
+ # enforce per-user limits.
1628
+ # @param [Google::Apis::RequestOptions] options
1629
+ # Request-specific options
1630
+ #
1631
+ # @yield [result, err] Result & error if block supplied
1632
+ # @yieldparam result [Google::Apis::MapsengineV1::RasterCollection] parsed result object
1633
+ # @yieldparam err [StandardError] error object if request failed
1634
+ #
1635
+ # @return [Google::Apis::MapsengineV1::RasterCollection]
1636
+ #
1637
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1638
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1639
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1640
+ def create_raster_collection(raster_collection_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1641
+ path = 'rasterCollections'
1642
+ command = make_simple_command(:post, path, options)
1643
+ command.request_representation = Google::Apis::MapsengineV1::RasterCollection::Representation
1644
+ command.request_object = raster_collection_object
1645
+ command.response_representation = Google::Apis::MapsengineV1::RasterCollection::Representation
1646
+ command.response_class = Google::Apis::MapsengineV1::RasterCollection
1647
+ command.query['fields'] = fields unless fields.nil?
1648
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1649
+ command.query['userIp'] = user_ip unless user_ip.nil?
1650
+ execute_or_queue_command(command, &block)
1651
+ end
1652
+
1653
+ # Delete a raster collection.
1654
+ # @param [String] id
1655
+ # The ID of the raster collection. Only the raster collection creator or project
1656
+ # owner are permitted to delete. If the rastor collection is included in a layer,
1657
+ # the request will fail. Remove the raster collection from all layers prior to
1658
+ # deleting.
1659
+ # @param [String] fields
1660
+ # Selector specifying which fields to include in a partial response.
1661
+ # @param [String] quota_user
1662
+ # Available to use for quota purposes for server-side applications. Can be any
1663
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1664
+ # Overrides userIp if both are provided.
1665
+ # @param [String] user_ip
1666
+ # IP address of the site where the request originates. Use this if you want to
1667
+ # enforce per-user limits.
1668
+ # @param [Google::Apis::RequestOptions] options
1669
+ # Request-specific options
1670
+ #
1671
+ # @yield [result, err] Result & error if block supplied
1672
+ # @yieldparam result [NilClass] No result returned for this method
1673
+ # @yieldparam err [StandardError] error object if request failed
1674
+ #
1675
+ # @return [void]
1676
+ #
1677
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1678
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1679
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1680
+ def delete_raster_collection(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1681
+ path = 'rasterCollections/{id}'
1682
+ command = make_simple_command(:delete, path, options)
1683
+ command.params['id'] = id unless id.nil?
1684
+ command.query['fields'] = fields unless fields.nil?
1685
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1686
+ command.query['userIp'] = user_ip unless user_ip.nil?
1687
+ execute_or_queue_command(command, &block)
1688
+ end
1689
+
1690
+ # Return metadata for a particular raster collection.
1691
+ # @param [String] id
1692
+ # The ID of the raster collection.
1693
+ # @param [String] fields
1694
+ # Selector specifying which fields to include in a partial response.
1695
+ # @param [String] quota_user
1696
+ # Available to use for quota purposes for server-side applications. Can be any
1697
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1698
+ # Overrides userIp if both are provided.
1699
+ # @param [String] user_ip
1700
+ # IP address of the site where the request originates. Use this if you want to
1701
+ # enforce per-user limits.
1702
+ # @param [Google::Apis::RequestOptions] options
1703
+ # Request-specific options
1704
+ #
1705
+ # @yield [result, err] Result & error if block supplied
1706
+ # @yieldparam result [Google::Apis::MapsengineV1::RasterCollection] parsed result object
1707
+ # @yieldparam err [StandardError] error object if request failed
1708
+ #
1709
+ # @return [Google::Apis::MapsengineV1::RasterCollection]
1710
+ #
1711
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1712
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1713
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1714
+ def get_raster_collection(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1715
+ path = 'rasterCollections/{id}'
1716
+ command = make_simple_command(:get, path, options)
1717
+ command.response_representation = Google::Apis::MapsengineV1::RasterCollection::Representation
1718
+ command.response_class = Google::Apis::MapsengineV1::RasterCollection
1719
+ command.params['id'] = id unless id.nil?
1720
+ command.query['fields'] = fields unless fields.nil?
1721
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1722
+ command.query['userIp'] = user_ip unless user_ip.nil?
1723
+ execute_or_queue_command(command, &block)
1724
+ end
1725
+
1726
+ # Return all raster collections readable by the current user.
1727
+ # @param [String] bbox
1728
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
1729
+ # which intersect this bounding box will be returned.
1730
+ # @param [DateTime] created_after
1731
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1732
+ # assets will have been created at or after this time.
1733
+ # @param [DateTime] created_before
1734
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1735
+ # assets will have been created at or before this time.
1736
+ # @param [String] creator_email
1737
+ # An email address representing a user. Returned assets that have been created
1738
+ # by the user associated with the provided email address.
1739
+ # @param [Fixnum] max_results
1740
+ # The maximum number of items to include in a single response page. The maximum
1741
+ # supported value is 100.
1742
+ # @param [DateTime] modified_after
1743
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1744
+ # assets will have been modified at or after this time.
1745
+ # @param [DateTime] modified_before
1746
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
1747
+ # assets will have been modified at or before this time.
1748
+ # @param [String] page_token
1749
+ # The continuation token, used to page through large result sets. To get the
1750
+ # next page of results, set this parameter to the value of nextPageToken from
1751
+ # the previous response.
1752
+ # @param [String] processing_status
1753
+ # @param [String] project_id
1754
+ # The ID of a Maps Engine project, used to filter the response. To list all
1755
+ # available projects with their IDs, send a Projects: list request. You can also
1756
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
1757
+ # signed in to mapsengine.google.com.
1758
+ # @param [String] role
1759
+ # The role parameter indicates that the response should only contain assets
1760
+ # where the current user has the specified level of access.
1761
+ # @param [String] search
1762
+ # An unstructured search string used to filter the set of results based on asset
1763
+ # metadata.
1764
+ # @param [String] tags
1765
+ # A comma separated list of tags. Returned assets will contain all the tags from
1766
+ # the list.
1767
+ # @param [String] fields
1768
+ # Selector specifying which fields to include in a partial response.
1769
+ # @param [String] quota_user
1770
+ # Available to use for quota purposes for server-side applications. Can be any
1771
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1772
+ # Overrides userIp if both are provided.
1773
+ # @param [String] user_ip
1774
+ # IP address of the site where the request originates. Use this if you want to
1775
+ # enforce per-user limits.
1776
+ # @param [Google::Apis::RequestOptions] options
1777
+ # Request-specific options
1778
+ #
1779
+ # @yield [result, err] Result & error if block supplied
1780
+ # @yieldparam result [Google::Apis::MapsengineV1::ListRasterCollectionsResponse] parsed result object
1781
+ # @yieldparam err [StandardError] error object if request failed
1782
+ #
1783
+ # @return [Google::Apis::MapsengineV1::ListRasterCollectionsResponse]
1784
+ #
1785
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1786
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1787
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1788
+ def list_raster_collections(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, processing_status: nil, project_id: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1789
+ path = 'rasterCollections'
1790
+ command = make_simple_command(:get, path, options)
1791
+ command.response_representation = Google::Apis::MapsengineV1::ListRasterCollectionsResponse::Representation
1792
+ command.response_class = Google::Apis::MapsengineV1::ListRasterCollectionsResponse
1793
+ command.query['bbox'] = bbox unless bbox.nil?
1794
+ command.query['createdAfter'] = created_after unless created_after.nil?
1795
+ command.query['createdBefore'] = created_before unless created_before.nil?
1796
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
1797
+ command.query['maxResults'] = max_results unless max_results.nil?
1798
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
1799
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
1800
+ command.query['pageToken'] = page_token unless page_token.nil?
1801
+ command.query['processingStatus'] = processing_status unless processing_status.nil?
1802
+ command.query['projectId'] = project_id unless project_id.nil?
1803
+ command.query['role'] = role unless role.nil?
1804
+ command.query['search'] = search unless search.nil?
1805
+ command.query['tags'] = tags unless tags.nil?
1806
+ command.query['fields'] = fields unless fields.nil?
1807
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1808
+ command.query['userIp'] = user_ip unless user_ip.nil?
1809
+ execute_or_queue_command(command, &block)
1810
+ end
1811
+
1812
+ # Mutate a raster collection asset.
1813
+ # @param [String] id
1814
+ # The ID of the raster collection.
1815
+ # @param [Google::Apis::MapsengineV1::RasterCollection] raster_collection_object
1816
+ # @param [String] fields
1817
+ # Selector specifying which fields to include in a partial response.
1818
+ # @param [String] quota_user
1819
+ # Available to use for quota purposes for server-side applications. Can be any
1820
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1821
+ # Overrides userIp if both are provided.
1822
+ # @param [String] user_ip
1823
+ # IP address of the site where the request originates. Use this if you want to
1824
+ # enforce per-user limits.
1825
+ # @param [Google::Apis::RequestOptions] options
1826
+ # Request-specific options
1827
+ #
1828
+ # @yield [result, err] Result & error if block supplied
1829
+ # @yieldparam result [NilClass] No result returned for this method
1830
+ # @yieldparam err [StandardError] error object if request failed
1831
+ #
1832
+ # @return [void]
1833
+ #
1834
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1835
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1836
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1837
+ def patch_raster_collection(id, raster_collection_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1838
+ path = 'rasterCollections/{id}'
1839
+ command = make_simple_command(:patch, path, options)
1840
+ command.request_representation = Google::Apis::MapsengineV1::RasterCollection::Representation
1841
+ command.request_object = raster_collection_object
1842
+ command.params['id'] = id unless id.nil?
1843
+ command.query['fields'] = fields unless fields.nil?
1844
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1845
+ command.query['userIp'] = user_ip unless user_ip.nil?
1846
+ execute_or_queue_command(command, &block)
1847
+ end
1848
+
1849
+ # Process a raster collection asset.
1850
+ # @param [String] id
1851
+ # The ID of the raster collection.
1852
+ # @param [String] fields
1853
+ # Selector specifying which fields to include in a partial response.
1854
+ # @param [String] quota_user
1855
+ # Available to use for quota purposes for server-side applications. Can be any
1856
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1857
+ # Overrides userIp if both are provided.
1858
+ # @param [String] user_ip
1859
+ # IP address of the site where the request originates. Use this if you want to
1860
+ # enforce per-user limits.
1861
+ # @param [Google::Apis::RequestOptions] options
1862
+ # Request-specific options
1863
+ #
1864
+ # @yield [result, err] Result & error if block supplied
1865
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
1866
+ # @yieldparam err [StandardError] error object if request failed
1867
+ #
1868
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
1869
+ #
1870
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1871
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1872
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1873
+ def process_raster_collection(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1874
+ path = 'rasterCollections/{id}/process'
1875
+ command = make_simple_command(:post, path, options)
1876
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
1877
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
1878
+ command.params['id'] = id unless id.nil?
1879
+ command.query['fields'] = fields unless fields.nil?
1880
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1881
+ command.query['userIp'] = user_ip unless user_ip.nil?
1882
+ execute_or_queue_command(command, &block)
1883
+ end
1884
+
1885
+ # Return all parent ids of the specified raster collection.
1886
+ # @param [String] id
1887
+ # The ID of the raster collection whose parents will be listed.
1888
+ # @param [Fixnum] max_results
1889
+ # The maximum number of items to include in a single response page. The maximum
1890
+ # supported value is 50.
1891
+ # @param [String] page_token
1892
+ # The continuation token, used to page through large result sets. To get the
1893
+ # next page of results, set this parameter to the value of nextPageToken from
1894
+ # the previous response.
1895
+ # @param [String] fields
1896
+ # Selector specifying which fields to include in a partial response.
1897
+ # @param [String] quota_user
1898
+ # Available to use for quota purposes for server-side applications. Can be any
1899
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1900
+ # Overrides userIp if both are provided.
1901
+ # @param [String] user_ip
1902
+ # IP address of the site where the request originates. Use this if you want to
1903
+ # enforce per-user limits.
1904
+ # @param [Google::Apis::RequestOptions] options
1905
+ # Request-specific options
1906
+ #
1907
+ # @yield [result, err] Result & error if block supplied
1908
+ # @yieldparam result [Google::Apis::MapsengineV1::ListParentsResponse] parsed result object
1909
+ # @yieldparam err [StandardError] error object if request failed
1910
+ #
1911
+ # @return [Google::Apis::MapsengineV1::ListParentsResponse]
1912
+ #
1913
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1914
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1915
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1916
+ def list_raster_collection_parents(id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1917
+ path = 'rasterCollections/{id}/parents'
1918
+ command = make_simple_command(:get, path, options)
1919
+ command.response_representation = Google::Apis::MapsengineV1::ListParentsResponse::Representation
1920
+ command.response_class = Google::Apis::MapsengineV1::ListParentsResponse
1921
+ command.params['id'] = id unless id.nil?
1922
+ command.query['maxResults'] = max_results unless max_results.nil?
1923
+ command.query['pageToken'] = page_token unless page_token.nil?
1924
+ command.query['fields'] = fields unless fields.nil?
1925
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1926
+ command.query['userIp'] = user_ip unless user_ip.nil?
1927
+ execute_or_queue_command(command, &block)
1928
+ end
1929
+
1930
+ # Remove permission entries from an already existing asset.
1931
+ # @param [String] id
1932
+ # The ID of the asset from which permissions will be removed.
1933
+ # @param [Google::Apis::MapsengineV1::BatchDeletePermissionsRequest] batch_delete_permissions_request_object
1934
+ # @param [String] fields
1935
+ # Selector specifying which fields to include in a partial response.
1936
+ # @param [String] quota_user
1937
+ # Available to use for quota purposes for server-side applications. Can be any
1938
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1939
+ # Overrides userIp if both are provided.
1940
+ # @param [String] user_ip
1941
+ # IP address of the site where the request originates. Use this if you want to
1942
+ # enforce per-user limits.
1943
+ # @param [Google::Apis::RequestOptions] options
1944
+ # Request-specific options
1945
+ #
1946
+ # @yield [result, err] Result & error if block supplied
1947
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse] parsed result object
1948
+ # @yieldparam err [StandardError] error object if request failed
1949
+ #
1950
+ # @return [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse]
1951
+ #
1952
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1953
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1954
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1955
+ def batch_delete_raster_collection_permission(id, batch_delete_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1956
+ path = 'rasterCollections/{id}/permissions/batchDelete'
1957
+ command = make_simple_command(:post, path, options)
1958
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsRequest::Representation
1959
+ command.request_object = batch_delete_permissions_request_object
1960
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse::Representation
1961
+ command.response_class = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse
1962
+ command.params['id'] = id unless id.nil?
1963
+ command.query['fields'] = fields unless fields.nil?
1964
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1965
+ command.query['userIp'] = user_ip unless user_ip.nil?
1966
+ execute_or_queue_command(command, &block)
1967
+ end
1968
+
1969
+ # Add or update permission entries to an already existing asset.
1970
+ # An asset can hold up to 20 different permission entries. Each batchInsert
1971
+ # request is atomic.
1972
+ # @param [String] id
1973
+ # The ID of the asset to which permissions will be added.
1974
+ # @param [Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest] batch_update_permissions_request_object
1975
+ # @param [String] fields
1976
+ # Selector specifying which fields to include in a partial response.
1977
+ # @param [String] quota_user
1978
+ # Available to use for quota purposes for server-side applications. Can be any
1979
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1980
+ # Overrides userIp if both are provided.
1981
+ # @param [String] user_ip
1982
+ # IP address of the site where the request originates. Use this if you want to
1983
+ # enforce per-user limits.
1984
+ # @param [Google::Apis::RequestOptions] options
1985
+ # Request-specific options
1986
+ #
1987
+ # @yield [result, err] Result & error if block supplied
1988
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse] parsed result object
1989
+ # @yieldparam err [StandardError] error object if request failed
1990
+ #
1991
+ # @return [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse]
1992
+ #
1993
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1994
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1995
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1996
+ def batch_update_raster_collection_permission(id, batch_update_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1997
+ path = 'rasterCollections/{id}/permissions/batchUpdate'
1998
+ command = make_simple_command(:post, path, options)
1999
+ command.request_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest::Representation
2000
+ command.request_object = batch_update_permissions_request_object
2001
+ command.response_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse::Representation
2002
+ command.response_class = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse
2003
+ command.params['id'] = id unless id.nil?
2004
+ command.query['fields'] = fields unless fields.nil?
2005
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2006
+ command.query['userIp'] = user_ip unless user_ip.nil?
2007
+ execute_or_queue_command(command, &block)
2008
+ end
2009
+
2010
+ # Return all of the permissions for the specified asset.
2011
+ # @param [String] id
2012
+ # The ID of the asset whose permissions will be listed.
2013
+ # @param [String] fields
2014
+ # Selector specifying which fields to include in a partial response.
2015
+ # @param [String] quota_user
2016
+ # Available to use for quota purposes for server-side applications. Can be any
2017
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2018
+ # Overrides userIp if both are provided.
2019
+ # @param [String] user_ip
2020
+ # IP address of the site where the request originates. Use this if you want to
2021
+ # enforce per-user limits.
2022
+ # @param [Google::Apis::RequestOptions] options
2023
+ # Request-specific options
2024
+ #
2025
+ # @yield [result, err] Result & error if block supplied
2026
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
2027
+ # @yieldparam err [StandardError] error object if request failed
2028
+ #
2029
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
2030
+ #
2031
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2032
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2033
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2034
+ def list_raster_collection_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2035
+ path = 'rasterCollections/{id}/permissions'
2036
+ command = make_simple_command(:get, path, options)
2037
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
2038
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
2039
+ command.params['id'] = id unless id.nil?
2040
+ command.query['fields'] = fields unless fields.nil?
2041
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2042
+ command.query['userIp'] = user_ip unless user_ip.nil?
2043
+ execute_or_queue_command(command, &block)
2044
+ end
2045
+
2046
+ # Remove rasters from an existing raster collection.
2047
+ # Up to 50 rasters can be included in a single batchDelete request. Each
2048
+ # batchDelete request is atomic.
2049
+ # @param [String] id
2050
+ # The ID of the raster collection to which these rasters belong.
2051
+ # @param [Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRasterRequest] batch_delete_raster_collections_raster_request_object
2052
+ # @param [String] fields
2053
+ # Selector specifying which fields to include in a partial response.
2054
+ # @param [String] quota_user
2055
+ # Available to use for quota purposes for server-side applications. Can be any
2056
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2057
+ # Overrides userIp if both are provided.
2058
+ # @param [String] user_ip
2059
+ # IP address of the site where the request originates. Use this if you want to
2060
+ # enforce per-user limits.
2061
+ # @param [Google::Apis::RequestOptions] options
2062
+ # Request-specific options
2063
+ #
2064
+ # @yield [result, err] Result & error if block supplied
2065
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRastersResponse] parsed result object
2066
+ # @yieldparam err [StandardError] error object if request failed
2067
+ #
2068
+ # @return [Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRastersResponse]
2069
+ #
2070
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2071
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2072
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2073
+ def batch_delete_raster_collection_raster(id, batch_delete_raster_collections_raster_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2074
+ path = 'rasterCollections/{id}/rasters/batchDelete'
2075
+ command = make_simple_command(:post, path, options)
2076
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRasterRequest::Representation
2077
+ command.request_object = batch_delete_raster_collections_raster_request_object
2078
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRastersResponse::Representation
2079
+ command.response_class = Google::Apis::MapsengineV1::BatchDeleteRasterCollectionsRastersResponse
2080
+ command.params['id'] = id unless id.nil?
2081
+ command.query['fields'] = fields unless fields.nil?
2082
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2083
+ command.query['userIp'] = user_ip unless user_ip.nil?
2084
+ execute_or_queue_command(command, &block)
2085
+ end
2086
+
2087
+ # Add rasters to an existing raster collection. Rasters must be successfully
2088
+ # processed in order to be added to a raster collection.
2089
+ # Up to 50 rasters can be included in a single batchInsert request. Each
2090
+ # batchInsert request is atomic.
2091
+ # @param [String] id
2092
+ # The ID of the raster collection to which these rasters belong.
2093
+ # @param [Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersRequest] batch_insert_raster_collections_rasters_request_object
2094
+ # @param [String] fields
2095
+ # Selector specifying which fields to include in a partial response.
2096
+ # @param [String] quota_user
2097
+ # Available to use for quota purposes for server-side applications. Can be any
2098
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2099
+ # Overrides userIp if both are provided.
2100
+ # @param [String] user_ip
2101
+ # IP address of the site where the request originates. Use this if you want to
2102
+ # enforce per-user limits.
2103
+ # @param [Google::Apis::RequestOptions] options
2104
+ # Request-specific options
2105
+ #
2106
+ # @yield [result, err] Result & error if block supplied
2107
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersResponse] parsed result object
2108
+ # @yieldparam err [StandardError] error object if request failed
2109
+ #
2110
+ # @return [Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersResponse]
2111
+ #
2112
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2113
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2114
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2115
+ def batch_insert_raster_collection_raster(id, batch_insert_raster_collections_rasters_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2116
+ path = 'rasterCollections/{id}/rasters/batchInsert'
2117
+ command = make_simple_command(:post, path, options)
2118
+ command.request_representation = Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersRequest::Representation
2119
+ command.request_object = batch_insert_raster_collections_rasters_request_object
2120
+ command.response_representation = Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersResponse::Representation
2121
+ command.response_class = Google::Apis::MapsengineV1::BatchInsertRasterCollectionsRastersResponse
2122
+ command.params['id'] = id unless id.nil?
2123
+ command.query['fields'] = fields unless fields.nil?
2124
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2125
+ command.query['userIp'] = user_ip unless user_ip.nil?
2126
+ execute_or_queue_command(command, &block)
2127
+ end
2128
+
2129
+ # Return all rasters within a raster collection.
2130
+ # @param [String] id
2131
+ # The ID of the raster collection to which these rasters belong.
2132
+ # @param [String] bbox
2133
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
2134
+ # which intersect this bounding box will be returned.
2135
+ # @param [DateTime] created_after
2136
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2137
+ # assets will have been created at or after this time.
2138
+ # @param [DateTime] created_before
2139
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2140
+ # assets will have been created at or before this time.
2141
+ # @param [String] creator_email
2142
+ # An email address representing a user. Returned assets that have been created
2143
+ # by the user associated with the provided email address.
2144
+ # @param [Fixnum] max_results
2145
+ # The maximum number of items to include in a single response page. The maximum
2146
+ # supported value is 100.
2147
+ # @param [DateTime] modified_after
2148
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2149
+ # assets will have been modified at or after this time.
2150
+ # @param [DateTime] modified_before
2151
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2152
+ # assets will have been modified at or before this time.
2153
+ # @param [String] page_token
2154
+ # The continuation token, used to page through large result sets. To get the
2155
+ # next page of results, set this parameter to the value of nextPageToken from
2156
+ # the previous response.
2157
+ # @param [String] role
2158
+ # The role parameter indicates that the response should only contain assets
2159
+ # where the current user has the specified level of access.
2160
+ # @param [String] search
2161
+ # An unstructured search string used to filter the set of results based on asset
2162
+ # metadata.
2163
+ # @param [String] tags
2164
+ # A comma separated list of tags. Returned assets will contain all the tags from
2165
+ # the list.
2166
+ # @param [String] fields
2167
+ # Selector specifying which fields to include in a partial response.
2168
+ # @param [String] quota_user
2169
+ # Available to use for quota purposes for server-side applications. Can be any
2170
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2171
+ # Overrides userIp if both are provided.
2172
+ # @param [String] user_ip
2173
+ # IP address of the site where the request originates. Use this if you want to
2174
+ # enforce per-user limits.
2175
+ # @param [Google::Apis::RequestOptions] options
2176
+ # Request-specific options
2177
+ #
2178
+ # @yield [result, err] Result & error if block supplied
2179
+ # @yieldparam result [Google::Apis::MapsengineV1::ListRasterCollectionsRastersResponse] parsed result object
2180
+ # @yieldparam err [StandardError] error object if request failed
2181
+ #
2182
+ # @return [Google::Apis::MapsengineV1::ListRasterCollectionsRastersResponse]
2183
+ #
2184
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2185
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2186
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2187
+ def list_raster_collection_rasters(id, bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2188
+ path = 'rasterCollections/{id}/rasters'
2189
+ command = make_simple_command(:get, path, options)
2190
+ command.response_representation = Google::Apis::MapsengineV1::ListRasterCollectionsRastersResponse::Representation
2191
+ command.response_class = Google::Apis::MapsengineV1::ListRasterCollectionsRastersResponse
2192
+ command.params['id'] = id unless id.nil?
2193
+ command.query['bbox'] = bbox unless bbox.nil?
2194
+ command.query['createdAfter'] = created_after unless created_after.nil?
2195
+ command.query['createdBefore'] = created_before unless created_before.nil?
2196
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
2197
+ command.query['maxResults'] = max_results unless max_results.nil?
2198
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
2199
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
2200
+ command.query['pageToken'] = page_token unless page_token.nil?
2201
+ command.query['role'] = role unless role.nil?
2202
+ command.query['search'] = search unless search.nil?
2203
+ command.query['tags'] = tags unless tags.nil?
2204
+ command.query['fields'] = fields unless fields.nil?
2205
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2206
+ command.query['userIp'] = user_ip unless user_ip.nil?
2207
+ execute_or_queue_command(command, &block)
2208
+ end
2209
+
2210
+ # Delete a raster.
2211
+ # @param [String] id
2212
+ # The ID of the raster. Only the raster creator or project owner are permitted
2213
+ # to delete. If the raster is included in a layer or mosaic, the request will
2214
+ # fail. Remove it from all parents prior to deleting.
2215
+ # @param [String] fields
2216
+ # Selector specifying which fields to include in a partial response.
2217
+ # @param [String] quota_user
2218
+ # Available to use for quota purposes for server-side applications. Can be any
2219
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2220
+ # Overrides userIp if both are provided.
2221
+ # @param [String] user_ip
2222
+ # IP address of the site where the request originates. Use this if you want to
2223
+ # enforce per-user limits.
2224
+ # @param [Google::Apis::RequestOptions] options
2225
+ # Request-specific options
2226
+ #
2227
+ # @yield [result, err] Result & error if block supplied
2228
+ # @yieldparam result [NilClass] No result returned for this method
2229
+ # @yieldparam err [StandardError] error object if request failed
2230
+ #
2231
+ # @return [void]
2232
+ #
2233
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2234
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2235
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2236
+ def delete_raster(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2237
+ path = 'rasters/{id}'
2238
+ command = make_simple_command(:delete, path, options)
2239
+ command.params['id'] = id unless id.nil?
2240
+ command.query['fields'] = fields unless fields.nil?
2241
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2242
+ command.query['userIp'] = user_ip unless user_ip.nil?
2243
+ execute_or_queue_command(command, &block)
2244
+ end
2245
+
2246
+ # Return metadata for a single raster.
2247
+ # @param [String] id
2248
+ # The ID of the raster.
2249
+ # @param [String] fields
2250
+ # Selector specifying which fields to include in a partial response.
2251
+ # @param [String] quota_user
2252
+ # Available to use for quota purposes for server-side applications. Can be any
2253
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2254
+ # Overrides userIp if both are provided.
2255
+ # @param [String] user_ip
2256
+ # IP address of the site where the request originates. Use this if you want to
2257
+ # enforce per-user limits.
2258
+ # @param [Google::Apis::RequestOptions] options
2259
+ # Request-specific options
2260
+ #
2261
+ # @yield [result, err] Result & error if block supplied
2262
+ # @yieldparam result [Google::Apis::MapsengineV1::Raster] parsed result object
2263
+ # @yieldparam err [StandardError] error object if request failed
2264
+ #
2265
+ # @return [Google::Apis::MapsengineV1::Raster]
2266
+ #
2267
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2268
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2269
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2270
+ def get_raster(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2271
+ path = 'rasters/{id}'
2272
+ command = make_simple_command(:get, path, options)
2273
+ command.response_representation = Google::Apis::MapsengineV1::Raster::Representation
2274
+ command.response_class = Google::Apis::MapsengineV1::Raster
2275
+ command.params['id'] = id unless id.nil?
2276
+ command.query['fields'] = fields unless fields.nil?
2277
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2278
+ command.query['userIp'] = user_ip unless user_ip.nil?
2279
+ execute_or_queue_command(command, &block)
2280
+ end
2281
+
2282
+ # Return all rasters readable by the current user.
2283
+ # @param [String] bbox
2284
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
2285
+ # which intersect this bounding box will be returned.
2286
+ # @param [DateTime] created_after
2287
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2288
+ # assets will have been created at or after this time.
2289
+ # @param [DateTime] created_before
2290
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2291
+ # assets will have been created at or before this time.
2292
+ # @param [String] creator_email
2293
+ # An email address representing a user. Returned assets that have been created
2294
+ # by the user associated with the provided email address.
2295
+ # @param [Fixnum] max_results
2296
+ # The maximum number of items to include in a single response page. The maximum
2297
+ # supported value is 100.
2298
+ # @param [DateTime] modified_after
2299
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2300
+ # assets will have been modified at or after this time.
2301
+ # @param [DateTime] modified_before
2302
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2303
+ # assets will have been modified at or before this time.
2304
+ # @param [String] page_token
2305
+ # The continuation token, used to page through large result sets. To get the
2306
+ # next page of results, set this parameter to the value of nextPageToken from
2307
+ # the previous response.
2308
+ # @param [String] processing_status
2309
+ # @param [String] project_id
2310
+ # The ID of a Maps Engine project, used to filter the response. To list all
2311
+ # available projects with their IDs, send a Projects: list request. You can also
2312
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
2313
+ # signed in to mapsengine.google.com.
2314
+ # @param [String] role
2315
+ # The role parameter indicates that the response should only contain assets
2316
+ # where the current user has the specified level of access.
2317
+ # @param [String] search
2318
+ # An unstructured search string used to filter the set of results based on asset
2319
+ # metadata.
2320
+ # @param [String] tags
2321
+ # A comma separated list of tags. Returned assets will contain all the tags from
2322
+ # the list.
2323
+ # @param [String] fields
2324
+ # Selector specifying which fields to include in a partial response.
2325
+ # @param [String] quota_user
2326
+ # Available to use for quota purposes for server-side applications. Can be any
2327
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2328
+ # Overrides userIp if both are provided.
2329
+ # @param [String] user_ip
2330
+ # IP address of the site where the request originates. Use this if you want to
2331
+ # enforce per-user limits.
2332
+ # @param [Google::Apis::RequestOptions] options
2333
+ # Request-specific options
2334
+ #
2335
+ # @yield [result, err] Result & error if block supplied
2336
+ # @yieldparam result [Google::Apis::MapsengineV1::ListRastersResponse] parsed result object
2337
+ # @yieldparam err [StandardError] error object if request failed
2338
+ #
2339
+ # @return [Google::Apis::MapsengineV1::ListRastersResponse]
2340
+ #
2341
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2342
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2343
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2344
+ def list_rasters(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, processing_status: nil, project_id: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2345
+ path = 'rasters'
2346
+ command = make_simple_command(:get, path, options)
2347
+ command.response_representation = Google::Apis::MapsengineV1::ListRastersResponse::Representation
2348
+ command.response_class = Google::Apis::MapsengineV1::ListRastersResponse
2349
+ command.query['bbox'] = bbox unless bbox.nil?
2350
+ command.query['createdAfter'] = created_after unless created_after.nil?
2351
+ command.query['createdBefore'] = created_before unless created_before.nil?
2352
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
2353
+ command.query['maxResults'] = max_results unless max_results.nil?
2354
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
2355
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
2356
+ command.query['pageToken'] = page_token unless page_token.nil?
2357
+ command.query['processingStatus'] = processing_status unless processing_status.nil?
2358
+ command.query['projectId'] = project_id unless project_id.nil?
2359
+ command.query['role'] = role unless role.nil?
2360
+ command.query['search'] = search unless search.nil?
2361
+ command.query['tags'] = tags unless tags.nil?
2362
+ command.query['fields'] = fields unless fields.nil?
2363
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2364
+ command.query['userIp'] = user_ip unless user_ip.nil?
2365
+ execute_or_queue_command(command, &block)
2366
+ end
2367
+
2368
+ # Mutate a raster asset.
2369
+ # @param [String] id
2370
+ # The ID of the raster.
2371
+ # @param [Google::Apis::MapsengineV1::Raster] raster_object
2372
+ # @param [String] fields
2373
+ # Selector specifying which fields to include in a partial response.
2374
+ # @param [String] quota_user
2375
+ # Available to use for quota purposes for server-side applications. Can be any
2376
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2377
+ # Overrides userIp if both are provided.
2378
+ # @param [String] user_ip
2379
+ # IP address of the site where the request originates. Use this if you want to
2380
+ # enforce per-user limits.
2381
+ # @param [Google::Apis::RequestOptions] options
2382
+ # Request-specific options
2383
+ #
2384
+ # @yield [result, err] Result & error if block supplied
2385
+ # @yieldparam result [NilClass] No result returned for this method
2386
+ # @yieldparam err [StandardError] error object if request failed
2387
+ #
2388
+ # @return [void]
2389
+ #
2390
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2391
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2392
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2393
+ def patch_raster(id, raster_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2394
+ path = 'rasters/{id}'
2395
+ command = make_simple_command(:patch, path, options)
2396
+ command.request_representation = Google::Apis::MapsengineV1::Raster::Representation
2397
+ command.request_object = raster_object
2398
+ command.params['id'] = id unless id.nil?
2399
+ command.query['fields'] = fields unless fields.nil?
2400
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2401
+ command.query['userIp'] = user_ip unless user_ip.nil?
2402
+ execute_or_queue_command(command, &block)
2403
+ end
2404
+
2405
+ # Process a raster asset.
2406
+ # @param [String] id
2407
+ # The ID of the raster.
2408
+ # @param [String] fields
2409
+ # Selector specifying which fields to include in a partial response.
2410
+ # @param [String] quota_user
2411
+ # Available to use for quota purposes for server-side applications. Can be any
2412
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2413
+ # Overrides userIp if both are provided.
2414
+ # @param [String] user_ip
2415
+ # IP address of the site where the request originates. Use this if you want to
2416
+ # enforce per-user limits.
2417
+ # @param [Google::Apis::RequestOptions] options
2418
+ # Request-specific options
2419
+ #
2420
+ # @yield [result, err] Result & error if block supplied
2421
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
2422
+ # @yieldparam err [StandardError] error object if request failed
2423
+ #
2424
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
2425
+ #
2426
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2427
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2428
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2429
+ def process_raster(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2430
+ path = 'rasters/{id}/process'
2431
+ command = make_simple_command(:post, path, options)
2432
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
2433
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
2434
+ command.params['id'] = id unless id.nil?
2435
+ command.query['fields'] = fields unless fields.nil?
2436
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2437
+ command.query['userIp'] = user_ip unless user_ip.nil?
2438
+ execute_or_queue_command(command, &block)
2439
+ end
2440
+
2441
+ # Create a skeleton raster asset for upload.
2442
+ # @param [Google::Apis::MapsengineV1::Raster] raster_object
2443
+ # @param [String] fields
2444
+ # Selector specifying which fields to include in a partial response.
2445
+ # @param [String] quota_user
2446
+ # Available to use for quota purposes for server-side applications. Can be any
2447
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2448
+ # Overrides userIp if both are provided.
2449
+ # @param [String] user_ip
2450
+ # IP address of the site where the request originates. Use this if you want to
2451
+ # enforce per-user limits.
2452
+ # @param [Google::Apis::RequestOptions] options
2453
+ # Request-specific options
2454
+ #
2455
+ # @yield [result, err] Result & error if block supplied
2456
+ # @yieldparam result [Google::Apis::MapsengineV1::Raster] parsed result object
2457
+ # @yieldparam err [StandardError] error object if request failed
2458
+ #
2459
+ # @return [Google::Apis::MapsengineV1::Raster]
2460
+ #
2461
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2462
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2463
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2464
+ def upload_raster(raster_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2465
+ path = 'rasters/upload'
2466
+ command = make_simple_command(:post, path, options)
2467
+ command.request_representation = Google::Apis::MapsengineV1::Raster::Representation
2468
+ command.request_object = raster_object
2469
+ command.response_representation = Google::Apis::MapsengineV1::Raster::Representation
2470
+ command.response_class = Google::Apis::MapsengineV1::Raster
2471
+ command.query['fields'] = fields unless fields.nil?
2472
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2473
+ command.query['userIp'] = user_ip unless user_ip.nil?
2474
+ execute_or_queue_command(command, &block)
2475
+ end
2476
+
2477
+ # Upload a file to a raster asset.
2478
+ # @param [String] id
2479
+ # The ID of the raster asset.
2480
+ # @param [String] filename
2481
+ # The file name of this uploaded file.
2482
+ # @param [String] fields
2483
+ # Selector specifying which fields to include in a partial response.
2484
+ # @param [String] quota_user
2485
+ # Available to use for quota purposes for server-side applications. Can be any
2486
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2487
+ # Overrides userIp if both are provided.
2488
+ # @param [String] user_ip
2489
+ # IP address of the site where the request originates. Use this if you want to
2490
+ # enforce per-user limits.
2491
+ # @param [IO, String] upload_source
2492
+ # IO stream or filename containing content to upload
2493
+ # @param [String] content_type
2494
+ # Content type of the uploaded content.
2495
+ # @param [Google::Apis::RequestOptions] options
2496
+ # Request-specific options
2497
+ #
2498
+ # @yield [result, err] Result & error if block supplied
2499
+ # @yieldparam result [NilClass] No result returned for this method
2500
+ # @yieldparam err [StandardError] error object if request failed
2501
+ #
2502
+ # @return [void]
2503
+ #
2504
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2505
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2506
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2507
+ def insert_raster_file(id, filename: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
2508
+ path = 'rasters/{id}/files'
2509
+ if upload_source.nil?
2510
+ command = make_simple_command(:post, path, options)
2511
+ else
2512
+ command = make_upload_command(:post, path, options)
2513
+ command.upload_source = upload_source
2514
+ command.upload_content_type = content_type
2515
+ end
2516
+ command.params['id'] = id unless id.nil?
2517
+ command.query['filename'] = filename unless filename.nil?
2518
+ command.query['fields'] = fields unless fields.nil?
2519
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2520
+ command.query['userIp'] = user_ip unless user_ip.nil?
2521
+ execute_or_queue_command(command, &block)
2522
+ end
2523
+
2524
+ # Return all parent ids of the specified rasters.
2525
+ # @param [String] id
2526
+ # The ID of the rasters whose parents will be listed.
2527
+ # @param [Fixnum] max_results
2528
+ # The maximum number of items to include in a single response page. The maximum
2529
+ # supported value is 50.
2530
+ # @param [String] page_token
2531
+ # The continuation token, used to page through large result sets. To get the
2532
+ # next page of results, set this parameter to the value of nextPageToken from
2533
+ # the previous response.
2534
+ # @param [String] fields
2535
+ # Selector specifying which fields to include in a partial response.
2536
+ # @param [String] quota_user
2537
+ # Available to use for quota purposes for server-side applications. Can be any
2538
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2539
+ # Overrides userIp if both are provided.
2540
+ # @param [String] user_ip
2541
+ # IP address of the site where the request originates. Use this if you want to
2542
+ # enforce per-user limits.
2543
+ # @param [Google::Apis::RequestOptions] options
2544
+ # Request-specific options
2545
+ #
2546
+ # @yield [result, err] Result & error if block supplied
2547
+ # @yieldparam result [Google::Apis::MapsengineV1::ListParentsResponse] parsed result object
2548
+ # @yieldparam err [StandardError] error object if request failed
2549
+ #
2550
+ # @return [Google::Apis::MapsengineV1::ListParentsResponse]
2551
+ #
2552
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2553
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2554
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2555
+ def list_raster_parents(id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2556
+ path = 'rasters/{id}/parents'
2557
+ command = make_simple_command(:get, path, options)
2558
+ command.response_representation = Google::Apis::MapsengineV1::ListParentsResponse::Representation
2559
+ command.response_class = Google::Apis::MapsengineV1::ListParentsResponse
2560
+ command.params['id'] = id unless id.nil?
2561
+ command.query['maxResults'] = max_results unless max_results.nil?
2562
+ command.query['pageToken'] = page_token unless page_token.nil?
2563
+ command.query['fields'] = fields unless fields.nil?
2564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2565
+ command.query['userIp'] = user_ip unless user_ip.nil?
2566
+ execute_or_queue_command(command, &block)
2567
+ end
2568
+
2569
+ # Remove permission entries from an already existing asset.
2570
+ # @param [String] id
2571
+ # The ID of the asset from which permissions will be removed.
2572
+ # @param [Google::Apis::MapsengineV1::BatchDeletePermissionsRequest] batch_delete_permissions_request_object
2573
+ # @param [String] fields
2574
+ # Selector specifying which fields to include in a partial response.
2575
+ # @param [String] quota_user
2576
+ # Available to use for quota purposes for server-side applications. Can be any
2577
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2578
+ # Overrides userIp if both are provided.
2579
+ # @param [String] user_ip
2580
+ # IP address of the site where the request originates. Use this if you want to
2581
+ # enforce per-user limits.
2582
+ # @param [Google::Apis::RequestOptions] options
2583
+ # Request-specific options
2584
+ #
2585
+ # @yield [result, err] Result & error if block supplied
2586
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse] parsed result object
2587
+ # @yieldparam err [StandardError] error object if request failed
2588
+ #
2589
+ # @return [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse]
2590
+ #
2591
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2592
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2593
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2594
+ def batch_delete_raster_permission(id, batch_delete_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2595
+ path = 'rasters/{id}/permissions/batchDelete'
2596
+ command = make_simple_command(:post, path, options)
2597
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsRequest::Representation
2598
+ command.request_object = batch_delete_permissions_request_object
2599
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse::Representation
2600
+ command.response_class = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse
2601
+ command.params['id'] = id unless id.nil?
2602
+ command.query['fields'] = fields unless fields.nil?
2603
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2604
+ command.query['userIp'] = user_ip unless user_ip.nil?
2605
+ execute_or_queue_command(command, &block)
2606
+ end
2607
+
2608
+ # Add or update permission entries to an already existing asset.
2609
+ # An asset can hold up to 20 different permission entries. Each batchInsert
2610
+ # request is atomic.
2611
+ # @param [String] id
2612
+ # The ID of the asset to which permissions will be added.
2613
+ # @param [Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest] batch_update_permissions_request_object
2614
+ # @param [String] fields
2615
+ # Selector specifying which fields to include in a partial response.
2616
+ # @param [String] quota_user
2617
+ # Available to use for quota purposes for server-side applications. Can be any
2618
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2619
+ # Overrides userIp if both are provided.
2620
+ # @param [String] user_ip
2621
+ # IP address of the site where the request originates. Use this if you want to
2622
+ # enforce per-user limits.
2623
+ # @param [Google::Apis::RequestOptions] options
2624
+ # Request-specific options
2625
+ #
2626
+ # @yield [result, err] Result & error if block supplied
2627
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse] parsed result object
2628
+ # @yieldparam err [StandardError] error object if request failed
2629
+ #
2630
+ # @return [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse]
2631
+ #
2632
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2633
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2634
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2635
+ def batch_update_raster_permission(id, batch_update_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2636
+ path = 'rasters/{id}/permissions/batchUpdate'
2637
+ command = make_simple_command(:post, path, options)
2638
+ command.request_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest::Representation
2639
+ command.request_object = batch_update_permissions_request_object
2640
+ command.response_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse::Representation
2641
+ command.response_class = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse
2642
+ command.params['id'] = id unless id.nil?
2643
+ command.query['fields'] = fields unless fields.nil?
2644
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2645
+ command.query['userIp'] = user_ip unless user_ip.nil?
2646
+ execute_or_queue_command(command, &block)
2647
+ end
2648
+
2649
+ # Return all of the permissions for the specified asset.
2650
+ # @param [String] id
2651
+ # The ID of the asset whose permissions will be listed.
2652
+ # @param [String] fields
2653
+ # Selector specifying which fields to include in a partial response.
2654
+ # @param [String] quota_user
2655
+ # Available to use for quota purposes for server-side applications. Can be any
2656
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2657
+ # Overrides userIp if both are provided.
2658
+ # @param [String] user_ip
2659
+ # IP address of the site where the request originates. Use this if you want to
2660
+ # enforce per-user limits.
2661
+ # @param [Google::Apis::RequestOptions] options
2662
+ # Request-specific options
2663
+ #
2664
+ # @yield [result, err] Result & error if block supplied
2665
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
2666
+ # @yieldparam err [StandardError] error object if request failed
2667
+ #
2668
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
2669
+ #
2670
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2671
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2672
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2673
+ def list_raster_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2674
+ path = 'rasters/{id}/permissions'
2675
+ command = make_simple_command(:get, path, options)
2676
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
2677
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
2678
+ command.params['id'] = id unless id.nil?
2679
+ command.query['fields'] = fields unless fields.nil?
2680
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2681
+ command.query['userIp'] = user_ip unless user_ip.nil?
2682
+ execute_or_queue_command(command, &block)
2683
+ end
2684
+
2685
+ # Create a table asset.
2686
+ # @param [Google::Apis::MapsengineV1::Table] table_object
2687
+ # @param [String] fields
2688
+ # Selector specifying which fields to include in a partial response.
2689
+ # @param [String] quota_user
2690
+ # Available to use for quota purposes for server-side applications. Can be any
2691
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2692
+ # Overrides userIp if both are provided.
2693
+ # @param [String] user_ip
2694
+ # IP address of the site where the request originates. Use this if you want to
2695
+ # enforce per-user limits.
2696
+ # @param [Google::Apis::RequestOptions] options
2697
+ # Request-specific options
2698
+ #
2699
+ # @yield [result, err] Result & error if block supplied
2700
+ # @yieldparam result [Google::Apis::MapsengineV1::Table] parsed result object
2701
+ # @yieldparam err [StandardError] error object if request failed
2702
+ #
2703
+ # @return [Google::Apis::MapsengineV1::Table]
2704
+ #
2705
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2706
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2707
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2708
+ def create_table(table_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2709
+ path = 'tables'
2710
+ command = make_simple_command(:post, path, options)
2711
+ command.request_representation = Google::Apis::MapsengineV1::Table::Representation
2712
+ command.request_object = table_object
2713
+ command.response_representation = Google::Apis::MapsengineV1::Table::Representation
2714
+ command.response_class = Google::Apis::MapsengineV1::Table
2715
+ command.query['fields'] = fields unless fields.nil?
2716
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2717
+ command.query['userIp'] = user_ip unless user_ip.nil?
2718
+ execute_or_queue_command(command, &block)
2719
+ end
2720
+
2721
+ # Delete a table.
2722
+ # @param [String] id
2723
+ # The ID of the table. Only the table creator or project owner are permitted to
2724
+ # delete. If the table is included in a layer, the request will fail. Remove it
2725
+ # from all layers prior to deleting.
2726
+ # @param [String] fields
2727
+ # Selector specifying which fields to include in a partial response.
2728
+ # @param [String] quota_user
2729
+ # Available to use for quota purposes for server-side applications. Can be any
2730
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2731
+ # Overrides userIp if both are provided.
2732
+ # @param [String] user_ip
2733
+ # IP address of the site where the request originates. Use this if you want to
2734
+ # enforce per-user limits.
2735
+ # @param [Google::Apis::RequestOptions] options
2736
+ # Request-specific options
2737
+ #
2738
+ # @yield [result, err] Result & error if block supplied
2739
+ # @yieldparam result [NilClass] No result returned for this method
2740
+ # @yieldparam err [StandardError] error object if request failed
2741
+ #
2742
+ # @return [void]
2743
+ #
2744
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2745
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2746
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2747
+ def delete_table(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2748
+ path = 'tables/{id}'
2749
+ command = make_simple_command(:delete, path, options)
2750
+ command.params['id'] = id unless id.nil?
2751
+ command.query['fields'] = fields unless fields.nil?
2752
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2753
+ command.query['userIp'] = user_ip unless user_ip.nil?
2754
+ execute_or_queue_command(command, &block)
2755
+ end
2756
+
2757
+ # Return metadata for a particular table, including the schema.
2758
+ # @param [String] id
2759
+ # The ID of the table.
2760
+ # @param [String] version
2761
+ # @param [String] fields
2762
+ # Selector specifying which fields to include in a partial response.
2763
+ # @param [String] quota_user
2764
+ # Available to use for quota purposes for server-side applications. Can be any
2765
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2766
+ # Overrides userIp if both are provided.
2767
+ # @param [String] user_ip
2768
+ # IP address of the site where the request originates. Use this if you want to
2769
+ # enforce per-user limits.
2770
+ # @param [Google::Apis::RequestOptions] options
2771
+ # Request-specific options
2772
+ #
2773
+ # @yield [result, err] Result & error if block supplied
2774
+ # @yieldparam result [Google::Apis::MapsengineV1::Table] parsed result object
2775
+ # @yieldparam err [StandardError] error object if request failed
2776
+ #
2777
+ # @return [Google::Apis::MapsengineV1::Table]
2778
+ #
2779
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2780
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2781
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2782
+ def get_table(id, version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2783
+ path = 'tables/{id}'
2784
+ command = make_simple_command(:get, path, options)
2785
+ command.response_representation = Google::Apis::MapsengineV1::Table::Representation
2786
+ command.response_class = Google::Apis::MapsengineV1::Table
2787
+ command.params['id'] = id unless id.nil?
2788
+ command.query['version'] = version unless version.nil?
2789
+ command.query['fields'] = fields unless fields.nil?
2790
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2791
+ command.query['userIp'] = user_ip unless user_ip.nil?
2792
+ execute_or_queue_command(command, &block)
2793
+ end
2794
+
2795
+ # Return all tables readable by the current user.
2796
+ # @param [String] bbox
2797
+ # A bounding box, expressed as "west,south,east,north". If set, only assets
2798
+ # which intersect this bounding box will be returned.
2799
+ # @param [DateTime] created_after
2800
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2801
+ # assets will have been created at or after this time.
2802
+ # @param [DateTime] created_before
2803
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2804
+ # assets will have been created at or before this time.
2805
+ # @param [String] creator_email
2806
+ # An email address representing a user. Returned assets that have been created
2807
+ # by the user associated with the provided email address.
2808
+ # @param [Fixnum] max_results
2809
+ # The maximum number of items to include in a single response page. The maximum
2810
+ # supported value is 100.
2811
+ # @param [DateTime] modified_after
2812
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2813
+ # assets will have been modified at or after this time.
2814
+ # @param [DateTime] modified_before
2815
+ # An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned
2816
+ # assets will have been modified at or before this time.
2817
+ # @param [String] page_token
2818
+ # The continuation token, used to page through large result sets. To get the
2819
+ # next page of results, set this parameter to the value of nextPageToken from
2820
+ # the previous response.
2821
+ # @param [String] processing_status
2822
+ # @param [String] project_id
2823
+ # The ID of a Maps Engine project, used to filter the response. To list all
2824
+ # available projects with their IDs, send a Projects: list request. You can also
2825
+ # find your project ID as the value of the DashboardPlace:cid URL parameter when
2826
+ # signed in to mapsengine.google.com.
2827
+ # @param [String] role
2828
+ # The role parameter indicates that the response should only contain assets
2829
+ # where the current user has the specified level of access.
2830
+ # @param [String] search
2831
+ # An unstructured search string used to filter the set of results based on asset
2832
+ # metadata.
2833
+ # @param [String] tags
2834
+ # A comma separated list of tags. Returned assets will contain all the tags from
2835
+ # the list.
2836
+ # @param [String] fields
2837
+ # Selector specifying which fields to include in a partial response.
2838
+ # @param [String] quota_user
2839
+ # Available to use for quota purposes for server-side applications. Can be any
2840
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2841
+ # Overrides userIp if both are provided.
2842
+ # @param [String] user_ip
2843
+ # IP address of the site where the request originates. Use this if you want to
2844
+ # enforce per-user limits.
2845
+ # @param [Google::Apis::RequestOptions] options
2846
+ # Request-specific options
2847
+ #
2848
+ # @yield [result, err] Result & error if block supplied
2849
+ # @yieldparam result [Google::Apis::MapsengineV1::ListTablesResponse] parsed result object
2850
+ # @yieldparam err [StandardError] error object if request failed
2851
+ #
2852
+ # @return [Google::Apis::MapsengineV1::ListTablesResponse]
2853
+ #
2854
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2855
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2856
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2857
+ def list_tables(bbox: nil, created_after: nil, created_before: nil, creator_email: nil, max_results: nil, modified_after: nil, modified_before: nil, page_token: nil, processing_status: nil, project_id: nil, role: nil, search: nil, tags: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2858
+ path = 'tables'
2859
+ command = make_simple_command(:get, path, options)
2860
+ command.response_representation = Google::Apis::MapsengineV1::ListTablesResponse::Representation
2861
+ command.response_class = Google::Apis::MapsengineV1::ListTablesResponse
2862
+ command.query['bbox'] = bbox unless bbox.nil?
2863
+ command.query['createdAfter'] = created_after unless created_after.nil?
2864
+ command.query['createdBefore'] = created_before unless created_before.nil?
2865
+ command.query['creatorEmail'] = creator_email unless creator_email.nil?
2866
+ command.query['maxResults'] = max_results unless max_results.nil?
2867
+ command.query['modifiedAfter'] = modified_after unless modified_after.nil?
2868
+ command.query['modifiedBefore'] = modified_before unless modified_before.nil?
2869
+ command.query['pageToken'] = page_token unless page_token.nil?
2870
+ command.query['processingStatus'] = processing_status unless processing_status.nil?
2871
+ command.query['projectId'] = project_id unless project_id.nil?
2872
+ command.query['role'] = role unless role.nil?
2873
+ command.query['search'] = search unless search.nil?
2874
+ command.query['tags'] = tags unless tags.nil?
2875
+ command.query['fields'] = fields unless fields.nil?
2876
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2877
+ command.query['userIp'] = user_ip unless user_ip.nil?
2878
+ execute_or_queue_command(command, &block)
2879
+ end
2880
+
2881
+ # Mutate a table asset.
2882
+ # @param [String] id
2883
+ # The ID of the table.
2884
+ # @param [Google::Apis::MapsengineV1::Table] table_object
2885
+ # @param [String] fields
2886
+ # Selector specifying which fields to include in a partial response.
2887
+ # @param [String] quota_user
2888
+ # Available to use for quota purposes for server-side applications. Can be any
2889
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2890
+ # Overrides userIp if both are provided.
2891
+ # @param [String] user_ip
2892
+ # IP address of the site where the request originates. Use this if you want to
2893
+ # enforce per-user limits.
2894
+ # @param [Google::Apis::RequestOptions] options
2895
+ # Request-specific options
2896
+ #
2897
+ # @yield [result, err] Result & error if block supplied
2898
+ # @yieldparam result [NilClass] No result returned for this method
2899
+ # @yieldparam err [StandardError] error object if request failed
2900
+ #
2901
+ # @return [void]
2902
+ #
2903
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2904
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2905
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2906
+ def patch_table(id, table_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2907
+ path = 'tables/{id}'
2908
+ command = make_simple_command(:patch, path, options)
2909
+ command.request_representation = Google::Apis::MapsengineV1::Table::Representation
2910
+ command.request_object = table_object
2911
+ command.params['id'] = id unless id.nil?
2912
+ command.query['fields'] = fields unless fields.nil?
2913
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2914
+ command.query['userIp'] = user_ip unless user_ip.nil?
2915
+ execute_or_queue_command(command, &block)
2916
+ end
2917
+
2918
+ # Process a table asset.
2919
+ # @param [String] id
2920
+ # The ID of the table.
2921
+ # @param [String] fields
2922
+ # Selector specifying which fields to include in a partial response.
2923
+ # @param [String] quota_user
2924
+ # Available to use for quota purposes for server-side applications. Can be any
2925
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2926
+ # Overrides userIp if both are provided.
2927
+ # @param [String] user_ip
2928
+ # IP address of the site where the request originates. Use this if you want to
2929
+ # enforce per-user limits.
2930
+ # @param [Google::Apis::RequestOptions] options
2931
+ # Request-specific options
2932
+ #
2933
+ # @yield [result, err] Result & error if block supplied
2934
+ # @yieldparam result [Google::Apis::MapsengineV1::ProcessResponse] parsed result object
2935
+ # @yieldparam err [StandardError] error object if request failed
2936
+ #
2937
+ # @return [Google::Apis::MapsengineV1::ProcessResponse]
2938
+ #
2939
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2940
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2941
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2942
+ def process_table(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2943
+ path = 'tables/{id}/process'
2944
+ command = make_simple_command(:post, path, options)
2945
+ command.response_representation = Google::Apis::MapsengineV1::ProcessResponse::Representation
2946
+ command.response_class = Google::Apis::MapsengineV1::ProcessResponse
2947
+ command.params['id'] = id unless id.nil?
2948
+ command.query['fields'] = fields unless fields.nil?
2949
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2950
+ command.query['userIp'] = user_ip unless user_ip.nil?
2951
+ execute_or_queue_command(command, &block)
2952
+ end
2953
+
2954
+ # Create a placeholder table asset to which table files can be uploaded.
2955
+ # Once the placeholder has been created, files are uploaded to the https://www.
2956
+ # googleapis.com/upload/mapsengine/v1/tables/table_id/files endpoint.
2957
+ # See Table Upload in the Developer's Guide or Table.files: insert in the
2958
+ # reference documentation for more information.
2959
+ # @param [Google::Apis::MapsengineV1::Table] table_object
2960
+ # @param [String] fields
2961
+ # Selector specifying which fields to include in a partial response.
2962
+ # @param [String] quota_user
2963
+ # Available to use for quota purposes for server-side applications. Can be any
2964
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2965
+ # Overrides userIp if both are provided.
2966
+ # @param [String] user_ip
2967
+ # IP address of the site where the request originates. Use this if you want to
2968
+ # enforce per-user limits.
2969
+ # @param [Google::Apis::RequestOptions] options
2970
+ # Request-specific options
2971
+ #
2972
+ # @yield [result, err] Result & error if block supplied
2973
+ # @yieldparam result [Google::Apis::MapsengineV1::Table] parsed result object
2974
+ # @yieldparam err [StandardError] error object if request failed
2975
+ #
2976
+ # @return [Google::Apis::MapsengineV1::Table]
2977
+ #
2978
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2979
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2980
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2981
+ def upload_table(table_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2982
+ path = 'tables/upload'
2983
+ command = make_simple_command(:post, path, options)
2984
+ command.request_representation = Google::Apis::MapsengineV1::Table::Representation
2985
+ command.request_object = table_object
2986
+ command.response_representation = Google::Apis::MapsengineV1::Table::Representation
2987
+ command.response_class = Google::Apis::MapsengineV1::Table
2988
+ command.query['fields'] = fields unless fields.nil?
2989
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2990
+ command.query['userIp'] = user_ip unless user_ip.nil?
2991
+ execute_or_queue_command(command, &block)
2992
+ end
2993
+
2994
+ # Delete all features matching the given IDs.
2995
+ # @param [String] id
2996
+ # The ID of the table that contains the features to be deleted.
2997
+ # @param [Google::Apis::MapsengineV1::BatchDeleteFeaturesRequest] batch_delete_features_request_object
2998
+ # @param [String] fields
2999
+ # Selector specifying which fields to include in a partial response.
3000
+ # @param [String] quota_user
3001
+ # Available to use for quota purposes for server-side applications. Can be any
3002
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3003
+ # Overrides userIp if both are provided.
3004
+ # @param [String] user_ip
3005
+ # IP address of the site where the request originates. Use this if you want to
3006
+ # enforce per-user limits.
3007
+ # @param [Google::Apis::RequestOptions] options
3008
+ # Request-specific options
3009
+ #
3010
+ # @yield [result, err] Result & error if block supplied
3011
+ # @yieldparam result [NilClass] No result returned for this method
3012
+ # @yieldparam err [StandardError] error object if request failed
3013
+ #
3014
+ # @return [void]
3015
+ #
3016
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3017
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3018
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3019
+ def batch_delete_table_feature(id, batch_delete_features_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3020
+ path = 'tables/{id}/features/batchDelete'
3021
+ command = make_simple_command(:post, path, options)
3022
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeleteFeaturesRequest::Representation
3023
+ command.request_object = batch_delete_features_request_object
3024
+ command.params['id'] = id unless id.nil?
3025
+ command.query['fields'] = fields unless fields.nil?
3026
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3027
+ command.query['userIp'] = user_ip unless user_ip.nil?
3028
+ execute_or_queue_command(command, &block)
3029
+ end
3030
+
3031
+ # Append features to an existing table.
3032
+ # A single batchInsert request can create:
3033
+ # - Up to 50 features.
3034
+ # - A combined total of 10 000 vertices.
3035
+ # Feature limits are documented in the Supported data formats and limits article
3036
+ # of the Google Maps Engine help center. Note that free and paid accounts have
3037
+ # different limits.
3038
+ # For more information about inserting features, read Creating features in the
3039
+ # Google Maps Engine developer's guide.
3040
+ # @param [String] id
3041
+ # The ID of the table to append the features to.
3042
+ # @param [Google::Apis::MapsengineV1::BatchInsertFeaturesRequest] batch_insert_features_request_object
3043
+ # @param [String] fields
3044
+ # Selector specifying which fields to include in a partial response.
3045
+ # @param [String] quota_user
3046
+ # Available to use for quota purposes for server-side applications. Can be any
3047
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3048
+ # Overrides userIp if both are provided.
3049
+ # @param [String] user_ip
3050
+ # IP address of the site where the request originates. Use this if you want to
3051
+ # enforce per-user limits.
3052
+ # @param [Google::Apis::RequestOptions] options
3053
+ # Request-specific options
3054
+ #
3055
+ # @yield [result, err] Result & error if block supplied
3056
+ # @yieldparam result [NilClass] No result returned for this method
3057
+ # @yieldparam err [StandardError] error object if request failed
3058
+ #
3059
+ # @return [void]
3060
+ #
3061
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3062
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3063
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3064
+ def batch_insert_table_feature(id, batch_insert_features_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3065
+ path = 'tables/{id}/features/batchInsert'
3066
+ command = make_simple_command(:post, path, options)
3067
+ command.request_representation = Google::Apis::MapsengineV1::BatchInsertFeaturesRequest::Representation
3068
+ command.request_object = batch_insert_features_request_object
3069
+ command.params['id'] = id unless id.nil?
3070
+ command.query['fields'] = fields unless fields.nil?
3071
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3072
+ command.query['userIp'] = user_ip unless user_ip.nil?
3073
+ execute_or_queue_command(command, &block)
3074
+ end
3075
+
3076
+ # Update the supplied features.
3077
+ # A single batchPatch request can update:
3078
+ # - Up to 50 features.
3079
+ # - A combined total of 10 000 vertices.
3080
+ # Feature limits are documented in the Supported data formats and limits article
3081
+ # of the Google Maps Engine help center. Note that free and paid accounts have
3082
+ # different limits.
3083
+ # Feature updates use HTTP PATCH semantics:
3084
+ # - A supplied value replaces an existing value (if any) in that field.
3085
+ # - Omitted fields remain unchanged.
3086
+ # - Complex values in geometries and properties must be replaced as atomic units.
3087
+ # For example, providing just the coordinates of a geometry is not allowed; the
3088
+ # complete geometry, including type, must be supplied.
3089
+ # - Setting a property's value to null deletes that property.
3090
+ # For more information about updating features, read Updating features in the
3091
+ # Google Maps Engine developer's guide.
3092
+ # @param [String] id
3093
+ # The ID of the table containing the features to be patched.
3094
+ # @param [Google::Apis::MapsengineV1::BatchPatchFeaturesRequest] batch_patch_features_request_object
3095
+ # @param [String] fields
3096
+ # Selector specifying which fields to include in a partial response.
3097
+ # @param [String] quota_user
3098
+ # Available to use for quota purposes for server-side applications. Can be any
3099
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3100
+ # Overrides userIp if both are provided.
3101
+ # @param [String] user_ip
3102
+ # IP address of the site where the request originates. Use this if you want to
3103
+ # enforce per-user limits.
3104
+ # @param [Google::Apis::RequestOptions] options
3105
+ # Request-specific options
3106
+ #
3107
+ # @yield [result, err] Result & error if block supplied
3108
+ # @yieldparam result [NilClass] No result returned for this method
3109
+ # @yieldparam err [StandardError] error object if request failed
3110
+ #
3111
+ # @return [void]
3112
+ #
3113
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3114
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3115
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3116
+ def batch_patch_table_feature(id, batch_patch_features_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3117
+ path = 'tables/{id}/features/batchPatch'
3118
+ command = make_simple_command(:post, path, options)
3119
+ command.request_representation = Google::Apis::MapsengineV1::BatchPatchFeaturesRequest::Representation
3120
+ command.request_object = batch_patch_features_request_object
3121
+ command.params['id'] = id unless id.nil?
3122
+ command.query['fields'] = fields unless fields.nil?
3123
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3124
+ command.query['userIp'] = user_ip unless user_ip.nil?
3125
+ execute_or_queue_command(command, &block)
3126
+ end
3127
+
3128
+ # Return a single feature, given its ID.
3129
+ # @param [String] table_id
3130
+ # The ID of the table.
3131
+ # @param [String] id
3132
+ # The ID of the feature to get.
3133
+ # @param [String] select
3134
+ # A SQL-like projection clause used to specify returned properties. If this
3135
+ # parameter is not included, all properties are returned.
3136
+ # @param [String] version
3137
+ # The table version to access. See Accessing Public Data for information.
3138
+ # @param [String] fields
3139
+ # Selector specifying which fields to include in a partial response.
3140
+ # @param [String] quota_user
3141
+ # Available to use for quota purposes for server-side applications. Can be any
3142
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3143
+ # Overrides userIp if both are provided.
3144
+ # @param [String] user_ip
3145
+ # IP address of the site where the request originates. Use this if you want to
3146
+ # enforce per-user limits.
3147
+ # @param [Google::Apis::RequestOptions] options
3148
+ # Request-specific options
3149
+ #
3150
+ # @yield [result, err] Result & error if block supplied
3151
+ # @yieldparam result [Google::Apis::MapsengineV1::Feature] parsed result object
3152
+ # @yieldparam err [StandardError] error object if request failed
3153
+ #
3154
+ # @return [Google::Apis::MapsengineV1::Feature]
3155
+ #
3156
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3157
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3158
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3159
+ def get_table_feature(table_id, id, select: nil, version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3160
+ path = 'tables/{tableId}/features/{id}'
3161
+ command = make_simple_command(:get, path, options)
3162
+ command.response_representation = Google::Apis::MapsengineV1::Feature::Representation
3163
+ command.response_class = Google::Apis::MapsengineV1::Feature
3164
+ command.params['tableId'] = table_id unless table_id.nil?
3165
+ command.params['id'] = id unless id.nil?
3166
+ command.query['select'] = select unless select.nil?
3167
+ command.query['version'] = version unless version.nil?
3168
+ command.query['fields'] = fields unless fields.nil?
3169
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3170
+ command.query['userIp'] = user_ip unless user_ip.nil?
3171
+ execute_or_queue_command(command, &block)
3172
+ end
3173
+
3174
+ # Return all features readable by the current user.
3175
+ # @param [String] id
3176
+ # The ID of the table to which these features belong.
3177
+ # @param [String] include
3178
+ # A comma separated list of optional data to include. Optional data available:
3179
+ # schema.
3180
+ # @param [String] intersects
3181
+ # A geometry literal that specifies the spatial restriction of the query.
3182
+ # @param [Fixnum] limit
3183
+ # The total number of features to return from the query, irrespective of the
3184
+ # number of pages.
3185
+ # @param [Fixnum] max_results
3186
+ # The maximum number of items to include in the response, used for paging. The
3187
+ # maximum supported value is 1000.
3188
+ # @param [String] order_by
3189
+ # An SQL-like order by clause used to sort results. If this parameter is not
3190
+ # included, the order of features is undefined.
3191
+ # @param [String] page_token
3192
+ # The continuation token, used to page through large result sets. To get the
3193
+ # next page of results, set this parameter to the value of nextPageToken from
3194
+ # the previous response.
3195
+ # @param [String] select
3196
+ # A SQL-like projection clause used to specify returned properties. If this
3197
+ # parameter is not included, all properties are returned.
3198
+ # @param [String] version
3199
+ # The table version to access. See Accessing Public Data for information.
3200
+ # @param [String] where
3201
+ # An SQL-like predicate used to filter results.
3202
+ # @param [String] fields
3203
+ # Selector specifying which fields to include in a partial response.
3204
+ # @param [String] quota_user
3205
+ # Available to use for quota purposes for server-side applications. Can be any
3206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3207
+ # Overrides userIp if both are provided.
3208
+ # @param [String] user_ip
3209
+ # IP address of the site where the request originates. Use this if you want to
3210
+ # enforce per-user limits.
3211
+ # @param [Google::Apis::RequestOptions] options
3212
+ # Request-specific options
3213
+ #
3214
+ # @yield [result, err] Result & error if block supplied
3215
+ # @yieldparam result [Google::Apis::MapsengineV1::ListFeaturesResponse] parsed result object
3216
+ # @yieldparam err [StandardError] error object if request failed
3217
+ #
3218
+ # @return [Google::Apis::MapsengineV1::ListFeaturesResponse]
3219
+ #
3220
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3221
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3222
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3223
+ def list_table_features(id, include: nil, intersects: nil, limit: nil, max_results: nil, order_by: nil, page_token: nil, select: nil, version: nil, where: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3224
+ path = 'tables/{id}/features'
3225
+ command = make_simple_command(:get, path, options)
3226
+ command.response_representation = Google::Apis::MapsengineV1::ListFeaturesResponse::Representation
3227
+ command.response_class = Google::Apis::MapsengineV1::ListFeaturesResponse
3228
+ command.params['id'] = id unless id.nil?
3229
+ command.query['include'] = include unless include.nil?
3230
+ command.query['intersects'] = intersects unless intersects.nil?
3231
+ command.query['limit'] = limit unless limit.nil?
3232
+ command.query['maxResults'] = max_results unless max_results.nil?
3233
+ command.query['orderBy'] = order_by unless order_by.nil?
3234
+ command.query['pageToken'] = page_token unless page_token.nil?
3235
+ command.query['select'] = select unless select.nil?
3236
+ command.query['version'] = version unless version.nil?
3237
+ command.query['where'] = where unless where.nil?
3238
+ command.query['fields'] = fields unless fields.nil?
3239
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3240
+ command.query['userIp'] = user_ip unless user_ip.nil?
3241
+ execute_or_queue_command(command, &block)
3242
+ end
3243
+
3244
+ # Upload a file to a placeholder table asset. See Table Upload in the Developer'
3245
+ # s Guide for more information.
3246
+ # Supported file types are listed in the Supported data formats and limits
3247
+ # article of the Google Maps Engine help center.
3248
+ # @param [String] id
3249
+ # The ID of the table asset.
3250
+ # @param [String] filename
3251
+ # The file name of this uploaded file.
3252
+ # @param [String] fields
3253
+ # Selector specifying which fields to include in a partial response.
3254
+ # @param [String] quota_user
3255
+ # Available to use for quota purposes for server-side applications. Can be any
3256
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3257
+ # Overrides userIp if both are provided.
3258
+ # @param [String] user_ip
3259
+ # IP address of the site where the request originates. Use this if you want to
3260
+ # enforce per-user limits.
3261
+ # @param [IO, String] upload_source
3262
+ # IO stream or filename containing content to upload
3263
+ # @param [String] content_type
3264
+ # Content type of the uploaded content.
3265
+ # @param [Google::Apis::RequestOptions] options
3266
+ # Request-specific options
3267
+ #
3268
+ # @yield [result, err] Result & error if block supplied
3269
+ # @yieldparam result [NilClass] No result returned for this method
3270
+ # @yieldparam err [StandardError] error object if request failed
3271
+ #
3272
+ # @return [void]
3273
+ #
3274
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3275
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3276
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3277
+ def insert_table_file(id, filename: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
3278
+ path = 'tables/{id}/files'
3279
+ if upload_source.nil?
3280
+ command = make_simple_command(:post, path, options)
3281
+ else
3282
+ command = make_upload_command(:post, path, options)
3283
+ command.upload_source = upload_source
3284
+ command.upload_content_type = content_type
3285
+ end
3286
+ command.params['id'] = id unless id.nil?
3287
+ command.query['filename'] = filename unless filename.nil?
3288
+ command.query['fields'] = fields unless fields.nil?
3289
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3290
+ command.query['userIp'] = user_ip unless user_ip.nil?
3291
+ execute_or_queue_command(command, &block)
3292
+ end
3293
+
3294
+ # Return all parent ids of the specified table.
3295
+ # @param [String] id
3296
+ # The ID of the table whose parents will be listed.
3297
+ # @param [Fixnum] max_results
3298
+ # The maximum number of items to include in a single response page. The maximum
3299
+ # supported value is 50.
3300
+ # @param [String] page_token
3301
+ # The continuation token, used to page through large result sets. To get the
3302
+ # next page of results, set this parameter to the value of nextPageToken from
3303
+ # the previous response.
3304
+ # @param [String] fields
3305
+ # Selector specifying which fields to include in a partial response.
3306
+ # @param [String] quota_user
3307
+ # Available to use for quota purposes for server-side applications. Can be any
3308
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3309
+ # Overrides userIp if both are provided.
3310
+ # @param [String] user_ip
3311
+ # IP address of the site where the request originates. Use this if you want to
3312
+ # enforce per-user limits.
3313
+ # @param [Google::Apis::RequestOptions] options
3314
+ # Request-specific options
3315
+ #
3316
+ # @yield [result, err] Result & error if block supplied
3317
+ # @yieldparam result [Google::Apis::MapsengineV1::ListParentsResponse] parsed result object
3318
+ # @yieldparam err [StandardError] error object if request failed
3319
+ #
3320
+ # @return [Google::Apis::MapsengineV1::ListParentsResponse]
3321
+ #
3322
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3323
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3324
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3325
+ def list_table_parents(id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3326
+ path = 'tables/{id}/parents'
3327
+ command = make_simple_command(:get, path, options)
3328
+ command.response_representation = Google::Apis::MapsengineV1::ListParentsResponse::Representation
3329
+ command.response_class = Google::Apis::MapsengineV1::ListParentsResponse
3330
+ command.params['id'] = id unless id.nil?
3331
+ command.query['maxResults'] = max_results unless max_results.nil?
3332
+ command.query['pageToken'] = page_token unless page_token.nil?
3333
+ command.query['fields'] = fields unless fields.nil?
3334
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3335
+ command.query['userIp'] = user_ip unless user_ip.nil?
3336
+ execute_or_queue_command(command, &block)
3337
+ end
3338
+
3339
+ # Remove permission entries from an already existing asset.
3340
+ # @param [String] id
3341
+ # The ID of the asset from which permissions will be removed.
3342
+ # @param [Google::Apis::MapsengineV1::BatchDeletePermissionsRequest] batch_delete_permissions_request_object
3343
+ # @param [String] fields
3344
+ # Selector specifying which fields to include in a partial response.
3345
+ # @param [String] quota_user
3346
+ # Available to use for quota purposes for server-side applications. Can be any
3347
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3348
+ # Overrides userIp if both are provided.
3349
+ # @param [String] user_ip
3350
+ # IP address of the site where the request originates. Use this if you want to
3351
+ # enforce per-user limits.
3352
+ # @param [Google::Apis::RequestOptions] options
3353
+ # Request-specific options
3354
+ #
3355
+ # @yield [result, err] Result & error if block supplied
3356
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse] parsed result object
3357
+ # @yieldparam err [StandardError] error object if request failed
3358
+ #
3359
+ # @return [Google::Apis::MapsengineV1::BatchDeletePermissionsResponse]
3360
+ #
3361
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3362
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3363
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3364
+ def batch_delete_table_permission(id, batch_delete_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3365
+ path = 'tables/{id}/permissions/batchDelete'
3366
+ command = make_simple_command(:post, path, options)
3367
+ command.request_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsRequest::Representation
3368
+ command.request_object = batch_delete_permissions_request_object
3369
+ command.response_representation = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse::Representation
3370
+ command.response_class = Google::Apis::MapsengineV1::BatchDeletePermissionsResponse
3371
+ command.params['id'] = id unless id.nil?
3372
+ command.query['fields'] = fields unless fields.nil?
3373
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3374
+ command.query['userIp'] = user_ip unless user_ip.nil?
3375
+ execute_or_queue_command(command, &block)
3376
+ end
3377
+
3378
+ # Add or update permission entries to an already existing asset.
3379
+ # An asset can hold up to 20 different permission entries. Each batchInsert
3380
+ # request is atomic.
3381
+ # @param [String] id
3382
+ # The ID of the asset to which permissions will be added.
3383
+ # @param [Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest] batch_update_permissions_request_object
3384
+ # @param [String] fields
3385
+ # Selector specifying which fields to include in a partial response.
3386
+ # @param [String] quota_user
3387
+ # Available to use for quota purposes for server-side applications. Can be any
3388
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3389
+ # Overrides userIp if both are provided.
3390
+ # @param [String] user_ip
3391
+ # IP address of the site where the request originates. Use this if you want to
3392
+ # enforce per-user limits.
3393
+ # @param [Google::Apis::RequestOptions] options
3394
+ # Request-specific options
3395
+ #
3396
+ # @yield [result, err] Result & error if block supplied
3397
+ # @yieldparam result [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse] parsed result object
3398
+ # @yieldparam err [StandardError] error object if request failed
3399
+ #
3400
+ # @return [Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse]
3401
+ #
3402
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3403
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3404
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3405
+ def batch_update_table_permission(id, batch_update_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3406
+ path = 'tables/{id}/permissions/batchUpdate'
3407
+ command = make_simple_command(:post, path, options)
3408
+ command.request_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsRequest::Representation
3409
+ command.request_object = batch_update_permissions_request_object
3410
+ command.response_representation = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse::Representation
3411
+ command.response_class = Google::Apis::MapsengineV1::BatchUpdatePermissionsResponse
3412
+ command.params['id'] = id unless id.nil?
3413
+ command.query['fields'] = fields unless fields.nil?
3414
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3415
+ command.query['userIp'] = user_ip unless user_ip.nil?
3416
+ execute_or_queue_command(command, &block)
3417
+ end
3418
+
3419
+ # Return all of the permissions for the specified asset.
3420
+ # @param [String] id
3421
+ # The ID of the asset whose permissions will be listed.
3422
+ # @param [String] fields
3423
+ # Selector specifying which fields to include in a partial response.
3424
+ # @param [String] quota_user
3425
+ # Available to use for quota purposes for server-side applications. Can be any
3426
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3427
+ # Overrides userIp if both are provided.
3428
+ # @param [String] user_ip
3429
+ # IP address of the site where the request originates. Use this if you want to
3430
+ # enforce per-user limits.
3431
+ # @param [Google::Apis::RequestOptions] options
3432
+ # Request-specific options
3433
+ #
3434
+ # @yield [result, err] Result & error if block supplied
3435
+ # @yieldparam result [Google::Apis::MapsengineV1::ListPermissionsResponse] parsed result object
3436
+ # @yieldparam err [StandardError] error object if request failed
3437
+ #
3438
+ # @return [Google::Apis::MapsengineV1::ListPermissionsResponse]
3439
+ #
3440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3443
+ def list_table_permissions(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
3444
+ path = 'tables/{id}/permissions'
3445
+ command = make_simple_command(:get, path, options)
3446
+ command.response_representation = Google::Apis::MapsengineV1::ListPermissionsResponse::Representation
3447
+ command.response_class = Google::Apis::MapsengineV1::ListPermissionsResponse
3448
+ command.params['id'] = id unless id.nil?
3449
+ command.query['fields'] = fields unless fields.nil?
3450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3451
+ command.query['userIp'] = user_ip unless user_ip.nil?
3452
+ execute_or_queue_command(command, &block)
3453
+ end
3454
+
3455
+ protected
3456
+
3457
+ def apply_command_defaults(command)
3458
+ command.query['key'] = key unless key.nil?
3459
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3460
+ command.query['userIp'] = user_ip unless user_ip.nil?
3461
+ end
3462
+ end
3463
+ end
3464
+ end
3465
+ end