Api-roll 40: 2016-08-08

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.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": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/tKpytEjguJTF-o5VbDt6Z-bTBvE\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/OxFhwmXVMAvezu3DksziaPGZ_dY\"",
     "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.4",
     "kind": "discovery#restDescription",
     "name": "adexchangebuyer",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 540 matching lines @@
                     "parameterOrder": [
                         "proposalId"
                     ],
                     "parameters": {
                         "pqlQuery": {
                             "description": "Query string to retrieve specific deals.",
                             "location": "query",
                             "type": "string"
                         },
                         "proposalId": {
-                            "description": "The proposalId to get deals for. To search across proposals specify order_id = '-' as part of the URL.",
+                            "description": "The proposalId to get deals for. To search across all proposals specify order_id = '-' as part of the URL.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "proposals/{proposalId}/deals",
                     "response": {
                         "$ref": "GetOrderDealsResponse"
                     },
                     "scopes": [
@@ skipping 57 matching lines @@
                     ]
                 },
                 "list": {
                     "description": "Get all the notes associated with a proposal",
                     "httpMethod": "GET",
                     "id": "adexchangebuyer.marketplacenotes.list",
                     "parameterOrder": [
                         "proposalId"
                     ],
                     "parameters": {
+                        "pqlQuery": {
+                            "description": "Query string to retrieve specific notes. To search the text contents of notes, please use syntax like \"WHERE note.note = \"foo\" or \"WHERE note.note LIKE \"%bar%\"",
+                            "location": "query",
+                            "type": "string"
+                        },
                         "proposalId": {
-                            "description": "The proposalId to get notes for.",
+                            "description": "The proposalId to get notes for. To search across all proposals specify order_id = '-' as part of the URL.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "proposals/{proposalId}/notes",
                     "response": {
                         "$ref": "GetOrderNotesResponse"
                     },
                     "scopes": [
@@ skipping 529 matching lines @@
                     "response": {
                         "$ref": "GetPublisherProfilesByAccountIdResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/adexchange.buyer"
                     ]
                 }
             }
         }
     },
-    "revision": "20160606",
+    "revision": "20160721",
     "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 405 matching lines @@
                             }
                         },
                         "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"
                 },
