smartsheet 2.77.0 → 2.101.1

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 (73) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +12 -12
  3. data/.rubocop.yml +4 -4
  4. data/.travis.yml +29 -15
  5. data/.yardopts +3 -3
  6. data/ADVANCED.md +78 -78
  7. data/CHANGELOG.md +133 -112
  8. data/Gemfile +6 -6
  9. data/LICENSE +202 -202
  10. data/README.md +248 -246
  11. data/Rakefile +29 -29
  12. data/bin/console +14 -14
  13. data/bin/setup +8 -8
  14. data/lib/smartsheet.rb +2 -2
  15. data/lib/smartsheet/api/body_builder.rb +25 -25
  16. data/lib/smartsheet/api/endpoint_spec.rb +54 -54
  17. data/lib/smartsheet/api/faraday_adapter/faraday_net_client.rb +45 -45
  18. data/lib/smartsheet/api/faraday_adapter/faraday_response.rb +70 -70
  19. data/lib/smartsheet/api/faraday_adapter/middleware/faraday_error_translator.rb +20 -20
  20. data/lib/smartsheet/api/faraday_adapter/middleware/response_parser.rb +25 -25
  21. data/lib/smartsheet/api/file_spec.rb +55 -55
  22. data/lib/smartsheet/api/header_builder.rb +96 -96
  23. data/lib/smartsheet/api/request.rb +42 -42
  24. data/lib/smartsheet/api/request_client.rb +43 -43
  25. data/lib/smartsheet/api/request_logger.rb +182 -182
  26. data/lib/smartsheet/api/request_spec.rb +57 -57
  27. data/lib/smartsheet/api/response_net_client_decorator.rb +54 -54
  28. data/lib/smartsheet/api/retry_logic.rb +40 -40
  29. data/lib/smartsheet/api/retry_net_client_decorator.rb +37 -37
  30. data/lib/smartsheet/api/url_builder.rb +25 -25
  31. data/lib/smartsheet/client.rb +193 -193
  32. data/lib/smartsheet/constants.rb +18 -18
  33. data/lib/smartsheet/endpoints/contacts/contacts.rb +30 -30
  34. data/lib/smartsheet/endpoints/events/events.rb +20 -20
  35. data/lib/smartsheet/endpoints/favorites/favorites.rb +159 -159
  36. data/lib/smartsheet/endpoints/folders/folders.rb +125 -125
  37. data/lib/smartsheet/endpoints/groups/groups.rb +83 -83
  38. data/lib/smartsheet/endpoints/home/home.rb +20 -20
  39. data/lib/smartsheet/endpoints/reports/reports.rb +100 -100
  40. data/lib/smartsheet/endpoints/reports/reports_share.rb +69 -69
  41. data/lib/smartsheet/endpoints/search/search.rb +30 -30
  42. data/lib/smartsheet/endpoints/server_info/server_info.rb +21 -21
  43. data/lib/smartsheet/endpoints/share/share.rb +58 -58
  44. data/lib/smartsheet/endpoints/sheets/automation_rules.rb +55 -55
  45. data/lib/smartsheet/endpoints/sheets/cells.rb +82 -82
  46. data/lib/smartsheet/endpoints/sheets/columns.rb +66 -66
  47. data/lib/smartsheet/endpoints/sheets/comments.rb +64 -64
  48. data/lib/smartsheet/endpoints/sheets/comments_attachments.rb +78 -78
  49. data/lib/smartsheet/endpoints/sheets/cross_sheet_references.rb +45 -45
  50. data/lib/smartsheet/endpoints/sheets/discussions.rb +84 -84
  51. data/lib/smartsheet/endpoints/sheets/discussions_attachments.rb +22 -22
  52. data/lib/smartsheet/endpoints/sheets/rows.rb +106 -106
  53. data/lib/smartsheet/endpoints/sheets/rows_attachments.rb +92 -92
  54. data/lib/smartsheet/endpoints/sheets/sheets.rb +514 -510
  55. data/lib/smartsheet/endpoints/sheets/sheets_attachments.rb +174 -174
  56. data/lib/smartsheet/endpoints/sheets/sheets_share.rb +69 -69
  57. data/lib/smartsheet/endpoints/sheets/sheets_summaries.rb +123 -0
  58. data/lib/smartsheet/endpoints/sights/sights.rb +101 -101
  59. data/lib/smartsheet/endpoints/sights/sights_share.rb +69 -69
  60. data/lib/smartsheet/endpoints/templates/templates.rb +29 -29
  61. data/lib/smartsheet/endpoints/token/token.rb +70 -66
  62. data/lib/smartsheet/endpoints/update_requests/sent_update_requests.rb +44 -44
  63. data/lib/smartsheet/endpoints/update_requests/update_requests.rb +74 -74
  64. data/lib/smartsheet/endpoints/users/alternate_emails.rb +79 -79
  65. data/lib/smartsheet/endpoints/users/users.rb +123 -77
  66. data/lib/smartsheet/endpoints/webhooks/webhooks.rb +71 -71
  67. data/lib/smartsheet/endpoints/workspaces/workspaces.rb +87 -87
  68. data/lib/smartsheet/endpoints/workspaces/workspaces_share.rb +70 -70
  69. data/lib/smartsheet/error.rb +69 -69
  70. data/lib/smartsheet/general_request.rb +74 -74
  71. data/lib/smartsheet/version.rb +5 -5
  72. data/smartsheet.gemspec +54 -54
  73. metadata +24 -12
