Update Reports.md

This commit is contained in:
Ross Scroggs
2023-07-26 08:04:47 -07:00
parent 75ebe459be
commit 7d686b9d91

View File

@@ -337,48 +337,123 @@ gam report users parameters accounts:drive_used_quota_in_mb,accounts:total_quota
``` ```
Report on email activity for individual users. Report on email activity for individual users.
``` ```
$ gam report users select users testuser1,testuser2,testuser3 fields gmail:num_emails_received,gmail:num_emails_sent range 2019-02-01 2019-02-07 $ gam report users select users testuser1,testuser2,testuser3 fields gmail:num_emails_received,gmail:num_emails_sent range 2023-07-01 2023-07-07
Getting Reports for testuser1@domain.com (1/3) Getting Reports for testuser1@rdschool.org (1/3)
Got 1 Report for testuser1@domain.com on 2023-07-01...
Got 1 Report for testuser1@domain.com on 2023-07-02...
Got 1 Report for testuser1@domain.com on 2023-07-03...
Got 1 Report for testuser1@domain.com on 2023-07-04...
Got 1 Report for testuser1@domain.com on 2023-07-05...
Got 1 Report for testuser1@domain.com on 2023-07-06...
Got 1 Report for testuser1@domain.com on 2023-07-07...
Getting Reports for testuser2@domain.com (2/3) Getting Reports for testuser2@domain.com (2/3)
Got 1 Report for testuser2@domain.com on 2023-07-01...
Got 1 Report for testuser2@domain.com on 2023-07-02...
Got 1 Report for testuser2@domain.com on 2023-07-03...
Got 1 Report for testuser2@domain.com on 2023-07-04...
Got 1 Report for testuser2@domain.com on 2023-07-05...
Got 1 Report for testuser2@domain.com on 2023-07-06...
Got 1 Report for testuser2@domain.com on 2023-07-07...
Getting Reports for testuser3@domain.com (3/3) Getting Reports for testuser3@domain.com (3/3)
Got 1 Report for testuser3@domain.com on 2023-07-01...
Got 1 Report for testuser3@domain.com on 2023-07-02...
Got 1 Report for testuser3@domain.com on 2023-07-03...
Got 1 Report for testuser3@domain.com on 2023-07-04...
Got 1 Report for testuser3@domain.com on 2023-07-05...
Got 1 Report for testuser3@domain.com on 2023-07-06...
Got 1 Report for testuser3@domain.com on 2023-07-07...
email,date,gmail:num_emails_received,gmail:num_emails_sent email,date,gmail:num_emails_received,gmail:num_emails_sent
testuser1@domain.com,2019-02-01,34,0 testuser1@domain.com,2023-07-01,10,1
testuser1@domain.com,2019-02-02,12,0 testuser1@domain.com,2023-07-02,5,1
testuser1@domain.com,2019-02-03,15,0 testuser1@domain.com,2023-07-03,14,3
testuser1@domain.com,2019-02-04,23,0 testuser1@domain.com,2023-07-04,3,0
testuser1@domain.com,2019-02-05,30,0 testuser1@domain.com,2023-07-05,35,4
testuser1@domain.com,2019-02-06,26,0 testuser1@domain.com,2023-07-06,30,2
testuser1@domain.com,2019-02-07,23,0 testuser1@domain.com,2023-07-07,20,0
testuser2@domain.com,2019-02-01,136,18 testuser2@domain.com,2023-07-01,3,1
testuser2@domain.com,2019-02-02,24,0 testuser2@domain.com,2023-07-02,1,0
testuser2@domain.com,2019-02-03,59,1 testuser2@domain.com,2023-07-03,4,0
testuser2@domain.com,2019-02-04,146,19 testuser2@domain.com,2023-07-04,1,0
testuser2@domain.com,2019-02-05,141,17 testuser2@domain.com,2023-07-05,15,0
testuser2@domain.com,2019-02-06,124,36 testuser2@domain.com,2023-07-06,14,0
testuser2@domain.com,2019-02-07,137,26 testuser2@domain.com,2023-07-07,9,1
testuser3@domain.com,2019-02-01,144,5 testuser3@domain.com,2023-07-01,14,0
testuser3@domain.com,2019-02-02,49,0 testuser3@domain.com,2023-07-02,14,0
testuser3@domain.com,2019-02-03,59,1 testuser3@domain.com,2023-07-03,20,0
testuser3@domain.com,2019-02-04,111,4 testuser3@domain.com,2023-07-04,12,0
testuser3@domain.com,2019-02-05,136,11 testuser3@domain.com,2023-07-05,37,2
testuser3@domain.com,2019-02-06,114,12 testuser3@domain.com,2023-07-06,42,0
testuser3@domain.com,2019-02-07,139,10 testuser3@domain.com,2023-07-07,20,0
``` ```
Report on email activity for individual users, aggregate by date. Report on email activity for individual users, aggregate by date across users.
``` ```
gam report users select users testuser1,testuser2,testuser3 fields gmail:num_emails_received,gmail:num_emails_sent range 2019-02-01 2019-02-07 aggregatebydate $ gam report users select users testuser1,testuser2,testuser3@domain.com fields gmail:num_emails_received,gmail:num_emails_sent range 2023-07-01 2023-07-07 aggregatebydate
Getting Reports for testuser1@domain.com (1/3) Getting Reports for testuser1@domain.com (1/3)
Got 1 Report for testuser1@domain.com on 2023-07-01...
Got 1 Report for testuser1@domain.com on 2023-07-02...
Got 1 Report for testuser1@domain.com on 2023-07-03...
Got 1 Report for testuser1@domain.com on 2023-07-04...
Got 1 Report for testuser1@domain.com on 2023-07-05...
Got 1 Report for testuser1@domain.com on 2023-07-06...
Got 1 Report for testuser1@domain.com on 2023-07-07...
Getting Reports for testuser2@domain.com (2/3) Getting Reports for testuser2@domain.com (2/3)
Got 1 Report for testuser2@domain.com on 2023-07-01...
Got 1 Report for testuser2@domain.com on 2023-07-02...
Got 1 Report for testuser2@domain.com on 2023-07-03...
Got 1 Report for testuser2@domain.com on 2023-07-04...
Got 1 Report for testuser2@domain.com on 2023-07-05...
Got 1 Report for testuser2@domain.com on 2023-07-06...
Got 1 Report for testuser2@domain.com on 2023-07-07...
Getting Reports for testuser3@domain.com (3/3) Getting Reports for testuser3@domain.com (3/3)
Got 1 Report for testuser3@domain.com on 2023-07-01...
Got 1 Report for testuser3@domain.com on 2023-07-02...
Got 1 Report for testuser3@domain.com on 2023-07-03...
Got 1 Report for testuser3@domain.com on 2023-07-04...
Got 1 Report for testuser3@domain.com on 2023-07-05...
Got 1 Report for testuser3@domain.com on 2023-07-06...
Got 1 Report for testuser3@domain.com on 2023-07-07...
date,gmail:num_emails_received,gmail:num_emails_sent date,gmail:num_emails_received,gmail:num_emails_sent
2019-02-01,314,23 2023-07-01,27,2
2019-02-02,85,0 2023-07-02,20,1
2019-02-03,133,2 2023-07-03,38,3
2019-02-04,280,23 2023-07-04,16,0
2019-02-05,307,28 2023-07-05,87,6
2019-02-06,264,48 2023-07-06,86,2
2019-02-07,299,36 2023-07-07,49,1
``` ```
Report on email activity for individual users, aggregate by user across dates.
```
$ gam report users select users testuser1,testuser2,testuser3@domain.com fields gmail:num_emails_received,gmail:num_emails_sent range 2023-07-01 2023-07-07 aggregatebyuser
Getting Reports for testuser1@domain.com (1/3)
Got 1 Report for testuser1@domain.com on 2023-07-01...
Got 1 Report for testuser1@domain.com on 2023-07-02...
Got 1 Report for testuser1@domain.com on 2023-07-03...
Got 1 Report for testuser1@domain.com on 2023-07-04...
Got 1 Report for testuser1@domain.com on 2023-07-05...
Got 1 Report for testuser1@domain.com on 2023-07-06...
Got 1 Report for testuser1@domain.com on 2023-07-07...
Getting Reports for testuser2@domain.com (2/3)
Got 1 Report for testuser2@domain.com on 2023-07-01...
Got 1 Report for testuser2@domain.com on 2023-07-02...
Got 1 Report for testuser2@domain.com on 2023-07-03...
Got 1 Report for testuser2@domain.com on 2023-07-04...
Got 1 Report for testuser2@domain.com on 2023-07-05...
Got 1 Report for testuser2@domain.com on 2023-07-06...
Got 1 Report for testuser2@domain.com on 2023-07-07...
Getting Reports for testuser3@domain.com (3/3)
Got 1 Report for testuser3@domain.com on 2023-07-01...
Got 1 Report for testuser3@domain.com on 2023-07-02...
Got 1 Report for testuser3@domain.com on 2023-07-03...
Got 1 Report for testuser3@domain.com on 2023-07-04...
Got 1 Report for testuser3@domain.com on 2023-07-05...
Got 1 Report for testuser3@domain.com on 2023-07-06...
Got 1 Report for testuser3@domain.com on 2023-07-07...
email,gmail:num_emails_received,gmail:num_emails_sent
testuser1@domain.com,117,11
testuser2@domain.com,47,2
testuser3@domain.com,159,2
```
## Monthly Report ## Monthly Report
### An example, running this on 3rd December 2020;- ### An example, running this on 3rd December 2020;-
If combined with a scheduled task or cron job, this will produce an ongoing report with a new tab/sheet for each month. If combined with a scheduled task or cron job, this will produce an ongoing report with a new tab/sheet for each month.