* Allows the administrators of Google Apps customers to fetch reports about the usage, collaboration, security and risk for their users. *
* ** For more information about this service, see the API * Documentation *
* * @author Google, Inc. */ class Google_Service_Reports extends Google_Service { /** View audit reports of Google Apps for your domain. */ const ADMIN_REPORTS_AUDIT_READONLY = "https://www.googleapis.com/auth/admin.reports.audit.readonly"; /** View usage reports of Google Apps for your domain. */ const ADMIN_REPORTS_USAGE_READONLY = "https://www.googleapis.com/auth/admin.reports.usage.readonly"; public $activities; public $channels; public $customerUsageReports; public $userUsageReport; /** * Constructs the internal representation of the Reports service. * * @param Google_Client $client */ public function __construct(Google_Client $client) { parent::__construct($client); $this->servicePath = 'admin/reports/v1/'; $this->version = 'reports_v1'; $this->serviceName = 'admin'; $this->activities = new Google_Service_Reports_Activities_Resource( $this, $this->serviceName, 'activities', array( 'methods' => array( 'list' => array( 'path' => 'activity/users/{userKey}/applications/{applicationName}', 'httpMethod' => 'GET', 'parameters' => array( 'userKey' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'applicationName' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'startTime' => array( 'location' => 'query', 'type' => 'string', ), 'actorIpAddress' => array( 'location' => 'query', 'type' => 'string', ), 'maxResults' => array( 'location' => 'query', 'type' => 'integer', ), 'eventName' => array( 'location' => 'query', 'type' => 'string', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'filters' => array( 'location' => 'query', 'type' => 'string', ), 'endTime' => array( 'location' => 'query', 'type' => 'string', ), 'customerId' => array( 'location' => 'query', 'type' => 'string', ), ), ),'watch' => array( 'path' => 'activity/users/{userKey}/applications/{applicationName}/watch', 'httpMethod' => 'POST', 'parameters' => array( 'userKey' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'applicationName' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'startTime' => array( 'location' => 'query', 'type' => 'string', ), 'actorIpAddress' => array( 'location' => 'query', 'type' => 'string', ), 'maxResults' => array( 'location' => 'query', 'type' => 'integer', ), 'eventName' => array( 'location' => 'query', 'type' => 'string', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'filters' => array( 'location' => 'query', 'type' => 'string', ), 'endTime' => array( 'location' => 'query', 'type' => 'string', ), 'customerId' => array( 'location' => 'query', 'type' => 'string', ), ), ), ) ) ); $this->channels = new Google_Service_Reports_Channels_Resource( $this, $this->serviceName, 'channels', array( 'methods' => array( 'stop' => array( 'path' => '/admin/reports_v1/channels/stop', 'httpMethod' => 'POST', 'parameters' => array(), ), ) ) ); $this->customerUsageReports = new Google_Service_Reports_CustomerUsageReports_Resource( $this, $this->serviceName, 'customerUsageReports', array( 'methods' => array( 'get' => array( 'path' => 'usage/dates/{date}', 'httpMethod' => 'GET', 'parameters' => array( 'date' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'customerId' => array( 'location' => 'query', 'type' => 'string', ), 'parameters' => array( 'location' => 'query', 'type' => 'string', ), ), ), ) ) ); $this->userUsageReport = new Google_Service_Reports_UserUsageReport_Resource( $this, $this->serviceName, 'userUsageReport', array( 'methods' => array( 'get' => array( 'path' => 'usage/users/{userKey}/dates/{date}', 'httpMethod' => 'GET', 'parameters' => array( 'userKey' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'date' => array( 'location' => 'path', 'type' => 'string', 'required' => true, ), 'parameters' => array( 'location' => 'query', 'type' => 'string', ), 'maxResults' => array( 'location' => 'query', 'type' => 'integer', ), 'pageToken' => array( 'location' => 'query', 'type' => 'string', ), 'filters' => array( 'location' => 'query', 'type' => 'string', ), 'customerId' => array( 'location' => 'query', 'type' => 'string', ), ), ), ) ) ); } } /** * The "activities" collection of methods. * Typical usage is: *
* $adminService = new Google_Service_Reports(...);
* $activities = $adminService->activities;
*
*/
class Google_Service_Reports_Activities_Resource extends Google_Service_Resource
{
/**
* Retrieves a list of activities for a specific customer and application.
* (activities.listActivities)
*
* @param string $userKey
* 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.
* @param string $applicationName
* Application name for which the events are to be retrieved.
* @param array $optParams Optional parameters.
*
* @opt_param string startTime
* Return events which occured at or after this time.
* @opt_param string actorIpAddress
* IP Address of host where the event was performed. Supports both IPv4 and IPv6 addresses.
* @opt_param int maxResults
* Number of activity records to be shown in each page.
* @opt_param string eventName
* Name of the event being queried.
* @opt_param string pageToken
* Token to specify next page.
* @opt_param string filters
* Event parameters in the form [parameter1 name][operator][parameter1 value],[parameter2
* name][operator][parameter2 value],...
* @opt_param string endTime
* Return events which occured at or before this time.
* @opt_param string customerId
* Represents the customer for which the data is to be fetched.
* @return Google_Service_Reports_Activities
*/
public function listActivities($userKey, $applicationName, $optParams = array())
{
$params = array('userKey' => $userKey, 'applicationName' => $applicationName);
$params = array_merge($params, $optParams);
return $this->call('list', array($params), "Google_Service_Reports_Activities");
}
/**
* Push changes to activities (activities.watch)
*
* @param string $userKey
* 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.
* @param string $applicationName
* Application name for which the events are to be retrieved.
* @param Google_Channel $postBody
* @param array $optParams Optional parameters.
*
* @opt_param string startTime
* Return events which occured at or after this time.
* @opt_param string actorIpAddress
* IP Address of host where the event was performed. Supports both IPv4 and IPv6 addresses.
* @opt_param int maxResults
* Number of activity records to be shown in each page.
* @opt_param string eventName
* Name of the event being queried.
* @opt_param string pageToken
* Token to specify next page.
* @opt_param string filters
* Event parameters in the form [parameter1 name][operator][parameter1 value],[parameter2
* name][operator][parameter2 value],...
* @opt_param string endTime
* Return events which occured at or before this time.
* @opt_param string customerId
* Represents the customer for which the data is to be fetched.
* @return Google_Service_Reports_Channel
*/
public function watch($userKey, $applicationName, Google_Service_Reports_Channel $postBody, $optParams = array())
{
$params = array('userKey' => $userKey, 'applicationName' => $applicationName, 'postBody' => $postBody);
$params = array_merge($params, $optParams);
return $this->call('watch', array($params), "Google_Service_Reports_Channel");
}
}
/**
* The "channels" collection of methods.
* Typical usage is:
*
* $adminService = new Google_Service_Reports(...);
* $channels = $adminService->channels;
*
*/
class Google_Service_Reports_Channels_Resource extends Google_Service_Resource
{
/**
* Stop watching resources through this channel (channels.stop)
*
* @param Google_Channel $postBody
* @param array $optParams Optional parameters.
*/
public function stop(Google_Service_Reports_Channel $postBody, $optParams = array())
{
$params = array('postBody' => $postBody);
$params = array_merge($params, $optParams);
return $this->call('stop', array($params));
}
}
/**
* The "customerUsageReports" collection of methods.
* Typical usage is:
*
* $adminService = new Google_Service_Reports(...);
* $customerUsageReports = $adminService->customerUsageReports;
*
*/
class Google_Service_Reports_CustomerUsageReports_Resource extends Google_Service_Resource
{
/**
* Retrieves a report which is a collection of properties / statistics for a
* specific customer. (customerUsageReports.get)
*
* @param string $date
* Represents the date in yyyy-mm-dd format for which the data is to be fetched.
* @param array $optParams Optional parameters.
*
* @opt_param string pageToken
* Token to specify next page.
* @opt_param string customerId
* Represents the customer for which the data is to be fetched.
* @opt_param string parameters
* Represents the application name, parameter name pairs to fetch in csv as app_name1:param_name1,
* app_name2:param_name2.
* @return Google_Service_Reports_UsageReports
*/
public function get($date, $optParams = array())
{
$params = array('date' => $date);
$params = array_merge($params, $optParams);
return $this->call('get', array($params), "Google_Service_Reports_UsageReports");
}
}
/**
* The "userUsageReport" collection of methods.
* Typical usage is:
*
* $adminService = new Google_Service_Reports(...);
* $userUsageReport = $adminService->userUsageReport;
*
*/
class Google_Service_Reports_UserUsageReport_Resource extends Google_Service_Resource
{
/**
* Retrieves a report which is a collection of properties / statistics for a set
* of users. (userUsageReport.get)
*
* @param string $userKey
* Represents the profile id or the user email for which the data should be filtered.
* @param string $date
* Represents the date in yyyy-mm-dd format for which the data is to be fetched.
* @param array $optParams Optional parameters.
*
* @opt_param string parameters
* Represents the application name, parameter name pairs to fetch in csv as app_name1:param_name1,
* app_name2:param_name2.
* @opt_param string maxResults
* Maximum number of results to return. Maximum allowed is 1000
* @opt_param string pageToken
* Token to specify next page.
* @opt_param string filters
* Represents the set of filters including parameter operator value.
* @opt_param string customerId
* Represents the customer for which the data is to be fetched.
* @return Google_Service_Reports_UsageReports
*/
public function get($userKey, $date, $optParams = array())
{
$params = array('userKey' => $userKey, 'date' => $date);
$params = array_merge($params, $optParams);
return $this->call('get', array($params), "Google_Service_Reports_UsageReports");
}
}
class Google_Service_Reports_Activities extends Google_Collection
{
protected $collection_key = 'items';
public $etag;
protected $itemsType = 'Google_Service_Reports_Activity';
protected $itemsDataType = 'array';
public $kind;
public $nextPageToken;
public function setEtag($etag)
{
$this->etag = $etag;
}
public function getEtag()
{
return $this->etag;
}
public function setItems($items)
{
$this->items = $items;
}
public function getItems()
{
return $this->items;
}
public function setKind($kind)
{
$this->kind = $kind;
}
public function getKind()
{
return $this->kind;
}
public function setNextPageToken($nextPageToken)
{
$this->nextPageToken = $nextPageToken;
}
public function getNextPageToken()
{
return $this->nextPageToken;
}
}
class Google_Service_Reports_Activity extends Google_Collection
{
protected $collection_key = 'events';
protected $actorType = 'Google_Service_Reports_ActivityActor';
protected $actorDataType = '';
public $etag;
protected $eventsType = 'Google_Service_Reports_ActivityEvents';
protected $eventsDataType = 'array';
protected $idType = 'Google_Service_Reports_ActivityId';
protected $idDataType = '';
public $ipAddress;
public $kind;
public $ownerDomain;
public function setActor(Google_Service_Reports_ActivityActor $actor)
{
$this->actor = $actor;
}
public function getActor()
{
return $this->actor;
}
public function setEtag($etag)
{
$this->etag = $etag;
}
public function getEtag()
{
return $this->etag;
}
public function setEvents($events)
{
$this->events = $events;
}
public function getEvents()
{
return $this->events;
}
public function setId(Google_Service_Reports_ActivityId $id)
{
$this->id = $id;
}
public function getId()
{
return $this->id;
}
public function setIpAddress($ipAddress)
{
$this->ipAddress = $ipAddress;
}
public function getIpAddress()
{
return $this->ipAddress;
}
public function setKind($kind)
{
$this->kind = $kind;
}
public function getKind()
{
return $this->kind;
}
public function setOwnerDomain($ownerDomain)
{
$this->ownerDomain = $ownerDomain;
}
public function getOwnerDomain()
{
return $this->ownerDomain;
}
}
class Google_Service_Reports_ActivityActor extends Google_Model
{
public $callerType;
public $email;
public $key;
public $profileId;
public function setCallerType($callerType)
{
$this->callerType = $callerType;
}
public function getCallerType()
{
return $this->callerType;
}
public function setEmail($email)
{
$this->email = $email;
}
public function getEmail()
{
return $this->email;
}
public function setKey($key)
{
$this->key = $key;
}
public function getKey()
{
return $this->key;
}
public function setProfileId($profileId)
{
$this->profileId = $profileId;
}
public function getProfileId()
{
return $this->profileId;
}
}
class Google_Service_Reports_ActivityEvents extends Google_Collection
{
protected $collection_key = 'parameters';
public $name;
protected $parametersType = 'Google_Service_Reports_ActivityEventsParameters';
protected $parametersDataType = 'array';
public $type;
public function setName($name)
{
$this->name = $name;
}
public function getName()
{
return $this->name;
}
public function setParameters($parameters)
{
$this->parameters = $parameters;
}
public function getParameters()
{
return $this->parameters;
}
public function setType($type)
{
$this->type = $type;
}
public function getType()
{
return $this->type;
}
}
class Google_Service_Reports_ActivityEventsParameters extends Google_Model
{
public $boolValue;
public $intValue;
public $name;
public $value;
public function setBoolValue($boolValue)
{
$this->boolValue = $boolValue;
}
public function getBoolValue()
{
return $this->boolValue;
}
public function setIntValue($intValue)
{
$this->intValue = $intValue;
}
public function getIntValue()
{
return $this->intValue;
}
public function setName($name)
{
$this->name = $name;
}
public function getName()
{
return $this->name;
}
public function setValue($value)
{
$this->value = $value;
}
public function getValue()
{
return $this->value;
}
}
class Google_Service_Reports_ActivityId extends Google_Model
{
public $applicationName;
public $customerId;
public $time;
public $uniqueQualifier;
public function setApplicationName($applicationName)
{
$this->applicationName = $applicationName;
}
public function getApplicationName()
{
return $this->applicationName;
}
public function setCustomerId($customerId)
{
$this->customerId = $customerId;
}
public function getCustomerId()
{
return $this->customerId;
}
public function setTime($time)
{
$this->time = $time;
}
public function getTime()
{
return $this->time;
}
public function setUniqueQualifier($uniqueQualifier)
{
$this->uniqueQualifier = $uniqueQualifier;
}
public function getUniqueQualifier()
{
return $this->uniqueQualifier;
}
}
class Google_Service_Reports_Channel extends Google_Model
{
public $address;
public $expiration;
public $id;
public $kind;
public $params;
public $payload;
public $resourceId;
public $resourceUri;
public $token;
public $type;
public function setAddress($address)
{
$this->address = $address;
}
public function getAddress()
{
return $this->address;
}
public function setExpiration($expiration)
{
$this->expiration = $expiration;
}
public function getExpiration()
{
return $this->expiration;
}
public function setId($id)
{
$this->id = $id;
}
public function getId()
{
return $this->id;
}
public function setKind($kind)
{
$this->kind = $kind;
}
public function getKind()
{
return $this->kind;
}
public function setParams($params)
{
$this->params = $params;
}
public function getParams()
{
return $this->params;
}
public function setPayload($payload)
{
$this->payload = $payload;
}
public function getPayload()
{
return $this->payload;
}
public function setResourceId($resourceId)
{
$this->resourceId = $resourceId;
}
public function getResourceId()
{
return $this->resourceId;
}
public function setResourceUri($resourceUri)
{
$this->resourceUri = $resourceUri;
}
public function getResourceUri()
{
return $this->resourceUri;
}
public function setToken($token)
{
$this->token = $token;
}
public function getToken()
{
return $this->token;
}
public function setType($type)
{
$this->type = $type;
}
public function getType()
{
return $this->type;
}
}
class Google_Service_Reports_ChannelParams extends Google_Model
{
}
class Google_Service_Reports_UsageReport extends Google_Collection
{
protected $collection_key = 'parameters';
public $date;
protected $entityType = 'Google_Service_Reports_UsageReportEntity';
protected $entityDataType = '';
public $etag;
public $kind;
protected $parametersType = 'Google_Service_Reports_UsageReportParameters';
protected $parametersDataType = 'array';
public function setDate($date)
{
$this->date = $date;
}
public function getDate()
{
return $this->date;
}
public function setEntity(Google_Service_Reports_UsageReportEntity $entity)
{
$this->entity = $entity;
}
public function getEntity()
{
return $this->entity;
}
public function setEtag($etag)
{
$this->etag = $etag;
}
public function getEtag()
{
return $this->etag;
}
public function setKind($kind)
{
$this->kind = $kind;
}
public function getKind()
{
return $this->kind;
}
public function setParameters($parameters)
{
$this->parameters = $parameters;
}
public function getParameters()
{
return $this->parameters;
}
}
class Google_Service_Reports_UsageReportEntity extends Google_Model
{
public $customerId;
public $profileId;
public $type;
public $userEmail;
public function setCustomerId($customerId)
{
$this->customerId = $customerId;
}
public function getCustomerId()
{
return $this->customerId;
}
public function setProfileId($profileId)
{
$this->profileId = $profileId;
}
public function getProfileId()
{
return $this->profileId;
}
public function setType($type)
{
$this->type = $type;
}
public function getType()
{
return $this->type;
}
public function setUserEmail($userEmail)
{
$this->userEmail = $userEmail;
}
public function getUserEmail()
{
return $this->userEmail;
}
}
class Google_Service_Reports_UsageReportParameters extends Google_Collection
{
protected $collection_key = 'msgValue';
public $boolValue;
public $datetimeValue;
public $intValue;
public $msgValue;
public $name;
public $stringValue;
public function setBoolValue($boolValue)
{
$this->boolValue = $boolValue;
}
public function getBoolValue()
{
return $this->boolValue;
}
public function setDatetimeValue($datetimeValue)
{
$this->datetimeValue = $datetimeValue;
}
public function getDatetimeValue()
{
return $this->datetimeValue;
}
public function setIntValue($intValue)
{
$this->intValue = $intValue;
}
public function getIntValue()
{
return $this->intValue;
}
public function setMsgValue($msgValue)
{
$this->msgValue = $msgValue;
}
public function getMsgValue()
{
return $this->msgValue;
}
public function setName($name)
{
$this->name = $name;
}
public function getName()
{
return $this->name;
}
public function setStringValue($stringValue)
{
$this->stringValue = $stringValue;
}
public function getStringValue()
{
return $this->stringValue;
}
}
class Google_Service_Reports_UsageReportParametersMsgValue extends Google_Model
{
}
class Google_Service_Reports_UsageReports extends Google_Collection
{
protected $collection_key = 'warnings';
public $etag;
public $kind;
public $nextPageToken;
protected $usageReportsType = 'Google_Service_Reports_UsageReport';
protected $usageReportsDataType = 'array';
protected $warningsType = 'Google_Service_Reports_UsageReportsWarnings';
protected $warningsDataType = 'array';
public function setEtag($etag)
{
$this->etag = $etag;
}
public function getEtag()
{
return $this->etag;
}
public function setKind($kind)
{
$this->kind = $kind;
}
public function getKind()
{
return $this->kind;
}
public function setNextPageToken($nextPageToken)
{
$this->nextPageToken = $nextPageToken;
}
public function getNextPageToken()
{
return $this->nextPageToken;
}
public function setUsageReports($usageReports)
{
$this->usageReports = $usageReports;
}
public function getUsageReports()
{
return $this->usageReports;
}
public function setWarnings($warnings)
{
$this->warnings = $warnings;
}
public function getWarnings()
{
return $this->warnings;
}
}
class Google_Service_Reports_UsageReportsWarnings extends Google_Collection
{
protected $collection_key = 'data';
public $code;
protected $dataType = 'Google_Service_Reports_UsageReportsWarningsData';
protected $dataDataType = 'array';
public $message;
public function setCode($code)
{
$this->code = $code;
}
public function getCode()
{
return $this->code;
}
public function setData($data)
{
$this->data = $data;
}
public function getData()
{
return $this->data;
}
public function setMessage($message)
{
$this->message = $message;
}
public function getMessage()
{
return $this->message;
}
}
class Google_Service_Reports_UsageReportsWarningsData extends Google_Model
{
public $key;
public $value;
public function setKey($key)
{
$this->key = $key;
}
public function getKey()
{
return $this->key;
}
public function setValue($value)
{
$this->value = $value;
}
public function getValue()
{
return $this->value;
}
}