"description":"Accesses the latest features for managing Ad Exchange accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.",
"description":"The unique numerical ID of the invitation that is sent to the user.\nThe value of this field is ignored in create operations.",
"format":"int64",
"type":"string"
},
"email":{
"description":"The email address to which the invitation is sent. Email\naddresses should be unique among all client users under each sponsor\nbuyer.",
"type":"string"
},
"clientAccountId":{
"description":"Numerical account ID of the client buyer\nthat the invited user is associated with.\nThe value of this field is ignored in create operations.",
"description":"An invitation for a new client user to get access to the Ad Exchange\nBuyer UI.\nAll fields are required unless otherwise specified."
},
"ListClientUserInvitationsResponse":{
"type":"object",
"properties":{
"invitations":{
"description":"The returned list of client users.",
"type":"array",
"items":{
"$ref":"ClientUserInvitation"
}
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientUserInvitationsRequest.pageToken\nfield in the subsequent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of results.",
"type":"string"
}
},
"id":"ListClientUserInvitationsResponse"
},
"ListClientUsersResponse":{
"type":"object",
"properties":{
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientUsersRequest.pageToken\nfield in the subsequent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of results.",
"type":"string"
},
"users":{
"description":"The returned list of client users.",
"type":"array",
"items":{
"$ref":"ClientUser"
}
}
},
"id":"ListClientUsersResponse"
},
"ListCreativeStatusBreakdownByDetailResponse":{
"type":"object",
"properties":{
"filteredBidDetailRows":{
"description":"List of rows, with counts of bids with a given creative status aggregated\nby detail.",
"type":"array",
"items":{
"$ref":"FilteredBidDetailRow"
}
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByDetailRequest.pageToken\nfield in the subsequent call to the filteredBids.details.list\nmethod to retrieve the next page of results.",
"type":"string"
},
"detailType":{
"type":"string",
"enumDescriptions":[
"A placeholder for an undefined status.\nThis value will never be returned in responses.",
"Indicates that the detail ID refers to a creative attribute; see\n[publisher-excludable-creative-attributes](https://developers.google.com/ad-exchange/rtb/downloads/publisher-excludable-creative-attributes).",
"Indicates that the detail ID refers to a vendor; see\n[vendors](https://developers.google.com/ad-exchange/rtb/downloads/vendors).",
"Indicates that the detail ID refers to a sensitive category; see\n[ad-sensitive-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-sensitive-categories).",
"Indicates that the detail ID refers to a product category; see\n[ad-product-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-product-categories).",
"Indicates that the detail ID refers to a disapproval reason; see\nDisapprovalReason enum in [snippet-status-report-proto](https://developers.google.com/ad-exchange/rtb/downloads/snippet-status-report-proto)."
],
"enum":[
"DETAIL_TYPE_UNSPECIFIED",
"CREATIVE_ATTRIBUTE",
"VENDOR",
"SENSITIVE_CATEGORY",
"PRODUCT_CATEGORY",
"DISAPPROVAL_REASON"
],
"description":"The type of detail that the detail IDs represent."
"description":"Response message for listing all details associated with a given filtered bid\nreason."
},
"LocationContext":{
"description":"@OutputOnly The Geo criteria the restriction applies to.",
"type":"object",
"properties":{
"geoCriteriaIds":{
"description":"IDs representing the geo location for this context.\nPlease refer to the\n[geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv)\nfile for different geo criteria IDs.",
"type":"array",
"items":{
"format":"int32",
"type":"integer"
}
}
},
"id":"LocationContext"
},
"PlatformContext":{
"description":"@OutputOnly The type of platform the restriction applies to.",
"type":"object",
"properties":{
"platforms":{
"description":"The platforms this restriction applies to.",
"type":"array",
"items":{
"enum":[
"DESKTOP",
"ANDROID",
"IOS"
],
"type":"string"
},
"enumDescriptions":[
"Desktop platform.",
"Android platform.",
"iOS platform."
]
}
},
"id":"PlatformContext"
},
"MetricValue":{
"description":"A metric value, with an expected value and a variance; represents a count\nthat may be either exact or estimated (i.e. when sampled).",
"type":"object",
"properties":{
"variance":{
"description":"The variance (i.e. square of the standard deviation) of the metric value.\nIf value is exact, variance is 0.\nCan be used to calculate margin of error as a percentage of value, using\nthe following formula, where Z is the standard constant that depends on the\ndesired size of the confidence interval (e.g. for 90% confidence interval,\nuse Z = 1.645):\n\n marginOfError = 100 * Z * sqrt(variance) / value",
"format":"int64",
"type":"string"
},
"value":{
"description":"The expected value of the metric.",
"format":"int64",
"type":"string"
}
},
"id":"MetricValue"
},
"ClientUser":{
"properties":{
"status":{
"enumDescriptions":[
"A placeholder for an undefined user status.",
"A user who was already created but hasn't accepted the invitation yet.",
"A user that is currently active.",
"A user that is currently disabled."
],
"enum":[
"USER_STATUS_UNSPECIFIED",
"PENDING",
"ACTIVE",
"DISABLED"
],
"description":"The status of the client user.",
"type":"string"
},
"userId":{
"description":"The unique numerical ID of the client user\nthat has accepted an invitation.\nThe value of this field is ignored in an update operation.",
"format":"int64",
"type":"string"
},
"email":{
"type":"string",
"description":"User's email address. The value of this field\nis ignored in an update operation."
},
"clientAccountId":{
"type":"string",
"description":"Numerical account ID of the client buyer\nwith which the user is associated; the\nbuyer must be a client of the current sponsor buyer.\nThe value of this field is ignored in an update operation.",
"format":"int64"
}
},
"id":"ClientUser",
"description":"A client user is created under a client buyer and has restricted access to\nthe Ad Exchange Marketplace and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngranted to the associated client buyer.\n\nThe only way a new client user can be created is via accepting an\nemail invitation\n(see the\naccounts.clients.invitations.create\nmethod).\n\nAll fields are required unless otherwise specified.",
"type":"object"
},
"CreativeDealAssociation":{
"properties":{
"creativeId":{
"description":"The ID of the creative associated with the deal.",
"type":"string"
},
"dealsId":{
"description":"The externalDealId for the deal associated with the creative.",
"type":"string"
},
"accountId":{
"description":"The account the creative belongs to.",
"type":"string"
}
},
"id":"CreativeDealAssociation",
"description":"The association between a creative and a deal.",
"type":"object"
},
"Creative":{
"description":"A creative and its classification data.",
"type":"object",
"properties":{
"version":{
"description":"@OutputOnly The version of this creative.",
"format":"int32",
"type":"integer"
},
"vendorIds":{
"description":"All vendor IDs for the ads that may be shown from this creative.\nSee https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt\nfor possible values.",
"description":"The set of URLs to be called to record an impression.",
"type":"array",
"items":{
"type":"string"
}
},
"html":{
"$ref":"HtmlContent",
"description":"An HTML creative."
},
"detectedProductCategories":{
"description":"@OutputOnly Detected product categories, if any.\nSee the ad-product-categories.txt file in the technical documentation\nfor a list of IDs.",
"type":"array",
"items":{
"format":"int32",
"type":"integer"
}
},
"dealsStatus":{
"enumDescriptions":[
"The status is unknown.",
"The creative has not been checked.",
"The creative has been conditionally approved.\nSee serving_restrictions for details.",
"The creative has been approved.",
"The creative has been disapproved."
],
"enum":[
"STATUS_UNSPECIFIED",
"NOT_CHECKED",
"CONDITIONALLY_APPROVED",
"APPROVED",
"DISAPPROVED"
],
"description":"@OutputOnly The top-level deals status of this creative.\nIf disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in\nserving_restrictions will also exist. Note\nthat this may be nuanced with other contextual restrictions, in which case,\nit may be preferable to read from serving_restrictions directly.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"openAuctionStatus":{
"enumDescriptions":[
"The status is unknown.",
"The creative has not been checked.",
"The creative has been conditionally approved.\nSee serving_restrictions for details.",
"The creative has been approved.",
"The creative has been disapproved."
],
"enum":[
"STATUS_UNSPECIFIED",
"NOT_CHECKED",
"CONDITIONALLY_APPROVED",
"APPROVED",
"DISAPPROVED"
],
"description":"@OutputOnly The top-level open auction status of this creative.\nIf disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in\nserving_restrictions will also exist. Note\nthat this may be nuanced with other contextual restrictions, in which case,\nit may be preferable to read from serving_restrictions directly.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"advertiserName":{
"description":"The name of the company being advertised in the creative.",
"type":"string"
},
"detectedAdvertiserIds":{
"description":"@OutputOnly Detected advertiser IDs, if any.",
"type":"array",
"items":{
"format":"int64",
"type":"string"
}
},
"detectedDomains":{
"description":"@OutputOnly\nThe detected domains for this creative.",
"type":"array",
"items":{
"type":"string"
}
},
"filteringStats":{
"$ref":"FilteringStats",
"description":"@OutputOnly The filtering stats for this creative."
},
"attributes":{
"description":"All attributes for the ads that may be shown from this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"The creative can dynamically resize to fill a variety of slot sizes."
]
},
"apiUpdateTime":{
"description":"@OutputOnly The last update timestamp of the creative via API.",
"format":"google-datetime",
"type":"string"
},
"detectedLanguages":{
"description":"@OutputOnly\nThe detected languages for this creative. The order is arbitrary. The codes\nare 2 or 5 characters and are documented at\nhttps://developers.google.com/adwords/api/docs/appendix/languagecodes.",
"type":"array",
"items":{
"type":"string"
}
},
"creativeId":{
"description":"The buyer-defined creative ID of this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"accountId":{
"description":"The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"native":{
"description":"A native creative.",
"$ref":"NativeContent"
},
"video":{
"$ref":"VideoContent",
"description":"A video creative."
},
"servingRestrictions":{
"description":"@OutputOnly The granular status of this ad in specific contexts.\nA context here relates to where something ultimately serves (for example,\na physical location, a platform, an HTTPS vs HTTP request, or the type\nof auction).",
"type":"array",
"items":{
"$ref":"ServingRestriction"
}
},
"agencyId":{
"description":"The agency ID for this creative.",
"format":"int64",
"type":"string"
},
"clickThroughUrls":{
"description":"The set of destination URLs for the creative.",
"type":"array",
"items":{
"type":"string"
}
},
"adChoicesDestinationUrl":{
"type":"string",
"description":"The link to AdChoices destination page."
},
"detectedSensitiveCategories":{
"description":"@OutputOnly Detected sensitive categories, if any.\nSee the ad-sensitive-categories.txt file in the technical documentation for\na list of IDs. You should use these IDs along with the\nexcluded-sensitive-category field in the bid request to filter your bids.",
"type":"array",
"items":{
"format":"int32",
"type":"integer"
}
},
"restrictedCategories":{
"enumDescriptions":[
"The ad has no restricted categories",
"The alcohol restricted category."
],
"description":"All restricted categories for the ads that may be shown from this creative.",
"type":"array",
"items":{
"enum":[
"NO_RESTRICTED_CATEGORIES",
"ALCOHOL"
],
"type":"string"
}
},
"corrections":{
"description":"@OutputOnly Shows any corrections that were applied to this creative.",
"description":"The day during which the data was collected.\nThe data is collected from 00:00:00 to 23:59:59 PT.\nDuring switches from PST to PDT and back, the day may\ncontain 23 or 25 hours of data instead of the usual 24."
"description":"Name used to represent this client to publishers.\nYou may have multiple clients that map to the same entity,\nbut for each client the combination of `clientName` and entity\nmust be unique.\nYou can specify this field as empty.",
"description":"The role which is assigned to the client buyer. Each role implies a set of\npermissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,\n`CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.",
"type":"string",
"enumDescriptions":[
"A placeholder for an undefined client role.",
"Users associated with this client can see publisher deal offers\nin the Marketplace.\nThey can neither negotiate proposals nor approve deals.\nIf this client is visible to publishers, they can send deal proposals\nto this client.",
"Users associated with this client can respond to deal proposals\nsent to them by publishers. They can also initiate deal proposals\nof their own.",
"Users associated with this client can approve eligible deals\non your behalf. Some deals may still explicitly require publisher\nfinalization. If this role is not selected, the sponsor buyer\nwill need to manually approve each of their deals."
]
},
"visibleToSeller":{
"description":"Whether the client buyer will be visible to sellers.",
"type":"boolean"
},
"entityId":{
"type":"string",
"description":"Numerical identifier of the client entity.\nThe entity can be an advertiser, a brand, or an agency.\nThis identifier is unique among all the entities with the same type.\n\nA list of all known advertisers with their identifiers is available in the\n[advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)\nfile.\n\nA list of all known brands with their identifiers is available in the\n[brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)\nfile.\n\nA list of all known agencies with their identifiers is available in the\n[agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)\nfile.",
"format":"int64"
},
"clientAccountId":{
"description":"The globally-unique numerical ID of the client.\nThe value of this field is ignored in create and update operations.",
"format":"int64",
"type":"string"
},
"entityName":{
"description":"The name of the entity. This field is automatically fetched based on\nthe type and ID.\nThe value of this field is ignored in create and update operations.",
"type":"string"
},
"status":{
"enumDescriptions":[
"A placeholder for an undefined client status.",
"A client that is currently disabled.",
"A client that is currently active."
],
"enum":[
"CLIENT_STATUS_UNSPECIFIED",
"DISABLED",
"ACTIVE"
],
"description":"The status of the client buyer.",
"type":"string"
},
"partnerClientId":{
"description":"Optional arbitrary unique identifier of this client buyer from the\nstandpoint of its Ad Exchange sponsor buyer.\n\nThis field can be used to associate a client buyer with the identifier\nin the namespace of its sponsor buyer, lookup client buyers by that\nidentifier and verify whether an Ad Exchange counterpart of a given client\nbuyer already exists.\n\nIf present, must be unique among all the client buyers for its\nAd Exchange sponsor buyer.",
"description":"A client resource represents a client buyer—an agency,\na brand, or an advertiser customer of the sponsor buyer.\nUsers associated with the client buyer have restricted access to\nthe Ad Exchange Marketplace and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngranted to the client buyer.\nAll fields are required unless otherwise specified."
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByCreativeRequest.pageToken\nfield in the subsequent call to the filteredBids.creatives.list\nmethod to retrieve the next page of results.",
"description":"The ID of the deal on which to filter; optional. This field may be set\nonly for a filter set that accesses account-level troubleshooting data,\ni.e. one whose name matches the `bidders/*/accounts/*/filterSets/*`\npattern.",
"format":"int64",
"type":"string"
},
"timeSeriesGranularity":{
"enum":[
"TIME_SERIES_GRANULARITY_UNSPECIFIED",
"HOURLY",
"DAILY"
],
"description":"The granularity of time intervals if a time series breakdown is desired;\noptional.",
"A placeholder for an unspecified interval; no time series is applied.\nAll rows in response will contain data for the entire requested time range.",
"Indicates that data will be broken down by the hour.",
"Indicates that data will be broken down by the day."
]
},
"realtimeTimeRange":{
"$ref":"RealtimeTimeRange",
"description":"An open-ended realtime time range, defined by the aggregation start\ntimestamp."
},
"formats":{
"description":"The list of formats on which to filter; may be empty. The filters\nrepresented by multiple formats are ORed together (i.e. if non-empty,\nresults must match any one of the formats).",
"type":"array",
"items":{
"enum":[
"FORMAT_UNSPECIFIED",
"DISPLAY",
"VIDEO"
],
"type":"string"
},
"enumDescriptions":[
"A placeholder for an undefined format; indicates that no format filter\nwill be applied.",
"The ad impression is display format (i.e. an image).",
"The ad impression is video format."
]
},
"creativeId":{
"description":"The ID of the creative on which to filter; optional. This field may be set\nonly for a filter set that accesses account-level troubleshooting data,\ni.e. one whose name matches the `bidders/*/accounts/*/filterSets/*`\npattern.",
"description":"A relative date range, defined by an offset from today and a duration.\nInterpreted relative to Pacific time zone."
},
"platforms":{
"type":"array",
"items":{
"enum":[
"PLATFORM_UNSPECIFIED",
"DESKTOP",
"TABLET",
"MOBILE"
],
"type":"string"
},
"enumDescriptions":[
"A placeholder for an undefined platform; indicates that no platform\nfilter will be applied.",
"The ad impression appears on a desktop.",
"The ad impression appears on a tablet.",
"The ad impression appears on a mobile device."
],
"description":"The list of platforms on which to filter; may be empty. The filters\nrepresented by multiple platforms are ORed together (i.e. if non-empty,\nresults must match any one of the platforms)."
},
"name":{
"description":"A user-defined name of the filter set. Filter set names must be unique\nglobally and match one of the patterns:\n\n- `bidders/*/filterSets/*` (for accessing bidder-level troubleshooting\ndata)\n- `bidders/*/accounts/*/filterSets/*` (for accessing account-level\ntroubleshooting data)\n\nThis field is required in create operations.",
"description":"The list of IDs of the seller (publisher) networks on which to filter;\nmay be empty. The filters represented by multiple seller network IDs are\nORed together (i.e. if non-empty, results must match any one of the\npublisher networks).\nSee [seller-network-ids](https://developers.google.com/ad-exchange/rtb/downloads/seller-network-ids)\nfile for the set of existing seller network IDs."
"description":"A set of filters that is applied to a request for data.\nWithin a filter set, an AND operation is performed across the filters\nrepresented by each field. An OR operation is performed across the filters\nrepresented by the multiple values of a repeated field. E.g.\n\"format=VIDEO AND deal_id=12 AND (seller_network_id=34 OR\nseller_network_id=56)\"",
"description":"The ID of the callout status.\nSee [callout-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/callout-status-codes).",
"description":"The number of impressions with the specified dimension values where the\ncorresponding bid request or bid response was not successful, as described by\nthe specified callout status.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListDealAssociationsRequest.page_token\nfield in the subsequent call to 'ListDealAssociation' method to retrieve\nthe next page of results.",
"description":"@OutputOnly A representation of the status of an ad in a\nspecific context. A context here relates to where something ultimately serves\n(for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,\nor the type of auction).",
"description":"Any disapprovals bound to this restriction.\nOnly present if status=DISAPPROVED.\nCan be used to filter the response of the\ncreatives.list\nmethod."
"description":"Represents a whole calendar date, e.g. date of birth. The time of day and\ntime zone are either specified elsewhere or are not significant. The date\nis relative to the Proleptic Gregorian Calendar. The day may be 0 to\nrepresent a year and month where the day is not significant, e.g. credit card\nexpiration date. The year may be 0 to represent a month and day independent\nof year, e.g. anniversary date. Related types are google.type.TimeOfDay\nand `google.protobuf.Timestamp`.",
"description":"Day of month. Must be from 1 to 31 and valid for the year and month, or 0\nif specifying a year/month where the day is not significant.",
"description":"A response may include multiple rows, breaking down along various dimensions.\nEncapsulates the values of all dimensions for a given row.",
"description":"A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
"type":"object",
"properties":{},
"id":"Empty"
},
"AppContext":{
"description":"@OutputOnly The app type the restriction applies to for mobile device.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilteredBidsRequest.pageToken\nfield in the subsequent call to the filteredBids.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativesRequest.page_token\nfield in the subsequent call to `ListCreatives` method to retrieve the next\npage of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilteredBidRequestsRequest.pageToken\nfield in the subsequent call to the filteredBidRequests.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidMetricsRequest.pageToken\nfield in the subsequent call to the bidMetrics.list\nmethod to retrieve the next page of results.",
"description":"The filtering status code. Please refer to the\n[creative-status-codes.txt](https://storage.googleapis.com/adx-rtb-dictionaries/creative-status-codes.txt)\nfile for different statuses.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListNonBillableWinningBidsRequest.pageToken\nfield in the subsequent call to the nonBillableWinningBids.list\nmethod to retrieve the next page of results."
"description":"A token to retrieve the next page of results.\nPass this value in the\nListLosingBidsRequest.pageToken\nfield in the subsequent call to the losingBids.list\nmethod to retrieve the next page of results."
"description":"The set of metrics that are measured in numbers of impressions, representing\nhow many impressions with the specified dimension values were considered\neligible at each stage of the bidding funnel.",
"type":"object",
"properties":{
"responsesWithBids":{
"$ref":"MetricValue",
"description":"The number of impressions for which Ad Exchange received a response from\nthe buyer that contained at least one applicable bid."
"description":"A token to retrieve the next page of results.\nPass this value in the\nListImpressionMetricsRequest.pageToken\nfield in the subsequent call to the impressionMetrics.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"id":"ListImpressionMetricsResponse"
},
"BidMetricsRow":{
"description":"The set of metrics that are measured in numbers of bids, representing how\nmany bids with the specified dimension values were considered eligible at\neach stage of the bidding funnel;",
"type":"object",
"properties":{
"rowDimensions":{
"description":"The values of all dimensions associated with metric values in this row.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidResponseErrorsRequest.pageToken\nfield in the subsequent call to the bidResponseErrors.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"id":"ListBidResponseErrorsResponse"
},
"CreativeStatusRow":{
"id":"CreativeStatusRow",
"description":"The number of bids with the specified dimension values that did not win the\nauction (either were filtered pre-auction or lost the auction), as described\nby the specified creative status.",
"type":"object",
"properties":{
"rowDimensions":{
"description":"The values of all dimensions associated with metric values in this row.",
"description":"The ID of the creative status.\nSee [creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
"description":"The number of bids with the specified status."
}
}
},
"RealtimeTimeRange":{
"description":"An open-ended realtime time range specified by the start timestamp.\nFor filter sets that specify a realtime time range RTB metrics continue to\nbe aggregated throughout the lifetime of the filter set.",
"type":"object",
"properties":{
"startTimestamp":{
"description":"The start timestamp of the real-time RTB metrics aggregation.",
"format":"google-datetime",
"type":"string"
}
},
"id":"RealtimeTimeRange"
},
"NonBillableWinningBidStatusRow":{
"id":"NonBillableWinningBidStatusRow",
"description":"The number of winning bids with the specified dimension values for which the\nbuyer was not billed, as described by the specified status.",
"type":"object",
"properties":{
"status":{
"description":"The status specifying why the winning bids were not billed.",
"description":"The number of bids with the specified status."
}
}
},
"FilteredBidDetailRow":{
"id":"FilteredBidDetailRow",
"description":"The number of filtered bids with the specified dimension values, among those\nfiltered due to the requested filtering reason (i.e. creative status), that\nhave the specified detail.",
"type":"object",
"properties":{
"rowDimensions":{
"description":"The values of all dimensions associated with metric values in this row.",
"$ref":"RowDimensions"
},
"bidCount":{
"$ref":"MetricValue",
"description":"The number of bids with the specified detail."
},
"detailId":{
"description":"The ID of the detail. The associated value can be looked up in the\ndictionary file corresponding to the DetailType in the response message.",
"format":"int32",
"type":"integer"
}
}
},
"AbsoluteDateRange":{
"description":"An absolute date range, specified by its start date and end date.\nThe supported range of dates begins 30 days before today and ends today.\nValidity checked upon filter set creation. If a filter set with an absolute\ndate range is run at a later date more than 30 days after start_date, it will\nfail.",
"type":"object",
"properties":{
"startDate":{
"description":"The start date of the range (inclusive).\nMust be within the 30 days leading up to current date, and must be equal to\nor before end_date.",
"$ref":"Date"
},
"endDate":{
"description":"The end date of the range (inclusive).\nMust be within the 30 days leading up to current date, and must be equal to\nor after start_date.",
"description":"The Pub/Sub topic to publish notifications to.\nThis topic must already exist and must give permission to\nad-exchange-buyside-reports@google.com to write to the topic.\nThis should be the full resource name in\n\"projects/{project_id}/topics/{topic_id}\" format.",
"type":"string"
}
},
"id":"WatchCreativeRequest",
"description":"A request for watching changes to creative Status."
},
"TimeInterval":{
"description":"An interval of time, with an absolute start and end.",
"type":"object",
"properties":{
"endTime":{
"description":"The timestamp marking the end of the range (exclusive) for which data is\nincluded.",
"description":"The values of all dimensions associated with metric values in this row."
},
"bidCount":{
"$ref":"MetricValue",
"description":"The number of bids with the specified creative."
},
"creativeId":{
"description":"The ID of the creative.",
"type":"string"
}
},
"id":"FilteredBidCreativeRow",
"description":"The number of filtered bids with the specified dimension values that have the\nspecified creative.",
"type":"object"
},
"RelativeDateRange":{
"description":"A relative date range, specified by an offset and a duration.\nThe supported range of dates begins 30 days before today and ends today.\nI.e. the limits for these values are:\noffset_days \u003e= 0\nduration_days \u003e= 1\noffset_days + duration_days \u003c= 30",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientsRequest.pageToken\nfield in the subsequent call to the\naccounts.clients.list method\nto retrieve the next page of results."
}
}
},
"ListBidResponsesWithoutBidsResponse":{
"description":"Response message for listing all reasons that bid responses were considered\nto have no applicable bids.",
"type":"object",
"properties":{
"bidResponseWithoutBidsStatusRows":{
"description":"List of rows, with counts of bid responses without bids aggregated by\nstatus.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidResponsesWithoutBidsRequest.pageToken\nfield in the subsequent call to the bidResponsesWithoutBids.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilterSetsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.list\nmethod to retrieve the next page of results."
"description":"The number of impressions for which there was a bid response with the\nspecified status.",
"$ref":"MetricValue"
},
"status":{
"enumDescriptions":[
"A placeholder for an undefined status.\nThis value will never be returned in responses.",
"The response had no bids.",
"The response had no bids for the specified account, though it may have\nincluded bids on behalf of other accounts.",
"The response had no bids for the specified deal, though it may have\nincluded bids on other deals on behalf of the account to which the deal\nbelongs."
"description":"The status specifying why the bid responses were considered to have no\napplicable bids.",
"type":"string"
}
},
"id":"BidResponseWithoutBidsStatusRow",
"description":"The number of impressions with the specified dimension values that were\nconsidered to have no applicable bids, as described by the specified status.",
"description":"Full name of the resource to delete.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
"description":"Full name of the resource being requested.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
"description":"Lists all filter sets for the account with the given account ID.",
"httpMethod":"GET",
"parameterOrder":[
"ownerName"
],
"response":{
"$ref":"ListFilterSetsResponse"
},
"parameters":{
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilterSetsResponse.nextPageToken\nreturned from the previous call to the\naccounts.filterSets.list\nmethod.",
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"type":"integer",
"location":"query"
},
"ownerName":{
"pattern":"^bidders/[^/]+$",
"location":"path",
"description":"Name of the owner (bidder or account) of the filter sets to be listed.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Whether the filter set is transient, or should be persisted indefinitely.\nBy default, filter sets are not transient.\nIf transient, it will be available for at least 1 hour after creation.",
"type":"boolean"
},
"ownerName":{
"pattern":"^bidders/[^/]+$",
"location":"path",
"description":"Name of the owner (bidder or account) of the filter set to be created.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Creates the specified filter set for the account with the given account ID.",
"request":{
"$ref":"FilterSet"
},
"response":{
"$ref":"FilterSet"
},
"parameterOrder":[
"ownerName"
],
"httpMethod":"POST"
}
},
"resources":{
"nonBillableWinningBids":{
"methods":{
"list":{
"response":{
"$ref":"ListNonBillableWinningBidsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"filterSetName":{
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListNonBillableWinningBidsResponse.nextPageToken\nreturned from the previous call to the nonBillableWinningBids.list\nmethod.",
"type":"string"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which winning bids were not billable, with the number\nof bids not billed for each reason."
}
}
},
"filteredBids":{
"methods":{
"list":{
"response":{
"$ref":"ListFilteredBidsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidsResponse.nextPageToken\nreturned from the previous call to the filteredBids.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which bids were filtered, with the number of bids\nfiltered for each reason."
}
},
"resources":{
"creatives":{
"methods":{
"list":{
"description":"List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"creativeStatusId":{
"description":"The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
"format":"int32",
"required":true,
"type":"integer",
"location":"path"
},
"pageToken":{
"type":"string",
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByCreativeResponse.nextPageToken\nreturned from the previous call to the filteredBids.creatives.list\nmethod."
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"creativeStatusId":{
"description":"The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).\nDetails are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format":"int32",
"required":true,
"type":"integer",
"location":"path"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByDetailResponse.nextPageToken\nreturned from the previous call to the filteredBids.details.list\nmethod.",
"type":"string"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which bids lost in the auction, with the number of\nbids that lost for each reason.",
"response":{
"$ref":"ListLosingBidsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"type":"integer",
"location":"query"
},
"filterSetName":{
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
},
"pageToken":{
"type":"string",
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListLosingBidsResponse.nextPageToken\nreturned from the previous call to the losingBids.list\nmethod."
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListImpressionMetricsResponse.nextPageToken\nreturned from the previous call to the impressionMetrics.list\nmethod.",
"type":"string"
},
"pageSize":{
"type":"integer",
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Lists all metrics that are measured in terms of number of impressions."
}
}
},
"bidMetrics":{
"methods":{
"list":{
"response":{
"$ref":"ListBidMetricsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"type":"integer"
},
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"pageToken":{
"type":"string",
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidMetricsResponse.nextPageToken\nreturned from the previous call to the bidMetrics.list\nmethod."
"description":"Lists all metrics that are measured in terms of number of bids."
}
}
},
"bidResponseErrors":{
"methods":{
"list":{
"response":{
"$ref":"ListBidResponseErrorsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"filterSetName":{
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponseErrorsResponse.nextPageToken\nreturned from the previous call to the bidResponseErrors.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all errors that occurred in bid responses, with the number of bid\nresponses affected for each reason."
}
}
},
"bidResponsesWithoutBids":{
"methods":{
"list":{
"response":{
"$ref":"ListBidResponsesWithoutBidsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"filterSetName":{
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponsesWithoutBidsResponse.nextPageToken\nreturned from the previous call to the bidResponsesWithoutBids.list\nmethod.",
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which bid responses were considered to have no\napplicable bids, with the number of bid responses affected for each reason."
}
}
},
"filteredBidRequests":{
"methods":{
"list":{
"description":"List all reasons that caused a bid request not to be sent for an\nimpression, with the number of bid requests not sent for each reason.",
"httpMethod":"GET",
"response":{
"$ref":"ListFilteredBidRequestsResponse"
},
"parameterOrder":[
"filterSetName"
],
"parameters":{
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"location":"path"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidRequestsResponse.nextPageToken\nreturned from the previous call to the filteredBidRequests.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Creates the specified filter set for the account with the given account ID.",
"response":{
"$ref":"FilterSet"
},
"parameterOrder":[
"ownerName"
],
"httpMethod":"POST",
"parameters":{
"isTransient":{
"description":"Whether the filter set is transient, or should be persisted indefinitely.\nBy default, filter sets are not transient.\nIf transient, it will be available for at least 1 hour after creation.",
"type":"boolean",
"location":"query"
},
"ownerName":{
"description":"Name of the owner (bidder or account) of the filter set to be created.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Full name of the resource to delete.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Full name of the resource being requested.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Lists all filter sets for the account with the given account ID.",
"httpMethod":"GET",
"response":{
"$ref":"ListFilterSetsResponse"
},
"parameterOrder":[
"ownerName"
],
"parameters":{
"ownerName":{
"location":"path",
"description":"Name of the owner (bidder or account) of the filter sets to be listed.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"required":true,
"type":"string",
"pattern":"^bidders/[^/]+/accounts/[^/]+$"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilterSetsResponse.nextPageToken\nreturned from the previous call to the\naccounts.filterSets.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which bid responses were considered to have no\napplicable bids, with the number of bid responses affected for each reason.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponsesWithoutBidsResponse.nextPageToken\nreturned from the previous call to the bidResponsesWithoutBids.list\nmethod.",
"type":"string"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidRequestsResponse.nextPageToken\nreturned from the previous call to the filteredBidRequests.list\nmethod."
},
"pageSize":{
"type":"integer",
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons that caused a bid request not to be sent for an\nimpression, with the number of bid requests not sent for each reason."
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidsResponse.nextPageToken\nreturned from the previous call to the filteredBids.list\nmethod."
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"type":"integer",
"location":"query"
}
}
}
},
"resources":{
"details":{
"methods":{
"list":{
"description":"List all details associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each detail.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).\nDetails are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format":"int32",
"required":true,
"type":"integer",
"location":"path"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByDetailResponse.nextPageToken\nreturned from the previous call to the filteredBids.details.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
"format":"int32",
"required":true,
"type":"integer"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByCreativeResponse.nextPageToken\nreturned from the previous call to the filteredBids.creatives.list\nmethod.",
"type":"string"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListNonBillableWinningBidsResponse.nextPageToken\nreturned from the previous call to the nonBillableWinningBids.list\nmethod.",
"type":"string"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"List all reasons for which bids lost in the auction, with the number of\nbids that lost for each reason.",
"httpMethod":"GET",
"parameterOrder":[
"filterSetName"
],
"response":{
"$ref":"ListLosingBidsResponse"
},
"parameters":{
"filterSetName":{
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListLosingBidsResponse.nextPageToken\nreturned from the previous call to the losingBids.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListImpressionMetricsResponse.nextPageToken\nreturned from the previous call to the impressionMetrics.list\nmethod.",
"type":"string",
"location":"query"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidMetricsResponse.nextPageToken\nreturned from the previous call to the bidMetrics.list\nmethod.",
"description":"List all errors that occurred in bid responses, with the number of bid\nresponses affected for each reason.",
"response":{
"$ref":"ListBidResponseErrorsResponse"
},
"parameterOrder":[
"filterSetName"
],
"httpMethod":"GET",
"parameters":{
"pageSize":{
"type":"integer",
"location":"query",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32"
},
"filterSetName":{
"location":"path",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponseErrorsResponse.nextPageToken\nreturned from the previous call to the bidResponseErrors.list\nmethod.",
"description":"Unique numerical account ID of the sponsor buyer to list the clients for.",
"format":"int64",
"required":true,
"type":"string",
"location":"path"
},
"pageSize":{
"location":"query",
"description":"Requested page size. The server may return fewer clients than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"type":"integer"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientsResponse.nextPageToken\nreturned from the previous call to the\naccounts.clients.list method.",
"type":"string"
},
"partnerClientId":{
"location":"query",
"description":"Optional unique identifier (from the standpoint of an Ad Exchange sponsor\nbuyer partner) of the client to return.\nIf specified, at most one client will be returned in the response.",
"description":"Lists all the clients for the current sponsor buyer."
},
"update":{
"request":{
"$ref":"Client"
},
"description":"Updates an existing client buyer.",
"httpMethod":"PUT",
"parameterOrder":[
"accountId",
"clientAccountId"
],
"response":{
"$ref":"Client"
},
"parameters":{
"accountId":{
"required":true,
"type":"string",
"location":"path",
"description":"Unique numerical account ID for the buyer of which the client buyer\nis a customer; the sponsor buyer to update a client for. (required)",
"format":"int64"
},
"clientAccountId":{
"required":true,
"type":"string",
"location":"path",
"description":"Unique numerical account ID of the client to update. (required)",
"description":"Unique numerical account ID for the buyer of which the client buyer\nis a customer; the sponsor buyer to create a client for. (required)",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientUserInvitationsResponse.nextPageToken\nreturned from the previous call to the\nclients.invitations.list\nmethod.",
"type":"string"
},
"accountId":{
"description":"Numerical account ID of the client's sponsor buyer. (required)",
"format":"int64",
"required":true,
"type":"string",
"location":"path"
},
"pageSize":{
"location":"query",
"description":"Requested page size. Server may return fewer clients than requested.\nIf unspecified, server will pick an appropriate default.",
"format":"int32",
"type":"integer"
},
"clientAccountId":{
"location":"path",
"description":"Numerical account ID of the client buyer to list invitations for.\n(required)\nYou must either specify a string representation of a\nnumerical account identifier or the `-` character\nto list all the invitations for all the clients\nof a given sponsor buyer.",
"description":"The account ID of the client buyer to list users for. (required)\nYou must specify either a string representation of a\nnumerical account identifier or the `-` character\nto list all the client users for all the clients\nof a given sponsor buyer.",
"required":true,
"type":"string",
"location":"path"
},
"pageToken":{
"location":"query",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientUsersResponse.nextPageToken\nreturned from the previous call to the\naccounts.clients.users.list method.",
"type":"string"
},
"accountId":{
"description":"Numerical account ID of the sponsor buyer of the client to list users for.\n(required)",
"format":"int64",
"required":true,
"type":"string",
"location":"path"
},
"pageSize":{
"description":"Requested page size. The server may return fewer clients than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Watches a creative. Will result in push notifications being sent to the\ntopic when the creative changes status.",
"response":{
"$ref":"Empty"
},
"parameterOrder":[
"accountId",
"creativeId"
],
"httpMethod":"POST",
"parameters":{
"accountId":{
"location":"path",
"description":"The account of the creative to watch.",
"required":true,
"type":"string"
},
"creativeId":{
"location":"path",
"description":"The creative ID to watch for status changes.\nSpecify \"-\" to watch all creatives under the above account.\nIf both creative-level and account-level notifications are\nsent, only a single notification will be sent to the\ncreative-level notification topic.",
"description":"An optional query string to filter creatives. If no filter is specified,\nall active creatives will be returned.\nSupported queries are:\n\u003cul\u003e\n\u003cli\u003eaccountId=\u003ci\u003eaccount_id_string\u003c/i\u003e\n\u003cli\u003ecreativeId=\u003ci\u003ecreative_id_string\u003c/i\u003e\n\u003cli\u003edealsStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eopenAuctionStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eattribute: {a numeric attribute from the list of attributes}\n\u003cli\u003edisapprovalReason: {a reason from\nDisapprovalReason}\n\u003c/ul\u003e\nExample: 'accountId=12345 AND (dealsStatus:disapproved AND\ndisapprovalReason:unacceptable_content) OR attribute:47'",
"type":"string"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativesResponse.next_page_token\nreturned from the previous call to 'ListCreatives' method.",
"type":"string",
"location":"query"
},
"accountId":{
"description":"The account to list the creatives from.\nSpecify \"-\" to list all creatives the current user has access to.",
"required":true,
"type":"string",
"location":"path"
},
"pageSize":{
"description":"Requested page size. The server may return fewer creatives than requested\n(due to timeout constraint) even if more are available via another call.\nIf unspecified, server will pick an appropriate default.\nAcceptable values are 1 to 1000, inclusive.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListDealAssociationsResponse.next_page_token\nreturned from the previous call to 'ListDealAssociations' method.",
"type":"string",
"location":"query"
},
"accountId":{
"location":"path",
"description":"The account to list the associations from.\nSpecify \"-\" to list all creatives the current user has access to.",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. Server may return fewer associations than requested.\nIf unspecified, server will pick an appropriate default.",
"format":"int32",
"type":"integer",
"location":"query"
},
"query":{
"location":"query",
"description":"An optional query string to filter deal associations. If no filter is\nspecified, all associations will be returned.\nSupported queries are:\n\u003cul\u003e\n\u003cli\u003eaccountId=\u003ci\u003eaccount_id_string\u003c/i\u003e\n\u003cli\u003ecreativeId=\u003ci\u003ecreative_id_string\u003c/i\u003e\n\u003cli\u003edealsId=\u003ci\u003edeals_id_string\u003c/i\u003e\n\u003cli\u003edealsStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eopenAuctionStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n\u003c/ul\u003e\nExample: 'dealsId=12345 AND dealsStatus:disapproved'",
"type":"string"
},
"creativeId":{
"description":"The creative ID to list the associations from.\nSpecify \"-\" to list all creatives under the above account.",
"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters."
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location":"query",
"description":"Data format for response.",
"default":"json"
},
"key":{
"location":"query",
"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",