# DoubleClick Bid Manager API . reports

## Instance Methods

Close httplib2 connections.

Retrieves stored reports.

Retrieves the next page of results.

### Method Details

`close()`

    Close httplib2 connections.

`listreports(queryId, pageSize=None, pageToken=None, x__xgafv=None)`

    Retrieves stored reports.

    Args:
      queryId: string, Query ID with which the reports are associated. (required)
      pageSize: integer, Maximum number of results per page. Must be between 1 and 100. Defaults to 100 if unspecified.
      pageToken: string, Optional pagination token.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # List reports response.
      "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "doubleclickbidmanager#listReportsResponse".
      "nextPageToken": "A String", # Next page's pagination token if one exists.
      "reports": [ # Retrieved reports.
        { # Represents a report.
          "key": { # Key used to identify a report. # Key used to identify a report.
            "queryId": "A String", # Query ID.
            "reportId": "A String", # Report ID.
          },
          "metadata": { # Report metadata. # Report metadata.
            "googleCloudStoragePath": "A String", # The path to the location in Google Cloud Storage where the report is stored.
            "reportDataEndTimeMs": "A String", # The ending time for the data that is shown in the report.
            "reportDataStartTimeMs": "A String", # The starting time for the data that is shown in the report.
            "status": { # Report status. # Report status.
              "failure": { # An explanation of a report failure. # If the report failed, this records the cause.
                "errorCode": "A String", # Error code that shows why the report was not created.
              },
              "finishTimeMs": "A String", # The time when this report either completed successfully or failed.
              "format": "A String", # The file type of the report.
              "state": "A String", # The state of the report.
            },
          },
          "params": { # Parameters of a query or report. # Report parameters.
            "filters": [ # Filters used to match traffic data in your report.
              { # Filter used to match traffic data in your report.
                "type": "A String", # Filter type.
                "value": "A String", # Filter value.
              },
            ],
            "groupBys": [ # Data is grouped by the filters listed in this field.
              "A String",
            ],
            "includeInviteData": True or False, # Deprecated. This field is no longer in use.
            "metrics": [ # Metrics to include as columns in your report.
              "A String",
            ],
            "options": { # Additional query options. # Additional query options.
              "includeOnlyTargetedUserLists": True or False, # Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.
              "pathQueryOptions": { # Path Query Options for Report Options. # Options that contain Path Filters and Custom Channel Groupings.
                "channelGrouping": { # A channel grouping defines a set of rules that can be used to categorize events in a path report. # Custom Channel Groupings.
                  "fallbackName": "A String", # The name to apply to an event that does not match any of the rules in the channel grouping.
                  "name": "A String", # Channel Grouping name.
                  "rules": [ # Rules within Channel Grouping. There is a limit of 100 rules that can be set per channel grouping.
                    { # A Rule defines a name, and a boolean expression in [conjunctive normal form](http: //mathworld.wolfram.com/ConjunctiveNormalForm.html){.external} that can be // applied to a path event to determine if that name should be applied.
                      "disjunctiveMatchStatements": [
                        { # DisjunctiveMatchStatement that OR's all contained filters.
                          "eventFilters": [ # Filters. There is a limit of 100 filters that can be set per disjunctive match statement.
                            { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
                              "dimensionFilter": { # Dimension Filter on path events. # Filter on a dimension.
                                "filter": "A String", # Dimension the filter is applied to.
                                "match": "A String", # Indicates how the filter should be matched to the value.
                                "values": [ # Value to filter on.
                                  "A String",
                                ],
                              },
                            },
                          ],
                        },
                      ],
                      "name": "A String", # Rule name.
                    },
                  ],
                },
                "pathFilters": [ # Path Filters. There is a limit of 100 path filters that can be set per report.
                  { # Path filters specify which paths to include in a report. A path is the result of combining DV360 events based on User ID to create a workflow of users' actions. When a path filter is set, the resulting report will only include paths that match the specified event at the specified position. All other paths will be excluded.
                    "eventFilters": [ # Filter on an event to be applied to some part of the path.
                      { # Defines the type of filter to be applied to the path, a DV360 event dimension filter.
                        "dimensionFilter": { # Dimension Filter on path events. # Filter on a dimension.
                          "filter": "A String", # Dimension the filter is applied to.
                          "match": "A String", # Indicates how the filter should be matched to the value.
                          "values": [ # Value to filter on.
                            "A String",
                          ],
                        },
                      },
                    ],
                    "pathMatchPosition": "A String", # Indicates the position of the path the filter should match to (first, last, or any event in path).
                  },
                ],
              },
            },
            "type": "A String", # Report type.
          },
        },
      ],
    }

`listreports_next()`

    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.