# Ad Exchange Buyer API II . buyers . filterSets . filteredBids

## Instance Methods

Returns the creatives Resource.

Returns the details Resource.

Close httplib2 connections.

List all reasons for which bids were filtered, with the number of bids filtered for each reason.

Retrieves the next page of results.

### Method Details

`close()`

    Close httplib2 connections.

`list(filterSetName, pageSize=None, pageToken=None, x__xgafv=None)`

    List all reasons for which bids were filtered, with the number of bids filtered for each reason.

    Args:
      filterSetName: string, Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc` (required)
      pageSize: integer, Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.
      pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListFilteredBidsResponse.nextPageToken returned from the previous call to the filteredBids.list method.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for listing all reasons that bids were filtered from the auction.
      "creativeStatusRows": [ # List of rows, with counts of filtered bids aggregated by filtering reason (for example, creative status).
        { # The number of bids with the specified dimension values that did not win the auction (either were filtered pre-auction or lost the auction), as described by the specified creative status.
          "bidCount": { # A metric value, with an expected value and a variance; represents a count that may be either exact or estimated (for example, when sampled). # The number of bids with the specified status.
            "value": "A String", # The expected value of the metric.
            "variance": "A String", # The variance (for example, square of the standard deviation) of the metric value. If value is exact, variance is 0. Can be used to calculate margin of error as a percentage of value, using the following formula, where Z is the standard constant that depends on the preferred size of the confidence interval (for example, for 90% confidence interval, use Z = 1.645): marginOfError = 100 * Z * sqrt(variance) / value
          },
          "creativeStatusId": 42, # The ID of the creative status. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).
          "rowDimensions": { # A response may include multiple rows, breaking down along various dimensions. Encapsulates the values of all dimensions for a given row. # The values of all dimensions associated with metric values in this row.
            "publisherIdentifier": "A String", # The publisher identifier for this row, if a breakdown by [BreakdownDimension.PUBLISHER_IDENTIFIER](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension) was requested.
            "timeInterval": { # An interval of time, with an absolute start and end. # The time interval that this row represents.
              "endTime": "A String", # The timestamp marking the end of the range (exclusive) for which data is included.
              "startTime": "A String", # The timestamp marking the start of the range (inclusive) for which data is included.
            },
          },
        },
      ],
      "nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the ListFilteredBidsRequest.pageToken field in the subsequent call to the filteredBids.list method to retrieve the next page of results.
    }

`list_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.