Reference documentation and code samples for the Google Analytics Admin V1beta Client class RunAccessReportRequest.
The request for a Data Access Record Report.
Generated from protobuf message google.analytics.admin.v1beta.RunAccessReportRequest
Namespace
Google \ Analytics \ Admin \ V1betaMethods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ entity
string
The Data Access Report supports requesting at the property level or account level. If requested at the account level, Data Access Reports include all access for all properties under that account. To request at the property level, entity should be for example 'properties/123' if "123" is your Google Analytics property ID. To request at the account level, entity should be for example 'accounts/1234' if "1234" is your Google Analytics Account ID.
↳ dimensions
array< AccessDimension
>
The dimensions requested and displayed in the response. Requests are allowed up to 9 dimensions.
↳ metrics
array< AccessMetric
>
The metrics requested and displayed in the response. Requests are allowed up to 10 metrics.
↳ date_ranges
array< AccessDateRange
>
Date ranges of access records to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the access records for the overlapping days is included in the response rows for both date ranges. Requests are allowed up to 2 date ranges.
↳ dimension_filter
AccessFilterExpression
Dimension filters let you restrict report response to specific dimension values which match the filter. For example, filtering on access records of a single user. To learn more, see Fundamentals of Dimension Filters for examples. Metrics cannot be used in this filter.
↳ metric_filter
AccessFilterExpression
Metric filters allow you to restrict report response to specific metric values which match the filter. Metric filters are applied after aggregating the report's rows, similar to SQL having-clause. Dimensions cannot be used in this filter.
↳ offset
int|string
The row count of the start row. The first row is counted as row 0. If offset is unspecified, it is treated as 0. If offset is zero, then this method will return the first page of results with limit
entries. To learn more about this pagination parameter, see Pagination
.
↳ limit
int|string
The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 100,000 rows per request, no matter how many you ask for. limit
must be positive. The API may return fewer rows than the requested limit
, if there aren't as many remaining rows as the limit
. For instance, there are fewer than 300 possible values for the dimension country
, so when reporting on only country
, you can't get more than 300 rows, even if you set limit
to a higher value. To learn more about this pagination parameter, see Pagination
.
↳ time_zone
string
This request's time zone if specified. If unspecified, the property's time zone is used. The request's time zone is used to interpret the start & end dates of the report. Formatted as strings from the IANA Time Zone database ( https://www.iana.org/time-zones ); for example "America/New_York" or "Asia/Tokyo".
↳ order_bys
↳ return_entity_quota
bool
Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in AccessQuota . For account-level requests, this field must be false.
↳ include_all_users
bool
Optional. Determines whether to include users who have never made an API call in the response. If true, all users with access to the specified property or account are included in the response, regardless of whether they have made an API call or not. If false, only the users who have made an API call will be included.
↳ expand_groups
bool
Optional. Decides whether to return the users within user groups. This field works only when include_all_users is set to true. If true, it will return all users with access to the specified property or account. If false, only the users with direct access will be returned.
getEntity
The Data Access Report supports requesting at the property level or account level. If requested at the account level, Data Access Reports include all access for all properties under that account.
To request at the property level, entity should be for example 'properties/123' if "123" is your Google Analytics property ID. To request at the account level, entity should be for example 'accounts/1234' if "1234" is your Google Analytics Account ID.
string
setEntity
The Data Access Report supports requesting at the property level or account level. If requested at the account level, Data Access Reports include all access for all properties under that account.
To request at the property level, entity should be for example 'properties/123' if "123" is your Google Analytics property ID. To request at the account level, entity should be for example 'accounts/1234' if "1234" is your Google Analytics Account ID.
var
string
$this
getDimensions
The dimensions requested and displayed in the response. Requests are allowed up to 9 dimensions.
setDimensions
The dimensions requested and displayed in the response. Requests are allowed up to 9 dimensions.
$this
getMetrics
The metrics requested and displayed in the response. Requests are allowed up to 10 metrics.
setMetrics
The metrics requested and displayed in the response. Requests are allowed up to 10 metrics.
$this
getDateRanges
Date ranges of access records to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the access records for the overlapping days is included in the response rows for both date ranges. Requests are allowed up to 2 date ranges.
setDateRanges
Date ranges of access records to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the access records for the overlapping days is included in the response rows for both date ranges. Requests are allowed up to 2 date ranges.
$this
getDimensionFilter
Dimension filters let you restrict report response to specific dimension values which match the filter. For example, filtering on access records of a single user. To learn more, see Fundamentals of Dimension Filters for examples. Metrics cannot be used in this filter.
hasDimensionFilter
clearDimensionFilter
setDimensionFilter
Dimension filters let you restrict report response to specific dimension values which match the filter. For example, filtering on access records of a single user. To learn more, see Fundamentals of Dimension Filters for examples. Metrics cannot be used in this filter.
$this
getMetricFilter
Metric filters allow you to restrict report response to specific metric values which match the filter. Metric filters are applied after aggregating the report's rows, similar to SQL having-clause. Dimensions cannot be used in this filter.
hasMetricFilter
clearMetricFilter
setMetricFilter
Metric filters allow you to restrict report response to specific metric values which match the filter. Metric filters are applied after aggregating the report's rows, similar to SQL having-clause. Dimensions cannot be used in this filter.
$this
getOffset
The row count of the start row. The first row is counted as row 0. If
offset is unspecified, it is treated as 0. If offset is zero, then this
method will return the first page of results with limit
entries.
To learn more about this pagination parameter, see Pagination .
int|string
setOffset
The row count of the start row. The first row is counted as row 0. If
offset is unspecified, it is treated as 0. If offset is zero, then this
method will return the first page of results with limit
entries.
To learn more about this pagination parameter, see Pagination .
var
int|string
$this
getLimit
The number of rows to return. If unspecified, 10,000 rows are returned. The
API returns a maximum of 100,000 rows per request, no matter how many you
ask for. limit
must be positive.
The API may return fewer rows than the requested limit
, if there aren't
as many remaining rows as the limit
. For instance, there are fewer than
300 possible values for the dimension country
, so when reporting on only country
, you can't get more than 300 rows, even if you set limit
to a
higher value.
To learn more about this pagination parameter, see Pagination
.
int|string
setLimit
The number of rows to return. If unspecified, 10,000 rows are returned. The
API returns a maximum of 100,000 rows per request, no matter how many you
ask for. limit
must be positive.
The API may return fewer rows than the requested limit
, if there aren't
as many remaining rows as the limit
. For instance, there are fewer than
300 possible values for the dimension country
, so when reporting on only country
, you can't get more than 300 rows, even if you set limit
to a
higher value.
To learn more about this pagination parameter, see Pagination
.
var
int|string
$this
getTimeZone
This request's time zone if specified. If unspecified, the property's time zone is used. The request's time zone is used to interpret the start & end dates of the report.
Formatted as strings from the IANA Time Zone database ( https://www.iana.org/time-zones ); for example "America/New_York" or "Asia/Tokyo".
string
setTimeZone
This request's time zone if specified. If unspecified, the property's time zone is used. The request's time zone is used to interpret the start & end dates of the report.
Formatted as strings from the IANA Time Zone database ( https://www.iana.org/time-zones ); for example "America/New_York" or "Asia/Tokyo".
var
string
$this
getOrderBys
Specifies how rows are ordered in the response.
setOrderBys
Specifies how rows are ordered in the response.
$this
getReturnEntityQuota
Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in AccessQuota . For account-level requests, this field must be false.
bool
setReturnEntityQuota
Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in AccessQuota . For account-level requests, this field must be false.
var
bool
$this
getIncludeAllUsers
Optional. Determines whether to include users who have never made an API call in the response. If true, all users with access to the specified property or account are included in the response, regardless of whether they have made an API call or not. If false, only the users who have made an API call will be included.
bool
setIncludeAllUsers
Optional. Determines whether to include users who have never made an API call in the response. If true, all users with access to the specified property or account are included in the response, regardless of whether they have made an API call or not. If false, only the users who have made an API call will be included.
var
bool
$this
getExpandGroups
Optional. Decides whether to return the users within user groups. This field works only when include_all_users is set to true. If true, it will return all users with access to the specified property or account.
If false, only the users with direct access will be returned.
bool
setExpandGroups
Optional. Decides whether to return the users within user groups. This field works only when include_all_users is set to true. If true, it will return all users with access to the specified property or account.
If false, only the users with direct access will be returned.
var
bool
$this
