onesignal 1.0.0.beta1 → 1.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +31 -0
- data/LICENSE +24 -0
- data/README.md +75 -45
- data/RELEASE_INSTRUCTIONS.md +11 -0
- data/docs/DefaultApi.md +86 -86
- data/docs/InlineResponse200.md +1 -1
- data/docs/InlineResponse2001.md +1 -1
- data/docs/InlineResponse2002.md +1 -1
- data/docs/InlineResponse2005.md +4 -2
- data/docs/{InlineResponse2003.md → InlineResponse2007.md} +3 -3
- data/docs/InlineResponse2008.md +18 -0
- data/docs/InlineResponse4002.md +4 -2
- data/docs/InlineResponse4003.md +18 -0
- data/docs/InvalidIdentifierError.md +20 -0
- data/docs/Notification.md +12 -12
- data/docs/Notification200Errors.md +49 -0
- data/docs/NotificationAllOf.md +11 -11
- data/docs/NotificationSlice.md +1 -1
- data/docs/NotificationTarget.md +1 -1
- data/docs/NotificationWithMeta.md +260 -0
- data/docs/NotificationWithMetaAllOf.md +38 -0
- data/docs/OutcomesData.md +18 -0
- data/docs/Player.md +2 -2
- data/docs/PlayerNotificationTarget.md +1 -1
- data/docs/StringMap.md +1 -1
- data/lib/onesignal/api/default_api.rb +82 -55
- data/lib/onesignal/api_client.rb +9 -7
- data/lib/onesignal/api_error.rb +2 -2
- data/lib/onesignal/configuration.rb +6 -3
- data/lib/onesignal/models/app.rb +3 -2
- data/lib/onesignal/models/button.rb +3 -2
- data/lib/onesignal/models/delivery_data.rb +8 -2
- data/lib/onesignal/models/export_players_request_body.rb +3 -2
- data/lib/onesignal/models/filter.rb +3 -2
- data/lib/onesignal/models/filter_expressions.rb +3 -2
- data/lib/onesignal/models/filter_notification_target.rb +3 -2
- data/lib/onesignal/models/get_notification_request_body.rb +3 -2
- data/lib/onesignal/models/inline_response200.rb +4 -3
- data/lib/onesignal/models/inline_response2001.rb +4 -3
- data/lib/onesignal/models/inline_response2002.rb +4 -3
- data/lib/onesignal/models/inline_response2005.rb +19 -9
- data/lib/onesignal/models/{inline_response2003.rb → inline_response2007.rb} +7 -6
- data/lib/onesignal/models/{inline_response2004.rb → inline_response2008.rb} +13 -21
- data/lib/onesignal/models/inline_response201.rb +3 -2
- data/lib/onesignal/models/inline_response400.rb +3 -2
- data/lib/onesignal/models/inline_response4001.rb +3 -2
- data/lib/onesignal/models/inline_response4002.rb +20 -10
- data/lib/onesignal/models/{inline_response409.rb → inline_response4003.rb} +14 -22
- data/lib/onesignal/models/invalid_identifier_error.rb +234 -0
- data/lib/onesignal/models/notification.rb +39 -19
- data/lib/onesignal/models/notification200_errors.rb +105 -0
- data/lib/onesignal/models/notification_all_of.rb +38 -18
- data/lib/onesignal/models/notification_all_of_android_background_layout.rb +3 -2
- data/lib/onesignal/models/notification_slice.rb +4 -3
- data/lib/onesignal/models/notification_target.rb +4 -3
- data/lib/onesignal/models/notification_with_meta.rb +1526 -0
- data/lib/onesignal/models/notification_with_meta_all_of.rb +322 -0
- data/lib/onesignal/models/operator.rb +3 -2
- data/lib/onesignal/models/outcome_data.rb +3 -2
- data/lib/onesignal/models/outcomes_data.rb +221 -0
- data/lib/onesignal/models/platform_delivery_data.rb +3 -2
- data/lib/onesignal/models/player.rb +6 -8
- data/lib/onesignal/models/player_notification_target.rb +4 -3
- data/lib/onesignal/models/player_slice.rb +3 -2
- data/lib/onesignal/models/purchase.rb +3 -2
- data/lib/onesignal/models/segment.rb +3 -2
- data/lib/onesignal/models/segment_notification_target.rb +3 -2
- data/lib/onesignal/models/string_map.rb +3 -7
- data/lib/onesignal/models/update_player_tags_request_body.rb +3 -2
- data/lib/onesignal/version.rb +3 -3
- data/lib/{OneSignal.rb → onesignal.rb} +10 -5
- data/onesignal.gemspec +5 -4
- data/spec/api/default_api_spec.rb +20 -20
- data/spec/api_client_spec.rb +4 -4
- data/spec/configuration_spec.rb +2 -2
- data/spec/models/app_spec.rb +2 -2
- data/spec/models/button_spec.rb +2 -2
- data/spec/models/delivery_data_spec.rb +2 -2
- data/spec/models/export_players_request_body_spec.rb +2 -2
- data/spec/models/filter_expressions_spec.rb +2 -2
- data/spec/models/filter_notification_target_spec.rb +2 -2
- data/spec/models/filter_spec.rb +2 -2
- data/spec/models/get_notification_request_body_spec.rb +2 -2
- data/spec/models/inline_response2001_spec.rb +2 -2
- data/spec/models/inline_response2002_spec.rb +2 -2
- data/spec/models/inline_response2005_spec.rb +9 -3
- data/spec/models/{inline_response2003_spec.rb → inline_response2007_spec.rb} +8 -8
- data/spec/models/{inline_response409_spec.rb → inline_response2008_spec.rb} +9 -15
- data/spec/models/inline_response200_spec.rb +2 -2
- data/spec/models/inline_response201_spec.rb +2 -2
- data/spec/models/inline_response4001_spec.rb +2 -2
- data/spec/models/inline_response4002_spec.rb +9 -3
- data/spec/models/inline_response4003_spec.rb +34 -0
- data/spec/models/inline_response400_spec.rb +2 -2
- data/spec/models/{inline_response2004_spec.rb → invalid_identifier_error_spec.rb} +10 -10
- data/spec/models/notification200_errors_spec.rb +31 -0
- data/spec/models/notification_all_of_android_background_layout_spec.rb +2 -2
- data/spec/models/notification_all_of_spec.rb +3 -3
- data/spec/models/notification_slice_spec.rb +2 -2
- data/spec/models/notification_spec.rb +3 -3
- data/spec/models/notification_target_spec.rb +2 -2
- data/spec/models/notification_with_meta_all_of_spec.rb +94 -0
- data/spec/models/notification_with_meta_spec.rb +764 -0
- data/spec/models/operator_spec.rb +2 -2
- data/spec/models/outcome_data_spec.rb +2 -2
- data/spec/models/outcomes_data_spec.rb +34 -0
- data/spec/models/platform_delivery_data_spec.rb +2 -2
- data/spec/models/player_notification_target_spec.rb +2 -2
- data/spec/models/player_slice_spec.rb +2 -2
- data/spec/models/player_spec.rb +2 -2
- data/spec/models/purchase_spec.rb +2 -2
- data/spec/models/segment_notification_target_spec.rb +2 -2
- data/spec/models/segment_spec.rb +2 -2
- data/spec/models/string_map_spec.rb +2 -2
- data/spec/models/update_player_tags_request_body_spec.rb +2 -2
- data/spec/spec_helper.rb +2 -2
- metadata +51 -29
- data/docs/InlineResponse2004.md +0 -20
- data/docs/InlineResponse409.md +0 -20
- data/git_push.sh +0 -58
data/docs/DefaultApi.md
CHANGED
@@ -36,12 +36,12 @@ Used to stop a scheduled or currently outgoing notification
|
|
36
36
|
### Examples
|
37
37
|
|
38
38
|
```ruby
|
39
|
-
require 'time'
|
40
39
|
require 'onesignal'
|
41
40
|
# setup authorization
|
42
41
|
OneSignal.configure do |config|
|
43
42
|
# Configure Bearer authorization: app_key
|
44
|
-
config.
|
43
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
44
|
+
|
45
45
|
end
|
46
46
|
|
47
47
|
api_instance = OneSignal::DefaultApi.new
|
@@ -107,12 +107,12 @@ Creates a new OneSignal app
|
|
107
107
|
### Examples
|
108
108
|
|
109
109
|
```ruby
|
110
|
-
require 'time'
|
111
110
|
require 'onesignal'
|
112
111
|
# setup authorization
|
113
112
|
OneSignal.configure do |config|
|
114
113
|
# Configure Bearer authorization: user_key
|
115
|
-
config.
|
114
|
+
config.user_key = 'YOUR_BEARER_TOKEN'
|
115
|
+
|
116
116
|
end
|
117
117
|
|
118
118
|
api_instance = OneSignal::DefaultApi.new
|
@@ -176,12 +176,12 @@ Sends notifications to your users
|
|
176
176
|
### Examples
|
177
177
|
|
178
178
|
```ruby
|
179
|
-
require 'time'
|
180
179
|
require 'onesignal'
|
181
180
|
# setup authorization
|
182
181
|
OneSignal.configure do |config|
|
183
182
|
# Configure Bearer authorization: app_key
|
184
|
-
config.
|
183
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
184
|
+
|
185
185
|
end
|
186
186
|
|
187
187
|
api_instance = OneSignal::DefaultApi.new
|
@@ -236,25 +236,25 @@ end
|
|
236
236
|
|
237
237
|
## create_player
|
238
238
|
|
239
|
-
> <
|
239
|
+
> <InlineResponse2005> create_player(player)
|
240
240
|
|
241
241
|
Add a device
|
242
242
|
|
243
|
-
Register a new device to one of your OneSignal apps
|
243
|
+
Register a new device to one of your OneSignal apps 🚧 Don't use this This API endpoint is designed to be used from our open source Mobile and Web Push SDKs. It is not designed for developers to use it directly, unless instructed to do so by OneSignal support. If you use this method instead of our SDKs, many OneSignal features such as conversion tracking, timezone tracking, language detection, and rich-push won't work out of the box. It will also make it harder to identify possible setup issues. This method is used to register a new device with OneSignal. If a device is already registered with the specified identifier, then this will update the existing device record instead of creating a new one. The returned player is a player / user ID. Use the returned ID to send push notifications to this specific user later, or to include this player when sending to a set of users. 🚧 iOS Must set test_type to 1 when building your iOS app as development. Omit this field in your production app builds.
|
244
244
|
|
245
245
|
### Examples
|
246
246
|
|
247
247
|
```ruby
|
248
|
-
require 'time'
|
249
248
|
require 'onesignal'
|
250
249
|
# setup authorization
|
251
250
|
OneSignal.configure do |config|
|
252
251
|
# Configure Bearer authorization: app_key
|
253
|
-
config.
|
252
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
253
|
+
|
254
254
|
end
|
255
255
|
|
256
256
|
api_instance = OneSignal::DefaultApi.new
|
257
|
-
player = OneSignal::Player.new({id: 'id_example',
|
257
|
+
player = OneSignal::Player.new({id: 'id_example', device_type: 37}) # Player |
|
258
258
|
|
259
259
|
begin
|
260
260
|
# Add a device
|
@@ -269,7 +269,7 @@ end
|
|
269
269
|
|
270
270
|
This returns an Array which contains the response data, status code and headers.
|
271
271
|
|
272
|
-
> <Array(<
|
272
|
+
> <Array(<InlineResponse2005>, Integer, Hash)> create_player_with_http_info(player)
|
273
273
|
|
274
274
|
```ruby
|
275
275
|
begin
|
@@ -277,7 +277,7 @@ begin
|
|
277
277
|
data, status_code, headers = api_instance.create_player_with_http_info(player)
|
278
278
|
p status_code # => 2xx
|
279
279
|
p headers # => { ... }
|
280
|
-
p data # => <
|
280
|
+
p data # => <InlineResponse2005>
|
281
281
|
rescue OneSignal::ApiError => e
|
282
282
|
puts "Error when calling DefaultApi->create_player_with_http_info: #{e}"
|
283
283
|
end
|
@@ -291,7 +291,7 @@ end
|
|
291
291
|
|
292
292
|
### Return type
|
293
293
|
|
294
|
-
[**
|
294
|
+
[**InlineResponse2005**](InlineResponse2005.md)
|
295
295
|
|
296
296
|
### Authorization
|
297
297
|
|
@@ -309,17 +309,17 @@ end
|
|
309
309
|
|
310
310
|
Create Segments
|
311
311
|
|
312
|
-
Create segments visible and usable in the dashboard and API - Required: OneSignal Paid Plan The Create Segment method is used when you want your server to programmatically create a segment instead of using the OneSignal Dashboard UI. Just like creating Segments from the dashboard you can pass in filters with multiple \"AND\" or \"OR\" operator's.
|
312
|
+
Create segments visible and usable in the dashboard and API - Required: OneSignal Paid Plan The Create Segment method is used when you want your server to programmatically create a segment instead of using the OneSignal Dashboard UI. Just like creating Segments from the dashboard you can pass in filters with multiple \"AND\" or \"OR\" operator's. 🚧 Does Not Update Segments This endpoint will only create segments, it does not edit or update currently created Segments. You will need to use the Delete Segments endpoint and re-create it with this endpoint to edit.
|
313
313
|
|
314
314
|
### Examples
|
315
315
|
|
316
316
|
```ruby
|
317
|
-
require 'time'
|
318
317
|
require 'onesignal'
|
319
318
|
# setup authorization
|
320
319
|
OneSignal.configure do |config|
|
321
320
|
# Configure Bearer authorization: app_key
|
322
|
-
config.
|
321
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
322
|
+
|
323
323
|
end
|
324
324
|
|
325
325
|
api_instance = OneSignal::DefaultApi.new
|
@@ -378,7 +378,7 @@ end
|
|
378
378
|
|
379
379
|
## delete_player
|
380
380
|
|
381
|
-
> <
|
381
|
+
> <InlineResponse2007> delete_player(app_id, player_id)
|
382
382
|
|
383
383
|
Delete a user record
|
384
384
|
|
@@ -387,12 +387,12 @@ Delete player - Required: Used to delete a single, specific Player ID record fro
|
|
387
387
|
### Examples
|
388
388
|
|
389
389
|
```ruby
|
390
|
-
require 'time'
|
391
390
|
require 'onesignal'
|
392
391
|
# setup authorization
|
393
392
|
OneSignal.configure do |config|
|
394
393
|
# Configure Bearer authorization: app_key
|
395
|
-
config.
|
394
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
395
|
+
|
396
396
|
end
|
397
397
|
|
398
398
|
api_instance = OneSignal::DefaultApi.new
|
@@ -412,7 +412,7 @@ end
|
|
412
412
|
|
413
413
|
This returns an Array which contains the response data, status code and headers.
|
414
414
|
|
415
|
-
> <Array(<
|
415
|
+
> <Array(<InlineResponse2007>, Integer, Hash)> delete_player_with_http_info(app_id, player_id)
|
416
416
|
|
417
417
|
```ruby
|
418
418
|
begin
|
@@ -420,7 +420,7 @@ begin
|
|
420
420
|
data, status_code, headers = api_instance.delete_player_with_http_info(app_id, player_id)
|
421
421
|
p status_code # => 2xx
|
422
422
|
p headers # => { ... }
|
423
|
-
p data # => <
|
423
|
+
p data # => <InlineResponse2007>
|
424
424
|
rescue OneSignal::ApiError => e
|
425
425
|
puts "Error when calling DefaultApi->delete_player_with_http_info: #{e}"
|
426
426
|
end
|
@@ -435,7 +435,7 @@ end
|
|
435
435
|
|
436
436
|
### Return type
|
437
437
|
|
438
|
-
[**
|
438
|
+
[**InlineResponse2007**](InlineResponse2007.md)
|
439
439
|
|
440
440
|
### Authorization
|
441
441
|
|
@@ -449,7 +449,7 @@ end
|
|
449
449
|
|
450
450
|
## delete_segments
|
451
451
|
|
452
|
-
> <
|
452
|
+
> <InlineResponse2001> delete_segments(app_id, segment_id)
|
453
453
|
|
454
454
|
Delete Segments
|
455
455
|
|
@@ -458,12 +458,12 @@ Delete segments (not user devices) - Required: OneSignal Paid Plan You can delet
|
|
458
458
|
### Examples
|
459
459
|
|
460
460
|
```ruby
|
461
|
-
require 'time'
|
462
461
|
require 'onesignal'
|
463
462
|
# setup authorization
|
464
463
|
OneSignal.configure do |config|
|
465
464
|
# Configure Bearer authorization: app_key
|
466
|
-
config.
|
465
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
466
|
+
|
467
467
|
end
|
468
468
|
|
469
469
|
api_instance = OneSignal::DefaultApi.new
|
@@ -483,7 +483,7 @@ end
|
|
483
483
|
|
484
484
|
This returns an Array which contains the response data, status code and headers.
|
485
485
|
|
486
|
-
> <Array(<
|
486
|
+
> <Array(<InlineResponse2001>, Integer, Hash)> delete_segments_with_http_info(app_id, segment_id)
|
487
487
|
|
488
488
|
```ruby
|
489
489
|
begin
|
@@ -491,7 +491,7 @@ begin
|
|
491
491
|
data, status_code, headers = api_instance.delete_segments_with_http_info(app_id, segment_id)
|
492
492
|
p status_code # => 2xx
|
493
493
|
p headers # => { ... }
|
494
|
-
p data # => <
|
494
|
+
p data # => <InlineResponse2001>
|
495
495
|
rescue OneSignal::ApiError => e
|
496
496
|
puts "Error when calling DefaultApi->delete_segments_with_http_info: #{e}"
|
497
497
|
end
|
@@ -506,7 +506,7 @@ end
|
|
506
506
|
|
507
507
|
### Return type
|
508
508
|
|
509
|
-
[**
|
509
|
+
[**InlineResponse2001**](InlineResponse2001.md)
|
510
510
|
|
511
511
|
### Authorization
|
512
512
|
|
@@ -520,21 +520,21 @@ end
|
|
520
520
|
|
521
521
|
## export_players
|
522
522
|
|
523
|
-
> <
|
523
|
+
> <InlineResponse2008> export_players(app_id, opts)
|
524
524
|
|
525
525
|
CSV export
|
526
526
|
|
527
|
-
Generate a compressed CSV export of all of your current user data This method can be used to generate a compressed CSV export of all of your current user data. It is a much faster alternative than retrieving this data using the /players API endpoint. The file will be compressed using GZip. The file may take several minutes to generate depending on the number of users in your app. The URL generated will be available for 3 days and includes random v4 uuid as part of the resource name to be unguessable.
|
527
|
+
Generate a compressed CSV export of all of your current user data This method can be used to generate a compressed CSV export of all of your current user data. It is a much faster alternative than retrieving this data using the /players API endpoint. The file will be compressed using GZip. The file may take several minutes to generate depending on the number of users in your app. The URL generated will be available for 3 days and includes random v4 uuid as part of the resource name to be unguessable. 🚧 403 Error Responses You can test if it is complete by making a GET request to the csv_file_url value. This file may take time to generate depending on how many device records are being pulled. If the file is not ready, a 403 error will be returned. Otherwise the file itself will be returned. 🚧 Requires Authentication Key Requires your OneSignal App's REST API Key, available in Keys & IDs. 🚧 Concurrent Exports Only one concurrent export is allowed per OneSignal account. Please ensure you have successfully downloaded the .csv.gz file before exporting another app. CSV File Format: - Default Columns: | Field | Details | | --- | --- | | id | OneSignal Player Id | | identifier | Push Token | | session_count | Number of times they visited the app or site | language | Device language code | | timezone | Number of seconds away from UTC. Example: -28800 | | game_version | Version of your mobile app gathered from Android Studio versionCode in your App/build.gradle and iOS uses kCFBundleVersionKey in Xcode. | | device_os | Device Operating System Version. Example: 80 = Chrome 80, 9 = Android 9 | | device_type | Device Operating System Type | | device_model | Device Hardware String Code. Example: Mobile Web Subscribers will have `Linux armv` | | ad_id | Based on the Google Advertising Id for Android, identifierForVendor for iOS. OptedOut means user turned off Advertising tracking on the device. | | tags | Current OneSignal Data Tags on the device. | | last_active | Date and time the user last opened the mobile app or visited the site. | | playtime | Total amount of time in seconds the user had the mobile app open. | | amount_spent | Mobile only - amount spent in USD on In-App Purchases. | | created_at | Date and time the device record was created in OneSignal. Mobile - first time they opened the app with OneSignal SDK. Web - first time the user subscribed to the site. | | invalid_identifier | t = unsubscribed, f = subscibed | | badge_count | Current number of badges on the device | - Extra Columns: | Field | Details | | --- | --- | | external_user_id | Your User Id set on the device | | notification_types | Notification types | | location | Location points (Latitude and Longitude) set on the device. | | country | Country code | | rooted | Android device rooted or not | | ip | IP Address of the device if being tracked. See Handling Personal Data. | | web_auth | Web Only authorization key. | | web_p256 | Web Only p256 key. |
|
528
528
|
|
529
529
|
### Examples
|
530
530
|
|
531
531
|
```ruby
|
532
|
-
require 'time'
|
533
532
|
require 'onesignal'
|
534
533
|
# setup authorization
|
535
534
|
OneSignal.configure do |config|
|
536
535
|
# Configure Bearer authorization: app_key
|
537
|
-
config.
|
536
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
537
|
+
|
538
538
|
end
|
539
539
|
|
540
540
|
api_instance = OneSignal::DefaultApi.new
|
@@ -556,7 +556,7 @@ end
|
|
556
556
|
|
557
557
|
This returns an Array which contains the response data, status code and headers.
|
558
558
|
|
559
|
-
> <Array(<
|
559
|
+
> <Array(<InlineResponse2008>, Integer, Hash)> export_players_with_http_info(app_id, opts)
|
560
560
|
|
561
561
|
```ruby
|
562
562
|
begin
|
@@ -564,7 +564,7 @@ begin
|
|
564
564
|
data, status_code, headers = api_instance.export_players_with_http_info(app_id, opts)
|
565
565
|
p status_code # => 2xx
|
566
566
|
p headers # => { ... }
|
567
|
-
p data # => <
|
567
|
+
p data # => <InlineResponse2008>
|
568
568
|
rescue OneSignal::ApiError => e
|
569
569
|
puts "Error when calling DefaultApi->export_players_with_http_info: #{e}"
|
570
570
|
end
|
@@ -579,7 +579,7 @@ end
|
|
579
579
|
|
580
580
|
### Return type
|
581
581
|
|
582
|
-
[**
|
582
|
+
[**InlineResponse2008**](InlineResponse2008.md)
|
583
583
|
|
584
584
|
### Authorization
|
585
585
|
|
@@ -602,12 +602,12 @@ View the details of a single OneSignal app
|
|
602
602
|
### Examples
|
603
603
|
|
604
604
|
```ruby
|
605
|
-
require 'time'
|
606
605
|
require 'onesignal'
|
607
606
|
# setup authorization
|
608
607
|
OneSignal.configure do |config|
|
609
608
|
# Configure Bearer authorization: user_key
|
610
|
-
config.
|
609
|
+
config.user_key = 'YOUR_BEARER_TOKEN'
|
610
|
+
|
611
611
|
end
|
612
612
|
|
613
613
|
api_instance = OneSignal::DefaultApi.new
|
@@ -662,7 +662,7 @@ end
|
|
662
662
|
|
663
663
|
## get_apps
|
664
664
|
|
665
|
-
>
|
665
|
+
> <Array<App>> get_apps
|
666
666
|
|
667
667
|
View apps
|
668
668
|
|
@@ -671,12 +671,12 @@ View the details of all of your current OneSignal apps
|
|
671
671
|
### Examples
|
672
672
|
|
673
673
|
```ruby
|
674
|
-
require 'time'
|
675
674
|
require 'onesignal'
|
676
675
|
# setup authorization
|
677
676
|
OneSignal.configure do |config|
|
678
677
|
# Configure Bearer authorization: user_key
|
679
|
-
config.
|
678
|
+
config.user_key = 'YOUR_BEARER_TOKEN'
|
679
|
+
|
680
680
|
end
|
681
681
|
|
682
682
|
api_instance = OneSignal::DefaultApi.new
|
@@ -694,7 +694,7 @@ end
|
|
694
694
|
|
695
695
|
This returns an Array which contains the response data, status code and headers.
|
696
696
|
|
697
|
-
> <Array(
|
697
|
+
> <Array(<Array<App>>, Integer, Hash)> get_apps_with_http_info
|
698
698
|
|
699
699
|
```ruby
|
700
700
|
begin
|
@@ -702,7 +702,7 @@ begin
|
|
702
702
|
data, status_code, headers = api_instance.get_apps_with_http_info
|
703
703
|
p status_code # => 2xx
|
704
704
|
p headers # => { ... }
|
705
|
-
p data # =>
|
705
|
+
p data # => <Array<App>>
|
706
706
|
rescue OneSignal::ApiError => e
|
707
707
|
puts "Error when calling DefaultApi->get_apps_with_http_info: #{e}"
|
708
708
|
end
|
@@ -714,7 +714,7 @@ This endpoint does not need any parameter.
|
|
714
714
|
|
715
715
|
### Return type
|
716
716
|
|
717
|
-
**
|
717
|
+
[**Array<App>**](App.md)
|
718
718
|
|
719
719
|
### Authorization
|
720
720
|
|
@@ -728,7 +728,7 @@ This endpoint does not need any parameter.
|
|
728
728
|
|
729
729
|
## get_notification
|
730
730
|
|
731
|
-
> <
|
731
|
+
> <NotificationWithMeta> get_notification(app_id, notification_id)
|
732
732
|
|
733
733
|
View notification
|
734
734
|
|
@@ -737,12 +737,12 @@ View the details of a single notification and outcomes associated with it
|
|
737
737
|
### Examples
|
738
738
|
|
739
739
|
```ruby
|
740
|
-
require 'time'
|
741
740
|
require 'onesignal'
|
742
741
|
# setup authorization
|
743
742
|
OneSignal.configure do |config|
|
744
743
|
# Configure Bearer authorization: app_key
|
745
|
-
config.
|
744
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
745
|
+
|
746
746
|
end
|
747
747
|
|
748
748
|
api_instance = OneSignal::DefaultApi.new
|
@@ -762,7 +762,7 @@ end
|
|
762
762
|
|
763
763
|
This returns an Array which contains the response data, status code and headers.
|
764
764
|
|
765
|
-
> <Array(<
|
765
|
+
> <Array(<NotificationWithMeta>, Integer, Hash)> get_notification_with_http_info(app_id, notification_id)
|
766
766
|
|
767
767
|
```ruby
|
768
768
|
begin
|
@@ -770,7 +770,7 @@ begin
|
|
770
770
|
data, status_code, headers = api_instance.get_notification_with_http_info(app_id, notification_id)
|
771
771
|
p status_code # => 2xx
|
772
772
|
p headers # => { ... }
|
773
|
-
p data # => <
|
773
|
+
p data # => <NotificationWithMeta>
|
774
774
|
rescue OneSignal::ApiError => e
|
775
775
|
puts "Error when calling DefaultApi->get_notification_with_http_info: #{e}"
|
776
776
|
end
|
@@ -785,7 +785,7 @@ end
|
|
785
785
|
|
786
786
|
### Return type
|
787
787
|
|
788
|
-
[**
|
788
|
+
[**NotificationWithMeta**](NotificationWithMeta.md)
|
789
789
|
|
790
790
|
### Authorization
|
791
791
|
|
@@ -803,17 +803,17 @@ end
|
|
803
803
|
|
804
804
|
Notification History
|
805
805
|
|
806
|
-
-> View the devices sent a message - OneSignal Paid Plan Required This method will return all devices that were sent the given notification_id of an Email or Push Notification if used within 7 days of the date sent. After 7 days of the sending date, the message history data will be unavailable. After a successful response is received, the destination url may be polled until the file becomes available. Most exports are done in ~1-3 minutes, so setting a poll interval of 10 seconds should be adequate. For use cases that are not meant to be consumed by a script, an email will be sent to the supplied email address.
|
806
|
+
-> View the devices sent a message - OneSignal Paid Plan Required This method will return all devices that were sent the given notification_id of an Email or Push Notification if used within 7 days of the date sent. After 7 days of the sending date, the message history data will be unavailable. After a successful response is received, the destination url may be polled until the file becomes available. Most exports are done in ~1-3 minutes, so setting a poll interval of 10 seconds should be adequate. For use cases that are not meant to be consumed by a script, an email will be sent to the supplied email address. 🚧 Requirements A OneSignal Paid Plan. Turn on Send History via OneSignal API in Settings -> Analytics. Cannot get data before this was turned on. Must be called within 7 days after sending the message. Messages targeting under 1000 recipients will not have \"sent\" events recorded, but will show \"clicked\" events. Requires your OneSignal App's REST API Key, available in Keys & IDs.
|
807
807
|
|
808
808
|
### Examples
|
809
809
|
|
810
810
|
```ruby
|
811
|
-
require 'time'
|
812
811
|
require 'onesignal'
|
813
812
|
# setup authorization
|
814
813
|
OneSignal.configure do |config|
|
815
814
|
# Configure Bearer authorization: app_key
|
816
|
-
config.
|
815
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
816
|
+
|
817
817
|
end
|
818
818
|
|
819
819
|
api_instance = OneSignal::DefaultApi.new
|
@@ -879,18 +879,18 @@ View the details of multiple notifications
|
|
879
879
|
### Examples
|
880
880
|
|
881
881
|
```ruby
|
882
|
-
require 'time'
|
883
882
|
require 'onesignal'
|
884
883
|
# setup authorization
|
885
884
|
OneSignal.configure do |config|
|
886
885
|
# Configure Bearer authorization: app_key
|
887
|
-
config.
|
886
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
887
|
+
|
888
888
|
end
|
889
889
|
|
890
890
|
api_instance = OneSignal::DefaultApi.new
|
891
891
|
app_id = 'app_id_example' # String | The app ID that you want to view notifications from
|
892
892
|
opts = {
|
893
|
-
limit:
|
893
|
+
limit: 56, # Integer | How many notifications to return. Max is 50. Default is 50.
|
894
894
|
offset: 56, # Integer | Page offset. Default is 0. Results are sorted by queued_at in descending order. queued_at is a representation of the time that the notification was queued at.
|
895
895
|
kind: 0 # Integer | Kind of notifications returned: * unset - All notification types (default) * `0` - Dashboard only * `1` - API only * `3` - Automated only
|
896
896
|
}
|
@@ -927,7 +927,7 @@ end
|
|
927
927
|
| Name | Type | Description | Notes |
|
928
928
|
| ---- | ---- | ----------- | ----- |
|
929
929
|
| **app_id** | **String** | The app ID that you want to view notifications from | |
|
930
|
-
| **limit** | **
|
930
|
+
| **limit** | **Integer** | How many notifications to return. Max is 50. Default is 50. | [optional] |
|
931
931
|
| **offset** | **Integer** | Page offset. Default is 0. Results are sorted by queued_at in descending order. queued_at is a representation of the time that the notification was queued at. | [optional] |
|
932
932
|
| **kind** | **Integer** | Kind of notifications returned: * unset - All notification types (default) * `0` - Dashboard only * `1` - API only * `3` - Automated only | [optional] |
|
933
933
|
|
@@ -947,28 +947,28 @@ end
|
|
947
947
|
|
948
948
|
## get_outcomes
|
949
949
|
|
950
|
-
> <
|
950
|
+
> <OutcomesData> get_outcomes(app_id, outcome_names, opts)
|
951
951
|
|
952
952
|
View Outcomes
|
953
953
|
|
954
|
-
View the details of all the outcomes associated with your app
|
954
|
+
View the details of all the outcomes associated with your app 🚧 Requires Authentication Key Requires your OneSignal App's REST API Key, available in Keys & IDs. 🚧 Outcome Data Limitations Outcomes are only accessible for around 30 days before deleted from our servers. You will need to export this data every month if you want to keep it.
|
955
955
|
|
956
956
|
### Examples
|
957
957
|
|
958
958
|
```ruby
|
959
|
-
require 'time'
|
960
959
|
require 'onesignal'
|
961
960
|
# setup authorization
|
962
961
|
OneSignal.configure do |config|
|
963
962
|
# Configure Bearer authorization: app_key
|
964
|
-
config.
|
963
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
964
|
+
|
965
965
|
end
|
966
966
|
|
967
967
|
api_instance = OneSignal::DefaultApi.new
|
968
968
|
app_id = 'app_id_example' # String | The OneSignal App ID for your app. Available in Keys & IDs.
|
969
|
-
outcome_names = 'outcome_names_example' # String | Required Comma-separated list of names and the value (sum/count) for the returned outcome data. Note: Clicks only support count aggregation. For out-of-the-box OneSignal outcomes such as click and session duration, please use the
|
969
|
+
outcome_names = 'outcome_names_example' # String | Required Comma-separated list of names and the value (sum/count) for the returned outcome data. Note: Clicks only support count aggregation. For out-of-the-box OneSignal outcomes such as click and session duration, please use the \"os\" prefix with two underscores. For other outcomes, please use the name specified by the user. Example:os__session_duration.count,os__click.count,CustomOutcomeName.sum
|
970
970
|
opts = {
|
971
|
-
outcome_names2: 'outcome_names_example', # String | Optional If outcome names contain any commas, then please specify only one value at a time. Example: outcome_names[]=os__click.count&outcome_names[]=Sales, Purchase.count where
|
971
|
+
outcome_names2: 'outcome_names_example', # String | Optional If outcome names contain any commas, then please specify only one value at a time. Example: outcome_names[]=os__click.count&outcome_names[]=Sales, Purchase.count where \"Sales, Purchase\" is the custom outcomes with a comma in the name.
|
972
972
|
outcome_time_range: 'outcome_time_range_example', # String | Optional Time range for the returned data. The values can be 1h (for the last 1 hour data), 1d (for the last 1 day data), or 1mo (for the last 1 month data). Default is 1h if the parameter is omitted.
|
973
973
|
outcome_platforms: 'outcome_platforms_example', # String | Optional Platform id. Refer device's platform ids for values. Example: outcome_platform=0 for iOS outcome_platform=7,8 for Safari and Firefox Default is data from all platforms if the parameter is omitted.
|
974
974
|
outcome_attribution: 'outcome_attribution_example' # String | Optional Attribution type for the outcomes. The values can be direct or influenced or unattributed. Example: outcome_attribution=direct Default is total (returns direct+influenced+unattributed) if the parameter is omitted.
|
@@ -987,7 +987,7 @@ end
|
|
987
987
|
|
988
988
|
This returns an Array which contains the response data, status code and headers.
|
989
989
|
|
990
|
-
> <Array(<
|
990
|
+
> <Array(<OutcomesData>, Integer, Hash)> get_outcomes_with_http_info(app_id, outcome_names, opts)
|
991
991
|
|
992
992
|
```ruby
|
993
993
|
begin
|
@@ -995,7 +995,7 @@ begin
|
|
995
995
|
data, status_code, headers = api_instance.get_outcomes_with_http_info(app_id, outcome_names, opts)
|
996
996
|
p status_code # => 2xx
|
997
997
|
p headers # => { ... }
|
998
|
-
p data # => <
|
998
|
+
p data # => <OutcomesData>
|
999
999
|
rescue OneSignal::ApiError => e
|
1000
1000
|
puts "Error when calling DefaultApi->get_outcomes_with_http_info: #{e}"
|
1001
1001
|
end
|
@@ -1006,15 +1006,15 @@ end
|
|
1006
1006
|
| Name | Type | Description | Notes |
|
1007
1007
|
| ---- | ---- | ----------- | ----- |
|
1008
1008
|
| **app_id** | **String** | The OneSignal App ID for your app. Available in Keys & IDs. | |
|
1009
|
-
| **outcome_names** | **String** | Required Comma-separated list of names and the value (sum/count) for the returned outcome data. Note: Clicks only support count aggregation. For out-of-the-box OneSignal outcomes such as click and session duration, please use the
|
1010
|
-
| **outcome_names2** | **String** | Optional If outcome names contain any commas, then please specify only one value at a time. Example: outcome_names[]=os__click.count&outcome_names[]=Sales, Purchase.count where
|
1009
|
+
| **outcome_names** | **String** | Required Comma-separated list of names and the value (sum/count) for the returned outcome data. Note: Clicks only support count aggregation. For out-of-the-box OneSignal outcomes such as click and session duration, please use the \"os\" prefix with two underscores. For other outcomes, please use the name specified by the user. Example:os__session_duration.count,os__click.count,CustomOutcomeName.sum | |
|
1010
|
+
| **outcome_names2** | **String** | Optional If outcome names contain any commas, then please specify only one value at a time. Example: outcome_names[]=os__click.count&outcome_names[]=Sales, Purchase.count where \"Sales, Purchase\" is the custom outcomes with a comma in the name. | [optional] |
|
1011
1011
|
| **outcome_time_range** | **String** | Optional Time range for the returned data. The values can be 1h (for the last 1 hour data), 1d (for the last 1 day data), or 1mo (for the last 1 month data). Default is 1h if the parameter is omitted. | [optional] |
|
1012
1012
|
| **outcome_platforms** | **String** | Optional Platform id. Refer device's platform ids for values. Example: outcome_platform=0 for iOS outcome_platform=7,8 for Safari and Firefox Default is data from all platforms if the parameter is omitted. | [optional] |
|
1013
1013
|
| **outcome_attribution** | **String** | Optional Attribution type for the outcomes. The values can be direct or influenced or unattributed. Example: outcome_attribution=direct Default is total (returns direct+influenced+unattributed) if the parameter is omitted. | [optional] |
|
1014
1014
|
|
1015
1015
|
### Return type
|
1016
1016
|
|
1017
|
-
[**
|
1017
|
+
[**OutcomesData**](OutcomesData.md)
|
1018
1018
|
|
1019
1019
|
### Authorization
|
1020
1020
|
|
@@ -1037,12 +1037,12 @@ View the details of an existing device in one of your OneSignal apps
|
|
1037
1037
|
### Examples
|
1038
1038
|
|
1039
1039
|
```ruby
|
1040
|
-
require 'time'
|
1041
1040
|
require 'onesignal'
|
1042
1041
|
# setup authorization
|
1043
1042
|
OneSignal.configure do |config|
|
1044
1043
|
# Configure Bearer authorization: app_key
|
1045
|
-
config.
|
1044
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
1045
|
+
|
1046
1046
|
end
|
1047
1047
|
|
1048
1048
|
api_instance = OneSignal::DefaultApi.new
|
@@ -1112,18 +1112,18 @@ View the details of multiple devices in one of your OneSignal apps Unavailable f
|
|
1112
1112
|
### Examples
|
1113
1113
|
|
1114
1114
|
```ruby
|
1115
|
-
require 'time'
|
1116
1115
|
require 'onesignal'
|
1117
1116
|
# setup authorization
|
1118
1117
|
OneSignal.configure do |config|
|
1119
1118
|
# Configure Bearer authorization: app_key
|
1120
|
-
config.
|
1119
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
1120
|
+
|
1121
1121
|
end
|
1122
1122
|
|
1123
1123
|
api_instance = OneSignal::DefaultApi.new
|
1124
1124
|
app_id = 'app_id_example' # String | The app ID that you want to view players from
|
1125
1125
|
opts = {
|
1126
|
-
limit:
|
1126
|
+
limit: 56, # Integer | How many devices to return. Max is 300. Default is 300
|
1127
1127
|
offset: 56 # Integer | Result offset. Default is 0. Results are sorted by id;
|
1128
1128
|
}
|
1129
1129
|
|
@@ -1159,7 +1159,7 @@ end
|
|
1159
1159
|
| Name | Type | Description | Notes |
|
1160
1160
|
| ---- | ---- | ----------- | ----- |
|
1161
1161
|
| **app_id** | **String** | The app ID that you want to view players from | |
|
1162
|
-
| **limit** | **
|
1162
|
+
| **limit** | **Integer** | How many devices to return. Max is 300. Default is 300 | [optional] |
|
1163
1163
|
| **offset** | **Integer** | Result offset. Default is 0. Results are sorted by id; | [optional] |
|
1164
1164
|
|
1165
1165
|
### Return type
|
@@ -1187,12 +1187,12 @@ Updates the name or configuration settings of an existing OneSignal app
|
|
1187
1187
|
### Examples
|
1188
1188
|
|
1189
1189
|
```ruby
|
1190
|
-
require 'time'
|
1191
1190
|
require 'onesignal'
|
1192
1191
|
# setup authorization
|
1193
1192
|
OneSignal.configure do |config|
|
1194
1193
|
# Configure Bearer authorization: user_key
|
1195
|
-
config.
|
1194
|
+
config.user_key = 'YOUR_BEARER_TOKEN'
|
1195
|
+
|
1196
1196
|
end
|
1197
1197
|
|
1198
1198
|
api_instance = OneSignal::DefaultApi.new
|
@@ -1258,17 +1258,17 @@ Update an existing device in one of your OneSignal apps
|
|
1258
1258
|
### Examples
|
1259
1259
|
|
1260
1260
|
```ruby
|
1261
|
-
require 'time'
|
1262
1261
|
require 'onesignal'
|
1263
1262
|
# setup authorization
|
1264
1263
|
OneSignal.configure do |config|
|
1265
1264
|
# Configure Bearer authorization: app_key
|
1266
|
-
config.
|
1265
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
1266
|
+
|
1267
1267
|
end
|
1268
1268
|
|
1269
1269
|
api_instance = OneSignal::DefaultApi.new
|
1270
1270
|
player_id = 'player_id_example' # String | Player's OneSignal ID
|
1271
|
-
player = OneSignal::Player.new({id: 'id_example',
|
1271
|
+
player = OneSignal::Player.new({id: 'id_example', device_type: 37}) # Player |
|
1272
1272
|
|
1273
1273
|
begin
|
1274
1274
|
# Edit device
|
@@ -1320,21 +1320,21 @@ end
|
|
1320
1320
|
|
1321
1321
|
## update_player_tags
|
1322
1322
|
|
1323
|
-
> <
|
1323
|
+
> <InlineResponse2001> update_player_tags(app_id, external_user_id, opts)
|
1324
1324
|
|
1325
1325
|
Edit tags with external user id
|
1326
1326
|
|
1327
|
-
Update an existing device's tags in one of your OneSignal apps using the External User ID. Warning - Android SDK Data Synchronization Tags added through the Android SDK tagging methods may not update if using the API to change or update the same tag. For example, if you use SDK method sendTag(\"key\", \"value1\") then update the tag value to \"value2\" with this API endpoint. You will not be able to set the value back to \"value1\" through the SDK, you will need to change it to something different through the SDK to be reset. Recommendations if using this Endpoint on Android Mobile Apps: 1 - Do not use the same tag keys for SDK and API updates 2 - If you want to use the same key for both SDK and API updates, call the SDK getTags method first to update the device's tags. This is only applicable on the Android Mobile App SDKs.
|
1327
|
+
Update an existing device's tags in one of your OneSignal apps using the External User ID. Warning - Android SDK Data Synchronization Tags added through the Android SDK tagging methods may not update if using the API to change or update the same tag. For example, if you use SDK method sendTag(\"key\", \"value1\") then update the tag value to \"value2\" with this API endpoint. You will not be able to set the value back to \"value1\" through the SDK, you will need to change it to something different through the SDK to be reset. Recommendations if using this Endpoint on Android Mobile Apps: 1 - Do not use the same tag keys for SDK and API updates 2 - If you want to use the same key for both SDK and API updates, call the SDK getTags method first to update the device's tags. This is only applicable on the Android Mobile App SDKs. 📘 Deleting Tags To delete a tag, include its key and set its value to blank. Omitting a key/value will not delete it. For example, if I wanted to delete two existing tags rank and category while simultaneously adding a new tag class, the tags JSON would look like the following: \"tags\": { \"rank\": \"\", \"category\": \"\", \"class\": \"my_new_value\" }
|
1328
1328
|
|
1329
1329
|
### Examples
|
1330
1330
|
|
1331
1331
|
```ruby
|
1332
|
-
require 'time'
|
1333
1332
|
require 'onesignal'
|
1334
1333
|
# setup authorization
|
1335
1334
|
OneSignal.configure do |config|
|
1336
1335
|
# Configure Bearer authorization: app_key
|
1337
|
-
config.
|
1336
|
+
config.app_key = 'YOUR_BEARER_TOKEN'
|
1337
|
+
|
1338
1338
|
end
|
1339
1339
|
|
1340
1340
|
api_instance = OneSignal::DefaultApi.new
|
@@ -1357,7 +1357,7 @@ end
|
|
1357
1357
|
|
1358
1358
|
This returns an Array which contains the response data, status code and headers.
|
1359
1359
|
|
1360
|
-
> <Array(<
|
1360
|
+
> <Array(<InlineResponse2001>, Integer, Hash)> update_player_tags_with_http_info(app_id, external_user_id, opts)
|
1361
1361
|
|
1362
1362
|
```ruby
|
1363
1363
|
begin
|
@@ -1365,7 +1365,7 @@ begin
|
|
1365
1365
|
data, status_code, headers = api_instance.update_player_tags_with_http_info(app_id, external_user_id, opts)
|
1366
1366
|
p status_code # => 2xx
|
1367
1367
|
p headers # => { ... }
|
1368
|
-
p data # => <
|
1368
|
+
p data # => <InlineResponse2001>
|
1369
1369
|
rescue OneSignal::ApiError => e
|
1370
1370
|
puts "Error when calling DefaultApi->update_player_tags_with_http_info: #{e}"
|
1371
1371
|
end
|
@@ -1381,7 +1381,7 @@ end
|
|
1381
1381
|
|
1382
1382
|
### Return type
|
1383
1383
|
|
1384
|
-
[**
|
1384
|
+
[**InlineResponse2001**](InlineResponse2001.md)
|
1385
1385
|
|
1386
1386
|
### Authorization
|
1387
1387
|
|
data/docs/InlineResponse200.md
CHANGED
@@ -7,7 +7,7 @@
|
|
7
7
|
| **id** | **String** | | |
|
8
8
|
| **recipients** | **Integer** | Estimated number of subscribers targetted by notification. | |
|
9
9
|
| **external_id** | **String** | | [optional] |
|
10
|
-
| **errors** | [**
|
10
|
+
| **errors** | [**Notification200Errors**](Notification200Errors.md) | | [optional] |
|
11
11
|
|
12
12
|
## Example
|
13
13
|
|