Api-roll 21: 2015-08-04

discovery/googleapis/adexchangebuyer__v1.4.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/adexchange.buyer": {
                     "description": "Manage your Ad Exchange buyer account configuration"
                 }
             }
         }
     },
-    "basePath": "/adexchangebuyer/v1.3/",
-    "baseUrl": "https://www.googleapis.com/adexchangebuyer/v1.3/",
+    "basePath": "/adexchangebuyer/v1.4/",
+    "baseUrl": "https://www.googleapis.com/adexchangebuyer/v1.4/",
     "batchPath": "batch",
     "canonicalName": "Ad Exchange Buyer",
     "description": "Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/ad-exchange/buyer-rest",
-    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/ekf6O2lwsP92coEGgGA2ge5cRGA\"",
+    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/3tMFaskv26syPphVkqBBz5AxI7I\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/doubleclick-16.gif",
         "x32": "https://www.google.com/images/icons/product/doubleclick-32.gif"
     },
-    "id": "adexchangebuyer:v1.3",
+    "id": "adexchangebuyer:v1.4",
     "kind": "discovery#restDescription",
     "name": "adexchangebuyer",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
         "alt": {
             "default": "json",
             "description": "Data format for the response.",
             "enum": [
                 "json"
@@ skipping 337 matching lines @@
                             "location": "query",
                             "repeated": true,
                             "type": "integer"
                         },
                         "buyerCreativeId": {
                             "description": "When specified, only creatives for the given buyer creative ids are returned.",
                             "location": "query",
                             "repeated": true,
                             "type": "string"
                         },
+                        "dealsStatusFilter": {
+                            "description": "When specified, only creatives having the given direct deals status are returned.",
+                            "enum": [
+                                "approved",
+                                "conditionally_approved",
+                                "disapproved",
+                                "not_checked"
+                            ],
+                            "enumDescriptions": [
+                                "Creatives which have been approved for serving on direct deals.",
+                                "Creatives which have been conditionally approved for serving on direct deals.",
+                                "Creatives which have been disapproved for serving on direct deals.",
+                                "Creatives whose direct deals status is not yet checked."
+                            ],
+                            "location": "query",
+                            "type": "string"
+                        },
                         "maxResults": {
                             "description": "Maximum number of entries returned on one result page. If not set, the default is 100. Optional.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "1000",
                             "minimum": "1",
                             "type": "integer"
                         },
+                        "openAuctionStatusFilter": {
+                            "description": "When specified, only creatives having the given open auction status are returned.",
+                            "enum": [
+                                "approved",
+                                "conditionally_approved",
+                                "disapproved",
+                                "not_checked"
+                            ],
+                            "enumDescriptions": [
+                                "Creatives which have been approved for serving on the open auction.",
+                                "Creatives which have been conditionally approved for serving on the open auction.",
+                                "Creatives which have been disapproved for serving on the open auction.",
+                                "Creatives whose open auction status is not yet checked."
+                            ],
+                            "location": "query",
+                            "type": "string"
+                        },
                         "pageToken": {
                             "description": "A continuation token, used to page through ad clients. To retrieve the next page, set this parameter to the value of \"nextPageToken\" from the previous response. Optional.",
                             "location": "query",
                             "type": "string"
-                        },
-                        "statusFilter": {
-                            "description": "When specified, only creatives having the given status are returned.",
-                            "enum": [
-                                "approved",
-                                "disapproved",
-                                "not_checked"
-                            ],
-                            "enumDescriptions": [
-                                "Creatives which have been approved.",
-                                "Creatives which have been disapproved.",
-                                "Creatives whose status is not yet checked."
-                            ],
-                            "location": "query",
-                            "type": "string"
                         }
                     },
                     "path": "creatives",
                     "response": {
                         "$ref": "CreativesList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/adexchange.buyer"
                     ]
                 }
             }
         },
