Api-roll 46: 2017-03-06

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": "\"tbys6C40o18GZwyMen5GMkdK-3s/gBf-L8hU2vSAjlFpvr_ZRh1Vf_I\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/XJ8vjwOJUtuz-unNR2L_5stMJIc\"",
     "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 1219 matching lines @@
                     "response": {
                         "$ref": "GetPublisherProfilesByAccountIdResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/adexchange.buyer"
                     ]
                 }
             }
         }
     },
-    "revision": "20170118",
+    "revision": "20170215",
     "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 304 matching lines @@
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "advertiserName": {
                     "annotations": {
                         "required": [
                             "adexchangebuyer.creatives.insert"
                         ]
                     },
-                    "description": "The name of the company being advertised in the creative.",
+                    "description": "The name of the company being advertised in the creative. The value provided must exist in the advertisers.txt file.",
                     "type": "string"
                 },
                 "agencyId": {
                     "description": "The agency id for this creative.",
                     "format": "int64",
                     "type": "string"
                 },
                 "apiUploadTimestamp": {
                     "description": "The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).",
                     "format": "date-time",
                     "type": "string"
                 },
                 "attribute": {
-                    "description": "All attributes for the ads that may be shown from this snippet.",
+                    "description": "List of buyer selectable attributes for the ads that may be shown from this snippet. Each attribute is represented by an integer as defined in  buyer-declarable-creative-attributes.txt.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "buyerCreativeId": {
                     "annotations": {
                         "required": [
                             "adexchangebuyer.creatives.insert"
@@ skipping 90 matching lines @@
                         "reasons": {
                             "description": "The filtering reasons.",
                             "items": {
                                 "properties": {
                                     "filteringCount": {
                                         "description": "The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.",
                                         "format": "int64",
                                         "type": "string"
                                     },
                                     "filteringStatus": {
-                                        "description": "The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.",
+                                        "description": "The filtering status code as defined in  creative-status-codes.txt.",
                                         "format": "int32",
                                         "type": "integer"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         }
                     },
                     "type": "object"
@@ skipping 129 matching lines @@
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "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.",
+                    "description": "Detected product categories, if any. Each category is represented by an integer as defined in  ad-product-categories.txt. 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.",
+                    "description": "All restricted categories for the ads that may be shown from this snippet. Each category is represented by an integer as defined in the  ad-restricted-categories.txt.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "sensitiveCategories": {
-                    "description": "Detected sensitive categories, if any. Read-only. This field should not be set in requests.",
+                    "description": "Detected sensitive categories, if any. Each category is represented by an integer as defined in  ad-sensitive-categories.txt. Read-only. This field should not be set in requests.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "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.",
+                                            "description": "Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to. Impressions are considered to match a context if either the user location or publisher location matches a given geoCriteriaId.",
                                             "items": {
                                                 "format": "int32",
                                                 "type": "integer"
                                             },
                                             "type": "array"
                                         },
                                         "platform": {
                                             "description": "Only set when contextType=PLATFORM. Represents the platforms this restriction applies to.",
                                             "items": {
                                                 "type": "string"
@@ skipping 28 matching lines @@
                             "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.",
+                    "description": "List of vendor types for the ads that may be shown from this snippet. Each vendor type is represented by an integer as defined in vendors.txt.",
                     "items": {
                         "format": "int32",
                         "type": "integer"
                     },
                     "type": "array"
                 },
                 "version": {
                     "description": "The version for this creative. Read-only. This field should not be set in requests.",
                     "format": "int32",
                     "type": "integer"
@@ skipping 69 matching lines @@
                 "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"
         },
         "DealServingMetadata": {
             "id": "DealServingMetadata",
             "properties": {
+                "alcoholAdsAllowed": {
+                    "description": "True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals",
+                    "type": "boolean"
+                },
                 "dealPauseStatus": {
                     "$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",
@@ skipping 1553 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "adexchangebuyer/v1.4/",
     "title": "Ad Exchange Buyer API",
     "version": "v1.4"
 }