DFA Reporting API v1.1
This documentation has been automatically generated using information supplied by the Google API Discovery service.
1 API Parameters
procedure
(_ [ #:alt alt #:fields fields #:key key #:oauth_token oauth_token #:prettyPrint prettyPrint #:quotaUser quotaUser #:userIp userIp]) → jsexpr? alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
This is not actually a function. This is just using Scribble’s defproc form to list the optional keyword arguments that may be passed to all functions for this service.
fields: Selector specifying which fields to include in a partial response.
key: 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.
oauth_token: OAuth 2.0 token for the current user.
prettyPrint: Returns response with indentations and line breaks.
quotaUser: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.
userIp: IP address of the site where the request originates. Use this if you want to enforce per-user limits.
2 Resources
2.1 files
procedure
profileId : string? sortOrder : string? = 'N/A maxResults : string? = 'N/A pageToken : string? = 'N/A sortField : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
profileId: The DFA profile ID.
sortOrder: Order of sorted results, default is ’DESCENDING’.
maxResults: Maximum number of results to return.
pageToken: The value of the nextToken from the previous result page.
sortField: The field by which to sort the list.
2.2 dimensionValues
procedure
→ jsexpr? profileId : string? maxResults : string? = 'N/A pageToken : string? = 'N/A kind : string? = 'N/A endDate : string? = 'N/A startDate : string? = 'N/A filters : string? = 'N/A dimensionName : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
profileId: The DFA user profile ID.
maxResults: Maximum number of results to return.
pageToken: The value of the nextToken from the previous result page.
kind: The kind of request this is, in this case dfareporting#dimensionValueRequest.
endDate: The end date of the date range for which to retrieve dimension values. A string of the format: "yyyy-MM-dd".
startDate: The start date of the date range for which to retrieve dimension values. A string of the format: "yyyy-MM-dd".
filters: The list of filters by which to filter values. The filters are ANDed.
dimensionName: The name of the dimension for which values should be requested.
2.3 reports
3 Resources
procedure
profileId : string? sortOrder : string? = 'N/A maxResults : string? = 'N/A pageToken : string? = 'N/A sortField : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
profileId: The DFA user profile ID.
sortOrder: Order of sorted results, default is ’DESCENDING’.
maxResults: Maximum number of results to return.
pageToken: The value of the nextToken from the previous result page.
sortField: The field by which to sort the list.
procedure
reportId : string? profileId : string? alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
reportId: The ID of the report.
profileId: The DFA user profile ID.
procedure
→ jsexpr? profileId : string? format : string? = 'N/A id : string? = 'N/A name : string? = 'N/A type : string? = 'N/A kind : string? = 'N/A etag : string? = 'N/A fileName : string? = 'N/A lastModifiedTime : string? = 'N/A accountId : string? = 'N/A activeGrpCriteria : string? = 'N/A criteria : string? = 'N/A crossDimensionReachCriteria : string? = 'N/A delivery : string? = 'N/A floodlightCriteria : string? = 'N/A ownerProfileId : string? = 'N/A pathToConversionCriteria : string? = 'N/A reachCriteria : string? = 'N/A schedule : string? = 'N/A subAccountId : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
profileId: The DFA user profile ID.
format: The output format of the report, currently only "CSV" is supported. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report’s size exceeds the format’s capabilities. "CSV" will then be the fallback format.
id: The unique ID identifying this report resource.
name: The name of the report.
type: The type of the report, one of: - STANDARD - REACH - ACTIVE_GRP - PATH_TO_CONVERSION - FLOODLIGHT - CROSS_DIMENSION_REACH
kind: The kind of resource this is, in this case dfareporting#report.
etag: The eTag of this response for caching purposes.
fileName: The file name used when generating report files for this report.
lastModifiedTime: The timestamp (in milliseconds since epoch) of when this report was last modified.
accountId: The account ID to which this report belongs.
activeGrpCriteria: The report criteria for a report of type "ACTIVE_GRP".
criteria: The report criteria for a report of type "STANDARD".
crossDimensionReachCriteria: The report criteria for a report of type "CROSS_DIMENSION_REACH".
delivery: The report’s email delivery settings.
floodlightCriteria: The report criteria for a report of type "FLOODLIGHT".
ownerProfileId: The user profile id of the owner of this report.
pathToConversionCriteria: The report criteria for a report of type "PATH_TO_CONVERSION".
reachCriteria: The report criteria for a report of type "REACH".
schedule: The report’s schedule. Can only be set if the report’s ’dateRange’ is a relative date range and the relative date range is not "TODAY".
subAccountId: The subbaccount ID to which this report belongs if applicable.
procedure
→ jsexpr? reportId : string? profileId : string? format : string? = 'N/A id : string? = 'N/A name : string? = 'N/A type : string? = 'N/A kind : string? = 'N/A etag : string? = 'N/A fileName : string? = 'N/A lastModifiedTime : string? = 'N/A accountId : string? = 'N/A activeGrpCriteria : string? = 'N/A criteria : string? = 'N/A crossDimensionReachCriteria : string? = 'N/A delivery : string? = 'N/A floodlightCriteria : string? = 'N/A ownerProfileId : string? = 'N/A pathToConversionCriteria : string? = 'N/A reachCriteria : string? = 'N/A schedule : string? = 'N/A subAccountId : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
reportId: The ID of the report.
profileId: The DFA user profile ID.
format: The output format of the report, currently only "CSV" is supported. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report’s size exceeds the format’s capabilities. "CSV" will then be the fallback format.
id: The unique ID identifying this report resource.
name: The name of the report.
type: The type of the report, one of: - STANDARD - REACH - ACTIVE_GRP - PATH_TO_CONVERSION - FLOODLIGHT - CROSS_DIMENSION_REACH
kind: The kind of resource this is, in this case dfareporting#report.
etag: The eTag of this response for caching purposes.
fileName: The file name used when generating report files for this report.
lastModifiedTime: The timestamp (in milliseconds since epoch) of when this report was last modified.
accountId: The account ID to which this report belongs.
activeGrpCriteria: The report criteria for a report of type "ACTIVE_GRP".
criteria: The report criteria for a report of type "STANDARD".
crossDimensionReachCriteria: The report criteria for a report of type "CROSS_DIMENSION_REACH".
delivery: The report’s email delivery settings.
floodlightCriteria: The report criteria for a report of type "FLOODLIGHT".
ownerProfileId: The user profile id of the owner of this report.
pathToConversionCriteria: The report criteria for a report of type "PATH_TO_CONVERSION".
reachCriteria: The report criteria for a report of type "REACH".
schedule: The report’s schedule. Can only be set if the report’s ’dateRange’ is a relative date range and the relative date range is not "TODAY".
subAccountId: The subbaccount ID to which this report belongs if applicable.
procedure
reportId : string? profileId : string? synchronous : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
reportId: The ID of the report.
profileId: The DFA profile ID.
synchronous: If set and true, tries to run the report synchronously.
procedure
(dfareporting-reports-delete #:reportId reportId #:profileId profileId [ #:alt alt #:fields fields #:key key #:oauth_token oauth_token #:prettyPrint prettyPrint #:quotaUser quotaUser #:userIp userIp]) → jsexpr? reportId : string? profileId : string? alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
reportId: The ID of the report.
profileId: The DFA user profile ID.
procedure
→ jsexpr? reportId : string? profileId : string? format : string? = 'N/A id : string? = 'N/A name : string? = 'N/A type : string? = 'N/A kind : string? = 'N/A etag : string? = 'N/A fileName : string? = 'N/A lastModifiedTime : string? = 'N/A accountId : string? = 'N/A activeGrpCriteria : string? = 'N/A criteria : string? = 'N/A crossDimensionReachCriteria : string? = 'N/A delivery : string? = 'N/A floodlightCriteria : string? = 'N/A ownerProfileId : string? = 'N/A pathToConversionCriteria : string? = 'N/A reachCriteria : string? = 'N/A schedule : string? = 'N/A subAccountId : string? = 'N/A alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
reportId: The ID of the report.
profileId: The DFA user profile ID.
format: The output format of the report, currently only "CSV" is supported. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report’s size exceeds the format’s capabilities. "CSV" will then be the fallback format.
id: The unique ID identifying this report resource.
name: The name of the report.
type: The type of the report, one of: - STANDARD - REACH - ACTIVE_GRP - PATH_TO_CONVERSION - FLOODLIGHT - CROSS_DIMENSION_REACH
kind: The kind of resource this is, in this case dfareporting#report.
etag: The eTag of this response for caching purposes.
fileName: The file name used when generating report files for this report.
lastModifiedTime: The timestamp (in milliseconds since epoch) of when this report was last modified.
accountId: The account ID to which this report belongs.
activeGrpCriteria: The report criteria for a report of type "ACTIVE_GRP".
criteria: The report criteria for a report of type "STANDARD".
crossDimensionReachCriteria: The report criteria for a report of type "CROSS_DIMENSION_REACH".
delivery: The report’s email delivery settings.
floodlightCriteria: The report criteria for a report of type "FLOODLIGHT".
ownerProfileId: The user profile id of the owner of this report.
pathToConversionCriteria: The report criteria for a report of type "PATH_TO_CONVERSION".
reachCriteria: The report criteria for a report of type "REACH".
schedule: The report’s schedule. Can only be set if the report’s ’dateRange’ is a relative date range and the relative date range is not "TODAY".
subAccountId: The subbaccount ID to which this report belongs if applicable.
3.1 userProfiles
procedure
(dfareporting-userProfiles-list [ #:alt alt #:fields fields #:key key #:oauth_token oauth_token #:prettyPrint prettyPrint #:quotaUser quotaUser #:userIp userIp]) → jsexpr? alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
procedure
(dfareporting-userProfiles-get #:profileId profileId [ #:alt alt #:fields fields #:key key #:oauth_token oauth_token #:prettyPrint prettyPrint #:quotaUser quotaUser #:userIp userIp]) → jsexpr? profileId : string? alt : string? = 'N/A fields : string? = 'N/A key : string? = (api-key) oauth_token : string? = 'N/A prettyPrint : string? = 'N/A quotaUser : string? = 'N/A userIp : string? = 'N/A
profileId: The user profile ID.