-        "directDeals": {
-            "methods": {
-                "get": {
-                    "description": "Gets one direct deal by ID.",
-                    "httpMethod": "GET",
-                    "id": "adexchangebuyer.directDeals.get",
-                    "parameterOrder": [
-                        "id"
-                    ],
-                    "parameters": {
-                        "id": {
-                            "description": "The direct deal id",
-                            "format": "int64",
-                            "location": "path",
-                            "required": true,
-                            "type": "string"
-                        }
-                    },
-                    "path": "directdeals/{id}",
-                    "response": {
-                        "$ref": "DirectDeal"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/adexchange.buyer"
-                    ]
-                },
-                "list": {
-                    "description": "Retrieves the authenticated user's list of direct deals.",
-                    "httpMethod": "GET",
-                    "id": "adexchangebuyer.directDeals.list",
-                    "path": "directdeals",
-                    "response": {
-                        "$ref": "DirectDealsList"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/adexchange.buyer"
-                    ]
-                }
-            }
-        },
         "performanceReport": {
             "methods": {
                 "list": {
                     "description": "Retrieves the authenticated user's list of performance metrics.",
                     "httpMethod": "GET",
                     "id": "adexchangebuyer.performanceReport.list",
                     "parameterOrder": [
                         "accountId",
                         "endDateTime",
                         "startDateTime"
@@ skipping 222 matching lines @@
                     "response": {
                         "$ref": "PretargetingConfig"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/adexchange.buyer"
                     ]
                 }
             }
         }
     },
