{
  "auth": {
    "oauth2": {
      "scopes": {
        "https://www.googleapis.com/auth/admin.reports.audit.readonly": {
          "description": "View audit reports for your G Suite domain"
        },
        "https://www.googleapis.com/auth/admin.reports.usage.readonly": {
          "description": "View usage reports for your G Suite domain"
        }
      }
    }
  },
  "basePath": "/admin/reports/v1/",
  "baseUrl": "https://www.googleapis.com/admin/reports/v1/",
  "batchPath": "batch/admin/reports_v1",
  "canonicalName": "reports",
  "description": "Fetches reports for the administrators of G Suite customers about the usage, collaboration, security, and risk for their users.",
  "discoveryVersion": "v1",
  "documentationLink": "https://developers.google.com/admin-sdk/reports/",
  "etag": "\"VPK3KBfpaEgZ16pozGOoMYfKc0U/9KOqS4zqNeHxjHku3mNs2ZYTZkM\"",
  "icons": {
    "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
    "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
  },
  "id": "admin:reports_v1",
  "kind": "discovery#restDescription",
  "name": "admin",
  "ownerDomain": "google.com",
  "ownerName": "Google",
  "packagePath": "admin",
  "parameters": {
    "alt": {
      "default": "json",
      "description": "Data format for the response.",
      "enum": [
        "json"
      ],
      "enumDescriptions": [
        "Responses with Content-Type of application/json"
      ],
      "location": "query",
      "type": "string"
    },
    "fields": {
      "description": "Selector specifying which fields to include in a partial response.",
      "location": "query",
      "type": "string"
    },
    "key": {
      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
      "location": "query",
      "type": "string"
    },
    "oauth_token": {
      "description": "OAuth 2.0 token for the current user.",
      "location": "query",
      "type": "string"
    },
    "prettyPrint": {
      "default": "true",
      "description": "Returns response with indentations and line breaks.",
      "location": "query",
      "type": "boolean"
    },
    "quotaUser": {
      "description": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
      "location": "query",
      "type": "string"
    },
    "userIp": {
      "description": "Deprecated. Please use quotaUser instead.",
      "location": "query",
      "type": "string"
    }
  },
  "protocol": "rest",
  "resources": {
    "activities": {
      "methods": {
        "list": {
          "description": "Retrieves a list of activities for a specific customer and application.",
          "httpMethod": "GET",
          "id": "reports.activities.list",
          "parameterOrder": [
            "userKey",
            "applicationName"
          ],
          "parameters": {
            "actorIpAddress": {
              "description": "IP Address of host where the event was performed. Supports both IPv4 and IPv6 addresses.",
              "location": "query",
              "type": "string"
            },
            "applicationName": {
              "description": "Application name for which the events are to be retrieved.",
              "location": "path",
              "pattern": "(admin)|(calendar)|(drive)|(login)|(mobile)|(token)|(groups)|(saml)|(chat)|(gplus)|(rules)|(jamboard)|(meet)|(user_accounts)|(access_transparency)|(groups_enterprise)",
              "required": true,
              "type": "string"
            },
            "customerId": {
              "description": "Represents the customer for which the data is to be fetched.",
              "location": "query",
              "pattern": "C.+",
              "type": "string"
            },
            "endTime": {
              "description": "Return events which occurred at or before this time.",
              "location": "query",
              "pattern": "(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)T(\\d\\d):(\\d\\d):(\\d\\d)(?:\\.(\\d+))?(?:(Z)|([-+])(\\d\\d):(\\d\\d))",
              "type": "string"
            },
            "eventName": {
              "description": "Name of the event being queried.",
              "location": "query",
              "type": "string"
            },
            "filters": {
              "description": "Event parameters in the form [parameter1 name][operator][parameter1 value],[parameter2 name][operator][parameter2 value],...",
              "location": "query",
              "pattern": "(.+[\u003c,\u003c=,==,\u003e=,\u003e,\u003c\u003e].+,)*(.+[\u003c,\u003c=,==,\u003e=,\u003e,\u003c\u003e].+)",
              "type": "string"
            },
            "maxResults": {
              "description": "Number of activity records to be shown in each page.",
              "format": "int32",
              "location": "query",
              "maximum": "1000",
              "minimum": "1",
              "type": "integer"
            },
            "orgUnitID": {
              "default": "",
              "description": "the organizational unit's(OU) ID to filter activities from users belonging to a specific OU or one of its sub-OU(s)",
              "location": "query",
              "pattern": "(id:[a-z0-9]+)",
              "type": "string"
            },
            "pageToken": {
              "description": "Token to specify next page.",
              "location": "query",
              "type": "string"
            },
            "startTime": {
              "description": "Return events which occurred at or after this time.",
              "location": "query",
              "pattern": "(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)T(\\d\\d):(\\d\\d):(\\d\\d)(?:\\.(\\d+))?(?:(Z)|([-+])(\\d\\d):(\\d\\d))",
              "type": "string"
            },
            "userKey": {
              "description": "Represents the profile id or the user email for which the data should be filtered. When 'all' is specified as the userKey, it returns usageReports for all users.",
              "location": "path",
              "required": true,
              "type": "string"
            }
          },
          "path": "activity/users/{userKey}/applications/{applicationName}",
          "response": {
            "$ref": "Activities"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.audit.readonly"
          ],
          "supportsSubscription": true
        },
        "watch": {
          "description": "Push changes to activities",
          "httpMethod": "POST",
          "id": "reports.activities.watch",
          "parameterOrder": [
            "userKey",
            "applicationName"
          ],
          "parameters": {
            "actorIpAddress": {
              "description": "IP Address of host where the event was performed. Supports both IPv4 and IPv6 addresses.",
              "location": "query",
              "type": "string"
            },
            "applicationName": {
              "description": "Application name for which the events are to be retrieved.",
              "location": "path",
              "pattern": "(admin)|(calendar)|(drive)|(login)|(mobile)|(token)|(groups)|(saml)|(chat)|(gplus)|(rules)|(jamboard)|(meet)|(user_accounts)|(access_transparency)|(groups_enterprise)",
              "required": true,
              "type": "string"
            },
            "customerId": {
              "description": "Represents the customer for which the data is to be fetched.",
              "location": "query",
              "pattern": "C.+",
              "type": "string"
            },
            "endTime": {
              "description": "Return events which occurred at or before this time.",
              "location": "query",
              "pattern": "(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)T(\\d\\d):(\\d\\d):(\\d\\d)(?:\\.(\\d+))?(?:(Z)|([-+])(\\d\\d):(\\d\\d))",
              "type": "string"
            },
            "eventName": {
              "description": "Name of the event being queried.",
              "location": "query",
              "type": "string"
            },
            "filters": {
              "description": "Event parameters in the form [parameter1 name][operator][parameter1 value],[parameter2 name][operator][parameter2 value],...",
              "location": "query",
              "pattern": "(.+[\u003c,\u003c=,==,\u003e=,\u003e,\u003c\u003e].+,)*(.+[\u003c,\u003c=,==,\u003e=,\u003e,\u003c\u003e].+)",
              "type": "string"
            },
            "maxResults": {
              "description": "Number of activity records to be shown in each page.",
              "format": "int32",
              "location": "query",
              "maximum": "1000",
              "minimum": "1",
              "type": "integer"
            },
            "orgUnitID": {
              "default": "",
              "description": "the organizational unit's(OU) ID to filter activities from users belonging to a specific OU or one of its sub-OU(s)",
              "location": "query",
              "pattern": "(id:[a-z0-9]+)",
              "type": "string"
            },
            "pageToken": {
              "description": "Token to specify next page.",
              "location": "query",
              "type": "string"
            },
            "startTime": {
              "description": "Return events which occurred at or after this time.",
              "location": "query",
              "pattern": "(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)T(\\d\\d):(\\d\\d):(\\d\\d)(?:\\.(\\d+))?(?:(Z)|([-+])(\\d\\d):(\\d\\d))",
              "type": "string"
            },
            "userKey": {
              "description": "Represents the profile id or the user email for which the data should be filtered. When 'all' is specified as the userKey, it returns usageReports for all users.",
              "location": "path",
              "required": true,
              "type": "string"
            }
          },
          "path": "activity/users/{userKey}/applications/{applicationName}/watch",
          "request": {
            "$ref": "Channel",
            "parameterName": "resource"
          },
          "response": {
            "$ref": "Channel"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.audit.readonly"
          ],
          "supportsSubscription": true
        }
      }
    },
    "channels": {
      "methods": {
        "stop": {
          "description": "Stop watching resources through this channel",
          "httpMethod": "POST",
          "id": "admin.channels.stop",
          "path": "/admin/reports_v1/channels/stop",
          "request": {
            "$ref": "Channel",
            "parameterName": "resource"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.audit.readonly"
          ]
        }
      }
    },
    "customerUsageReports": {
      "methods": {
        "get": {
          "description": "Retrieves a report which is a collection of properties / statistics for a specific customer.",
          "httpMethod": "GET",
          "id": "reports.customerUsageReports.get",
          "parameterOrder": [
            "date"
          ],
          "parameters": {
            "customerId": {
              "description": "Represents the customer for which the data is to be fetched.",
              "location": "query",
              "pattern": "C.+",
              "type": "string"
            },
            "date": {
              "description": "Represents the date in yyyy-mm-dd format for which the data is to be fetched.",
              "location": "path",
              "pattern": "(\\d){4}-(\\d){2}-(\\d){2}",
              "required": true,
              "type": "string"
            },
            "pageToken": {
              "description": "Token to specify next page.",
              "location": "query",
              "type": "string"
            },
            "parameters": {
              "description": "Represents the application name, parameter name pairs to fetch in csv as app_name1:param_name1, app_name2:param_name2.",
              "location": "query",
              "pattern": "(((accounts)|(app_maker)|(apps_scripts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)|(meet)):[^,]+,)*(((accounts)|(app_maker)|(apps_scripts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)|(meet)):[^,]+)",
              "type": "string"
            }
          },
          "path": "usage/dates/{date}",
          "response": {
            "$ref": "UsageReports"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.usage.readonly"
          ]
        }
      }
    },
    "entityUsageReports": {
      "methods": {
        "get": {
          "description": "Retrieves a report which is a collection of properties / statistics for a set of objects.",
          "httpMethod": "GET",
          "id": "reports.entityUsageReports.get",
          "parameterOrder": [
            "entityType",
            "entityKey",
            "date"
          ],
          "parameters": {
            "customerId": {
              "description": "Represents the customer for which the data is to be fetched.",
              "location": "query",
              "pattern": "C.+",
              "type": "string"
            },
            "date": {
              "description": "Represents the date in yyyy-mm-dd format for which the data is to be fetched.",
              "location": "path",
              "pattern": "(\\d){4}-(\\d){2}-(\\d){2}",
              "required": true,
              "type": "string"
            },
            "entityKey": {
              "description": "Represents the key of object for which the data should be filtered.",
              "location": "path",
              "required": true,
              "type": "string"
            },
            "entityType": {
              "description": "Type of object. Should be one of - gplus_communities.",
              "location": "path",
              "pattern": "(gplus_communities)",
              "required": true,
              "type": "string"
            },
            "filters": {
              "description": "Represents the set of filters including parameter operator value.",
              "location": "query",
              "pattern": "(((gplus)):[a-z0-9_]+[\u003c,\u003c=,==,\u003e=,\u003e,!=][^,]+,)*(((gplus)):[a-z0-9_]+[\u003c,\u003c=,==,\u003e=,\u003e,!=][^,]+)",
              "type": "string"
            },
            "maxResults": {
              "description": "Maximum number of results to return. Maximum allowed is 1000",
              "format": "uint32",
              "location": "query",
              "maximum": "1000",
              "type": "integer"
            },
            "pageToken": {
              "description": "Token to specify next page.",
              "location": "query",
              "type": "string"
            },
            "parameters": {
              "description": "Represents the application name, parameter name pairs to fetch in csv as app_name1:param_name1, app_name2:param_name2.",
              "location": "query",
              "pattern": "(((gplus)):[^,]+,)*(((gplus)):[^,]+)",
              "type": "string"
            }
          },
          "path": "usage/{entityType}/{entityKey}/dates/{date}",
          "response": {
            "$ref": "UsageReports"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.usage.readonly"
          ]
        }
      }
    },
    "userUsageReport": {
      "methods": {
        "get": {
          "description": "Retrieves a report which is a collection of properties / statistics for a set of users.",
          "httpMethod": "GET",
          "id": "reports.userUsageReport.get",
          "parameterOrder": [
            "userKey",
            "date"
          ],
          "parameters": {
            "customerId": {
              "description": "Represents the customer for which the data is to be fetched.",
              "location": "query",
              "pattern": "C.+",
              "type": "string"
            },
            "date": {
              "description": "Represents the date in yyyy-mm-dd format for which the data is to be fetched.",
              "location": "path",
              "pattern": "(\\d){4}-(\\d){2}-(\\d){2}",
              "required": true,
              "type": "string"
            },
            "filters": {
              "description": "Represents the set of filters including parameter operator value.",
              "location": "query",
              "pattern": "(((accounts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)):[a-z0-9_]+[\u003c,\u003c=,==,\u003e=,\u003e,!=][^,]+,)*(((accounts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)):[a-z0-9_]+[\u003c,\u003c=,==,\u003e=,\u003e,!=][^,]+)",
              "type": "string"
            },
            "maxResults": {
              "description": "Maximum number of results to return. Maximum allowed is 1000",
              "format": "uint32",
              "location": "query",
              "maximum": "1000",
              "type": "integer"
            },
            "orgUnitID": {
              "default": "",
              "description": "the organizational unit's ID to filter usage parameters from users belonging to a specific OU or one of its sub-OU(s).",
              "location": "query",
              "pattern": "(id:[a-z0-9]+)",
              "type": "string"
            },
            "pageToken": {
              "description": "Token to specify next page.",
              "location": "query",
              "type": "string"
            },
            "parameters": {
              "description": "Represents the application name, parameter name pairs to fetch in csv as app_name1:param_name1, app_name2:param_name2.",
              "location": "query",
              "pattern": "(((accounts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)):[^,]+,)*(((accounts)|(classroom)|(cros)|(gmail)|(calendar)|(docs)|(gplus)|(sites)|(device_management)|(drive)):[^,]+)",
              "type": "string"
            },
            "userKey": {
              "description": "Represents the profile id or the user email for which the data should be filtered.",
              "location": "path",
              "required": true,
              "type": "string"
            }
          },
          "path": "usage/users/{userKey}/dates/{date}",
          "response": {
            "$ref": "UsageReports"
          },
          "scopes": [
            "https://www.googleapis.com/auth/admin.reports.usage.readonly"
          ]
        }
      }
    }
  },
  "revision": "20190210",
  "rootUrl": "https://www.googleapis.com/",
  "schemas": {
    "Activities": {
      "description": "JSON template for a collection of activites.",
      "id": "Activities",
      "properties": {
        "etag": {
          "description": "ETag of the resource.",
          "type": "string"
        },
        "items": {
          "description": "Each record in read response.",
          "items": {
            "$ref": "Activity"
          },
          "type": "array"
        },
        "kind": {
          "default": "admin#reports#activities",
          "description": "Kind of list response this is.",
          "type": "string"
        },
        "nextPageToken": {
          "description": "Token for retrieving the next page",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Activity": {
      "description": "JSON template for the activity resource.",
      "id": "Activity",
      "properties": {
        "actor": {
          "description": "User doing the action.",
          "properties": {
            "callerType": {
              "description": "User or OAuth 2LO request.",
              "type": "string"
            },
            "email": {
              "description": "Email address of the user.",
              "type": "string"
            },
            "key": {
              "description": "For OAuth 2LO API requests, consumer_key of the requestor.",
              "type": "string"
            },
            "profileId": {
              "description": "Obfuscated user id of the user.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "etag": {
          "description": "ETag of the entry.",
          "type": "string"
        },
        "events": {
          "description": "Activity events.",
          "items": {
            "properties": {
              "name": {
                "description": "Name of event.",
                "type": "string"
              },
              "parameters": {
                "description": "Parameter value pairs for various applications.",
                "items": {
                  "properties": {
                    "boolValue": {
                      "description": "Boolean value of the parameter.",
                      "type": "boolean"
                    },
                    "intValue": {
                      "description": "Integral value of the parameter.",
                      "format": "int64",
                      "type": "string"
                    },
                    "multiIntValue": {
                      "description": "Multi-int value of the parameter.",
                      "items": {
                        "format": "int64",
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "multiValue": {
                      "description": "Multi-string value of the parameter.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "The name of the parameter.",
                      "type": "string"
                    },
                    "value": {
                      "description": "String value of the parameter.",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "type": {
                "description": "Type of event.",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "id": {
          "description": "Unique identifier for each activity record.",
          "properties": {
            "applicationName": {
              "description": "Application name to which the event belongs.",
              "type": "string"
            },
            "customerId": {
              "description": "Obfuscated customer ID of the source customer.",
              "type": "string"
            },
            "time": {
              "description": "Time of occurrence of the activity.",
              "format": "date-time",
              "type": "string"
            },
            "uniqueQualifier": {
              "description": "Unique qualifier if multiple events have the same time.",
              "format": "int64",
              "type": "string"
            }
          },
          "type": "object"
        },
        "ipAddress": {
          "description": "IP Address of the user doing the action.",
          "type": "string"
        },
        "kind": {
          "default": "admin#reports#activity",
          "description": "Kind of resource this is.",
          "type": "string"
        },
        "ownerDomain": {
          "description": "Domain of source customer.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Channel": {
      "description": "An notification channel used to watch for resource changes.",
      "id": "Channel",
      "properties": {
        "address": {
          "description": "The address where notifications are delivered for this channel.",
          "type": "string"
        },
        "expiration": {
          "description": "Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.",
          "format": "int64",
          "type": "string"
        },
        "id": {
          "description": "A UUID or similar unique string that identifies this channel.",
          "type": "string"
        },
        "kind": {
          "default": "api#channel",
          "description": "Identifies this as a notification channel used to watch for changes to a resource. Value: the fixed string \"api#channel\".",
          "type": "string"
        },
        "params": {
          "additionalProperties": {
            "description": "Declares a new parameter by name.",
            "type": "string"
          },
          "description": "Additional parameters controlling delivery channel behavior. Optional.",
          "type": "object"
        },
        "payload": {
          "description": "A Boolean value to indicate whether payload is wanted. Optional.",
          "type": "boolean"
        },
        "resourceId": {
          "description": "An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.",
          "type": "string"
        },
        "resourceUri": {
          "description": "A version-specific identifier for the watched resource.",
          "type": "string"
        },
        "token": {
          "description": "An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.",
          "type": "string"
        },
        "type": {
          "description": "The type of delivery mechanism used for this channel.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "UsageReport": {
      "description": "JSON template for a usage report.",
      "id": "UsageReport",
      "properties": {
        "date": {
          "description": "The date to which the record belongs.",
          "readOnly": true,
          "type": "string"
        },
        "entity": {
          "description": "Information about the type of the item.",
          "properties": {
            "customerId": {
              "description": "Obfuscated customer id for the record.",
              "readOnly": true,
              "type": "string"
            },
            "entityId": {
              "description": "Object key. Only relevant if entity.type = \"OBJECT\" Note: external-facing name of report is \"Entities\" rather than \"Objects\".",
              "readOnly": true,
              "type": "string"
            },
            "profileId": {
              "description": "Obfuscated user id for the record.",
              "readOnly": true,
              "type": "string"
            },
            "type": {
              "description": "The type of item, can be customer, user, or entity (aka. object).",
              "readOnly": true,
              "type": "string"
            },
            "userEmail": {
              "description": "user's email. Only relevant if entity.type = \"USER\"",
              "readOnly": true,
              "type": "string"
            }
          },
          "readOnly": true,
          "type": "object"
        },
        "etag": {
          "description": "ETag of the resource.",
          "type": "string"
        },
        "kind": {
          "default": "admin#reports#usageReport",
          "description": "The kind of object.",
          "type": "string"
        },
        "parameters": {
          "description": "Parameter value pairs for various applications.",
          "items": {
            "properties": {
              "boolValue": {
                "description": "Boolean value of the parameter.",
                "readOnly": true,
                "type": "boolean"
              },
              "datetimeValue": {
                "description": "RFC 3339 formatted value of the parameter.",
                "format": "date-time",
                "readOnly": true,
                "type": "string"
              },
              "intValue": {
                "description": "Integral value of the parameter.",
                "format": "int64",
                "readOnly": true,
                "type": "string"
              },
              "msgValue": {
                "description": "Nested message value of the parameter.",
                "items": {
                  "additionalProperties": {
                    "type": "any"
                  },
                  "type": "object"
                },
                "readOnly": true,
                "type": "array"
              },
              "name": {
                "description": "The name of the parameter.",
                "type": "string"
              },
              "stringValue": {
                "description": "String value of the parameter.",
                "readOnly": true,
                "type": "string"
              }
            },
            "type": "object"
          },
          "readOnly": true,
          "type": "array"
        }
      },
      "type": "object"
    },
    "UsageReports": {
      "description": "JSON template for a collection of usage reports.",
      "id": "UsageReports",
      "properties": {
        "etag": {
          "description": "ETag of the resource.",
          "type": "string"
        },
        "kind": {
          "default": "admin#reports#usageReports",
          "description": "The kind of object.",
          "type": "string"
        },
        "nextPageToken": {
          "description": "Token for retrieving the next page",
          "type": "string"
        },
        "usageReports": {
          "description": "Various application parameter records.",
          "items": {
            "$ref": "UsageReport"
          },
          "type": "array"
        },
        "warnings": {
          "description": "Warnings if any.",
          "items": {
            "properties": {
              "code": {
                "description": "Machine readable code / warning type.",
                "type": "string"
              },
              "data": {
                "description": "Key-Value pairs to give detailed information on the warning.",
                "items": {
                  "properties": {
                    "key": {
                      "description": "Key associated with a key-value pair to give detailed information on the warning.",
                      "type": "string"
                    },
                    "value": {
                      "description": "Value associated with a key-value pair to give detailed information on the warning.",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "message": {
                "description": "Human readable message for the warning.",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "servicePath": "admin/reports/v1/",
  "title": "Admin Reports API",
  "version": "reports_v1"
}