@@ -1,12 +1,12 @@
2 "kind": "discovery#restDescription",
2 "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/bLuDj8hKbRr7zEELKLv2i5H2Ydk\"",
3+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/gBf-L8hU2vSAjlFpvr_ZRh1Vf_I\"",
4 "discoveryVersion": "v1",
4 "discoveryVersion": "v1",
5 "id": "adexchangebuyer:v1.4",
5 "id": "adexchangebuyer:v1.4",
6 "name": "adexchangebuyer",
6 "name": "adexchangebuyer",
7 "canonicalName": "Ad Exchange Buyer",
7 "canonicalName": "Ad Exchange Buyer",
8 "version": "v1.4",
8 "version": "v1.4",
9− "revision": "20161003",
9+ "revision": "20170118",
10 "title": "Ad Exchange Buyer API",
10 "title": "Ad Exchange Buyer API",
11 "description": "Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.",
11 "description": "Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.",
12 "ownerDomain": "google.com",
12 "ownerDomain": "google.com",
@@ -90,7 +90,7 @@
90 "properties": {
90 "properties": {
91 "bidProtocol": {
91 "bidProtocol": {
92 "type": "string",
92 "type": "string",
93− "description": "The protocol that the bidder endpoint is using. By default, OpenRTB protocols use JSON, except PROTOCOL_OPENRTB_PROTOBUF. PROTOCOL_OPENRTB_PROTOBUF uses protobuf encoding over the latest OpenRTB protocol version, which is 2.3 right now. Allowed values: \n- PROTOCOL_ADX \n- PROTOCOL_OPENRTB_2_2 \n- PROTOCOL_OPENRTB_2_3 \n- PROTOCOL_OPENRTB_PROTOBUF"
93+ "description": "The protocol that the bidder endpoint is using. OpenRTB protocols with prefix PROTOCOL_OPENRTB_PROTOBUF use proto buffer, otherwise use JSON. Allowed values: \n- PROTOCOL_ADX \n- PROTOCOL_OPENRTB_2_2 \n- PROTOCOL_OPENRTB_2_3 \n- PROTOCOL_OPENRTB_2_4 \n- PROTOCOL_OPENRTB_PROTOBUF_2_3 \n- PROTOCOL_OPENRTB_PROTOBUF_2_4"
95 "maximumQps": {
95 "maximumQps": {
96 "type": "integer",
96 "type": "integer",
@@ -598,6 +598,10 @@
598 "type": "string",
598 "type": "string",
599 "description": "A label for the button that the user is supposed to click."
599 "description": "A label for the button that the user is supposed to click."
603+ "description": "The URL that the browser/SDK will load when the user clicks the ad."
601 "clickTrackingUrl": {
605 "clickTrackingUrl": {
602 "type": "string",
606 "type": "string",
603 "description": "The URL to use for click tracking."
607 "description": "The URL to use for click tracking."
@@ -661,7 +665,8 @@
661 "description": "The URL to the app store to purchase/download the promoted app."
665 "description": "The URL to the app store to purchase/download the promoted app."
663 "videoURL": {
667 "videoURL": {
664− "type": "string"
668+ "type": "string",
669+ "description": "The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url."
@@ -776,7 +781,7 @@
777 "videoURL": {
782 "videoURL": {
778 "type": "string",
783 "type": "string",
779− "description": "The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above."
784+ "description": "The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above."
781 "width": {
786 "width": {
782 "type": "integer",
787 "type": "integer",
@@ -1300,7 +1305,7 @@
1301 "inventoryDescription": {
1306 "inventoryDescription": {
1302 "type": "string",
1307 "type": "string",
1303− "description": "Description for the deal terms. (updatable)"
1308+ "description": "Description for the deal terms. (buyer-readonly)"
1305 "isRfpTemplate": {
1310 "isRfpTemplate": {
1306 "type": "boolean",
1311 "type": "boolean",
@@ -1702,6 +1707,11 @@
1702 "type": "string"
1707 "type": "string"
1710+ "minimumViewabilityDecile": {
1712+ "description": "Requests where the predicted viewability is below the specified decile will not match. E.g. if the buyer sets this value to 5, requests from slots where the predicted viewability is below 50% will not match. If the predicted viewability is unknown this field will be ignored.",
1705 "mobileCarriers": {
1715 "mobileCarriers": {
1706 "type": "array",
1716 "type": "array",
1707 "description": "Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.",
1717 "description": "Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.",
@@ -1758,6 +1768,13 @@
1758 "format": "int64"
1768 "format": "int64"
1771+ "userIdentifierDataRequired": {
1773+ "description": "Requests containing the specified type of user data will match. Possible values are HOSTED_MATCH_DATA, which means the request is cookie-targetable and has a match in the buyer's hosted match table, and COOKIE_OR_IDFA, which means the request has either a targetable cookie or an iOS IDFA.",
1761 "userLists": {
1778 "userLists": {
1762 "type": "array",
1779 "type": "array",
1763 "description": "Requests containing any of these user list ids will match.",
1780 "description": "Requests containing any of these user list ids will match.",
@@ -1941,6 +1958,10 @@
1941 "type": "string",
1958 "type": "string",
1942 "description": "Optional legacy offer id if this offer is a preferred deal offer."
1959 "description": "Optional legacy offer id if this offer is a preferred deal offer."
1961+ "marketplacePublisherProfileId": {
1963+ "description": "Marketplace publisher profile Id. This Id differs from the regular publisher_profile_id in that 1. This is a new id, the old Id will be deprecated in 2017. 2. This id uniquely identifies a publisher profile by itself."
1944 "name": {
1965 "name": {
1945 "type": "string",
1966 "type": "string",
1946 "description": "The name for this product as set by the seller. (buyer-readonly)"
1967 "description": "The name for this product as set by the seller. (buyer-readonly)"
@@ -3433,7 +3454,7 @@
3433 "propose",
3454 "propose",
3434 "proposeAndAccept",
3455 "proposeAndAccept",
3435 "unknownAction",
3456 "unknownAction",
3436− "updateFinalized"
3457+ "updateNonTerms"
3438 "enumDescriptions": [
3459 "enumDescriptions": [
@@ -3529,7 +3550,7 @@
3529 "propose",
3550 "propose",
3530 "proposeAndAccept",
3551 "proposeAndAccept",
3531 "unknownAction",
3552 "unknownAction",
3532− "updateFinalized"
3553+ "updateNonTerms"
3534 "enumDescriptions": [
3555 "enumDescriptions": [