+                "detectedDomains": {
+                    "description": "Detected domains for this creative. Read-only. This field should not be set in requests.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
                 "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.",
                             "items": {
@@ skipping 297 matching lines @@
                     "$ref": "DealServingMetadataDealPauseStatus",
                     "description": "Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)"
                 }
             },
             "type": "object"
         },
         "DealServingMetadataDealPauseStatus": {
             "description": "Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently.",
             "id": "DealServingMetadataDealPauseStatus",
             "properties": {
+                "buyerPauseReason": {
+                    "type": "string"
+                },
                 "firstPausedBy": {
                     "description": "If the deal is paused, records which party paused the deal first.",
                     "type": "string"
                 },
                 "hasBuyerPaused": {
                     "type": "boolean"
                 },
                 "hasSellerPaused": {
                     "type": "boolean"
+                },
+                "sellerPauseReason": {
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "DealTerms": {
             "id": "DealTerms",
             "properties": {
                 "brandingType": {
                     "description": "Visibilty of the URL in bid requests.",
                     "type": "string"
@@ skipping 16 matching lines @@
                     "description": "The terms for guaranteed fixed price deals."
                 },
                 "nonGuaranteedAuctionTerms": {
                     "$ref": "DealTermsNonGuaranteedAuctionTerms",
                     "description": "The terms for non-guaranteed auction deals."
                 },
                 "nonGuaranteedFixedPriceTerms": {
                     "$ref": "DealTermsNonGuaranteedFixedPriceTerms",
                     "description": "The terms for non-guaranteed fixed price deals."
                 },
+                "rubiconNonGuaranteedTerms": {
+                    "$ref": "DealTermsRubiconNonGuaranteedTerms",
+                    "description": "The terms for rubicon non-guaranteed deals."
+                },
                 "sellerTimeZone": {
                     "description": "For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DealTermsGuaranteedFixedPriceTerms": {
             "id": "DealTermsGuaranteedFixedPriceTerms",
             "properties": {
                 "billingInfo": {
                     "$ref": "DealTermsGuaranteedFixedPriceTermsBillingInfo",
                     "description": "External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX."
                 },
                 "fixedPrices": {
                     "description": "Fixed price for the specified buyer.",
                     "items": {
                         "$ref": "PricePerBuyer"
                     },
                     "type": "array"
                 },
                 "guaranteedImpressions": {
                     "description": "Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.",
                     "format": "int64",
                     "type": "string"
                 },
                 "guaranteedLooks": {
-                    "description": "Count of guaranteed looks. Required for deal, optional for product.",
+                    "description": "Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "minimumDailyLooks": {
+                    "description": "Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.",
                     "format": "int64",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DealTermsGuaranteedFixedPriceTermsBillingInfo": {
             "id": "DealTermsGuaranteedFixedPriceTermsBillingInfo",
             "properties": {
                 "currencyConversionTimeMs": {
                     "description": "The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into advertiser's currency without discrepancy.",
                     "format": "int64",
                     "type": "string"
                 },
                 "dfpLineItemId": {
                     "description": "The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.",
                     "format": "int64",
                     "type": "string"
                 },
                 "originalContractedQuantity": {
-                    "description": "The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes publisher will book the deal with a impression buffer, however clients are billed using the original contracted quantity.",
+                    "description": "The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.",
                     "format": "int64",
                     "type": "string"
                 },
                 "price": {
                     "$ref": "Price",
                     "description": "The original reservation price for the deal, if the currency code is different from the one used in negotiation."
                 }
             },
             "type": "object"
         },
@@ skipping 20 matching lines @@
                 "fixedPrices": {
                     "description": "Fixed price for the specified buyer.",
                     "items": {
                         "$ref": "PricePerBuyer"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "DealTermsRubiconNonGuaranteedTerms": {
+            "id": "DealTermsRubiconNonGuaranteedTerms",
+            "properties": {
+                "priorityPrice": {
+                    "$ref": "Price",
+                    "description": "Optional price for Rubicon priority access in the auction."
+                },
+                "standardPrice": {
+                    "$ref": "Price",
+                    "description": "Optional price for Rubicon standard access in the auction."
+                }
+            },
+            "type": "object"
+        },
         "DeleteOrderDealsRequest": {
             "id": "DeleteOrderDealsRequest",
             "properties": {
                 "dealIds": {
                     "description": "List of deals to delete for a given proposal",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
@@ skipping 166 matching lines @@
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GetOrderNotesResponse": {
             "id": "GetOrderNotesResponse",
             "properties": {
                 "notes": {
-                    "description": "The list of matching notes.",
+                    "description": "The list of matching notes. The notes for a proposal are ordered from oldest to newest. If the notes span multiple proposals, they will be grouped by proposal, with the notes for the most recently modified proposal appearing first.",
                     "items": {
                         "$ref": "MarketplaceNote"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GetOrdersResponse": {
             "id": "GetOrdersResponse",
@@ skipping 36 matching lines @@
                 },
                 "creativePreApprovalPolicy": {
                     "description": "Specifies the creative pre-approval policy (buyer-readonly)",
                     "type": "string"
                 },
                 "creativeSafeFrameCompatibility": {
                     "description": "Specifies whether the creative is safeFrame compatible (buyer-readonly)",
                     "type": "string"
                 },
                 "dealId": {
-                    "description": "A unique deal=id for the deal (readonly).",
+                    "description": "A unique deal-id for the deal (readonly).",
                     "type": "string"
                 },
                 "dealServingMetadata": {
                     "$ref": "DealServingMetadata",
                     "description": "Metadata about the serving status of this deal (readonly, writes via custom actions)"
                 },
                 "deliveryControl": {
                     "$ref": "DeliveryControl",
                     "description": "The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension."
                 },
@@ skipping 540 matching lines @@
             "properties": {
                 "amountMicros": {
                     "description": "The price value in micros.",
                     "format": "double",
                     "type": "number"
                 },
                 "currencyCode": {
                     "description": "The currency code for the price.",
                     "type": "string"
                 },
+                "expectedCpmMicros": {
+                    "description": "In case of CPD deals, the expected CPM in micros.",
+                    "format": "double",
+                    "type": "number"
+                },
                 "pricingType": {
                     "description": "The pricing type for the deal/product.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "PricePerBuyer": {
             "description": "Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in an product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer or buyer/advertiser pair, we look for the most specific matching rule - we first look for a rule matching the buyer and advertiser, next a rule with the buyer but an empty advertiser list, and otherwise look for a matching rule where no buyer is set.",
             "id": "PricePerBuyer",
@@ skipping 146 matching lines @@
             "properties": {
                 "billedBuyer": {
                     "$ref": "Buyer",
                     "description": "Reference to the buyer that will get billed for this proposal. (readonly)"
                 },
                 "buyer": {
                     "$ref": "Buyer",
                     "description": "Reference to the buyer on the proposal. (readonly, except on create)"
                 },
                 "buyerContacts": {
-                    "description": "Optional contact information fort the buyer. (seller-readonly)",
+                    "description": "Optional contact information of the buyer. (seller-readonly)",
                     "items": {
                         "$ref": "ContactInformation"
                     },
                     "type": "array"
                 },
                 "buyerPrivateData": {
                     "$ref": "PrivateData",
                     "description": "Private data for buyer. (hidden from seller)."
                 },
                 "hasBuyerSignedOff": {
-                    "description": "When an proposal is in an accepted state, indicates whether the buyer has signed off Once both sides have signed off on a deal, the proposal can be finalized by the seller. (seller-readonly)",
+                    "description": "When an proposal is in an accepted state, indicates whether the buyer has signed off. Once both sides have signed off on a deal, the proposal can be finalized by the seller. (seller-readonly)",
                     "type": "boolean"
                 },
                 "hasSellerSignedOff": {
                     "description": "When an proposal is in an accepted state, indicates whether the buyer has signed off Once both sides have signed off on a deal, the proposal can be finalized by the seller. (buyer-readonly)",
                     "type": "boolean"
                 },
                 "inventorySource": {
                     "description": "What exchange will provide this inventory (readonly, except on create).",
                     "type": "string"
                 },
@@ skipping 53 matching lines @@
                 "revisionTimeMs": {
                     "description": "The time (ms since epoch) when the proposal was last revised (readonly).",
                     "format": "int64",
                     "type": "string"
                 },
                 "seller": {
                     "$ref": "Seller",
                     "description": "Reference to the seller on the proposal. (readonly, except on create)"
                 },
                 "sellerContacts": {
-                    "description": "Optional contact information for the seller (buyer-readonly).",
+                    "description": "Optional contact information of the seller (buyer-readonly).",
                     "items": {
                         "$ref": "ContactInformation"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "PublisherProfileApiProto": {
             "id": "PublisherProfileApiProto",
@@ skipping 287 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "adexchangebuyer/v1.4/",
     "title": "Ad Exchange Buyer API",
     "version": "v1.4"
 }