Returns the compatibleFields Resource.
Returns the files Resource.
Close httplib2 connections.
delete(profileId, reportId, x__xgafv=None)
Deletes a report by its ID.
get(profileId, reportId, x__xgafv=None)
Retrieves a report by its ID.
insert(profileId, body=None, x__xgafv=None)
Creates a report.
Retrieves list of reports.
list_next(previous_request, previous_response)
Retrieves the next page of results.
patch(profileId, reportId, body=None, x__xgafv=None)
Updates an existing report. This method supports patch semantics.
run(profileId, reportId, synchronous=None, x__xgafv=None)
Runs a report.
update(profileId, reportId, body=None, x__xgafv=None)
Updates a report.
close()
Close httplib2 connections.
delete(profileId, reportId, x__xgafv=None)
Deletes a report by its ID. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) reportId: string, The ID of the report. (required) x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format
get(profileId, reportId, x__xgafv=None)
Retrieves a report by its ID. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) reportId: string, The ID of the report. (required) x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, }
insert(profileId, body=None, x__xgafv=None)
Creates a report. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) body: object, The request body. The object takes the form of: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, } x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, }
list(profileId, sortField=None, pageToken=None, sortOrder=None, maxResults=None, scope=None, x__xgafv=None)
Retrieves list of reports. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) sortField: string, The field by which to sort the list. Allowed values ID - Sort by report ID. LAST_MODIFIED_TIME - Sort by 'lastModifiedTime' field. NAME - Sort by name of reports. pageToken: string, The value of the nextToken from the previous result page. sortOrder: string, Order of sorted results. Allowed values ASCENDING - Ascending order. DESCENDING - Descending order. maxResults: integer, Maximum number of results to return. scope: string, The scope that defines which results are returned. Allowed values ALL - All reports in account. MINE - My reports. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents the list of reports. "nextPageToken": "A String", # Continuation token used to page through reports. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted. "kind": "A String", # The kind of list this is, in this case dfareporting#reportList. "etag": "A String", # The eTag of this response for caching purposes. "items": [ # The reports returned in this response. { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, }, ], }
list_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.
patch(profileId, reportId, body=None, x__xgafv=None)
Updates an existing report. This method supports patch semantics. Args: profileId: string, The DFA user profile ID. (required) reportId: string, The ID of the report. (required) body: object, The request body. The object takes the form of: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, } x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, }
run(profileId, reportId, synchronous=None, x__xgafv=None)
Runs a report. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) reportId: string, The ID of the report. (required) synchronous: boolean, If set and true, tries to run the report synchronously. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE". "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified. "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#file". "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "urls": { # The URLs where the completed report file can be downloaded. "apiUrl": "A String", # The URL for downloading the report data through the API. "browserUrl": "A String", # The URL for downloading the report data through a browser. }, "status": "A String", # The status of the report file. "format": "A String", # The output format of the report. Only available once the file is available. "reportId": "A String", # The ID of the report this file was generated from. "etag": "A String", # Etag of this resource. "id": "A String", # The unique ID of this report file. "fileName": "A String", # The filename of the file. }
update(profileId, reportId, body=None, x__xgafv=None)
Updates a report. Args: profileId: string, The Campaign Manager 360 user profile ID. (required) reportId: string, The ID of the report. (required) body: object, The request body. The object takes the form of: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, } x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # Represents a Report resource. "fileName": "A String", # The filename used when generating report files for this report. "pathCriteria": { # The report criteria for a report of type "PATH". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "accountId": "A String", # The account ID to which this report belongs. "delivery": { # The report's email delivery settings. "message": "A String", # The message to be sent with each email. "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. "emailOwner": True or False, # Whether the report should be emailed to the report owner. "recipients": [ # The list of recipients to which to email the report. { # Represents a recipient. "deliveryType": "A String", # The delivery type for the recipient. "email": "A String", # The email address of the recipient. "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. }, ], }, "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". "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. "expirationDate": "A String", "startDate": "A String", "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. "A String", ], "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. }, "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. "dimensionFilters": [ # The list of filters on which dimensions are filtered. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimension": "A String", # The dimension option. "breakdown": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "overlapMetricNames": [ # The list of names of overlap metrics the report should include. "A String", ], }, "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. "etag": "A String", # The eTag of this response for caching purposes. "id": "A String", # The unique ID identifying this report resource. "pathAttributionCriteria": { # The report criteria for a report of type "PATH_ATTRIBUTION". "pathFilters": [ # Path Filters. { # Represents a DfaReporting path filter. "eventFilters": [ # Event filters in path report. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], "pathMatchPosition": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathFilter. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "customChannelGrouping": { # Represents a DfaReporting channel grouping. # Channel Grouping. "fallbackName": "A String", # ChannelGrouping fallback name. "name": "A String", # ChannelGrouping name. "rules": [ # The rules contained within this channel grouping. { # Represents a DfaReporting channel grouping rule. "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGroupingRule. "disjunctiveMatchStatements": [ # The disjunctive match statements contained within this rule. { # Represents a Disjunctive Match Statement resource, which is a conjunction (and) of disjunctive (or) boolean statements. "kind": "A String", # The kind of resource this is, in this case dfareporting#disjunctiveMatchStatement. "eventFilters": [ # The event filters contained within this disjunctive match statement. { # Represents a DfaReporting event filter. "kind": "A String", # The kind of resource this is, in this case dfareporting#eventFilter. "dimensionFilter": { # Represents a PathReportDimensionValue resource. # The dimension filter contained within this EventFilter. "dimensionName": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#pathReportDimensionValue. "ids": [ # The possible ID's associated with the value if available. "A String", ], "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "values": [ # The possible values of the dimension. "A String", ], }, }, ], }, ], "name": "A String", # Rule name. }, ], "kind": "A String", # The kind of resource this is, in this case dfareporting#channelGrouping. }, }, "name": "A String", # The name of the report. "kind": "A String", # The kind of resource this is, in this case dfareporting#report. "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "activityFilters": [ # The list of 'dfa:activity' values to filter on. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reportProperties": { # The properties of the report. "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. "includeAttributedIPConversions": True or False, # Deprecated: has no effect. "clicksLookbackWindow": 42, # DFA checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. "impressionsLookbackWindow": 42, # DFA checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. }, "conversionDimensions": [ # The list of conversion dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], }, "ownerProfileId": "A String", # The user profile id of the owner of this report. "type": "A String", # The type of the report. "format": "A String", # The output format of the report. 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. "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "metricNames": [ # The list of names of metrics the report should include. "A String", ], "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, "reportProperties": { # The properties of the report. "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "customRichMediaEvents": [ # The list of custom rich media events to include. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "criteria": { # The report criteria for a report of type "STANDARD". "metricNames": [ # The list of names of metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "dateRange": { # Represents a date range. # The date range for which this report should be run. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of standard dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], }, "reachCriteria": { # The report criteria for a report of type "REACH". "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], }, "metricNames": [ # The list of names of metrics the report should include. "A String", ], "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "dimensions": [ # The list of dimensions the report should include. { # Represents a sorted dimension. "sortOrder": "A String", # An optional sort order for the dimension column. "name": "A String", # The name of the dimension. "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. }, ], "dateRange": { # Represents a date range. # The date range this report should be run for. "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. "endDate": "A String", "relativeDateRange": "A String", # The date range relative to the date of when the report is run. "startDate": "A String", }, "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. "A String", ], "activities": { # Represents an activity group. # Activity group. "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". { # Represents a DimensionValue resource. "value": "A String", # The value of the dimension. "id": "A String", # The ID associated with the value if available. "dimensionName": "A String", # The name of the dimension. "etag": "A String", # The eTag of this response for caching purposes. "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. }, ], "metricNames": [ # List of names of floodlight activity metrics. "A String", ], }, }, }