@@ -0,0 +1,123 @@
1
+ require 'smartsheet/api/file_spec'
2
+
3
+ module Smartsheet
4
+ # Sheet Summaries Endpoints
5
+ # @see https://smartsheet-platform.github.io/api-docs/?ruby#______ API Sheet Summaries Docs
6
+ class SheetsSummaries
7
+ attr_reader :client
8
+ private :client
9
+
10
+ def initialize(client)
11
+ @client = client
12
+ end
13
+
14
+ def get(sheet_id:, params: {}, header_overrides: {})
15
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sheets', :sheet_id, 'summary'])
16
+ request_spec = Smartsheet::API::RequestSpec.new(
17
+ params: params,
18
+ header_overrides: header_overrides,
19
+ sheet_id: sheet_id
20
+ )
21
+ client.make_request(endpoint_spec, request_spec)
22
+ end
23
+
24
+ def get_fields(sheet_id:, params: {}, header_overrides: {})
25
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sheets', :sheet_id, 'summary', 'fields'])
26
+ request_spec = Smartsheet::API::RequestSpec.new(
27
+ params: params,
28
+ header_overrides: header_overrides,
29
+ sheet_id: sheet_id
30
+ )
31
+ client.make_request(endpoint_spec, request_spec)
32
+ end
33
+
34
+ def add_fields(sheet_id:, body:, params: {}, header_overrides: {})
35
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(
36
+ :post,
37
+ ['sheets', :sheet_id, 'summary', 'fields'],
38
+ body_type: :json
39
+ )
40
+ request_spec = Smartsheet::API::RequestSpec.new(
41
+ params: params,
42
+ header_overrides: header_overrides,
43
+ body: body,
44
+ sheet_id: sheet_id
45
+ )
46
+ client.make_request(endpoint_spec, request_spec)
47
+ end
48
+
49
+ def delete_fields(sheet_id:, params: {}, header_overrides: {})
50
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:delete, ['sheets', :sheet_id, 'summary', 'fields'])
51
+ request_spec = Smartsheet::API::RequestSpec.new(
52
+ params: params,
53
+ header_overrides: header_overrides,
54
+ sheet_id: sheet_id
55
+ )
56
+ client.make_request(endpoint_spec, request_spec)
57
+ end
58
+
59
+ def update_fields(sheet_id:, body:, params: {}, header_overrides: {})
60
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(
61
+ :put,
62
+ ['sheets', :sheet_id, 'summary', 'fields'],
63
+ body_type: :json
64
+ )
65
+ request_spec = Smartsheet::API::RequestSpec.new(
66
+ params: params,
67
+ header_overrides: header_overrides,
68
+ body: body,
69
+ sheet_id: sheet_id
70
+ )
71
+ client.make_request(endpoint_spec, request_spec)
72
+ end
73
+
74
+ def add_image(
75
+ sheet_id:,
76
+ field_id:,
77
+ file:,
78
+ filename:,
79
+ file_length:,
80
+ content_type: '',
81
+ params: {},
82
+ header_overrides: {}
83
+ )
84
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(
85
+ :post,
86
+ ['sheets', :sheet_id, 'summary', 'fields', :field_id, 'images'],
87
+ body_type: :file
88
+ )
89
+ request_spec = Smartsheet::API::RequestSpec.new(
90
+ header_overrides: header_overrides,
91
+ params: params,
92
+ file_spec: Smartsheet::API::ObjectFileSpec.new(file, filename, file_length, content_type),
93
+ sheet_id: sheet_id,
94
+ field_id: field_id
95
+ )
96
+ client.make_request(endpoint_spec, request_spec)
97
+ end
98
+
99
+ def add_image_from_path(
100
+ sheet_id:,
101
+ field_id:,
102
+ path:,
103
+ filename: nil,
104
+ content_type: '',
105
+ params: {},
106
+ header_overrides: {}
107
+ )
108
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(
109
+ :post,
110
+ ['sheets', :sheet_id, 'summary', 'fields', :field_id, 'images'],
111
+ body_type: :file
112
+ )
113
+ request_spec = Smartsheet::API::RequestSpec.new(
114
+ header_overrides: header_overrides,
115
+ params: params,
116
+ file_spec: Smartsheet::API::PathFileSpec.new(path, filename, content_type),
117
+ sheet_id: sheet_id,
118
+ field_id: field_id
119
+ )
120
+ client.make_request(endpoint_spec, request_spec)
121
+ end
122
+ end
123
+ end
@@ -1,102 +1,102 @@
1
- require_relative 'sights_share'
2
-
3
- module Smartsheet
4
- # Sights Endpoints
5
- # @see https://smartsheet-platform.github.io/api-docs/?ruby#sights API Sights Docs
6
- #
7
- # @!attribute [r] share
8
- # @return [SightsShare]
9
- class Sights
10
- attr_reader :client, :share
11
- private :client
12
-
13
- def initialize(client)
14
- @client = client
15
-
16
- @share = SightsShare.new(client)
17
- end
18
-
19
- def copy(sight_id:, body:, params: {}, header_overrides: {})
20
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:post, ['sights', :sight_id, 'copy'], body_type: :json)
21
- request_spec = Smartsheet::API::RequestSpec.new(
22
- header_overrides: header_overrides,
23
- params: params,
24
- body: body,
25
- sight_id: sight_id
26
- )
27
- client.make_request(endpoint_spec, request_spec)
28
- end
29
-
30
- def delete(sight_id:, params: {}, header_overrides: {})
31
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:delete, ['sights', :sight_id])
32
- request_spec = Smartsheet::API::RequestSpec.new(
33
- params: params,
34
- header_overrides: header_overrides,
35
- sight_id: sight_id
36
- )
37
- client.make_request(endpoint_spec, request_spec)
38
- end
39
-
40
- def get(sight_id:, params: {}, header_overrides: {})
41
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights', :sight_id])
42
- request_spec = Smartsheet::API::RequestSpec.new(
43
- params: params,
44
- header_overrides: header_overrides,
45
- sight_id: sight_id
46
- )
47
- client.make_request(endpoint_spec, request_spec)
48
- end
49
-
50
- def list(params: {}, header_overrides: {})
51
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights'])
52
- request_spec = Smartsheet::API::RequestSpec.new(
53
- header_overrides: header_overrides,
54
- params: params
55
- )
56
- client.make_request(endpoint_spec, request_spec)
57
- end
58
-
59
- def move(sight_id:, body:, params: {}, header_overrides: {})
60
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:post, ['sights', :sight_id, 'move'], body_type: :json)
61
- request_spec = Smartsheet::API::RequestSpec.new(
62
- params: params,
63
- header_overrides: header_overrides,
64
- body: body,
65
- sight_id: sight_id
66
- )
67
- client.make_request(endpoint_spec, request_spec)
68
- end
69
-
70
- def get_publish_status(sight_id:, params: {}, header_overrides: {})
71
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights', :sight_id, 'publish'])
72
- request_spec = Smartsheet::API::RequestSpec.new(
73
- params: params,
74
- header_overrides: header_overrides,
75
- sight_id: sight_id
76
- )
77
- client.make_request(endpoint_spec, request_spec)
78
- end
79
-
80
- def set_publish_status(sight_id:, body:, params: {}, header_overrides: {})
81
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:put, ['sights', :sight_id, 'publish'], body_type: :json)
82
- request_spec = Smartsheet::API::RequestSpec.new(
83
- params: params,
84
- header_overrides: header_overrides,
85
- body: body,
86
- sight_id: sight_id
87
- )
88
- client.make_request(endpoint_spec, request_spec)
89
- end
90
-
91
- def update(sight_id:, body:, params: {}, header_overrides: {})
92
- endpoint_spec = Smartsheet::API::EndpointSpec.new(:put, ['sights', :sight_id], body_type: :json)
93
- request_spec = Smartsheet::API::RequestSpec.new(
94
- params: params,
95
- header_overrides: header_overrides,
96
- body: body,
97
- sight_id: sight_id
98
- )
99
- client.make_request(endpoint_spec, request_spec)
100
- end
101
- end
1
+ require_relative 'sights_share'
2
+
3
+ module Smartsheet
4
+ # Sights Endpoints
5
+ # @see https://smartsheet-platform.github.io/api-docs/?ruby#sights API Sights Docs
6
+ #
7
+ # @!attribute [r] share
8
+ # @return [SightsShare]
9
+ class Sights
10
+ attr_reader :client, :share
11
+ private :client
12
+
13
+ def initialize(client)
14
+ @client = client
15
+
16
+ @share = SightsShare.new(client)
17
+ end
18
+
19
+ def copy(sight_id:, body:, params: {}, header_overrides: {})
20
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:post, ['sights', :sight_id, 'copy'], body_type: :json)
21
+ request_spec = Smartsheet::API::RequestSpec.new(
22
+ header_overrides: header_overrides,
23
+ params: params,
24
+ body: body,
25
+ sight_id: sight_id
26
+ )
27
+ client.make_request(endpoint_spec, request_spec)
28
+ end
29
+
30
+ def delete(sight_id:, params: {}, header_overrides: {})
31
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:delete, ['sights', :sight_id])
32
+ request_spec = Smartsheet::API::RequestSpec.new(
33
+ params: params,
34
+ header_overrides: header_overrides,
35
+ sight_id: sight_id
36
+ )
37
+ client.make_request(endpoint_spec, request_spec)
38
+ end
39
+
40
+ def get(sight_id:, params: {}, header_overrides: {})
41
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights', :sight_id])
42
+ request_spec = Smartsheet::API::RequestSpec.new(
43
+ params: params,
44
+ header_overrides: header_overrides,
45
+ sight_id: sight_id
46
+ )
47
+ client.make_request(endpoint_spec, request_spec)
48
+ end
49
+
50
+ def list(params: {}, header_overrides: {})
51
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights'])
52
+ request_spec = Smartsheet::API::RequestSpec.new(
53
+ header_overrides: header_overrides,
54
+ params: params
55
+ )
56
+ client.make_request(endpoint_spec, request_spec)
57
+ end
58
+
59
+ def move(sight_id:, body:, params: {}, header_overrides: {})
60
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:post, ['sights', :sight_id, 'move'], body_type: :json)
61
+ request_spec = Smartsheet::API::RequestSpec.new(
62
+ params: params,
63
+ header_overrides: header_overrides,
64
+ body: body,
65
+ sight_id: sight_id
66
+ )
67
+ client.make_request(endpoint_spec, request_spec)
68
+ end
69
+
70
+ def get_publish_status(sight_id:, params: {}, header_overrides: {})
71
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['sights', :sight_id, 'publish'])
72
+ request_spec = Smartsheet::API::RequestSpec.new(
73
+ params: params,
74
+ header_overrides: header_overrides,
75
+ sight_id: sight_id
76
+ )
77
+ client.make_request(endpoint_spec, request_spec)
78
+ end
79
+
80
+ def set_publish_status(sight_id:, body:, params: {}, header_overrides: {})
81
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:put, ['sights', :sight_id, 'publish'], body_type: :json)
82
+ request_spec = Smartsheet::API::RequestSpec.new(
83
+ params: params,
84
+ header_overrides: header_overrides,
85
+ body: body,
86
+ sight_id: sight_id
87
+ )
88
+ client.make_request(endpoint_spec, request_spec)
89
+ end
90
+
91
+ def update(sight_id:, body:, params: {}, header_overrides: {})
92
+ endpoint_spec = Smartsheet::API::EndpointSpec.new(:put, ['sights', :sight_id], body_type: :json)
93
+ request_spec = Smartsheet::API::RequestSpec.new(
94
+ params: params,
95
+ header_overrides: header_overrides,
96
+ body: body,
97
+ sight_id: sight_id
98
+ )
99
+ client.make_request(endpoint_spec, request_spec)
100
+ end
101
+ end
102
102
  end