-    "revision": "20150520",
+    "revision": "20150720",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Account": {
             "description": "Configuration data for an Ad Exchange buyer account.",
             "id": "Account",
             "properties": {
                 "bidderLocation": {
                     "description": "Your bidder locations that have distinct URLs.",
                     "items": {
                         "properties": {
@@ skipping 234 matching lines @@
                             },
                             "reason": {
                                 "description": "The type of correction that was applied to the creative.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
-                "disapprovalReasons": {
-                    "description": "The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.",
-                    "items": {
-                        "properties": {
-                            "details": {
-                                "description": "Additional details about the reason for disapproval.",
-                                "items": {
-                                    "type": "string"
-                                },
-                                "type": "array"
-                            },
-                            "reason": {
-                                "description": "The categorized reason for disapproval.",
-                                "type": "string"
-                            }
-                        },
-                        "type": "object"
-                    },
-                    "type": "array"
+                "dealsStatus": {
+                    "description": "Top-level deals status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=DIRECT_DEALS (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from servingRestrictions directly.",
+                    "type": "string"
                 },
                 "filteringReasons": {
                     "description": "The filtering reasons for the creative. Read-only. This field should not be set in requests.",
                     "properties": {
                         "date": {
                             "description": "The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.",
                             "type": "string"
                         },
                         "reasons": {
                             "description": "The filtering reasons.",
@@ skipping 25 matching lines @@
                     },
                     "description": "Ad height.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "kind": {
                     "default": "adexchangebuyer#creative",
                     "description": "Resource type.",
                     "type": "string"
                 },
+                "openAuctionStatus": {
+                    "description": "Top-level open auction status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=OPEN_AUCTION (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from ServingRestrictions directly.",
+                    "type": "string"
+                },
                 "productCategories": {
                     "description": "Detected product categories, if any. Read-only. This field should not be set in requests.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "restrictedCategories": {
                     "description": "All restricted categories for the ads that may be shown from this snippet.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "sensitiveCategories": {
                     "description": "Detected sensitive categories, if any. Read-only. This field should not be set in requests.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
-                "status": {
-                    "description": "Creative serving status. Read-only. This field should not be set in requests.",
-                    "type": "string"
+                "servingRestrictions": {
+                    "description": "The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction). Read-only. This field should not be set in requests.",
+                    "items": {
+                        "properties": {
+                            "contexts": {
+                                "description": "All known contexts/restrictions.",
+                                "items": {
+                                    "properties": {
+                                        "auctionType": {
+                                            "description": "Only set when contextType=AUCTION_TYPE. Represents the auction types this restriction applies to.",
+                                            "items": {
+                                                "type": "string"
+                                            },
+                                            "type": "array"
+                                        },
+                                        "contextType": {
+                                            "description": "The type of context (e.g., location, platform, auction type, SSL-ness).",
+                                            "type": "string"
+                                        },
+                                        "geoCriteriaId": {
+                                            "description": "Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to.",
+                                            "items": {
+                                                "format": "int32",
+                                                "type": "integer"
+                                            },
+                                            "type": "array"
+                                        },
+                                        "platform": {
+                                            "description": "Only set when contextType=PLATFORM. Represents the platforms this restriction applies to.",
+                                            "items": {
+                                                "type": "string"
+                                            },
+                                            "type": "array"
+                                        }
+                                    },
+                                    "type": "object"
+                                },
+                                "type": "array"
+                            },
+                            "disapprovalReasons": {
+                                "description": "The reasons for disapproval within this restriction, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED or CONDITIONALLY_APPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue.",
+                                "items": {
+                                    "properties": {
+                                        "details": {
+                                            "description": "Additional details about the reason for disapproval.",
+                                            "items": {
+                                                "type": "string"
+                                            },
+                                            "type": "array"
+                                        },
+                                        "reason": {
+                                            "description": "The categorized reason for disapproval.",
+                                            "type": "string"
+                                        }
+                                    },
+                                    "type": "object"
+                                },
+                                "type": "array"
+                            },
+                            "reason": {
+                                "description": "Why the creative is ineligible to serve in this context (e.g., it has been explicitly disapproved or is pending review).",
+                                "type": "string"
+                            }
+                        },
+                        "type": "object"
+                    },
+                    "type": "array"
                 },
                 "vendorType": {
                     "description": "All vendor types for the ads that may be shown from this snippet.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "videoURL": {
@@ skipping 29 matching lines @@
                     "description": "Resource type.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "Continuation token used to page through creatives. To retrieve the next page of results, set the next request's \"pageToken\" value to this.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
-        "DirectDeal": {
-            "description": "The configuration data for an Ad Exchange direct deal.",
-            "id": "DirectDeal",
-            "properties": {
-                "accountId": {
-                    "description": "The account id of the buyer this deal is for.",
-                    "format": "int32",
-                    "type": "integer"
-                },
-                "advertiser": {
-                    "description": "The name of the advertiser this deal is for.",
-                    "type": "string"
-                },
-                "currencyCode": {
-                    "description": "The currency code that applies to the fixed_cpm value. If not set then assumed to be USD.",
-                    "type": "string"
-                },
-                "endTime": {
-                    "description": "End time for when this deal stops being active. If not set then this deal is valid until manually disabled by the publisher. In seconds since the epoch.",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "fixedCpm": {
-                    "description": "The fixed price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the fixed price tier of buying (highest priority, pay exactly the configured fixed price).",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "id": {
-                    "description": "Deal id.",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "kind": {
-                    "default": "adexchangebuyer#directDeal",
-                    "description": "Resource type.",
-                    "type": "string"
-                },
-                "name": {
-                    "description": "Deal name.",
-                    "type": "string"
-                },
-                "privateExchangeMinCpm": {
-                    "description": "The minimum price for this direct deal. In cpm micros of currency according to currency_code. If set, then this deal is eligible for the private exchange tier of buying (below fixed price priority, run as a second price auction).",
-                    "format": "int64",
-                    "type": "string"
-                },
-                "publisherBlocksOverriden": {
-                    "description": "If true, the publisher has opted to have their blocks ignored when a creative is bid with for this deal.",
-                    "type": "boolean"
-                },
-                "sellerNetwork": {
-                    "description": "The name of the publisher offering this direct deal.",
-                    "type": "string"
-                },
-                "startTime": {
-                    "description": "Start time for when this deal becomes active. If not set then this deal is active immediately upon creation. In seconds since the epoch.",
-                    "format": "int64",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "DirectDealsList": {
-            "description": "A direct deals feed lists Direct Deals the Ad Exchange buyer account has access to. This includes direct deals set up for the buyer account as well as its merged stream seats.",
-            "id": "DirectDealsList",
-            "properties": {
-                "directDeals": {
-                    "description": "A list of direct deals relevant for your account.",
-                    "items": {
-                        "$ref": "DirectDeal"
-                    },
-                    "type": "array"
-                },
-                "kind": {
-                    "default": "adexchangebuyer#directDealsList",
-                    "description": "Resource type.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
         "PerformanceReport": {
             "description": "The configuration data for an Ad Exchange performance report list.",
             "id": "PerformanceReport",
             "properties": {
                 "bidRate": {
                     "description": "The number of bid responses with an ad.",
                     "format": "double",
                     "type": "number"
                 },
                 "bidRequestRate": {
@@ skipping 341 matching lines @@
                 },
                 "kind": {
                     "default": "adexchangebuyer#pretargetingConfigList",
                     "description": "Resource type.",
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
-    "servicePath": "adexchangebuyer/v1.3/",
+    "servicePath": "adexchangebuyer/v1.4/",
     "title": "Ad Exchange Buyer API",
-    "version": "v1.3"
+    "version": "v1.4"
 }