google-api-client 0.32.1 → 0.33.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +40 -0
- data/generated/google/apis/accessapproval_v1beta1.rb +1 -1
- data/generated/google/apis/accessapproval_v1beta1/classes.rb +5 -2
- data/generated/google/apis/accessapproval_v1beta1/service.rb +3 -6
- data/generated/google/apis/admin_directory_v1.rb +4 -1
- data/generated/google/apis/admin_directory_v1/classes.rb +4 -3
- data/generated/google/apis/admin_reports_v1.rb +2 -2
- data/generated/google/apis/admin_reports_v1/classes.rb +87 -44
- data/generated/google/apis/admin_reports_v1/service.rb +306 -63
- data/generated/google/apis/androidpublisher_v3.rb +1 -1
- data/generated/google/apis/androidpublisher_v3/classes.rb +6 -0
- data/generated/google/apis/androidpublisher_v3/representations.rb +1 -0
- data/generated/google/apis/appengine_v1.rb +1 -1
- data/generated/google/apis/appengine_v1/service.rb +10 -6
- data/generated/google/apis/appengine_v1beta.rb +1 -1
- data/generated/google/apis/appengine_v1beta/service.rb +10 -6
- data/generated/google/apis/bigquery_v2.rb +1 -1
- data/generated/google/apis/bigquery_v2/classes.rb +10 -18
- data/generated/google/apis/bigqueryconnection_v1beta1.rb +1 -1
- data/generated/google/apis/bigqueryconnection_v1beta1/service.rb +1 -0
- data/generated/google/apis/cloudbilling_v1.rb +1 -1
- data/generated/google/apis/cloudbilling_v1/classes.rb +65 -36
- data/generated/google/apis/cloudbilling_v1/representations.rb +0 -1
- data/generated/google/apis/cloudbilling_v1/service.rb +5 -3
- data/generated/google/apis/cloudfunctions_v1.rb +1 -1
- data/generated/google/apis/cloudfunctions_v1/service.rb +7 -3
- data/generated/google/apis/cloudfunctions_v1beta2.rb +1 -1
- data/generated/google/apis/cloudfunctions_v1beta2/classes.rb +7 -0
- data/generated/google/apis/cloudfunctions_v1beta2/representations.rb +1 -0
- data/generated/google/apis/cloudfunctions_v1beta2/service.rb +10 -4
- data/generated/google/apis/cloudkms_v1.rb +1 -1
- data/generated/google/apis/cloudkms_v1/service.rb +3 -0
- data/generated/google/apis/content_v2.rb +1 -1
- data/generated/google/apis/content_v2/classes.rb +23 -220
- data/generated/google/apis/content_v2/representations.rb +0 -115
- data/generated/google/apis/content_v2/service.rb +0 -160
- data/generated/google/apis/content_v2_1.rb +1 -1
- data/generated/google/apis/content_v2_1/classes.rb +57 -18
- data/generated/google/apis/content_v2_1/representations.rb +3 -0
- data/generated/google/apis/dataflow_v1b3.rb +1 -1
- data/generated/google/apis/dataflow_v1b3/classes.rb +6 -9
- data/generated/google/apis/dataflow_v1b3/representations.rb +1 -1
- data/generated/google/apis/datafusion_v1beta1.rb +1 -1
- data/generated/google/apis/datafusion_v1beta1/classes.rb +156 -46
- data/generated/google/apis/datafusion_v1beta1/representations.rb +33 -0
- data/generated/google/apis/datafusion_v1beta1/service.rb +10 -1
- data/generated/google/apis/dialogflow_v2.rb +1 -1
- data/generated/google/apis/dialogflow_v2/classes.rb +280 -0
- data/generated/google/apis/dialogflow_v2/representations.rb +115 -0
- data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
- data/generated/google/apis/dialogflow_v2beta1/classes.rb +280 -0
- data/generated/google/apis/dialogflow_v2beta1/representations.rb +115 -0
- data/generated/google/apis/iap_v1.rb +1 -1
- data/generated/google/apis/iap_v1/classes.rb +2 -2
- data/generated/google/apis/iap_v1beta1.rb +1 -1
- data/generated/google/apis/iap_v1beta1/classes.rb +2 -2
- data/generated/google/apis/logging_v2.rb +1 -1
- data/generated/google/apis/logging_v2/classes.rb +12 -0
- data/generated/google/apis/logging_v2/representations.rb +2 -0
- data/generated/google/apis/logging_v2/service.rb +10 -5
- data/generated/google/apis/monitoring_v3.rb +1 -1
- data/generated/google/apis/monitoring_v3/classes.rb +15 -1
- data/generated/google/apis/monitoring_v3/representations.rb +1 -0
- data/generated/google/apis/policytroubleshooter_v1beta.rb +1 -1
- data/generated/google/apis/policytroubleshooter_v1beta/classes.rb +5 -4
- data/generated/google/apis/pubsub_v1.rb +1 -1
- data/generated/google/apis/pubsub_v1/service.rb +3 -0
- data/generated/google/apis/pubsub_v1beta2.rb +1 -1
- data/generated/google/apis/pubsub_v1beta2/service.rb +2 -0
- data/generated/google/apis/remotebuildexecution_v1.rb +1 -1
- data/generated/google/apis/remotebuildexecution_v1/classes.rb +24 -0
- data/generated/google/apis/remotebuildexecution_v1/representations.rb +4 -0
- data/generated/google/apis/remotebuildexecution_v1alpha.rb +1 -1
- data/generated/google/apis/remotebuildexecution_v1alpha/classes.rb +24 -0
- data/generated/google/apis/remotebuildexecution_v1alpha/representations.rb +4 -0
- data/generated/google/apis/remotebuildexecution_v2.rb +1 -1
- data/generated/google/apis/remotebuildexecution_v2/classes.rb +24 -0
- data/generated/google/apis/remotebuildexecution_v2/representations.rb +4 -0
- data/generated/google/apis/securitycenter_v1.rb +1 -1
- data/generated/google/apis/securitycenter_v1/classes.rb +2 -2
- data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
- data/generated/google/apis/securitycenter_v1beta1/classes.rb +2 -2
- data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
- data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +63 -0
- data/generated/google/apis/serviceconsumermanagement_v1/representations.rb +30 -0
- data/generated/google/apis/servicemanagement_v1.rb +1 -1
- data/generated/google/apis/servicemanagement_v1/classes.rb +33 -7
- data/generated/google/apis/servicemanagement_v1/representations.rb +24 -0
- data/generated/google/apis/servicemanagement_v1/service.rb +31 -17
- data/generated/google/apis/serviceusage_v1.rb +1 -1
- data/generated/google/apis/serviceusage_v1/classes.rb +55 -0
- data/generated/google/apis/serviceusage_v1/representations.rb +29 -0
- data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
- data/generated/google/apis/serviceusage_v1beta1/classes.rb +55 -0
- data/generated/google/apis/serviceusage_v1beta1/representations.rb +29 -0
- data/generated/google/apis/sheets_v4.rb +1 -1
- data/generated/google/apis/sheets_v4/classes.rb +389 -0
- data/generated/google/apis/sheets_v4/representations.rb +79 -0
- data/google-api-client.gemspec +3 -3
- data/lib/google/apis/version.rb +1 -1
- metadata +10 -21
- data/generated/google/apis/urlshortener_v1.rb +0 -34
- data/generated/google/apis/urlshortener_v1/classes.rb +0 -246
- data/generated/google/apis/urlshortener_v1/representations.rb +0 -121
- data/generated/google/apis/urlshortener_v1/service.rb +0 -169
@@ -31,7 +31,7 @@ module Google
|
|
31
31
|
# Admin = Google::Apis::AdminReportsV1 # Alias the module
|
32
32
|
# service = Admin::ReportsService.new
|
33
33
|
#
|
34
|
-
# @see
|
34
|
+
# @see /admin-sdk/reports/
|
35
35
|
class ReportsService < Google::Apis::Core::BaseService
|
36
36
|
# @return [String]
|
37
37
|
# API key. Your API key identifies your project and provides you with API access,
|
@@ -52,34 +52,108 @@ module Google
|
|
52
52
|
@batch_path = 'batch/admin/reports_v1'
|
53
53
|
end
|
54
54
|
|
55
|
-
# Retrieves a list of activities for a specific customer and
|
55
|
+
# Retrieves a list of activities for a specific customer's account and
|
56
|
+
# application such as the Admin console application or the Google Drive
|
57
|
+
# application. For more information, see the guides for administrator and Google
|
58
|
+
# Drive activity reports. For more information about the activity report's
|
59
|
+
# parameters, see the activity parameters reference guides.
|
56
60
|
# @param [String] user_key
|
57
|
-
# Represents the profile
|
58
|
-
# filtered.
|
59
|
-
# all users.
|
61
|
+
# Represents the profile ID or the user email for which the data should be
|
62
|
+
# filtered.
|
60
63
|
# @param [String] application_name
|
61
64
|
# Application name for which the events are to be retrieved.
|
62
65
|
# @param [String] actor_ip_address
|
63
|
-
# IP Address of host where the event was performed.
|
64
|
-
#
|
66
|
+
# The Internet Protocol (IP) Address of host where the event was performed. This
|
67
|
+
# is an additional way to filter a report's summary using the IP address of the
|
68
|
+
# user whose activity is being reported. This IP address may or may not reflect
|
69
|
+
# the user's physical location. For example, the IP address can be the user's
|
70
|
+
# proxy server's address or a virtual private network (VPN) address. This
|
71
|
+
# parameter supports both IPv4 and IPv6 address versions.
|
65
72
|
# @param [String] customer_id
|
66
|
-
#
|
73
|
+
# The unique ID of the customer to retrieve data for.
|
67
74
|
# @param [String] end_time
|
68
|
-
#
|
75
|
+
# Sets the end of the range of time shown in the report. The date is in the RFC
|
76
|
+
# 3339 format, for example 2010-10-28T10:26:35.000Z. The default value is the
|
77
|
+
# approximate time of the API request. An API report has three basic time
|
78
|
+
# concepts:
|
79
|
+
# - Date of the API's request for a report: When the API created and retrieved
|
80
|
+
# the report.
|
81
|
+
# - Report's start time: The beginning of the timespan shown in the report. The
|
82
|
+
# startTime must be before the endTime (if specified) and the current time when
|
83
|
+
# the request is made, or the API returns an error.
|
84
|
+
# - Report's end time: The end of the timespan shown in the report. For example,
|
85
|
+
# the timespan of events summarized in a report can start in April and end in
|
86
|
+
# May. The report itself can be requested in August. If the endTime is not
|
87
|
+
# specified, the report returns all activities from the startTime until the
|
88
|
+
# current time or the most recent 180 days if the startTime is more than 180
|
89
|
+
# days in the past.
|
69
90
|
# @param [String] event_name
|
70
|
-
#
|
91
|
+
# The name of the event being queried by the API. Each eventName is related to a
|
92
|
+
# specific G Suite service or feature which the API organizes into types of
|
93
|
+
# events. An example is the Google Calendar events in the Admin console
|
94
|
+
# application's reports. The Calendar Settings type structure has all of the
|
95
|
+
# Calendar eventName activities reported by the API. When an administrator
|
96
|
+
# changes a Calendar setting, the API reports this activity in the Calendar
|
97
|
+
# Settings type and eventName parameters. For more information about eventName
|
98
|
+
# query strings and parameters, see the list of event names for various
|
99
|
+
# applications above in applicationName.
|
71
100
|
# @param [String] filters
|
72
|
-
#
|
73
|
-
#
|
101
|
+
# The filters query string is a comma-separated list. The list is composed of
|
102
|
+
# event parameters that are manipulated by relational operators. Event
|
103
|
+
# parameters are in the form [parameter1 name][relational operator][parameter1
|
104
|
+
# value],[parameter2 name][relational operator][parameter2 value],...
|
105
|
+
# These event parameters are associated with a specific eventName. An empty
|
106
|
+
# report is returned if the filtered request's parameter does not belong to the
|
107
|
+
# eventName. For more information about eventName parameters, see the list of
|
108
|
+
# event names for various applications above in applicationName.
|
109
|
+
# In the following Admin Activity example, the <> operator is URL-encoded in the
|
110
|
+
# request's query string (%3C%3E):
|
111
|
+
# GET...&eventName=CHANGE_CALENDAR_SETTING &filters=NEW_VALUE%3C%
|
112
|
+
# 3EREAD_ONLY_ACCESS
|
113
|
+
# In the following Drive example, the list can be a view or edit event's doc_id
|
114
|
+
# parameter with a value that is manipulated by an 'equal to' (==) or 'not equal
|
115
|
+
# to' (<>) relational operator. In the first example, the report returns each
|
116
|
+
# edited document's doc_id. In the second example, the report returns each
|
117
|
+
# viewed document's doc_id that equals the value 12345 and does not return any
|
118
|
+
# viewed document's which have a doc_id value of 98765. The <> operator is URL-
|
119
|
+
# encoded in the request's query string (%3C%3E):
|
120
|
+
# GET...&eventName=edit&filters=doc_id GET...&eventName=view&filters=doc_id==
|
121
|
+
# 12345,doc_id%3C%3E98765
|
122
|
+
# The relational operators include:
|
123
|
+
# - == - 'equal to'.
|
124
|
+
# - <> - 'not equal to'. It is URL-encoded (%3C%3E).
|
125
|
+
# - < - 'less than'. It is URL-encoded (%3C).
|
126
|
+
# - <= - 'less than or equal to'. It is URL-encoded (%3C=).
|
127
|
+
# - > - 'greater than'. It is URL-encoded (%3E).
|
128
|
+
# - >= - 'greater than or equal to'. It is URL-encoded (%3E=).
|
129
|
+
# Note: The API doesn't accept multiple values of a parameter. If a particular
|
130
|
+
# parameter is supplied more than once in the API request, the API only accepts
|
131
|
+
# the last value of that request parameter.
|
132
|
+
# In addition, if an invalid request parameter is supplied in the API request,
|
133
|
+
# the API ignores that request parameter and returns the response corresponding
|
134
|
+
# to the remaining valid request parameters. If no parameters are requested, all
|
135
|
+
# parameters are returned.
|
74
136
|
# @param [Fixnum] max_results
|
75
|
-
#
|
137
|
+
# Determines how many activity records are shown on each response page. For
|
138
|
+
# example, if the request sets maxResults=1 and the report has two activities,
|
139
|
+
# the report has two pages. The response's nextPageToken property has the token
|
140
|
+
# to the second page. The maxResults query string is optional in the request.
|
141
|
+
# The default value is 1000.
|
76
142
|
# @param [String] org_unit_id
|
77
|
-
# the organizational unit
|
78
|
-
#
|
143
|
+
# ID of the organizational unit to report on. Activity records will be shown
|
144
|
+
# only for users who belong to the specified organizational unit. Data before
|
145
|
+
# Dec 17, 2018 doesn't appear in the filtered results.
|
79
146
|
# @param [String] page_token
|
80
|
-
#
|
147
|
+
# The token to specify next page. A report with multiple pages has a
|
148
|
+
# nextPageToken property in the response. In your follow-on request getting the
|
149
|
+
# next page of the report, enter the nextPageToken value in the pageToken query
|
150
|
+
# string.
|
81
151
|
# @param [String] start_time
|
82
|
-
#
|
152
|
+
# Sets the beginning of the range of time shown in the report. The date is in
|
153
|
+
# the RFC 3339 format, for example 2010-10-28T10:26:35.000Z. The report returns
|
154
|
+
# all activities from startTime until endTime. The startTime must be before the
|
155
|
+
# endTime (if specified) and the current time when the request is made, or the
|
156
|
+
# API returns an error.
|
83
157
|
# @param [String] fields
|
84
158
|
# Selector specifying which fields to include in a partial response.
|
85
159
|
# @param [String] quota_user
|
@@ -120,35 +194,106 @@ module Google
|
|
120
194
|
execute_or_queue_command(command, &block)
|
121
195
|
end
|
122
196
|
|
123
|
-
#
|
197
|
+
# Start receiving notifications for account activities. For more information,
|
198
|
+
# see Receiving Push Notifications.
|
124
199
|
# @param [String] user_key
|
125
|
-
# Represents the profile
|
126
|
-
# filtered.
|
127
|
-
# all users.
|
200
|
+
# Represents the profile ID or the user email for which the data should be
|
201
|
+
# filtered.
|
128
202
|
# @param [String] application_name
|
129
203
|
# Application name for which the events are to be retrieved.
|
130
204
|
# @param [Google::Apis::AdminReportsV1::Channel] channel_object
|
131
205
|
# @param [String] actor_ip_address
|
132
|
-
# IP Address of host where the event was performed.
|
133
|
-
#
|
206
|
+
# The Internet Protocol (IP) Address of host where the event was performed. This
|
207
|
+
# is an additional way to filter a report's summary using the IP address of the
|
208
|
+
# user whose activity is being reported. This IP address may or may not reflect
|
209
|
+
# the user's physical location. For example, the IP address can be the user's
|
210
|
+
# proxy server's address or a virtual private network (VPN) address. This
|
211
|
+
# parameter supports both IPv4 and IPv6 address versions.
|
134
212
|
# @param [String] customer_id
|
135
|
-
#
|
213
|
+
# The unique ID of the customer to retrieve data for.
|
136
214
|
# @param [String] end_time
|
137
|
-
#
|
215
|
+
# Sets the end of the range of time shown in the report. The date is in the RFC
|
216
|
+
# 3339 format, for example 2010-10-28T10:26:35.000Z. The default value is the
|
217
|
+
# approximate time of the API request. An API report has three basic time
|
218
|
+
# concepts:
|
219
|
+
# - Date of the API's request for a report: When the API created and retrieved
|
220
|
+
# the report.
|
221
|
+
# - Report's start time: The beginning of the timespan shown in the report. The
|
222
|
+
# startTime must be before the endTime (if specified) and the current time when
|
223
|
+
# the request is made, or the API returns an error.
|
224
|
+
# - Report's end time: The end of the timespan shown in the report. For example,
|
225
|
+
# the timespan of events summarized in a report can start in April and end in
|
226
|
+
# May. The report itself can be requested in August. If the endTime is not
|
227
|
+
# specified, the report returns all activities from the startTime until the
|
228
|
+
# current time or the most recent 180 days if the startTime is more than 180
|
229
|
+
# days in the past.
|
138
230
|
# @param [String] event_name
|
139
|
-
#
|
231
|
+
# The name of the event being queried by the API. Each eventName is related to a
|
232
|
+
# specific G Suite service or feature which the API organizes into types of
|
233
|
+
# events. An example is the Google Calendar events in the Admin console
|
234
|
+
# application's reports. The Calendar Settings type structure has all of the
|
235
|
+
# Calendar eventName activities reported by the API. When an administrator
|
236
|
+
# changes a Calendar setting, the API reports this activity in the Calendar
|
237
|
+
# Settings type and eventName parameters. For more information about eventName
|
238
|
+
# query strings and parameters, see the list of event names for various
|
239
|
+
# applications above in applicationName.
|
140
240
|
# @param [String] filters
|
141
|
-
#
|
142
|
-
#
|
241
|
+
# The filters query string is a comma-separated list. The list is composed of
|
242
|
+
# event parameters that are manipulated by relational operators. Event
|
243
|
+
# parameters are in the form [parameter1 name][relational operator][parameter1
|
244
|
+
# value],[parameter2 name][relational operator][parameter2 value],...
|
245
|
+
# These event parameters are associated with a specific eventName. An empty
|
246
|
+
# report is returned if the filtered request's parameter does not belong to the
|
247
|
+
# eventName. For more information about eventName parameters, see the list of
|
248
|
+
# event names for various applications above in applicationName.
|
249
|
+
# In the following Admin Activity example, the <> operator is URL-encoded in the
|
250
|
+
# request's query string (%3C%3E):
|
251
|
+
# GET...&eventName=CHANGE_CALENDAR_SETTING &filters=NEW_VALUE%3C%
|
252
|
+
# 3EREAD_ONLY_ACCESS
|
253
|
+
# In the following Drive example, the list can be a view or edit event's doc_id
|
254
|
+
# parameter with a value that is manipulated by an 'equal to' (==) or 'not equal
|
255
|
+
# to' (<>) relational operator. In the first example, the report returns each
|
256
|
+
# edited document's doc_id. In the second example, the report returns each
|
257
|
+
# viewed document's doc_id that equals the value 12345 and does not return any
|
258
|
+
# viewed document's which have a doc_id value of 98765. The <> operator is URL-
|
259
|
+
# encoded in the request's query string (%3C%3E):
|
260
|
+
# GET...&eventName=edit&filters=doc_id GET...&eventName=view&filters=doc_id==
|
261
|
+
# 12345,doc_id%3C%3E98765
|
262
|
+
# The relational operators include:
|
263
|
+
# - == - 'equal to'.
|
264
|
+
# - <> - 'not equal to'. It is URL-encoded (%3C%3E).
|
265
|
+
# - < - 'less than'. It is URL-encoded (%3C).
|
266
|
+
# - <= - 'less than or equal to'. It is URL-encoded (%3C=).
|
267
|
+
# - > - 'greater than'. It is URL-encoded (%3E).
|
268
|
+
# - >= - 'greater than or equal to'. It is URL-encoded (%3E=).
|
269
|
+
# Note: The API doesn't accept multiple values of a parameter. If a particular
|
270
|
+
# parameter is supplied more than once in the API request, the API only accepts
|
271
|
+
# the last value of that request parameter.
|
272
|
+
# In addition, if an invalid request parameter is supplied in the API request,
|
273
|
+
# the API ignores that request parameter and returns the response corresponding
|
274
|
+
# to the remaining valid request parameters. If no parameters are requested, all
|
275
|
+
# parameters are returned.
|
143
276
|
# @param [Fixnum] max_results
|
144
|
-
#
|
277
|
+
# Determines how many activity records are shown on each response page. For
|
278
|
+
# example, if the request sets maxResults=1 and the report has two activities,
|
279
|
+
# the report has two pages. The response's nextPageToken property has the token
|
280
|
+
# to the second page. The maxResults query string is optional in the request.
|
281
|
+
# The default value is 1000.
|
145
282
|
# @param [String] org_unit_id
|
146
|
-
# the organizational unit
|
147
|
-
#
|
283
|
+
# ID of the organizational unit to report on. Activity records will be shown
|
284
|
+
# only for users who belong to the specified organizational unit. Data before
|
285
|
+
# Dec 17, 2018 doesn't appear in the filtered results.
|
148
286
|
# @param [String] page_token
|
149
|
-
#
|
287
|
+
# The token to specify next page. A report with multiple pages has a
|
288
|
+
# nextPageToken property in the response. In your follow-on request getting the
|
289
|
+
# next page of the report, enter the nextPageToken value in the pageToken query
|
290
|
+
# string.
|
150
291
|
# @param [String] start_time
|
151
|
-
#
|
292
|
+
# Sets the beginning of the range of time shown in the report. The date is in
|
293
|
+
# the RFC 3339 format, for example 2010-10-28T10:26:35.000Z. The report returns
|
294
|
+
# all activities from startTime until endTime. The startTime must be before the
|
295
|
+
# endTime (if specified) and the current time when the request is made, or the
|
296
|
+
# API returns an error.
|
152
297
|
# @param [String] fields
|
153
298
|
# Selector specifying which fields to include in a partial response.
|
154
299
|
# @param [String] quota_user
|
@@ -222,17 +367,35 @@ module Google
|
|
222
367
|
execute_or_queue_command(command, &block)
|
223
368
|
end
|
224
369
|
|
225
|
-
# Retrieves a report which is a collection of properties
|
226
|
-
# specific customer.
|
370
|
+
# Retrieves a report which is a collection of properties and statistics for a
|
371
|
+
# specific customer's account. For more information, see the Customers Usage
|
372
|
+
# Report guide. For more information about the customer report's parameters, see
|
373
|
+
# the Customers Usage parameters reference guides.
|
227
374
|
# @param [String] date
|
228
|
-
# Represents the date
|
375
|
+
# Represents the date the usage occurred. The timestamp is in the ISO 8601
|
376
|
+
# format, yyyy-mm-dd. We recommend you use your account's time zone for this.
|
229
377
|
# @param [String] customer_id
|
230
|
-
#
|
378
|
+
# The unique ID of the customer to retrieve data for.
|
231
379
|
# @param [String] page_token
|
232
|
-
# Token to specify next page.
|
380
|
+
# Token to specify next page. A report with multiple pages has a nextPageToken
|
381
|
+
# property in the response. For your follow-on requests getting all of the
|
382
|
+
# report's pages, enter the nextPageToken value in the pageToken query string.
|
233
383
|
# @param [String] parameters
|
234
|
-
#
|
235
|
-
#
|
384
|
+
# The parameters query string is a comma-separated list of event parameters that
|
385
|
+
# refine a report's results. The parameter is associated with a specific
|
386
|
+
# application. The application values for the Customers usage report include
|
387
|
+
# accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail,
|
388
|
+
# gplus, device_management, meet, and sites.
|
389
|
+
# A parameters query string is in the CSV form of app_name1:param_name1,
|
390
|
+
# app_name2:param_name2.
|
391
|
+
# Note: The API doesn't accept multiple values of a parameter. If a particular
|
392
|
+
# parameter is supplied more than once in the API request, the API only accepts
|
393
|
+
# the last value of that request parameter.
|
394
|
+
# In addition, if an invalid request parameter is supplied in the API request,
|
395
|
+
# the API ignores that request parameter and returns the response corresponding
|
396
|
+
# to the remaining valid request parameters.
|
397
|
+
# An example of an invalid request parameter is one that does not belong to the
|
398
|
+
# application. If no parameters are requested, all parameters are returned.
|
236
399
|
# @param [String] fields
|
237
400
|
# Selector specifying which fields to include in a partial response.
|
238
401
|
# @param [String] quota_user
|
@@ -266,25 +429,64 @@ module Google
|
|
266
429
|
execute_or_queue_command(command, &block)
|
267
430
|
end
|
268
431
|
|
269
|
-
# Retrieves a report which is a collection of properties
|
270
|
-
#
|
432
|
+
# Retrieves a report which is a collection of properties and statistics for
|
433
|
+
# entities used by users within the account. For more information, see the
|
434
|
+
# Entities Usage Report guide. For more information about the entities report's
|
435
|
+
# parameters, see the Entities Usage parameters reference guides.
|
271
436
|
# @param [String] entity_type
|
272
|
-
#
|
437
|
+
# Represents the type of entity for the report.
|
273
438
|
# @param [String] entity_key
|
274
|
-
# Represents the key of object
|
439
|
+
# Represents the key of the object to filter the data with.
|
275
440
|
# @param [String] date
|
276
|
-
# Represents the date
|
441
|
+
# Represents the date the usage occurred. The timestamp is in the ISO 8601
|
442
|
+
# format, yyyy-mm-dd. We recommend you use your account's time zone for this.
|
277
443
|
# @param [String] customer_id
|
278
|
-
#
|
444
|
+
# The unique ID of the customer to retrieve data for.
|
279
445
|
# @param [String] filters
|
280
|
-
#
|
446
|
+
# The filters query string is a comma-separated list of an application's event
|
447
|
+
# parameters where the parameter's value is manipulated by a relational operator.
|
448
|
+
# The filters query string includes the name of the application whose usage is
|
449
|
+
# returned in the report. The application values for the Entities usage report
|
450
|
+
# include accounts, docs, and gmail.
|
451
|
+
# Filters are in the form [application name]:[parameter name][relational
|
452
|
+
# operator][parameter value],....
|
453
|
+
# In this example, the <> 'not equal to' operator is URL-encoded in the request'
|
454
|
+
# s query string (%3C%3E):
|
455
|
+
# GET https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/
|
456
|
+
# dates/2017-12-01 ?parameters=gplus:community_name,gplus:num_total_members &
|
457
|
+
# filters=gplus:num_total_members>0
|
458
|
+
# The relational operators include:
|
459
|
+
# - == - 'equal to'.
|
460
|
+
# - <> - 'not equal to'. It is URL-encoded (%3C%3E).
|
461
|
+
# - < - 'less than'. It is URL-encoded (%3C).
|
462
|
+
# - <= - 'less than or equal to'. It is URL-encoded (%3C=).
|
463
|
+
# - > - 'greater than'. It is URL-encoded (%3E).
|
464
|
+
# - >= - 'greater than or equal to'. It is URL-encoded (%3E=). Filters can only
|
465
|
+
# be applied to numeric parameters.
|
281
466
|
# @param [Fixnum] max_results
|
282
|
-
#
|
467
|
+
# Determines how many activity records are shown on each response page. For
|
468
|
+
# example, if the request sets maxResults=1 and the report has two activities,
|
469
|
+
# the report has two pages. The response's nextPageToken property has the token
|
470
|
+
# to the second page.
|
283
471
|
# @param [String] page_token
|
284
|
-
# Token to specify next page.
|
472
|
+
# Token to specify next page. A report with multiple pages has a nextPageToken
|
473
|
+
# property in the response. In your follow-on request getting the next page of
|
474
|
+
# the report, enter the nextPageToken value in the pageToken query string.
|
285
475
|
# @param [String] parameters
|
286
|
-
#
|
287
|
-
#
|
476
|
+
# The parameters query string is a comma-separated list of event parameters that
|
477
|
+
# refine a report's results. The parameter is associated with a specific
|
478
|
+
# application. The application values for the Entities usage report are only
|
479
|
+
# gplus.
|
480
|
+
# A parameter query string is in the CSV form of [app_name1:param_name1], [
|
481
|
+
# app_name2:param_name2]....
|
482
|
+
# Note: The API doesn't accept multiple values of a parameter. If a particular
|
483
|
+
# parameter is supplied more than once in the API request, the API only accepts
|
484
|
+
# the last value of that request parameter.
|
485
|
+
# In addition, if an invalid request parameter is supplied in the API request,
|
486
|
+
# the API ignores that request parameter and returns the response corresponding
|
487
|
+
# to the remaining valid request parameters.
|
488
|
+
# An example of an invalid request parameter is one that does not belong to the
|
489
|
+
# application. If no parameters are requested, all parameters are returned.
|
288
490
|
# @param [String] fields
|
289
491
|
# Selector specifying which fields to include in a partial response.
|
290
492
|
# @param [String] quota_user
|
@@ -322,27 +524,68 @@ module Google
|
|
322
524
|
execute_or_queue_command(command, &block)
|
323
525
|
end
|
324
526
|
|
325
|
-
# Retrieves a report which is a collection of properties
|
326
|
-
# of users.
|
527
|
+
# Retrieves a report which is a collection of properties and statistics for a
|
528
|
+
# set of users with the account. For more information, see the User Usage Report
|
529
|
+
# guide. For more information about the user report's parameters, see the Users
|
530
|
+
# Usage parameters reference guides.
|
327
531
|
# @param [String] user_key
|
328
|
-
# Represents the profile
|
532
|
+
# Represents the profile ID or the user email for which the data should be
|
329
533
|
# filtered.
|
330
534
|
# @param [String] date
|
331
|
-
# Represents the date
|
535
|
+
# Represents the date the usage occurred. The timestamp is in the ISO 8601
|
536
|
+
# format, yyyy-mm-dd. We recommend you use your account's time zone for this.
|
332
537
|
# @param [String] customer_id
|
333
|
-
#
|
538
|
+
# The unique ID of the customer to retrieve data for.
|
334
539
|
# @param [String] filters
|
335
|
-
#
|
540
|
+
# The filters query string is a comma-separated list of an application's event
|
541
|
+
# parameters where the parameter's value is manipulated by a relational operator.
|
542
|
+
# The filters query string includes the name of the application whose usage is
|
543
|
+
# returned in the report. The application values for the Users Usage Report
|
544
|
+
# include accounts, docs, and gmail.
|
545
|
+
# Filters are in the form [application name]:[parameter name][relational
|
546
|
+
# operator][parameter value],....
|
547
|
+
# In this example, the <> 'not equal to' operator is URL-encoded in the request'
|
548
|
+
# s query string (%3C%3E):
|
549
|
+
# GET https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-
|
550
|
+
# 03 ?parameters=accounts:last_login_time &filters=accounts:last_login_time>2010-
|
551
|
+
# 10-28T10:26:35.000Z
|
552
|
+
# The relational operators include:
|
553
|
+
# - == - 'equal to'.
|
554
|
+
# - <> - 'not equal to'. It is URL-encoded (%3C%3E).
|
555
|
+
# - < - 'less than'. It is URL-encoded (%3C).
|
556
|
+
# - <= - 'less than or equal to'. It is URL-encoded (%3C=).
|
557
|
+
# - > - 'greater than'. It is URL-encoded (%3E).
|
558
|
+
# - >= - 'greater than or equal to'. It is URL-encoded (%3E=).
|
336
559
|
# @param [Fixnum] max_results
|
337
|
-
#
|
560
|
+
# Determines how many activity records are shown on each response page. For
|
561
|
+
# example, if the request sets maxResults=1 and the report has two activities,
|
562
|
+
# the report has two pages. The response's nextPageToken property has the token
|
563
|
+
# to the second page.
|
564
|
+
# The maxResults query string is optional.
|
338
565
|
# @param [String] org_unit_id
|
339
|
-
# the organizational unit
|
340
|
-
# to
|
566
|
+
# ID of the organizational unit to report on. User activity will be shown only
|
567
|
+
# for users who belong to the specified organizational unit. Data before Dec 17,
|
568
|
+
# 2018 doesn't appear in the filtered results.
|
341
569
|
# @param [String] page_token
|
342
|
-
# Token to specify next page.
|
570
|
+
# Token to specify next page. A report with multiple pages has a nextPageToken
|
571
|
+
# property in the response. In your follow-on request getting the next page of
|
572
|
+
# the report, enter the nextPageToken value in the pageToken query string.
|
343
573
|
# @param [String] parameters
|
344
|
-
#
|
345
|
-
#
|
574
|
+
# The parameters query string is a comma-separated list of event parameters that
|
575
|
+
# refine a report's results. The parameter is associated with a specific
|
576
|
+
# application. The application values for the Customers usage report include
|
577
|
+
# accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail,
|
578
|
+
# gplus, device_management, meet, and sites.
|
579
|
+
# A parameters query string is in the CSV form of app_name1:param_name1,
|
580
|
+
# app_name2:param_name2.
|
581
|
+
# Note: The API doesn't accept multiple values of a parameter.
|
582
|
+
# If a particular parameter is supplied more than once in the API request, the
|
583
|
+
# API only accepts the last value of that request parameter. In addition, if an
|
584
|
+
# invalid request parameter is supplied in the API request, the API ignores that
|
585
|
+
# request parameter and returns the response corresponding to the remaining
|
586
|
+
# valid request parameters.
|
587
|
+
# An example of an invalid request parameter is one that does not belong to the
|
588
|
+
# application. If no parameters are requested, all parameters are returned.
|
346
589
|
# @param [String] fields
|
347
590
|
# Selector specifying which fields to include in a partial response.
|
348
591
|
# @param [String] quota_user
|