google-api-client 0.8.7 → 0.9.pre1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (397) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +20 -0
  3. data/.rspec +2 -0
  4. data/.rubocop.yml +7 -0
  5. data/.rubocop_todo.yml +63 -0
  6. data/.travis.yml +21 -0
  7. data/.yardopts +12 -0
  8. data/CHANGELOG.md +6 -3
  9. data/CONTRIBUTING.md +31 -0
  10. data/Gemfile +28 -2
  11. data/MIGRATING.md +171 -0
  12. data/README.md +158 -150
  13. data/Rakefile +1 -40
  14. data/api_names.yaml +872 -0
  15. data/api_names_out.yaml +20843 -0
  16. data/bin/generate-api +93 -0
  17. data/generated/google/apis/adexchangebuyer_v1_3.rb +35 -0
  18. data/generated/google/apis/adexchangebuyer_v1_3/classes.rb +1124 -0
  19. data/generated/google/apis/adexchangebuyer_v1_3/representations.rb +375 -0
  20. data/generated/google/apis/adexchangebuyer_v1_3/service.rb +893 -0
  21. data/generated/google/apis/adexchangeseller_v2_0.rb +38 -0
  22. data/generated/google/apis/adexchangeseller_v2_0/classes.rb +792 -0
  23. data/generated/google/apis/adexchangeseller_v2_0/representations.rb +309 -0
  24. data/generated/google/apis/adexchangeseller_v2_0/service.rb +682 -0
  25. data/generated/google/apis/admin_directory_v1.rb +89 -0
  26. data/generated/google/apis/admin_directory_v1/classes.rb +2389 -0
  27. data/generated/google/apis/admin_directory_v1/representations.rb +780 -0
  28. data/generated/google/apis/admin_directory_v1/service.rb +2805 -0
  29. data/generated/google/apis/admin_reports_v1.rb +38 -0
  30. data/generated/google/apis/admin_reports_v1/classes.rb +582 -0
  31. data/generated/google/apis/admin_reports_v1/representations.rb +231 -0
  32. data/generated/google/apis/admin_reports_v1/service.rb +341 -0
  33. data/generated/google/apis/adsense_v1_4.rb +38 -0
  34. data/generated/google/apis/adsense_v1_4/classes.rb +1279 -0
  35. data/generated/google/apis/adsense_v1_4/representations.rb +493 -0
  36. data/generated/google/apis/adsense_v1_4/service.rb +1752 -0
  37. data/generated/google/apis/adsensehost_v4_1.rb +35 -0
  38. data/generated/google/apis/adsensehost_v4_1/classes.rb +834 -0
  39. data/generated/google/apis/adsensehost_v4_1/representations.rb +327 -0
  40. data/generated/google/apis/adsensehost_v4_1/service.rb +1190 -0
  41. data/generated/google/apis/analytics_v3.rb +49 -0
  42. data/generated/google/apis/analytics_v3/classes.rb +5113 -0
  43. data/generated/google/apis/analytics_v3/representations.rb +1661 -0
  44. data/generated/google/apis/analytics_v3/service.rb +3600 -0
  45. data/generated/google/apis/androidenterprise_v1.rb +34 -0
  46. data/generated/google/apis/androidenterprise_v1/classes.rb +1162 -0
  47. data/generated/google/apis/androidenterprise_v1/representations.rb +431 -0
  48. data/generated/google/apis/androidenterprise_v1/service.rb +1979 -0
  49. data/generated/google/apis/androidpublisher_v2.rb +34 -0
  50. data/generated/google/apis/androidpublisher_v2/classes.rb +1374 -0
  51. data/generated/google/apis/androidpublisher_v2/representations.rb +630 -0
  52. data/generated/google/apis/androidpublisher_v2/service.rb +2390 -0
  53. data/generated/google/apis/appsactivity_v1.rb +46 -0
  54. data/generated/google/apis/appsactivity_v1/classes.rb +392 -0
  55. data/generated/google/apis/appsactivity_v1/representations.rb +184 -0
  56. data/generated/google/apis/appsactivity_v1/service.rb +129 -0
  57. data/generated/google/apis/appstate_v1.rb +34 -0
  58. data/generated/google/apis/appstate_v1/classes.rb +154 -0
  59. data/generated/google/apis/appstate_v1/representations.rb +79 -0
  60. data/generated/google/apis/appstate_v1/service.rb +265 -0
  61. data/generated/google/apis/autoscaler_v1beta2.rb +38 -0
  62. data/generated/google/apis/autoscaler_v1beta2/classes.rb +747 -0
  63. data/generated/google/apis/autoscaler_v1beta2/representations.rb +281 -0
  64. data/generated/google/apis/autoscaler_v1beta2/service.rb +488 -0
  65. data/generated/google/apis/bigquery_v2.rb +49 -0
  66. data/generated/google/apis/bigquery_v2/classes.rb +2255 -0
  67. data/generated/google/apis/bigquery_v2/representations.rb +754 -0
  68. data/generated/google/apis/bigquery_v2/service.rb +1003 -0
  69. data/generated/google/apis/blogger_v3.rb +37 -0
  70. data/generated/google/apis/blogger_v3/classes.rb +1354 -0
  71. data/generated/google/apis/blogger_v3/representations.rb +562 -0
  72. data/generated/google/apis/blogger_v3/service.rb +1620 -0
  73. data/generated/google/apis/books_v1.rb +34 -0
  74. data/generated/google/apis/books_v1/classes.rb +3515 -0
  75. data/generated/google/apis/books_v1/representations.rb +1361 -0
  76. data/generated/google/apis/books_v1/service.rb +2170 -0
  77. data/generated/google/apis/calendar_v3.rb +37 -0
  78. data/generated/google/apis/calendar_v3/classes.rb +1702 -0
  79. data/generated/google/apis/calendar_v3/representations.rb +566 -0
  80. data/generated/google/apis/calendar_v3/service.rb +1943 -0
  81. data/generated/google/apis/civicinfo_v2.rb +31 -0
  82. data/generated/google/apis/civicinfo_v2/classes.rb +1057 -0
  83. data/generated/google/apis/civicinfo_v2/representations.rb +374 -0
  84. data/generated/google/apis/civicinfo_v2/service.rb +284 -0
  85. data/generated/google/apis/cloudmonitoring_v2beta2.rb +34 -0
  86. data/generated/google/apis/cloudmonitoring_v2beta2/classes.rb +679 -0
  87. data/generated/google/apis/cloudmonitoring_v2beta2/representations.rb +311 -0
  88. data/generated/google/apis/cloudmonitoring_v2beta2/service.rb +458 -0
  89. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +38 -0
  90. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +139 -0
  91. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +65 -0
  92. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +301 -0
  93. data/generated/google/apis/compute_v1.rb +49 -0
  94. data/generated/google/apis/compute_v1/classes.rb +6391 -0
  95. data/generated/google/apis/compute_v1/representations.rb +2209 -0
  96. data/generated/google/apis/compute_v1/service.rb +6352 -0
  97. data/generated/google/apis/container_v1beta1.rb +35 -0
  98. data/generated/google/apis/container_v1beta1/classes.rb +466 -0
  99. data/generated/google/apis/container_v1beta1/representations.rb +177 -0
  100. data/generated/google/apis/container_v1beta1/service.rb +394 -0
  101. data/generated/google/apis/content_v2.rb +35 -0
  102. data/generated/google/apis/content_v2/classes.rb +3780 -0
  103. data/generated/google/apis/content_v2/representations.rb +1456 -0
  104. data/generated/google/apis/content_v2/service.rb +1706 -0
  105. data/generated/google/apis/coordinate_v1.rb +37 -0
  106. data/generated/google/apis/coordinate_v1/classes.rb +669 -0
  107. data/generated/google/apis/coordinate_v1/representations.rb +285 -0
  108. data/generated/google/apis/coordinate_v1/service.rb +687 -0
  109. data/{lib/google/api_client/auth/compute_service_account.rb → generated/google/apis/customsearch_v1.rb} +13 -10
  110. data/generated/google/apis/customsearch_v1/classes.rb +771 -0
  111. data/generated/google/apis/customsearch_v1/representations.rb +276 -0
  112. data/generated/google/apis/customsearch_v1/service.rb +208 -0
  113. data/generated/google/apis/datastore_v1beta2.rb +40 -0
  114. data/generated/google/apis/datastore_v1beta2/classes.rb +1186 -0
  115. data/generated/google/apis/datastore_v1beta2/representations.rb +526 -0
  116. data/generated/google/apis/datastore_v1beta2/service.rb +300 -0
  117. data/generated/google/apis/deploymentmanager_v2beta2.rb +41 -0
  118. data/generated/google/apis/deploymentmanager_v2beta2/classes.rb +820 -0
  119. data/generated/google/apis/deploymentmanager_v2beta2/representations.rb +303 -0
  120. data/generated/google/apis/deploymentmanager_v2beta2/service.rb +647 -0
  121. data/generated/google/apis/dfareporting_v2_1.rb +37 -0
  122. data/generated/google/apis/dfareporting_v2_1/classes.rb +10755 -0
  123. data/generated/google/apis/dfareporting_v2_1/representations.rb +3438 -0
  124. data/generated/google/apis/dfareporting_v2_1/service.rb +8775 -0
  125. data/generated/google/apis/discovery_v1.rb +32 -0
  126. data/generated/google/apis/discovery_v1/classes.rb +947 -0
  127. data/generated/google/apis/discovery_v1/representations.rb +355 -0
  128. data/generated/google/apis/discovery_v1/service.rb +144 -0
  129. data/generated/google/apis/dns_v1.rb +41 -0
  130. data/generated/google/apis/dns_v1/classes.rb +406 -0
  131. data/generated/google/apis/dns_v1/representations.rb +151 -0
  132. data/generated/google/apis/dns_v1/service.rb +460 -0
  133. data/{spec/google/api_client/request_spec.rb → generated/google/apis/doubleclickbidmanager_v1.rb} +15 -13
  134. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +709 -0
  135. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +297 -0
  136. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +349 -0
  137. data/generated/google/apis/doubleclicksearch_v2.rb +35 -0
  138. data/generated/google/apis/doubleclicksearch_v2/classes.rb +947 -0
  139. data/generated/google/apis/doubleclicksearch_v2/representations.rb +315 -0
  140. data/generated/google/apis/doubleclicksearch_v2/service.rb +490 -0
  141. data/generated/google/apis/drive_v2.rb +55 -0
  142. data/generated/google/apis/drive_v2/classes.rb +2519 -0
  143. data/generated/google/apis/drive_v2/representations.rb +781 -0
  144. data/generated/google/apis/drive_v2/service.rb +2685 -0
  145. data/generated/google/apis/fitness_v1.rb +49 -0
  146. data/generated/google/apis/fitness_v1/classes.rb +809 -0
  147. data/generated/google/apis/fitness_v1/representations.rb +295 -0
  148. data/generated/google/apis/fitness_v1/service.rb +684 -0
  149. data/generated/google/apis/fusiontables_v2.rb +37 -0
  150. data/generated/google/apis/fusiontables_v2/classes.rb +1048 -0
  151. data/generated/google/apis/fusiontables_v2/representations.rb +409 -0
  152. data/generated/google/apis/fusiontables_v2/service.rb +1496 -0
  153. data/generated/google/apis/games_configuration_v1configuration.rb +34 -0
  154. data/generated/google/apis/games_configuration_v1configuration/classes.rb +506 -0
  155. data/generated/google/apis/games_configuration_v1configuration/representations.rb +206 -0
  156. data/generated/google/apis/games_configuration_v1configuration/service.rb +578 -0
  157. data/generated/google/apis/games_v1.rb +40 -0
  158. data/generated/google/apis/games_v1/classes.rb +4578 -0
  159. data/generated/google/apis/games_v1/representations.rb +1570 -0
  160. data/generated/google/apis/games_v1/service.rb +2306 -0
  161. data/generated/google/apis/gan_v1beta1.rb +31 -0
  162. data/generated/google/apis/gan_v1beta1/classes.rb +1428 -0
  163. data/generated/google/apis/gan_v1beta1/representations.rb +428 -0
  164. data/generated/google/apis/gan_v1beta1/service.rb +692 -0
  165. data/generated/google/apis/genomics_v1beta2.rb +46 -0
  166. data/generated/google/apis/genomics_v1beta2/classes.rb +3288 -0
  167. data/generated/google/apis/genomics_v1beta2/representations.rb +1194 -0
  168. data/generated/google/apis/genomics_v1beta2/service.rb +2356 -0
  169. data/generated/google/apis/gmail_v1.rb +49 -0
  170. data/generated/google/apis/gmail_v1/classes.rb +794 -0
  171. data/generated/google/apis/gmail_v1/representations.rb +339 -0
  172. data/generated/google/apis/gmail_v1/service.rb +1502 -0
  173. data/generated/google/apis/groupsmigration_v1.rb +34 -0
  174. data/generated/google/apis/groupsmigration_v1/classes.rb +51 -0
  175. data/generated/google/apis/groupsmigration_v1/representations.rb +38 -0
  176. data/generated/google/apis/groupsmigration_v1/service.rb +111 -0
  177. data/generated/google/apis/groupssettings_v1.rb +34 -0
  178. data/generated/google/apis/groupssettings_v1/classes.rb +221 -0
  179. data/generated/google/apis/groupssettings_v1/representations.rb +64 -0
  180. data/generated/google/apis/groupssettings_v1/service.rb +179 -0
  181. data/generated/google/apis/identitytoolkit_v3.rb +31 -0
  182. data/generated/google/apis/identitytoolkit_v3/classes.rb +1229 -0
  183. data/generated/google/apis/identitytoolkit_v3/representations.rb +422 -0
  184. data/generated/google/apis/identitytoolkit_v3/service.rb +491 -0
  185. data/generated/google/apis/licensing_v1.rb +34 -0
  186. data/generated/google/apis/licensing_v1/classes.rb +132 -0
  187. data/generated/google/apis/licensing_v1/representations.rb +68 -0
  188. data/generated/google/apis/licensing_v1/service.rb +376 -0
  189. data/generated/google/apis/logging_v1beta3.rb +35 -0
  190. data/generated/google/apis/logging_v1beta3/classes.rb +505 -0
  191. data/generated/google/apis/logging_v1beta3/representations.rb +222 -0
  192. data/generated/google/apis/logging_v1beta3/service.rb +670 -0
  193. data/generated/google/apis/manager_v1beta2.rb +50 -0
  194. data/generated/google/apis/manager_v1beta2/classes.rb +1287 -0
  195. data/generated/google/apis/manager_v1beta2/representations.rb +536 -0
  196. data/generated/google/apis/manager_v1beta2/service.rb +380 -0
  197. data/generated/google/apis/mapsengine_v1.rb +38 -0
  198. data/generated/google/apis/mapsengine_v1/classes.rb +2873 -0
  199. data/generated/google/apis/mapsengine_v1/representations.rb +1235 -0
  200. data/generated/google/apis/mapsengine_v1/service.rb +3465 -0
  201. data/generated/google/apis/mirror_v1.rb +37 -0
  202. data/generated/google/apis/mirror_v1/classes.rb +1072 -0
  203. data/generated/google/apis/mirror_v1/representations.rb +350 -0
  204. data/generated/google/apis/mirror_v1/service.rb +1001 -0
  205. data/generated/google/apis/oauth2_v2.rb +43 -0
  206. data/generated/google/apis/oauth2_v2/classes.rb +245 -0
  207. data/generated/google/apis/oauth2_v2/representations.rb +94 -0
  208. data/generated/google/apis/oauth2_v2/service.rb +203 -0
  209. data/generated/google/apis/pagespeedonline_v2.rb +32 -0
  210. data/generated/google/apis/pagespeedonline_v2/classes.rb +614 -0
  211. data/generated/google/apis/pagespeedonline_v2/representations.rb +244 -0
  212. data/generated/google/apis/pagespeedonline_v2/service.rb +120 -0
  213. data/generated/google/apis/plus_domains_v1.rb +61 -0
  214. data/generated/google/apis/plus_domains_v1/classes.rb +2402 -0
  215. data/generated/google/apis/plus_domains_v1/representations.rb +873 -0
  216. data/generated/google/apis/plus_domains_v1/service.rb +924 -0
  217. data/generated/google/apis/plus_v1.rb +43 -0
  218. data/generated/google/apis/plus_v1/classes.rb +2384 -0
  219. data/generated/google/apis/plus_v1/representations.rb +812 -0
  220. data/generated/google/apis/plus_v1/service.rb +616 -0
  221. data/generated/google/apis/prediction_v1_6.rb +44 -0
  222. data/generated/google/apis/prediction_v1_6/classes.rb +751 -0
  223. data/generated/google/apis/prediction_v1_6/representations.rb +327 -0
  224. data/generated/google/apis/prediction_v1_6/service.rb +388 -0
  225. data/generated/google/apis/pubsub_v1beta2.rb +37 -0
  226. data/generated/google/apis/pubsub_v1beta2/classes.rb +824 -0
  227. data/generated/google/apis/pubsub_v1beta2/representations.rb +366 -0
  228. data/generated/google/apis/pubsub_v1beta2/service.rb +778 -0
  229. data/generated/google/apis/qpx_express_v1.rb +31 -0
  230. data/generated/google/apis/qpx_express_v1/classes.rb +1268 -0
  231. data/generated/google/apis/qpx_express_v1/representations.rb +424 -0
  232. data/generated/google/apis/qpx_express_v1/service.rb +101 -0
  233. data/generated/google/apis/replicapool_v1beta2.rb +41 -0
  234. data/generated/google/apis/replicapool_v1beta2/classes.rb +621 -0
  235. data/generated/google/apis/replicapool_v1beta2/representations.rb +235 -0
  236. data/generated/google/apis/replicapool_v1beta2/service.rb +620 -0
  237. data/generated/google/apis/replicapoolupdater_v1beta1.rb +41 -0
  238. data/generated/google/apis/replicapoolupdater_v1beta1/classes.rb +682 -0
  239. data/generated/google/apis/replicapoolupdater_v1beta1/representations.rb +247 -0
  240. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +472 -0
  241. data/generated/google/apis/reseller_v1.rb +37 -0
  242. data/generated/google/apis/reseller_v1/classes.rb +502 -0
  243. data/generated/google/apis/reseller_v1/representations.rb +199 -0
  244. data/generated/google/apis/reseller_v1/service.rb +637 -0
  245. data/generated/google/apis/resourceviews_v1beta2.rb +47 -0
  246. data/generated/google/apis/resourceviews_v1beta2/classes.rb +660 -0
  247. data/generated/google/apis/resourceviews_v1beta2/representations.rb +269 -0
  248. data/generated/google/apis/resourceviews_v1beta2/service.rb +574 -0
  249. data/generated/google/apis/site_verification_v1.rb +37 -0
  250. data/generated/google/apis/site_verification_v1/classes.rb +185 -0
  251. data/generated/google/apis/site_verification_v1/representations.rb +101 -0
  252. data/generated/google/apis/site_verification_v1/service.rb +322 -0
  253. data/generated/google/apis/sqladmin_v1beta4.rb +37 -0
  254. data/generated/google/apis/sqladmin_v1beta4/classes.rb +1817 -0
  255. data/generated/google/apis/sqladmin_v1beta4/representations.rb +688 -0
  256. data/generated/google/apis/sqladmin_v1beta4/service.rb +1534 -0
  257. data/generated/google/apis/storage_v1.rb +43 -0
  258. data/generated/google/apis/storage_v1/classes.rb +1177 -0
  259. data/generated/google/apis/storage_v1/representations.rb +427 -0
  260. data/generated/google/apis/storage_v1/service.rb +1920 -0
  261. data/generated/google/apis/tagmanager_v1.rb +52 -0
  262. data/generated/google/apis/tagmanager_v1/classes.rb +1226 -0
  263. data/generated/google/apis/tagmanager_v1/representations.rb +461 -0
  264. data/generated/google/apis/tagmanager_v1/service.rb +1978 -0
  265. data/generated/google/apis/taskqueue_v1beta2.rb +37 -0
  266. data/generated/google/apis/taskqueue_v1beta2/classes.rb +254 -0
  267. data/generated/google/apis/taskqueue_v1beta2/representations.rb +114 -0
  268. data/generated/google/apis/taskqueue_v1beta2/service.rb +416 -0
  269. data/generated/google/apis/tasks_v1.rb +37 -0
  270. data/generated/google/apis/tasks_v1/classes.rb +296 -0
  271. data/generated/google/apis/tasks_v1/representations.rb +115 -0
  272. data/generated/google/apis/tasks_v1/service.rb +657 -0
  273. data/generated/google/apis/translate_v2.rb +31 -0
  274. data/generated/google/apis/translate_v2/classes.rb +168 -0
  275. data/generated/google/apis/translate_v2/representations.rb +109 -0
  276. data/generated/google/apis/translate_v2/service.rb +185 -0
  277. data/generated/google/apis/urlshortener_v1.rb +34 -0
  278. data/generated/google/apis/urlshortener_v1/classes.rb +246 -0
  279. data/generated/google/apis/urlshortener_v1/representations.rb +111 -0
  280. data/generated/google/apis/urlshortener_v1/service.rb +179 -0
  281. data/generated/google/apis/webmasters_v3.rb +37 -0
  282. data/generated/google/apis/webmasters_v3/classes.rb +563 -0
  283. data/generated/google/apis/webmasters_v3/representations.rb +250 -0
  284. data/generated/google/apis/webmasters_v3/service.rb +587 -0
  285. data/generated/google/apis/youtube_analytics_v1.rb +46 -0
  286. data/generated/google/apis/youtube_analytics_v1/classes.rb +540 -0
  287. data/generated/google/apis/youtube_analytics_v1/representations.rb +242 -0
  288. data/generated/google/apis/youtube_analytics_v1/service.rb +567 -0
  289. data/generated/google/apis/youtube_v3.rb +49 -0
  290. data/generated/google/apis/youtube_v3/classes.rb +7225 -0
  291. data/generated/google/apis/youtube_v3/representations.rb +2529 -0
  292. data/generated/google/apis/youtube_v3/service.rb +4051 -0
  293. data/google-api-client.gemspec +27 -39
  294. data/lib/google/api_client/auth/storage.rb +3 -2
  295. data/lib/google/api_client/auth/storages/file_store.rb +1 -3
  296. data/lib/google/api_client/auth/storages/redis_store.rb +6 -2
  297. data/lib/google/apis.rb +48 -0
  298. data/lib/google/apis/core/api_command.rb +128 -0
  299. data/lib/google/apis/core/base_service.rb +314 -0
  300. data/lib/google/apis/core/batch.rb +222 -0
  301. data/lib/google/apis/core/download.rb +94 -0
  302. data/lib/google/apis/core/hashable.rb +44 -0
  303. data/lib/google/apis/core/http_command.rb +275 -0
  304. data/lib/google/apis/core/json_representation.rb +122 -0
  305. data/lib/google/{api_client/version.rb → apis/core/logging.rb} +12 -8
  306. data/lib/google/apis/core/multipart.rb +173 -0
  307. data/lib/google/apis/core/upload.rb +275 -0
  308. data/lib/google/{api_client → apis}/errors.rb +32 -28
  309. data/lib/google/apis/generator.rb +70 -0
  310. data/lib/google/apis/generator/annotator.rb +271 -0
  311. data/lib/google/apis/generator/helpers.rb +74 -0
  312. data/lib/google/apis/generator/model.rb +130 -0
  313. data/lib/google/apis/generator/template.rb +124 -0
  314. data/lib/google/apis/generator/templates/_class.tmpl +40 -0
  315. data/lib/google/apis/generator/templates/_method.tmpl +90 -0
  316. data/lib/google/apis/generator/templates/_representation.tmpl +51 -0
  317. data/lib/google/apis/generator/templates/_representation_stub.tmpl +15 -0
  318. data/lib/google/apis/generator/templates/_representation_type.tmpl +10 -0
  319. data/lib/google/{api_client/reference.rb → apis/generator/templates/classes.rb.tmpl} +11 -9
  320. data/lib/google/apis/generator/templates/module.rb.tmpl +40 -0
  321. data/lib/google/apis/generator/templates/representations.rb.tmpl +32 -0
  322. data/lib/google/apis/generator/templates/service.rb.tmpl +60 -0
  323. data/lib/google/apis/options.rb +79 -0
  324. data/lib/google/apis/version.rb +39 -0
  325. data/rakelib/metrics.rake +22 -0
  326. data/rakelib/rubocop.rake +10 -0
  327. data/rakelib/spec.rake +11 -0
  328. data/rakelib/yard.rake +11 -0
  329. data/samples/calendar/calendar.rb +43 -0
  330. data/samples/drive/drive.rb +40 -0
  331. data/samples/pubsub/pubsub.rb +52 -0
  332. data/{lib/google/api_client/discovery.rb → samples/translate/translate.rb} +14 -5
  333. data/script/generate +79 -0
  334. data/script/package +8 -0
  335. data/script/release +15 -0
  336. data/spec/fixtures/files/api_names.yaml +3 -0
  337. data/spec/fixtures/files/auth_stored_credentials.json +8 -0
  338. data/spec/fixtures/files/client_secrets.json +1 -0
  339. data/spec/fixtures/files/test.blah +1 -0
  340. data/spec/fixtures/files/test.txt +1 -0
  341. data/spec/fixtures/files/test_api.json +440 -0
  342. data/spec/google/api_client/auth/storage_spec.rb +1 -3
  343. data/spec/google/api_client/auth/storages/file_store_spec.rb +1 -2
  344. data/spec/google/api_client/auth/storages/redis_store_spec.rb +1 -3
  345. data/spec/google/apis/core/api_command_spec.rb +170 -0
  346. data/spec/google/apis/core/batch_spec.rb +128 -0
  347. data/spec/google/apis/core/download_spec.rb +90 -0
  348. data/spec/google/apis/core/hashable_spec.rb +60 -0
  349. data/spec/google/apis/core/http_command_spec.rb +238 -0
  350. data/spec/google/apis/core/json_representation_spec.rb +192 -0
  351. data/spec/google/apis/core/service_spec.rb +247 -0
  352. data/spec/google/apis/core/upload_spec.rb +238 -0
  353. data/{lib/google/api_client/service_account.rb → spec/google/apis/generated_spec.rb} +14 -8
  354. data/spec/google/apis/generator/generator_spec.rb +272 -0
  355. data/spec/google/apis/logging_spec.rb +45 -0
  356. data/spec/google/apis/options_spec.rb +40 -0
  357. data/spec/integration_tests/drive_spec.rb +35 -0
  358. data/spec/integration_tests/pubsub_spec.rb +48 -0
  359. data/spec/integration_tests/url_shortener_spec.rb +31 -0
  360. data/spec/spec_helper.rb +102 -46
  361. metadata +433 -178
  362. data/lib/compat/multi_json.rb +0 -19
  363. data/lib/google/api_client.rb +0 -750
  364. data/lib/google/api_client/auth/file_storage.rb +0 -59
  365. data/lib/google/api_client/auth/jwt_asserter.rb +0 -126
  366. data/lib/google/api_client/auth/key_utils.rb +0 -93
  367. data/lib/google/api_client/auth/pkcs12.rb +0 -41
  368. data/lib/google/api_client/batch.rb +0 -326
  369. data/lib/google/api_client/charset.rb +0 -33
  370. data/lib/google/api_client/discovery/api.rb +0 -310
  371. data/lib/google/api_client/discovery/media.rb +0 -77
  372. data/lib/google/api_client/discovery/method.rb +0 -363
  373. data/lib/google/api_client/discovery/resource.rb +0 -156
  374. data/lib/google/api_client/discovery/schema.rb +0 -117
  375. data/lib/google/api_client/environment.rb +0 -42
  376. data/lib/google/api_client/gzip.rb +0 -28
  377. data/lib/google/api_client/logging.rb +0 -32
  378. data/lib/google/api_client/media.rb +0 -259
  379. data/lib/google/api_client/railtie.rb +0 -18
  380. data/lib/google/api_client/request.rb +0 -350
  381. data/lib/google/api_client/result.rb +0 -255
  382. data/lib/google/api_client/service.rb +0 -233
  383. data/lib/google/api_client/service/batch.rb +0 -110
  384. data/lib/google/api_client/service/request.rb +0 -144
  385. data/lib/google/api_client/service/resource.rb +0 -40
  386. data/lib/google/api_client/service/result.rb +0 -162
  387. data/lib/google/api_client/service/simple_file_store.rb +0 -151
  388. data/lib/google/api_client/service/stub_generator.rb +0 -61
  389. data/spec/google/api_client/batch_spec.rb +0 -248
  390. data/spec/google/api_client/discovery_spec.rb +0 -708
  391. data/spec/google/api_client/gzip_spec.rb +0 -98
  392. data/spec/google/api_client/media_spec.rb +0 -178
  393. data/spec/google/api_client/result_spec.rb +0 -207
  394. data/spec/google/api_client/service_account_spec.rb +0 -169
  395. data/spec/google/api_client/service_spec.rb +0 -618
  396. data/spec/google/api_client/simple_file_store_spec.rb +0 -133
  397. data/spec/google/api_client_spec.rb +0 -352
@@ -0,0 +1,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