@@ -1,70 +1,70 @@
1
- require 'smartsheet/endpoints/share/share'
2
-
3
- module Smartsheet
4
- # Sight Sharing Endpoints
5
- # @see https://smartsheet-platform.github.io/api-docs/?ruby#sight-sharing API Sight Sharing Docs
6
- class SightsShare
7
- attr_reader :client
8
- private :client
9
-
10
- URL = ['sights', :sight_id]
11
-
12
- def initialize(client)
13
- @client = client
14
- end
15
-
16
- def delete(sight_id:, share_id:, params: {}, header_overrides: {})
17
- delete_share(
18
- share_id: share_id,
19
- url: URL,
20
- params: params,
21
- header_overrides: header_overrides,
22
- sight_id: sight_id
23
- )
24
- end
25
-
26
- def get(sight_id:, share_id:, params: {}, header_overrides: {})
27
- get_share(
28
- share_id: share_id,
29
- url: URL,
30
- params: params,
31
- header_overrides: header_overrides,
32
- sight_id: sight_id
33
- )
34
- end
35
-
36
- def list(sight_id:, params: {}, header_overrides: {})
37
- list_share(
38
- url: URL,
39
- header_overrides: header_overrides,
40
- params: params,
41
- sight_id: sight_id
42
- )
43
- end
44
-
45
- def create(sight_id:, body:, params: {}, header_overrides: {})
46
- create_share(
47
- url: URL,
48
- header_overrides: header_overrides,
49
- params: params,
50
- body: body,
51
- sight_id: sight_id
52
- )
53
- end
54
-
55
- def update(sight_id:, share_id:, body:, params: {}, header_overrides: {})
56
- update_share(
57
- share_id: share_id,
58
- url: URL,
59
- params: params,
60
- header_overrides: header_overrides,
61
- body: body,
62
- sight_id: sight_id
63
- )
64
- end
65
-
66
- private
67
-
68
- include Smartsheet::Share
69
- end
1
+ require 'smartsheet/endpoints/share/share'
2
+
3
+ module Smartsheet
4
+ # Sight Sharing Endpoints
5
+ # @see https://smartsheet-platform.github.io/api-docs/?ruby#sight-sharing API Sight Sharing Docs
6
+ class SightsShare
7
+ attr_reader :client
8
+ private :client
9
+
10
+ URL = ['sights', :sight_id]
11
+
12
+ def initialize(client)
13
+ @client = client
14
+ end
15
+
16
+ def delete(sight_id:, share_id:, params: {}, header_overrides: {})
17
+ delete_share(
18
+ share_id: share_id,
19
+ url: URL,
20
+ params: params,
21
+ header_overrides: header_overrides,
22
+ sight_id: sight_id
23
+ )
24
+ end
25
+
26
+ def get(sight_id:, share_id:, params: {}, header_overrides: {})
27
+ get_share(
28
+ share_id: share_id,
29
+ url: URL,
30
+ params: params,
31
+ header_overrides: header_overrides,
32
+ sight_id: sight_id
33
+ )
34
+ end
35
+
36
+ def list(sight_id:, params: {}, header_overrides: {})
37
+ list_share(
38
+ url: URL,
39
+ header_overrides: header_overrides,
40
+ params: params,
41
+ sight_id: sight_id
42
+ )
43
+ end
44
+
45
+ def create(sight_id:, body:, params: {}, header_overrides: {})
46
+ create_share(
47
+ url: URL,
48
+ header_overrides: header_overrides,
49
+ params: params,
50
+ body: body,
51
+ sight_id: sight_id
52
+ )
53
+ end
54
+
55
+ def update(sight_id:, share_id:, body:, params: {}, header_overrides: {})
56
+ update_share(
57
+ share_id: share_id,
58
+ url: URL,
59
+ params: params,
60
+ header_overrides: header_overrides,
61
+ body: body,
62
+ sight_id: sight_id
63
+ )
64
+ end
65
+
66
+ private
67
+
68
+ include Smartsheet::Share
69
+ end
70
70
  end