onesignal 5.17.0 → 5.18.0
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +7 -0
- data/Gemfile.lock +2 -2
- data/README.md +3 -3
- data/docs/DefaultApi.md +192 -20
- data/docs/EmailMetrics.md +34 -0
- data/docs/EmailProviderMetrics.md +20 -0
- data/docs/EmailProviderMetricsEvent.md +20 -0
- data/docs/EmailProviderMetricsResponse.md +18 -0
- data/docs/EmailProviderMetricsTimeseriesResponse.md +18 -0
- data/lib/onesignal/api/default_api.rb +183 -0
- data/lib/onesignal/api_client.rb +24 -1
- data/lib/onesignal/configuration.rb +4 -2
- data/lib/onesignal/models/email_metrics.rb +300 -0
- data/lib/onesignal/models/email_provider_metrics.rb +229 -0
- data/lib/onesignal/models/email_provider_metrics_event.rb +229 -0
- data/lib/onesignal/models/email_provider_metrics_response.rb +222 -0
- data/lib/onesignal/models/email_provider_metrics_timeseries_response.rb +222 -0
- data/lib/onesignal/version.rb +1 -1
- data/lib/onesignal.rb +5 -0
- data/spec/api/default_api_spec.rb +32 -0
- data/spec/api_client_spec.rb +6 -6
- data/spec/models/email_metrics_spec.rb +81 -0
- data/spec/models/email_provider_metrics_event_spec.rb +39 -0
- data/spec/models/email_provider_metrics_response_spec.rb +33 -0
- data/spec/models/email_provider_metrics_spec.rb +39 -0
- data/spec/models/email_provider_metrics_timeseries_response_spec.rb +33 -0
- data/vendor/bundle/ruby/3.2.0/cache/date-3.6.0.gem +0 -0
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/byebug-13.0.0/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/date-3.6.0/date_core.so +0 -0
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/date-3.6.0/gem_make.out +26 -0
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/{date-3.5.1 → date-3.6.0}/mkmf.log +55 -2
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/io-console-0.9.4/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/io-console-0.9.4/mkmf.log +3 -3
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/jaro_winkler-1.5.6/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/psych-5.5.0/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/racc-1.8.1/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/stringio-3.2.0/gem_make.out +5 -5
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/Makefile +1 -1
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/date_core.c +293 -77
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/date_parse.c +14 -4
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/date_strptime.c +13 -13
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/extconf.rb +6 -0
- data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/lib/date.rb +1 -1
- data/vendor/bundle/ruby/3.2.0/gems/date-3.6.0/lib/date_core.so +0 -0
- data/vendor/bundle/ruby/3.2.0/specifications/{date-3.5.1.gemspec → date-3.6.0.gemspec} +3 -3
- metadata +43 -23
- data/vendor/bundle/ruby/3.2.0/cache/date-3.5.1.gem +0 -0
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/date-3.5.1/date_core.so +0 -0
- data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/date-3.5.1/gem_make.out +0 -24
- data/vendor/bundle/ruby/3.2.0/gems/date-3.5.1/lib/date_core.so +0 -0
- /data/vendor/bundle/ruby/3.2.0/extensions/x86_64-linux/3.2.0/{date-3.5.1 → date-3.6.0}/gem.build_complete +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/BSDL +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/COPYING +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/README.md +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/date_strftime.c +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/date_tmx.h +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/prereq.mk +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/zonetab.h +0 -0
- /data/vendor/bundle/ruby/3.2.0/gems/{date-3.5.1 → date-3.6.0}/ext/date/zonetab.list +0 -0
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 3f913f0ad3fb26a447ee94a14fdc02d6c2b539e20a226664cbac357b81dd7857
|
|
4
|
+
data.tar.gz: 2cf7a7de8f23c4630c7c7797dbbe7dc2a40cc9f64633324ef9be01e894ac895c
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: b0103aa968b00d7757ca8dbb3a29c5b2ac66b7d4133397bbd294cdb290db0c441d433204392a6eb32995620190079b14ceac5f0ef348ac2f9b9ec5ae6d40c64d
|
|
7
|
+
data.tar.gz: 5abe54075e9d9bfb8dfbef376a38bdae885d0083e8b34f9899050ec84e22d681b3dd03e1c9f766dbca4329965b8dd05349789609faff2b66b8a3e92be7f1cdc7
|
data/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [5.17.0](https://github.com/OneSignal/onesignal-ruby-api/compare/v5.16.0...v5.17.0) (2026-10-02)
|
|
4
|
+
|
|
5
|
+
### Features
|
|
6
|
+
|
|
7
|
+
* add v5.17.0 package updates ([aad9aa7](https://github.com/OneSignal/onesignal-ruby-api/commit/aad9aa71252c6f42c47cde91f4dcf5820fa25b56))
|
|
8
|
+
* add v5.17.0 package updates ([#135](https://github.com/OneSignal/onesignal-ruby-api/issues/135)) ([34cbe92](https://github.com/OneSignal/onesignal-ruby-api/commit/34cbe92a91f2b20feba25e92cb40d26b4558d343)), closes [OneSignal/api-client-libraries#468](https://github.com/OneSignal/api-client-libraries/issues/468) [OneSignal/api-client-libraries#469](https://github.com/OneSignal/api-client-libraries/issues/469) [OneSignal/api-client-libraries#470](https://github.com/OneSignal/api-client-libraries/issues/470)
|
|
9
|
+
|
|
3
10
|
## [5.16.0](https://github.com/OneSignal/onesignal-ruby-api/compare/v5.15.0...v5.16.0) (2026-09-09)
|
|
4
11
|
|
|
5
12
|
### Features
|
data/Gemfile.lock
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
PATH
|
|
2
2
|
remote: .
|
|
3
3
|
specs:
|
|
4
|
-
onesignal (5.
|
|
4
|
+
onesignal (5.18.0)
|
|
5
5
|
typhoeus (~> 1.0, >= 1.0.1)
|
|
6
6
|
|
|
7
7
|
GEM
|
|
@@ -11,7 +11,7 @@ GEM
|
|
|
11
11
|
byebug (13.0.0)
|
|
12
12
|
reline (>= 0.6.0)
|
|
13
13
|
coderay (1.1.3)
|
|
14
|
-
date (3.
|
|
14
|
+
date (3.6.0)
|
|
15
15
|
diff-lcs (1.6.2)
|
|
16
16
|
ethon (0.18.0)
|
|
17
17
|
ffi (>= 1.15.0)
|
data/README.md
CHANGED
|
@@ -6,15 +6,15 @@ OneSignal - the Ruby gem for OneSignal
|
|
|
6
6
|
|
|
7
7
|
A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
|
|
8
8
|
|
|
9
|
-
- API version: 5.
|
|
10
|
-
- Package version: 5.
|
|
9
|
+
- API version: 5.18.0
|
|
10
|
+
- Package version: 5.18.0
|
|
11
11
|
|
|
12
12
|
## Installation
|
|
13
13
|
|
|
14
14
|
Add to your `Gemfile`:
|
|
15
15
|
|
|
16
16
|
```ruby
|
|
17
|
-
gem 'onesignal', '~> 5.
|
|
17
|
+
gem 'onesignal', '~> 5.18.0'
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
Then run `bundle install`.
|
data/docs/DefaultApi.md
CHANGED
|
@@ -32,6 +32,8 @@ All URIs are relative to *https://api.onesignal.com*
|
|
|
32
32
|
| [**get_aliases_by_subscription**](DefaultApi.md#get_aliases_by_subscription) | **GET** /apps/{app_id}/subscriptions/{subscription_id}/user/identity | |
|
|
33
33
|
| [**get_app**](DefaultApi.md#get_app) | **GET** /apps/{app_id} | View an app |
|
|
34
34
|
| [**get_apps**](DefaultApi.md#get_apps) | **GET** /apps | View apps |
|
|
35
|
+
| [**get_email_provider_metrics**](DefaultApi.md#get_email_provider_metrics) | **GET** /apps/{app_id}/email_analytics/provider_metrics | Get email inbox provider metrics |
|
|
36
|
+
| [**get_email_provider_metrics_timeseries**](DefaultApi.md#get_email_provider_metrics_timeseries) | **GET** /apps/{app_id}/email_analytics/provider_metrics_timeseries | Get email inbox provider metrics over time |
|
|
35
37
|
| [**get_email_reputation**](DefaultApi.md#get_email_reputation) | **GET** /apps/{app_id}/email_analytics/delivery_metrics | Get email reputation statistics |
|
|
36
38
|
| [**get_notification**](DefaultApi.md#get_notification) | **GET** /notifications/{notification_id} | View notification |
|
|
37
39
|
| [**get_notification_history**](DefaultApi.md#get_notification_history) | **POST** /notifications/{notification_id}/history | Notification History |
|
|
@@ -198,7 +200,7 @@ end
|
|
|
198
200
|
api_instance = OneSignal::DefaultApi.new
|
|
199
201
|
template_id = 'e4d3c2b1-a09f-4f1e-8d7c-6b5a4f3e2d1c' # String |
|
|
200
202
|
app_id = 'YOUR_APP_ID' # String |
|
|
201
|
-
copy_template_request = OneSignal::CopyTemplateRequest.new({target_app_id: '
|
|
203
|
+
copy_template_request = OneSignal::CopyTemplateRequest.new({target_app_id: 'YOUR_TARGET_APP_ID'}) # CopyTemplateRequest |
|
|
202
204
|
|
|
203
205
|
begin
|
|
204
206
|
# Copy template to another app
|
|
@@ -593,7 +595,7 @@ end
|
|
|
593
595
|
|
|
594
596
|
api_instance = OneSignal::DefaultApi.new
|
|
595
597
|
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
596
|
-
custom_events_request = OneSignal::CustomEventsRequest.new({events: [OneSignal::CustomEvent.new({name: '
|
|
598
|
+
custom_events_request = OneSignal::CustomEventsRequest.new({events: [OneSignal::CustomEvent.new({name: 'YOUR_NAME'})]}) # CustomEventsRequest |
|
|
597
599
|
|
|
598
600
|
begin
|
|
599
601
|
# Create custom events
|
|
@@ -671,7 +673,7 @@ end
|
|
|
671
673
|
|
|
672
674
|
api_instance = OneSignal::DefaultApi.new
|
|
673
675
|
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
674
|
-
create_journey_request = OneSignal::CreateJourneyRequest.new({name: '
|
|
676
|
+
create_journey_request = OneSignal::CreateJourneyRequest.new({name: 'YOUR_NAME'}) # CreateJourneyRequest |
|
|
675
677
|
|
|
676
678
|
begin
|
|
677
679
|
# Create journey
|
|
@@ -1044,7 +1046,7 @@ OneSignal.configure do |config|
|
|
|
1044
1046
|
end
|
|
1045
1047
|
|
|
1046
1048
|
api_instance = OneSignal::DefaultApi.new
|
|
1047
|
-
create_template_request = OneSignal::CreateTemplateRequest.new({app_id: '
|
|
1049
|
+
create_template_request = OneSignal::CreateTemplateRequest.new({app_id: 'YOUR_APP_ID', name: 'YOUR_NAME', contents: OneSignal::LanguageStringMap.new}) # CreateTemplateRequest |
|
|
1048
1050
|
|
|
1049
1051
|
begin
|
|
1050
1052
|
# Create template
|
|
@@ -1842,7 +1844,7 @@ OneSignal.configure do |config|
|
|
|
1842
1844
|
end
|
|
1843
1845
|
|
|
1844
1846
|
api_instance = OneSignal::DefaultApi.new
|
|
1845
|
-
estimate_notification_recipients_request = OneSignal::EstimateNotificationRecipientsRequest.new({app_id: '
|
|
1847
|
+
estimate_notification_recipients_request = OneSignal::EstimateNotificationRecipientsRequest.new({app_id: 'YOUR_APP_ID'}) # EstimateNotificationRecipientsRequest |
|
|
1846
1848
|
|
|
1847
1849
|
begin
|
|
1848
1850
|
# Estimate notification recipients
|
|
@@ -2363,6 +2365,176 @@ This endpoint does not need any parameter.
|
|
|
2363
2365
|
- **Accept**: application/json
|
|
2364
2366
|
|
|
2365
2367
|
|
|
2368
|
+
## get_email_provider_metrics
|
|
2369
|
+
|
|
2370
|
+
> <EmailProviderMetricsResponse> get_email_provider_metrics(app_id, domain, start, _end)
|
|
2371
|
+
|
|
2372
|
+
Get email inbox provider metrics
|
|
2373
|
+
|
|
2374
|
+
Email delivery, opens, clicks, bounces, failures, and spam complaints broken down by inbox provider (Gmail, Outlook, Yahoo, Apple, and more) to pinpoint where deliverability problems are coming from. Metrics are reported for a single sending domain over the requested time range. `start` must be before `end` and no more than 365 days ago. `providers` is empty when the domain is not found for the app or is not currently active for sending.
|
|
2375
|
+
|
|
2376
|
+
### Examples
|
|
2377
|
+
|
|
2378
|
+
```ruby
|
|
2379
|
+
require 'onesignal'
|
|
2380
|
+
# setup authorization
|
|
2381
|
+
OneSignal.configure do |config|
|
|
2382
|
+
# Configure Bearer authorization: rest_api_key
|
|
2383
|
+
config.rest_api_key = 'YOUR_REST_API_KEY'
|
|
2384
|
+
|
|
2385
|
+
end
|
|
2386
|
+
|
|
2387
|
+
api_instance = OneSignal::DefaultApi.new
|
|
2388
|
+
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
2389
|
+
domain = 'mail.example.com' # String | The sending domain to report on. Must be an email domain configured for this app.
|
|
2390
|
+
start = Time.parse('2026-08-01T00:00Z') # Time | Start of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-01T00:00:00Z`).
|
|
2391
|
+
_end = Time.parse('2026-08-08T00:00Z') # Time | End of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-08T00:00:00Z`).
|
|
2392
|
+
|
|
2393
|
+
begin
|
|
2394
|
+
# Get email inbox provider metrics
|
|
2395
|
+
result = api_instance.get_email_provider_metrics(app_id, domain, start, _end)
|
|
2396
|
+
p result
|
|
2397
|
+
rescue OneSignal::ApiError => e
|
|
2398
|
+
puts "Error when calling DefaultApi->get_email_provider_metrics: #{e}"
|
|
2399
|
+
puts "Status Code: #{e.code}"
|
|
2400
|
+
# `e.error_messages` flattens any error-envelope shape to an Array<String>;
|
|
2401
|
+
# the raw body remains on `e.response_body`.
|
|
2402
|
+
puts "Error Messages: #{e.error_messages}"
|
|
2403
|
+
puts "Response Body: #{e.response_body}"
|
|
2404
|
+
end
|
|
2405
|
+
```
|
|
2406
|
+
|
|
2407
|
+
#### Using the get_email_provider_metrics_with_http_info variant
|
|
2408
|
+
|
|
2409
|
+
This returns an Array which contains the response data, status code and headers.
|
|
2410
|
+
|
|
2411
|
+
> <Array(<EmailProviderMetricsResponse>, Integer, Hash)> get_email_provider_metrics_with_http_info(app_id, domain, start, _end)
|
|
2412
|
+
|
|
2413
|
+
```ruby
|
|
2414
|
+
begin
|
|
2415
|
+
# Get email inbox provider metrics
|
|
2416
|
+
data, status_code, headers = api_instance.get_email_provider_metrics_with_http_info(app_id, domain, start, _end)
|
|
2417
|
+
p status_code # => 2xx
|
|
2418
|
+
p headers # => { ... }
|
|
2419
|
+
p data # => <EmailProviderMetricsResponse>
|
|
2420
|
+
rescue OneSignal::ApiError => e
|
|
2421
|
+
puts "Error when calling DefaultApi->get_email_provider_metrics_with_http_info: #{e}"
|
|
2422
|
+
puts "Status Code: #{e.code}"
|
|
2423
|
+
puts "Response Body: #{e.response_body}"
|
|
2424
|
+
end
|
|
2425
|
+
```
|
|
2426
|
+
|
|
2427
|
+
### Parameters
|
|
2428
|
+
|
|
2429
|
+
| Name | Type | Description | Notes |
|
|
2430
|
+
| ---- | ---- | ----------- | ----- |
|
|
2431
|
+
| **app_id** | **String** | Your OneSignal App ID in UUID v4 format. | |
|
|
2432
|
+
| **domain** | **String** | The sending domain to report on. Must be an email domain configured for this app. | |
|
|
2433
|
+
| **start** | **Time** | Start of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-01T00:00:00Z`). | |
|
|
2434
|
+
| **_end** | **Time** | End of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-08T00:00:00Z`). | |
|
|
2435
|
+
|
|
2436
|
+
### Return type
|
|
2437
|
+
|
|
2438
|
+
[**EmailProviderMetricsResponse**](EmailProviderMetricsResponse.md)
|
|
2439
|
+
|
|
2440
|
+
### Authorization
|
|
2441
|
+
|
|
2442
|
+
[rest_api_key](https://github.com/OneSignal/onesignal-ruby-api#configuration)
|
|
2443
|
+
|
|
2444
|
+
### HTTP request headers
|
|
2445
|
+
|
|
2446
|
+
- **Content-Type**: Not defined
|
|
2447
|
+
- **Accept**: application/json
|
|
2448
|
+
|
|
2449
|
+
|
|
2450
|
+
## get_email_provider_metrics_timeseries
|
|
2451
|
+
|
|
2452
|
+
> <EmailProviderMetricsTimeseriesResponse> get_email_provider_metrics_timeseries(app_id, domain, start, _end, granularity, opts)
|
|
2453
|
+
|
|
2454
|
+
Get email inbox provider metrics over time
|
|
2455
|
+
|
|
2456
|
+
Email delivery, opens, clicks, bounces, failures, and spam complaints for a sending domain over time, bucketed by hour, day, or month. Use `providers[]` to narrow the totals to specific inbox providers (Gmail, Outlook, Yahoo, Apple, and more) and track how deliverability to them changes. Each event's metrics are totaled across the requested providers, or across all providers when none are given. `start` must be before `end` and no more than 365 days ago, or 60 days ago for `hourly` granularity. `events` is empty when the domain is not found for the app or is not currently active for sending.
|
|
2457
|
+
|
|
2458
|
+
### Examples
|
|
2459
|
+
|
|
2460
|
+
```ruby
|
|
2461
|
+
require 'onesignal'
|
|
2462
|
+
# setup authorization
|
|
2463
|
+
OneSignal.configure do |config|
|
|
2464
|
+
# Configure Bearer authorization: rest_api_key
|
|
2465
|
+
config.rest_api_key = 'YOUR_REST_API_KEY'
|
|
2466
|
+
|
|
2467
|
+
end
|
|
2468
|
+
|
|
2469
|
+
api_instance = OneSignal::DefaultApi.new
|
|
2470
|
+
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
2471
|
+
domain = 'mail.example.com' # String | The sending domain to report on. Must be an email domain configured for this app.
|
|
2472
|
+
start = Time.parse('2026-08-01T00:00Z') # Time | Start of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-01T00:00:00Z`).
|
|
2473
|
+
_end = Time.parse('2026-08-08T00:00Z') # Time | End of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-08T00:00:00Z`).
|
|
2474
|
+
granularity = 'hourly' # String | The size of each time bucket. Hourly data is only available for the last 60 days.
|
|
2475
|
+
opts = {
|
|
2476
|
+
providers: ['gmail'] # Array<String> | Inbox providers to include in the totals. Omit to include all providers. Accepted values: `apple`, `att`, `canadian`, `chinese`, `comcast`, `free_fr`, `french`, `german`, `gmail`, `google_workspace`, `googlers`, `inbox_lv`, `italian`, `japanese`, `outlook_365`, `outlook_eu`, `outlook_us`, `proton`, `rackspace`, `russian`, `uk`, `united_online`, `yahoo_eu`, `yahoo_us`, `other_eu`, `other_us`, and `other`. Example: providers[]=gmail&providers[]=yahoo_us
|
|
2477
|
+
}
|
|
2478
|
+
|
|
2479
|
+
begin
|
|
2480
|
+
# Get email inbox provider metrics over time
|
|
2481
|
+
result = api_instance.get_email_provider_metrics_timeseries(app_id, domain, start, _end, granularity, opts)
|
|
2482
|
+
p result
|
|
2483
|
+
rescue OneSignal::ApiError => e
|
|
2484
|
+
puts "Error when calling DefaultApi->get_email_provider_metrics_timeseries: #{e}"
|
|
2485
|
+
puts "Status Code: #{e.code}"
|
|
2486
|
+
# `e.error_messages` flattens any error-envelope shape to an Array<String>;
|
|
2487
|
+
# the raw body remains on `e.response_body`.
|
|
2488
|
+
puts "Error Messages: #{e.error_messages}"
|
|
2489
|
+
puts "Response Body: #{e.response_body}"
|
|
2490
|
+
end
|
|
2491
|
+
```
|
|
2492
|
+
|
|
2493
|
+
#### Using the get_email_provider_metrics_timeseries_with_http_info variant
|
|
2494
|
+
|
|
2495
|
+
This returns an Array which contains the response data, status code and headers.
|
|
2496
|
+
|
|
2497
|
+
> <Array(<EmailProviderMetricsTimeseriesResponse>, Integer, Hash)> get_email_provider_metrics_timeseries_with_http_info(app_id, domain, start, _end, granularity, opts)
|
|
2498
|
+
|
|
2499
|
+
```ruby
|
|
2500
|
+
begin
|
|
2501
|
+
# Get email inbox provider metrics over time
|
|
2502
|
+
data, status_code, headers = api_instance.get_email_provider_metrics_timeseries_with_http_info(app_id, domain, start, _end, granularity, opts)
|
|
2503
|
+
p status_code # => 2xx
|
|
2504
|
+
p headers # => { ... }
|
|
2505
|
+
p data # => <EmailProviderMetricsTimeseriesResponse>
|
|
2506
|
+
rescue OneSignal::ApiError => e
|
|
2507
|
+
puts "Error when calling DefaultApi->get_email_provider_metrics_timeseries_with_http_info: #{e}"
|
|
2508
|
+
puts "Status Code: #{e.code}"
|
|
2509
|
+
puts "Response Body: #{e.response_body}"
|
|
2510
|
+
end
|
|
2511
|
+
```
|
|
2512
|
+
|
|
2513
|
+
### Parameters
|
|
2514
|
+
|
|
2515
|
+
| Name | Type | Description | Notes |
|
|
2516
|
+
| ---- | ---- | ----------- | ----- |
|
|
2517
|
+
| **app_id** | **String** | Your OneSignal App ID in UUID v4 format. | |
|
|
2518
|
+
| **domain** | **String** | The sending domain to report on. Must be an email domain configured for this app. | |
|
|
2519
|
+
| **start** | **Time** | Start of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-01T00:00:00Z`). | |
|
|
2520
|
+
| **_end** | **Time** | End of the reporting window, as an ISO 8601 timestamp (for example, `2026-08-08T00:00:00Z`). | |
|
|
2521
|
+
| **granularity** | **String** | The size of each time bucket. Hourly data is only available for the last 60 days. | |
|
|
2522
|
+
| **providers** | [**Array<String>**](String.md) | Inbox providers to include in the totals. Omit to include all providers. Accepted values: `apple`, `att`, `canadian`, `chinese`, `comcast`, `free_fr`, `french`, `german`, `gmail`, `google_workspace`, `googlers`, `inbox_lv`, `italian`, `japanese`, `outlook_365`, `outlook_eu`, `outlook_us`, `proton`, `rackspace`, `russian`, `uk`, `united_online`, `yahoo_eu`, `yahoo_us`, `other_eu`, `other_us`, and `other`. Example: providers[]=gmail&providers[]=yahoo_us | [optional] |
|
|
2523
|
+
|
|
2524
|
+
### Return type
|
|
2525
|
+
|
|
2526
|
+
[**EmailProviderMetricsTimeseriesResponse**](EmailProviderMetricsTimeseriesResponse.md)
|
|
2527
|
+
|
|
2528
|
+
### Authorization
|
|
2529
|
+
|
|
2530
|
+
[rest_api_key](https://github.com/OneSignal/onesignal-ruby-api#configuration)
|
|
2531
|
+
|
|
2532
|
+
### HTTP request headers
|
|
2533
|
+
|
|
2534
|
+
- **Content-Type**: Not defined
|
|
2535
|
+
- **Accept**: application/json
|
|
2536
|
+
|
|
2537
|
+
|
|
2366
2538
|
## get_email_reputation
|
|
2367
2539
|
|
|
2368
2540
|
> <EmailReputationResponse> get_email_reputation(app_id)
|
|
@@ -3035,17 +3207,17 @@ end
|
|
|
3035
3207
|
api_instance = OneSignal::DefaultApi.new
|
|
3036
3208
|
organization_id = 'YOUR_ORG_ID' # String | The UUID of the organization to retrieve audit logs for. Must match the authenticated Organization API Key.
|
|
3037
3209
|
opts = {
|
|
3038
|
-
start_time: '
|
|
3039
|
-
end_time: '
|
|
3040
|
-
cursor: '
|
|
3041
|
-
limit:
|
|
3042
|
-
app_ids: ['
|
|
3043
|
-
actions: ['
|
|
3044
|
-
actor_ids: ['
|
|
3045
|
-
actor_emails: ['
|
|
3046
|
-
target_types: ['
|
|
3047
|
-
target_ids: ['
|
|
3048
|
-
ip_addresses: ['
|
|
3210
|
+
start_time: '2026-02-01T00:00:00Z', # String | Start of the time range in ISO 8601 format (e.g. 2026-02-01T00:00:00Z). Required unless cursor is provided. Must be within the last 90 days.
|
|
3211
|
+
end_time: '2026-02-02T00:00:00Z', # String | End of the time range in ISO 8601 format. Defaults to the current time. Must be after start_time.
|
|
3212
|
+
cursor: 'YOUR_NEXT_CURSOR', # String | Pagination cursor returned in a previous response as next_cursor. When provided, start_time and end_time are ignored.
|
|
3213
|
+
limit: 50, # Integer | Maximum number of events to return per page. Minimum 1, maximum 100. Values outside this range are clamped automatically by the server.
|
|
3214
|
+
app_ids: ['YOUR_APP_ID'], # Array<String> | Filter events by app UUID. Accepts up to 10 values. Org-level events are always included.
|
|
3215
|
+
actions: ['notification.sent'], # Array<String> | Filter by action type (e.g. notification.sent, segment.created). Accepts up to 20 values.
|
|
3216
|
+
actor_ids: ['YOUR_ACTOR_ID'], # Array<String> | Filter by actor UUID (the user or service that performed the action). Accepts up to 10 values.
|
|
3217
|
+
actor_emails: ['admin@example.com'], # Array<String> | Filter by actor email address. Accepts up to 10 values.
|
|
3218
|
+
target_types: ['notification'], # Array<String> | Filter by the type of resource the action was performed on (e.g. notification, segment, journey). Accepts up to 10 values.
|
|
3219
|
+
target_ids: ['YOUR_TARGET_ID'], # Array<String> | Filter by the UUID of the resource the action was performed on. Accepts up to 10 values.
|
|
3220
|
+
ip_addresses: ['203.0.113.42'] # Array<String> | Filter by the IP address the action originated from. Accepts up to 10 values.
|
|
3049
3221
|
}
|
|
3050
3222
|
|
|
3051
3223
|
begin
|
|
@@ -3213,7 +3385,7 @@ end
|
|
|
3213
3385
|
api_instance = OneSignal::DefaultApi.new
|
|
3214
3386
|
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
3215
3387
|
activity_type = 'order_status' # String | The name of the Live Activity defined in your app. This should match the attributes struct used in your app's Live Activity implementation.
|
|
3216
|
-
start_live_activity_request = OneSignal::StartLiveActivityRequest.new({name: '
|
|
3388
|
+
start_live_activity_request = OneSignal::StartLiveActivityRequest.new({name: 'YOUR_NAME', event: 'start', activity_id: 'YOUR_ACTIVITY_ID', event_attributes: {}, event_updates: {}, contents: OneSignal::LanguageStringMap.new, headings: OneSignal::LanguageStringMap.new}) # StartLiveActivityRequest |
|
|
3217
3389
|
|
|
3218
3390
|
begin
|
|
3219
3391
|
# Start Live Activity
|
|
@@ -3773,7 +3945,7 @@ end
|
|
|
3773
3945
|
api_instance = OneSignal::DefaultApi.new
|
|
3774
3946
|
app_id = 'YOUR_APP_ID' # String | The OneSignal App ID for your app. Available in Keys & IDs.
|
|
3775
3947
|
activity_id = '12345' # String | Live Activity record ID
|
|
3776
|
-
update_live_activity_request = OneSignal::UpdateLiveActivityRequest.new({name: '
|
|
3948
|
+
update_live_activity_request = OneSignal::UpdateLiveActivityRequest.new({name: 'YOUR_NAME', event: 'update', event_updates: {}}) # UpdateLiveActivityRequest |
|
|
3777
3949
|
|
|
3778
3950
|
begin
|
|
3779
3951
|
# Update a Live Activity via Push
|
|
@@ -3854,7 +4026,7 @@ api_instance = OneSignal::DefaultApi.new
|
|
|
3854
4026
|
app_id = 'YOUR_APP_ID' # String | The OneSignal App ID for your app. Available in Keys & IDs.
|
|
3855
4027
|
segment_id = 'd6c5a3e1-9f17-44a1-9d10-7c0e4a2b1c8e' # String | The segment's unique identifier. In the dashboard, go to Audience > Segments, open the segment's options menu, and select Copy segment ID. You can also get it from the View Segments API or the segment's URL in the dashboard.
|
|
3856
4028
|
opts = {
|
|
3857
|
-
update_segment_request: OneSignal::UpdateSegmentRequest.new({name: '
|
|
4029
|
+
update_segment_request: OneSignal::UpdateSegmentRequest.new({name: 'YOUR_NAME'}) # UpdateSegmentRequest |
|
|
3858
4030
|
}
|
|
3859
4031
|
|
|
3860
4032
|
begin
|
|
@@ -4490,7 +4662,7 @@ end
|
|
|
4490
4662
|
api_instance = OneSignal::DefaultApi.new
|
|
4491
4663
|
app_id = 'YOUR_APP_ID' # String | Your OneSignal App ID in UUID v4 format.
|
|
4492
4664
|
opts = {
|
|
4493
|
-
cursor: '
|
|
4665
|
+
cursor: 'YOUR_NEXT_CURSOR', # String | Opaque pagination token from a previous response's next_cursor. Omit for the first page.
|
|
4494
4666
|
limit: 50 # Integer | Maximum journeys to return per page. Minimum 1, maximum 50.
|
|
4495
4667
|
}
|
|
4496
4668
|
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# OneSignal::EmailMetrics
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **sent** | **Integer** | The number of emails sent. | [optional] |
|
|
8
|
+
| **delivered** | **Integer** | The number of emails successfully delivered. | [optional] |
|
|
9
|
+
| **opened** | **Integer** | The total number of email opens, including repeat opens by the same recipient. | [optional] |
|
|
10
|
+
| **clicked** | **Integer** | The total number of email link clicks, including repeat clicks by the same recipient. | [optional] |
|
|
11
|
+
| **unique_opened** | **Integer** | The number of emails opened at least once. | [optional] |
|
|
12
|
+
| **unique_clicked** | **Integer** | The number of emails with at least one link click. | [optional] |
|
|
13
|
+
| **failed** | **Integer** | The number of emails that failed to send. | [optional] |
|
|
14
|
+
| **bounced** | **Integer** | The number of emails that bounced. | [optional] |
|
|
15
|
+
| **complained** | **Integer** | The number of emails that recipients reported as spam. | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'onesignal'
|
|
21
|
+
|
|
22
|
+
instance = OneSignal::EmailMetrics.new(
|
|
23
|
+
sent: 100,
|
|
24
|
+
delivered: 95,
|
|
25
|
+
opened: 40,
|
|
26
|
+
clicked: 10,
|
|
27
|
+
unique_opened: 35,
|
|
28
|
+
unique_clicked: 8,
|
|
29
|
+
failed: 5,
|
|
30
|
+
bounced: 3,
|
|
31
|
+
complained: 1
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# OneSignal::EmailProviderMetrics
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **provider** | **String** | The inbox provider. Known values include `apple`, `att`, `canadian`, `chinese`, `comcast`, `free_fr`, `french`, `german`, `gmail`, `google_workspace`, `googlers`, `inbox_lv`, `italian`, `japanese`, `outlook_365`, `outlook_eu`, `outlook_us`, `proton`, `rackspace`, `russian`, `uk`, `united_online`, `yahoo_eu`, `yahoo_us`, `other_eu`, `other_us`, and `other`. New providers may be added over time. | [optional] |
|
|
8
|
+
| **metrics** | [**EmailMetrics**](EmailMetrics.md) | | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'onesignal'
|
|
14
|
+
|
|
15
|
+
instance = OneSignal::EmailProviderMetrics.new(
|
|
16
|
+
provider: 'gmail',
|
|
17
|
+
metrics: nil
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# OneSignal::EmailProviderMetricsEvent
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **date** | **Time** | The start of the time bucket, aligned to the hour, day, or month in UTC. | [optional] |
|
|
8
|
+
| **metrics** | [**EmailMetrics**](EmailMetrics.md) | | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'onesignal'
|
|
14
|
+
|
|
15
|
+
instance = OneSignal::EmailProviderMetricsEvent.new(
|
|
16
|
+
date: 2026-08-01T00:00Z,
|
|
17
|
+
metrics: nil
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# OneSignal::EmailProviderMetricsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **providers** | [**Array<EmailProviderMetrics>**](EmailProviderMetrics.md) | One entry per inbox provider that received email from the domain during the reporting window. Empty when the domain is not found for the app or is not currently active for sending. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'onesignal'
|
|
13
|
+
|
|
14
|
+
instance = OneSignal::EmailProviderMetricsResponse.new(
|
|
15
|
+
providers: nil
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# OneSignal::EmailProviderMetricsTimeseriesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **events** | [**Array<EmailProviderMetricsEvent>**](EmailProviderMetricsEvent.md) | One entry for every time bucket in the reporting window, oldest first. Buckets with no email activity are included with all metrics set to `0`. Empty when the domain is not found for the app or is not currently active for sending. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'onesignal'
|
|
13
|
+
|
|
14
|
+
instance = OneSignal::EmailProviderMetricsTimeseriesResponse.new(
|
|
15
|
+
events: nil
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|