mirror of
https://github.com/GAM-team/GAM.git
synced 2026-06-28 01:41:36 +00:00
Update Reports.md
This commit is contained in:
Ross Scroggs
141
docs/Reports.md
141
docs/Reports.md
@@ -337,48 +337,123 @@ gam report users parameters accounts:drive_used_quota_in_mb,accounts:total_quota
|
||||
```
|
||||
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
|
||||
Getting Reports for testuser1@domain.com (1/3)
|
||||
$ 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@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)
|
||||
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,date,gmail:num_emails_received,gmail:num_emails_sent
|
||||
testuser1@domain.com,2019-02-01,34,0
|
||||
testuser1@domain.com,2019-02-02,12,0
|
||||
testuser1@domain.com,2019-02-03,15,0
|
||||
testuser1@domain.com,2019-02-04,23,0
|
||||
testuser1@domain.com,2019-02-05,30,0
|
||||
testuser1@domain.com,2019-02-06,26,0
|
||||
testuser1@domain.com,2019-02-07,23,0
|
||||
testuser2@domain.com,2019-02-01,136,18
|
||||
testuser2@domain.com,2019-02-02,24,0
|
||||
testuser2@domain.com,2019-02-03,59,1
|
||||
testuser2@domain.com,2019-02-04,146,19
|
||||
testuser2@domain.com,2019-02-05,141,17
|
||||
testuser2@domain.com,2019-02-06,124,36
|
||||
testuser2@domain.com,2019-02-07,137,26
|
||||
testuser3@domain.com,2019-02-01,144,5
|
||||
testuser3@domain.com,2019-02-02,49,0
|
||||
testuser3@domain.com,2019-02-03,59,1
|
||||
testuser3@domain.com,2019-02-04,111,4
|
||||
testuser3@domain.com,2019-02-05,136,11
|
||||
testuser3@domain.com,2019-02-06,114,12
|
||||
testuser3@domain.com,2019-02-07,139,10
|
||||
testuser1@domain.com,2023-07-01,10,1
|
||||
testuser1@domain.com,2023-07-02,5,1
|
||||
testuser1@domain.com,2023-07-03,14,3
|
||||
testuser1@domain.com,2023-07-04,3,0
|
||||
testuser1@domain.com,2023-07-05,35,4
|
||||
testuser1@domain.com,2023-07-06,30,2
|
||||
testuser1@domain.com,2023-07-07,20,0
|
||||
testuser2@domain.com,2023-07-01,3,1
|
||||
testuser2@domain.com,2023-07-02,1,0
|
||||
testuser2@domain.com,2023-07-03,4,0
|
||||
testuser2@domain.com,2023-07-04,1,0
|
||||
testuser2@domain.com,2023-07-05,15,0
|
||||
testuser2@domain.com,2023-07-06,14,0
|
||||
testuser2@domain.com,2023-07-07,9,1
|
||||
testuser3@domain.com,2023-07-01,14,0
|
||||
testuser3@domain.com,2023-07-02,14,0
|
||||
testuser3@domain.com,2023-07-03,20,0
|
||||
testuser3@domain.com,2023-07-04,12,0
|
||||
testuser3@domain.com,2023-07-05,37,2
|
||||
testuser3@domain.com,2023-07-06,42,0
|
||||
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)
|
||||
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...
|
||||
date,gmail:num_emails_received,gmail:num_emails_sent
|
||||
2019-02-01,314,23
|
||||
2019-02-02,85,0
|
||||
2019-02-03,133,2
|
||||
2019-02-04,280,23
|
||||
2019-02-05,307,28
|
||||
2019-02-06,264,48
|
||||
2019-02-07,299,36
|
||||
2023-07-01,27,2
|
||||
2023-07-02,20,1
|
||||
2023-07-03,38,3
|
||||
2023-07-04,16,0
|
||||
2023-07-05,87,6
|
||||
2023-07-06,86,2
|
||||
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
|
||||
### 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.
|
||||
@@ -395,4 +470,4 @@ $ gam report usage customer parameters meet:total_call_minutes,meet:total_meetin
|
||||
|
||||
**Notes**
|
||||
|
||||
You need to have already created the Google Sheet, to get the File ID. And tdtitle is not optional, although you should be able to specify "" (a blank name) if you just want the Google Sheet to show the updated date.
|
||||
You need to have already created the Google Sheet, to get the File ID. And tdtitle is not optional, although you should be able to specify "" (a blank name) if you just want the Google Sheet to show the updated date.
|
||||
|
||||
Reference in New Issue
Block a user