@@ -1,12 +1,12 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/e2ZwVjK29RxJqz1-z8CpRPnLiKo\"",
3+ "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/EdmLlIWDPOXUaIR9PyM0JrTn9Ls\"",
44 "discoveryVersion": "v1",
55 "id": "adexchangebuyer:v1.4",
66 "name": "adexchangebuyer",
77 "canonicalName": "Ad Exchange Buyer",
88 "version": "v1.4",
9− "revision": "20150909",
9+ "revision": "20160118",
1010 "title": "Ad Exchange Buyer API",
1111 "description": "Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.",
1212 "ownerDomain": "google.com",
@@ -158,46 +158,6 @@
158158 }
159159 }
160160 },
161− "AdSize": {
162− "id": "AdSize",
163− "type": "object",
164− "properties": {
165− "height": {
166− "type": "integer",
167− "format": "int32"
168− },
169− "width": {
170− "type": "integer",
171− "format": "int32"
172− }
173− }
174− },
175− "AdSlotDto": {
176− "id": "AdSlotDto",
177− "type": "object",
178− "properties": {
179− "channelCode": {
180− "type": "string"
181− },
182− "channelId": {
183− "type": "integer",
184− "format": "int32"
185− },
186− "description": {
187− "type": "string"
188− },
189− "name": {
190− "type": "string"
191− },
192− "size": {
193− "type": "string"
194− },
195− "webPropertyId": {
196− "type": "integer",
197− "format": "int32"
198− }
199− }
200− },
201161 "AddOrderDealsRequest": {
202162 "id": "AddOrderDealsRequest",
203163 "type": "object",
@@ -209,14 +169,14 @@
209169 "$ref": "MarketplaceDeal"
210170 }
211171 },
212− "orderRevisionNumber": {
172+ "proposalRevisionNumber": {
213173 "type": "string",
214− "description": "The last known order revision number.",
174+ "description": "The last known proposal revision number.",
215175 "format": "int64"
216176 },
217177 "updateAction": {
218178 "type": "string",
219− "description": "Indicates an optional action to take on the order"
179+ "description": "Indicates an optional action to take on the proposal"
220180 }
221181 }
222182 },
@@ -226,14 +186,14 @@
226186 "properties": {
227187 "deals": {
228188 "type": "array",
229− "description": "List of deals added (in the same order as passed in the request)",
189+ "description": "List of deals added (in the same proposal as passed in the request)",
230190 "items": {
231191 "$ref": "MarketplaceDeal"
232192 }
233193 },
234− "orderRevisionNumber": {
194+ "proposalRevisionNumber": {
235195 "type": "string",
236− "description": "The updated revision number for the order.",
196+ "description": "The updated revision number for the proposal.",
237197 "format": "int64"
238198 }
239199 }
@@ -263,48 +223,6 @@
263223 }
264224 }
265225 },
266− "AdvertiserDto": {
267− "id": "AdvertiserDto",
268− "type": "object",
269− "properties": {
270− "brands": {
271− "type": "array",
272− "items": {
273− "$ref": "BrandDto"
274− }
275− },
276− "id": {
277− "type": "string",
278− "format": "int64"
279− },
280− "name": {
281− "type": "string"
282− },
283− "status": {
284− "type": "string"
285− }
286− }
287− },
288− "AudienceSegment": {
289− "id": "AudienceSegment",
290− "type": "object",
291− "properties": {
292− "description": {
293− "type": "string"
294− },
295− "id": {
296− "type": "string",
297− "format": "int64"
298− },
299− "name": {
300− "type": "string"
301− },
302− "numCookies": {
303− "type": "string",
304− "format": "int64"
305− }
306− }
307− },
308226 "BillingInfo": {
309227 "id": "BillingInfo",
310228 "type": "object",
@@ -352,23 +270,6 @@
352270 }
353271 }
354272 },
355− "BrandDto": {
356− "id": "BrandDto",
357− "type": "object",
358− "properties": {
359− "advertiserId": {
360− "type": "string",
361− "format": "int64"
362− },
363− "id": {
364− "type": "string",
365− "format": "int64"
366− },
367− "name": {
368− "type": "string"
369− }
370− }
371− },
372273 "Budget": {
373274 "id": "Budget",
374275 "type": "object",
@@ -386,7 +287,7 @@
386287 },
387288 "budgetAmount": {
388289 "type": "string",
389− "description": "The budget amount to apply for the billingId provided. This is required for update requests.",
290+ "description": "The daily budget amount in unit amount of the account currency to apply for the billingId provided. This is required for update requests.",
390291 "format": "int64"
391292 },
392293 "currencyCode": {
@@ -414,54 +315,6 @@
414315 }
415316 }
416317 },
417− "BuyerDto": {
418− "id": "BuyerDto",
419− "type": "object",
420− "properties": {
421− "accountId": {
422− "type": "integer",
423− "format": "int32"
424− },
425− "customerId": {
426− "type": "integer",
427− "format": "int32"
428− },
429− "displayName": {
430− "type": "string"
431− },
432− "enabledForInterestTargetingDeals": {
433− "type": "boolean"
434− },
435− "enabledForPreferredDeals": {
436− "type": "boolean"
437− },
438− "id": {
439− "type": "integer",
440− "format": "int32"
441− },
442− "sponsorAccountId": {
443− "type": "integer",
444− "format": "int32"
445− }
446− }
447− },
448− "ClientAccessCapabilities": {
449− "id": "ClientAccessCapabilities",
450− "type": "object",
451− "properties": {
452− "capabilities": {
453− "type": "array",
454− "items": {
455− "type": "integer",
456− "format": "int32"
457− }
458− },
459− "clientAccountId": {
460− "type": "string",
461− "format": "int64"
462− }
463− }
464− },
465318 "ContactInformation": {
466319 "id": "ContactInformation",
467320 "type": "object",
@@ -480,11 +333,11 @@
480333 "id": "CreateOrdersRequest",
481334 "type": "object",
482335 "properties": {
483− "orders": {
336+ "proposals": {
484337 "type": "array",
485− "description": "The list of orders to create.",
338+ "description": "The list of proposals to create.",
486339 "items": {
487− "$ref": "MarketplaceOrder"
340+ "$ref": "Proposal"
488341 }
489342 },
490343 "webPropertyCode": {
@@ -496,11 +349,11 @@
496349 "id": "CreateOrdersResponse",
497350 "type": "object",
498351 "properties": {
499− "orders": {
352+ "proposals": {
500353 "type": "array",
501− "description": "The list of orders successfully created.",
354+ "description": "The list of proposals successfully created.",
502355 "items": {
503− "$ref": "MarketplaceOrder"
356+ "$ref": "Proposal"
504357 }
505358 }
506359 }
@@ -546,7 +399,7 @@
546399 "description": "The agency id for this creative.",
547400 "format": "int64"
548401 },
549− "api_upload_timestamp": {
402+ "apiUploadTimestamp": {
550403 "type": "string",
551404 "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).",
552405 "format": "date-time"
@@ -899,69 +752,27 @@
899752 }
900753 }
901754 },
902− "DateTime": {
903− "id": "DateTime",
904− "type": "object",
905− "properties": {
906− "day": {
907− "type": "integer",
908− "format": "int32"
909− },
910− "hour": {
911− "type": "integer",
912− "format": "int32"
913− },
914− "minute": {
915− "type": "integer",
916− "format": "int32"
917− },
918− "month": {
919− "type": "integer",
920− "format": "int32"
921− },
922− "second": {
923− "type": "integer",
924− "format": "int32"
925− },
926− "timeZoneId": {
927− "type": "string"
928− },
929− "year": {
930− "type": "integer",
931− "format": "int32"
932− }
933− }
934− },
935− "DealPartyDto": {
936− "id": "DealPartyDto",
937− "type": "object",
938− "properties": {
939− "buyer": {
940− "$ref": "BuyerDto"
941− },
942− "buyerSellerRole": {
943− "type": "string"
944− },
945− "customerId": {
946− "type": "integer",
947− "format": "int32"
948− },
949− "name": {
950− "type": "string"
951− },
952− "webProperty": {
953− "$ref": "WebPropertyDto"
954− }
955− }
956− },
957755 "DealTerms": {
958756 "id": "DealTerms",
959757 "type": "object",
960758 "properties": {
759+ "brandingType": {
760+ "type": "string",
761+ "description": "Visibilty of the URL in bid requests."
762+ },
961763 "description": {
962764 "type": "string",
963765 "description": "Description for the proposed terms of the deal."
964766 },
767+ "estimatedGrossSpend": {
768+ "$ref": "Price",
769+ "description": "Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller."
770+ },
771+ "estimatedImpressionsPerDay": {
772+ "type": "string",
773+ "description": "Non-binding estimate of the impressions served per day Can be set by buyer or seller.",
774+ "format": "int64"
775+ },
965776 "guaranteedFixedPriceTerms": {
966777 "$ref": "DealTermsGuaranteedFixedPriceTerms",
967778 "description": "The terms for guaranteed fixed price deals."
@@ -994,7 +805,7 @@
994805 },
995806 "guaranteedLooks": {
996807 "type": "string",
997− "description": "Count of guaranteed looks. Required for deal, optional for offer.",
808+ "description": "Count of guaranteed looks. Required for deal, optional for product.",
998809 "format": "int64"
999810 }
1000811 }
@@ -1035,14 +846,14 @@
1035846 "properties": {
1036847 "dealIds": {
1037848 "type": "array",
1038− "description": "List of deals to delete for a given order",
849+ "description": "List of deals to delete for a given proposal",
1039850 "items": {
1040851 "type": "string"
1041852 }
1042853 },
1043− "orderRevisionNumber": {
854+ "proposalRevisionNumber": {
1044855 "type": "string",
1045− "description": "The last known order revision number.",
856+ "description": "The last known proposal revision number.",
1046857 "format": "int64"
1047858 },
1048859 "updateAction": {
@@ -1056,14 +867,14 @@
1056867 "properties": {
1057868 "deals": {
1058869 "type": "array",
1059− "description": "List of deals deleted (in the same order as passed in the request)",
870+ "description": "List of deals deleted (in the same proposal as passed in the request)",
1060871 "items": {
1061872 "$ref": "MarketplaceDeal"
1062873 }
1063874 },
1064− "orderRevisionNumber": {
875+ "proposalRevisionNumber": {
1065876 "type": "string",
1066− "description": "The updated revision number for the order.",
877+ "description": "The updated revision number for the proposal.",
1067878 "format": "int64"
1068879 }
1069880 }
@@ -1072,6 +883,9 @@
1072883 "id": "DeliveryControl",
1073884 "type": "object",
1074885 "properties": {
886+ "creativeBlockingLevel": {
887+ "type": "string"
888+ },
1075889 "deliveryRateType": {
1076890 "type": "string"
1077891 },
@@ -1106,23 +920,23 @@
1106920 "properties": {
1107921 "deals": {
1108922 "type": "array",
1109− "description": "List of deals to edit. Service may perform 3 different operations based on comparison of deals in this list vs deals already persisted in database: 1. Add new deal to order If a deal in this list does not exist in the order, the service will create a new deal and add it to the order. Validation will follow AddOrderDealsRequest. 2. Update existing deal in the order If a deal in this list already exist in the order, the service will update that existing deal to this new deal in the request. Validation will follow UpdateOrderDealsRequest. 3. Delete deals from the order (just need the id) If a existing deal in the order is not present in this list, the service will delete that deal from the order. Validation will follow DeleteOrderDealsRequest.",
923+ "description": "List of deals to edit. Service may perform 3 different operations based on comparison of deals in this list vs deals already persisted in database: 1. Add new deal to proposal If a deal in this list does not exist in the proposal, the service will create a new deal and add it to the proposal. Validation will follow AddOrderDealsRequest. 2. Update existing deal in the proposal If a deal in this list already exist in the proposal, the service will update that existing deal to this new deal in the request. Validation will follow UpdateOrderDealsRequest. 3. Delete deals from the proposal (just need the id) If a existing deal in the proposal is not present in this list, the service will delete that deal from the proposal. Validation will follow DeleteOrderDealsRequest.",
1110924 "items": {
1111925 "$ref": "MarketplaceDeal"
1112926 }
1113927 },
1114− "order": {
1115− "$ref": "MarketplaceOrder",
1116− "description": "If specified, also updates the order in the batch transaction. This is useful when the order and the deals need to be updated in one transaction."
928+ "proposal": {
929+ "$ref": "Proposal",
930+ "description": "If specified, also updates the proposal in the batch transaction. This is useful when the proposal and the deals need to be updated in one transaction."
1117931 },
1118− "orderRevisionNumber": {
932+ "proposalRevisionNumber": {
1119933 "type": "string",
1120− "description": "The last known revision number for the order.",
934+ "description": "The last known revision number for the proposal.",
1121935 "format": "int64"
1122936 },
1123937 "updateAction": {
1124938 "type": "string",
1125− "description": "Indicates an optional action to take on the order"
939+ "description": "Indicates an optional action to take on the proposal"
1126940 }
1127941 }
1128942 },
@@ -1132,92 +946,22 @@
1132946 "properties": {
1133947 "deals": {
1134948 "type": "array",
1135− "description": "List of all deals in the order after edit.",
949+ "description": "List of all deals in the proposal after edit.",
1136950 "items": {
1137951 "$ref": "MarketplaceDeal"
1138952 }
1139953 }
1140954 }
1141955 },
1142− "EditHistoryDto": {
1143− "id": "EditHistoryDto",
1144− "type": "object",
1145− "properties": {
1146− "createdByLoginName": {
1147− "type": "string"
1148− },
1149− "createdTimeStamp": {
1150− "type": "string",
1151− "format": "int64"
1152− },
1153− "lastUpdateTimeStamp": {
1154− "type": "string",
1155− "format": "int64"
1156− },
1157− "lastUpdatedByLoginName": {
1158− "type": "string"
1159− }
1160− }
1161− },
1162− "GetFinalizedNegotiationByExternalDealIdRequest": {
1163− "id": "GetFinalizedNegotiationByExternalDealIdRequest",
1164− "type": "object",
1165− "properties": {
1166− "includePrivateAuctions": {
1167− "type": "boolean"
1168− }
1169− }
1170− },
1171− "GetNegotiationByIdRequest": {
1172− "id": "GetNegotiationByIdRequest",
1173− "type": "object",
1174− "properties": {
1175− "includePrivateAuctions": {
1176− "type": "boolean"
1177− }
1178− }
1179− },
1180− "GetNegotiationsRequest": {
1181− "id": "GetNegotiationsRequest",
1182− "type": "object",
1183− "properties": {
1184− "finalized": {
1185− "type": "boolean"
1186− },
1187− "includePrivateAuctions": {
1188− "type": "boolean"
1189− },
1190− "sinceTimestampMillis": {
1191− "type": "string",
1192− "format": "int64"
1193− }
1194− }
1195− },
1196− "GetNegotiationsResponse": {
1197− "id": "GetNegotiationsResponse",
1198− "type": "object",
1199− "properties": {
1200− "kind": {
1201− "type": "string",
1202− "default": "adexchangebuyer#negotiationsList"
1203− },
1204− "negotiations": {
1205− "type": "array",
1206− "items": {
1207− "$ref": "NegotiationDto"
1208− }
1209− }
1210− }
1211− },
1212956 "GetOffersResponse": {
1213957 "id": "GetOffersResponse",
1214958 "type": "object",
1215959 "properties": {
1216− "offers": {
960+ "products": {
1217961 "type": "array",
1218− "description": "The returned list of offers.",
962+ "description": "The returned list of products.",
1219963 "items": {
1220− "$ref": "MarketplaceOffer"
964+ "$ref": "Product"
1221965 }
1222966 }
1223967 }
@@ -1228,7 +972,7 @@
1228972 "properties": {
1229973 "deals": {
1230974 "type": "array",
1231− "description": "List of deals for the order",
975+ "description": "List of deals for the proposal",
1232976 "items": {
1233977 "$ref": "MarketplaceDeal"
1234978 }
@@ -1252,328 +996,40 @@
1252996 "id": "GetOrdersResponse",
1253997 "type": "object",
1254998 "properties": {
1255− "orders": {
999+ "proposals": {
12561000 "type": "array",
1257− "description": "The list of matching orders.",
1001+ "description": "The list of matching proposals.",
12581002 "items": {
1259− "$ref": "MarketplaceOrder"
1003+ "$ref": "Proposal"
12601004 }
12611005 }
12621006 }
12631007 },
1264− "InventorySegmentTargeting": {
1265− "id": "InventorySegmentTargeting",
1008+ "MarketplaceDeal": {
1009+ "id": "MarketplaceDeal",
12661010 "type": "object",
1011+ "description": "A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.",
12671012 "properties": {
1268− "negativeAdSizes": {
1269− "type": "array",
1270− "items": {
1271− "$ref": "AdSize"
1272− }
1273− },
1274− "negativeAdTypeSegments": {
1275− "type": "array",
1276− "items": {
1277− "type": "string"
1278− }
1013+ "buyerPrivateData": {
1014+ "$ref": "PrivateData",
1015+ "description": "Buyer private data (hidden from seller)."
12791016 },
1280− "negativeAudienceSegments": {
1281− "type": "array",
1282− "items": {
1283− "type": "string",
1284− "format": "int64"
1285− }
1017+ "creationTimeMs": {
1018+ "type": "string",
1019+ "description": "The time (ms since epoch) of the deal creation. (readonly)",
1020+ "format": "int64"
12861021 },
1287− "negativeDeviceCategories": {
1288− "type": "array",
1289− "items": {
1290− "type": "string",
1291− "format": "int64"
1292− }
1022+ "creativePreApprovalPolicy": {
1023+ "type": "string",
1024+ "description": "Specifies the creative pre-approval policy (buyer-readonly)"
12931025 },
1294− "negativeIcmBrands": {
1295− "type": "array",
1296− "items": {
1297− "type": "string",
1298− "format": "int64"
1299− }
1026+ "dealId": {
1027+ "type": "string",
1028+ "description": "A unique deal=id for the deal (readonly)."
13001029 },
1301− "negativeIcmInterests": {
1302− "type": "array",
1303− "items": {
1304− "type": "string",
1305− "format": "int64"
1306− }
1307− },
1308− "negativeInventorySlots": {
1309− "type": "array",
1310− "items": {
1311− "type": "string"
1312− }
1313− },
1314− "negativeKeyValues": {
1315− "type": "array",
1316− "items": {
1317− "$ref": "RuleKeyValuePair"
1318− }
1319− },
1320− "negativeLocations": {
1321− "type": "array",
1322− "items": {
1323− "type": "string",
1324− "format": "int64"
1325− }
1326− },
1327− "negativeMobileApps": {
1328− "type": "array",
1329− "items": {
1330− "type": "string"
1331− }
1332− },
1333− "negativeOperatingSystemVersions": {
1334− "type": "array",
1335− "items": {
1336− "type": "string",
1337− "format": "int64"
1338− }
1339− },
1340− "negativeOperatingSystems": {
1341− "type": "array",
1342− "items": {
1343− "type": "string",
1344− "format": "int64"
1345− }
1346− },
1347− "negativeSiteUrls": {
1348− "type": "array",
1349− "items": {
1350− "type": "string"
1351− }
1352− },
1353− "negativeSizes": {
1354− "type": "array",
1355− "items": {
1356− "type": "string",
1357− "format": "int64"
1358− }
1359− },
1360− "negativeVideoAdPositionSegments": {
1361− "type": "array",
1362− "items": {
1363− "type": "string"
1364− }
1365− },
1366− "negativeVideoDurationSegments": {
1367− "type": "array",
1368− "items": {
1369− "type": "string",
1370− "format": "int64"
1371− }
1372− },
1373− "negativeXfpAdSlots": {
1374− "type": "array",
1375− "items": {
1376− "type": "string",
1377− "format": "int64"
1378− }
1379− },
1380− "negativeXfpPlacements": {
1381− "type": "array",
1382− "items": {
1383− "type": "string",
1384− "format": "int64"
1385− }
1386− },
1387− "positiveAdSizes": {
1388− "type": "array",
1389− "items": {
1390− "$ref": "AdSize"
1391− }
1392− },
1393− "positiveAdTypeSegments": {
1394− "type": "array",
1395− "items": {
1396− "type": "string"
1397− }
1398− },
1399− "positiveAudienceSegments": {
1400− "type": "array",
1401− "items": {
1402− "type": "string",
1403− "format": "int64"
1404− }
1405− },
1406− "positiveDeviceCategories": {
1407− "type": "array",
1408− "items": {
1409− "type": "string",
1410− "format": "int64"
1411− }
1412− },
1413− "positiveIcmBrands": {
1414− "type": "array",
1415− "items": {
1416− "type": "string",
1417− "format": "int64"
1418− }
1419− },
1420− "positiveIcmInterests": {
1421− "type": "array",
1422− "items": {
1423− "type": "string",
1424− "format": "int64"
1425− }
1426− },
1427− "positiveInventorySlots": {
1428− "type": "array",
1429− "items": {
1430− "type": "string"
1431− }
1432− },
1433− "positiveKeyValues": {
1434− "type": "array",
1435− "items": {
1436− "$ref": "RuleKeyValuePair"
1437− }
1438− },
1439− "positiveLocations": {
1440− "type": "array",
1441− "items": {
1442− "type": "string",
1443− "format": "int64"
1444− }
1445− },
1446− "positiveMobileApps": {
1447− "type": "array",
1448− "items": {
1449− "type": "string"
1450− }
1451− },
1452− "positiveOperatingSystemVersions": {
1453− "type": "array",
1454− "items": {
1455− "type": "string",
1456− "format": "int64"
1457− }
1458− },
1459− "positiveOperatingSystems": {
1460− "type": "array",
1461− "items": {
1462− "type": "string",
1463− "format": "int64"
1464− }
1465− },
1466− "positiveSiteUrls": {
1467− "type": "array",
1468− "items": {
1469− "type": "string"
1470− }
1471− },
1472− "positiveSizes": {
1473− "type": "array",
1474− "items": {
1475− "type": "string",
1476− "format": "int64"
1477− }
1478− },
1479− "positiveVideoAdPositionSegments": {
1480− "type": "array",
1481− "items": {
1482− "type": "string"
1483− }
1484− },
1485− "positiveVideoDurationSegments": {
1486− "type": "array",
1487− "items": {
1488− "type": "string",
1489− "format": "int64"
1490− }
1491− },
1492− "positiveXfpAdSlots": {
1493− "type": "array",
1494− "items": {
1495− "type": "string",
1496− "format": "int64"
1497− }
1498− },
1499− "positiveXfpPlacements": {
1500− "type": "array",
1501− "items": {
1502− "type": "string",
1503− "format": "int64"
1504− }
1505− }
1506− }
1507− },
1508− "ListClientAccessCapabilitiesRequest": {
1509− "id": "ListClientAccessCapabilitiesRequest",
1510− "type": "object",
1511− "properties": {
1512− "sponsorAccountId": {
1513− "type": "string",
1514− "format": "int64"
1515− }
1516− }
1517− },
1518− "ListClientAccessCapabilitiesResponse": {
1519− "id": "ListClientAccessCapabilitiesResponse",
1520− "type": "object",
1521− "properties": {
1522− "clientAccessPermissions": {
1523− "type": "array",
1524− "items": {
1525− "$ref": "ClientAccessCapabilities"
1526− }
1527− }
1528− }
1529− },
1530− "ListOffersRequest": {
1531− "id": "ListOffersRequest",
1532− "type": "object",
1533− "properties": {
1534− "sinceTimestampMillis": {
1535− "type": "string",
1536− "format": "int64"
1537− }
1538− }
1539− },
1540− "ListOffersResponse": {
1541− "id": "ListOffersResponse",
1542− "type": "object",
1543− "properties": {
1544− "kind": {
1545− "type": "string",
1546− "default": "adexchangebuyer#offersList"
1547− },
1548− "offers": {
1549− "type": "array",
1550− "items": {
1551− "$ref": "OfferDto"
1552− }
1553− }
1554− }
1555− },
1556− "MarketplaceDeal": {
1557− "id": "MarketplaceDeal",
1558− "type": "object",
1559− "description": "An order can contain multiple deals. A deal contains the terms and targeting information that is used for serving.",
1560− "properties": {
1561− "buyerPrivateData": {
1562− "$ref": "PrivateData",
1563− "description": "Buyer private data (hidden from seller)."
1564− },
1565− "creationTimeMs": {
1566− "type": "string",
1567− "description": "The time (ms since epoch) of the deal creation. (readonly)",
1568− "format": "int64"
1569− },
1570− "dealId": {
1571− "type": "string",
1572− "description": "A unique deal=id for the deal (readonly)."
1573− },
1574− "deliveryControl": {
1575− "$ref": "DeliveryControl",
1576− "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."
1030+ "deliveryControl": {
1031+ "$ref": "DeliveryControl",
1032+ "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."
15771033 },
15781034 "externalDealId": {
15791035 "type": "string",
@@ -1607,16 +1063,16 @@
16071063 "type": "string",
16081064 "description": "The name of the deal. (updatable)"
16091065 },
1610− "offerId": {
1066+ "productId": {
16111067 "type": "string",
1612− "description": "The offer-id from which this deal was created. (readonly, except on create)"
1068+ "description": "The product-id from which this deal was created. (readonly, except on create)"
16131069 },
1614− "offerRevisionNumber": {
1070+ "productRevisionNumber": {
16151071 "type": "string",
1616− "description": "The revision number of the offer that the deal was created from (readonly, except on create)",
1072+ "description": "The revision number of the product that the deal was created from (readonly, except on create)",
16171073 "format": "int64"
16181074 },
1619− "orderId": {
1075+ "proposalId": {
16201076 "type": "string"
16211077 },
16221078 "sellerContacts": {
@@ -1686,7 +1142,7 @@
16861142 "MarketplaceNote": {
16871143 "id": "MarketplaceNote",
16881144 "type": "object",
1689− "description": "An order is associated with a bunch of notes which may optionally be associated with a deal and/or revision number.",
1145+ "description": "A proposal is associated with a bunch of notes which may optionally be associated with a deal and/or revision number.",
16901146 "properties": {
16911147 "creatorRole": {
16921148 "type": "string",
@@ -1709,13 +1165,13 @@
17091165 "type": "string",
17101166 "description": "The unique id for the note. (readonly)"
17111167 },
1712− "orderId": {
1168+ "proposalId": {
17131169 "type": "string",
1714− "description": "The order_id that a note is attached to. (readonly)"
1170+ "description": "The proposalId that a note is attached to. (readonly)"
17151171 },
1716− "orderRevisionNumber": {
1172+ "proposalRevisionNumber": {
17171173 "type": "string",
1718− "description": "If the note is associated with an order revision number, then store that here. (readonly, except on create)",
1174+ "description": "If the note is associated with a proposal revision number, then store that here. (readonly, except on create)",
17191175 "format": "int64"
17201176 },
17211177 "timestampMs": {
@@ -1725,829 +1181,638 @@
17251181 }
17261182 }
17271183 },
1728− "MarketplaceOffer": {
1729− "id": "MarketplaceOffer",
1184+ "PerformanceReport": {
1185+ "id": "PerformanceReport",
17301186 "type": "object",
1731− "description": "An offer is segment of inventory that a seller wishes to sell. It is associated with certain terms and targeting information which helps buyer know more about the inventory. Each field in an order can have one of the following setting:\n\n(readonly) - It is an error to try and set this field. (buyer-readonly) - Only the seller can set this field. (seller-readonly) - Only the buyer can set this field. (updatable) - The field is updatable at all times by either buyer or the seller.",
1187+ "description": "The configuration data for an Ad Exchange performance report list.",
17321188 "properties": {
1733− "creationTimeMs": {
1734− "type": "string",
1735− "description": "Creation time in ms. since epoch (readonly)",
1736− "format": "int64"
1189+ "bidRate": {
1190+ "type": "number",
1191+ "description": "The number of bid responses with an ad.",
1192+ "format": "double"
17371193 },
1738− "creatorContacts": {
1194+ "bidRequestRate": {
1195+ "type": "number",
1196+ "description": "The number of bid requests sent to your bidder.",
1197+ "format": "double"
1198+ },
1199+ "calloutStatusRate": {
17391200 "type": "array",
1740− "description": "Optional contact information for the creator of this offer. (buyer-readonly)",
1201+ "description": "Rate of various prefiltering statuses per match. Please refer to the callout-status-codes.txt file for different statuses.",
17411202 "items": {
1742− "$ref": "ContactInformation"
1203+ "type": "any"
17431204 }
17441205 },
1745− "flightEndTimeMs": {
1746− "type": "string",
1747− "description": "The proposed end time for the deal (ms since epoch) (buyer-readonly)",
1748− "format": "int64"
1749− },
1750− "flightStartTimeMs": {
1751− "type": "string",
1752− "description": "Inventory availability dates. (times are in ms since epoch) The granularity is generally in the order of seconds. (buyer-readonly)",
1753− "format": "int64"
1206+ "cookieMatcherStatusRate": {
1207+ "type": "array",
1208+ "description": "Average QPS for cookie matcher operations.",
1209+ "items": {
1210+ "type": "any"
1211+ }
17541212 },
1755− "hasCreatorSignedOff": {
1756− "type": "boolean",
1757− "description": "If the creator has already signed off on the offer, then the buyer can finalize the deal by accepting the offer as is. When copying to an order, if any of the terms are changed, then auto_finalize is automatically set to false."
1758− },
1759− "kind": {
1760− "type": "string",
1761− "description": "Identifies what kind of resource this is. Value: the fixed string \"adexchangebuyer#marketplaceOffer\".",
1762− "default": "adexchangebuyer#marketplaceOffer"
1763− },
1764− "labels": {
1213+ "creativeStatusRate": {
17651214 "type": "array",
1766− "description": "Optional List of labels for the offer (optional, buyer-readonly).",
1215+ "description": "Rate of ads with a given status. Please refer to the creative-status-codes.txt file for different statuses.",
17671216 "items": {
1768− "$ref": "MarketplaceLabel"
1217+ "type": "any"
17691218 }
17701219 },
1771− "lastUpdateTimeMs": {
1772− "type": "string",
1773− "description": "Time of last update in ms. since epoch (readonly)",
1774− "format": "int64"
1775− },
1776− "name": {
1777− "type": "string",
1778− "description": "The name for this offer as set by the seller. (buyer-readonly)"
1779− },
1780− "offerId": {
1781− "type": "string",
1782− "description": "The unique id for the offer (readonly)"
1783− },
1784− "revisionNumber": {
1785− "type": "string",
1786− "description": "The revision number of the offer. (readonly)",
1787− "format": "int64"
1788− },
1789− "seller": {
1790− "$ref": "Seller",
1791− "description": "Information about the seller that created this offer (readonly, except on create)"
1220+ "filteredBidRate": {
1221+ "type": "number",
1222+ "description": "The number of bid responses that were filtered due to a policy violation or other errors.",
1223+ "format": "double"
17921224 },
1793− "sharedTargetings": {
1225+ "hostedMatchStatusRate": {
17941226 "type": "array",
1795− "description": "Targeting that is shared between the buyer and the seller. Each targeting criteria has a specified key and for each key there is a list of inclusion value or exclusion values. (buyer-readonly)",
1227+ "description": "Average QPS for hosted match operations.",
17961228 "items": {
1797− "$ref": "SharedTargeting"
1229+ "type": "any"
17981230 }
17991231 },
1800− "state": {
1801− "type": "string",
1802− "description": "The state of the offer. (buyer-readonly)"
1232+ "inventoryMatchRate": {
1233+ "type": "number",
1234+ "description": "The number of potential queries based on your pretargeting settings.",
1235+ "format": "double"
18031236 },
1804− "syndicationProduct": {
1237+ "kind": {
18051238 "type": "string",
1806− "description": "The syndication product associated with the deal. (readonly, except on create)"
1807− },
1808− "terms": {
1809− "$ref": "DealTerms",
1810− "description": "The negotiable terms of the deal (buyer-readonly)"
1811− },
1812− "webPropertyCode": {
1813− "type": "string"
1814− }
1815− }
1816− },
1817− "MarketplaceOrder": {
1818− "id": "MarketplaceOrder",
1819− "type": "object",
1820− "description": "Represents an order in the marketplace. An order is the unit of negotiation between a seller and a buyer and contains deals which are served. Each field in an order can have one of the following setting:\n\n(readonly) - It is an error to try and set this field. (buyer-readonly) - Only the seller can set this field. (seller-readonly) - Only the buyer can set this field. (updatable) - The field is updatable at all times by either buyer or the seller.",
1821− "properties": {
1822− "billedBuyer": {
1823− "$ref": "Buyer",
1824− "description": "Reference to the buyer that will get billed for this order. (readonly)"
1825− },
1826− "buyer": {
1827− "$ref": "Buyer",
1828− "description": "Reference to the buyer on the order. (readonly, except on create)"
1829− },
1830− "buyerContacts": {
1831− "type": "array",
1832− "description": "Optional contact information fort the buyer. (seller-readonly)",
1833− "items": {
1834− "$ref": "ContactInformation"
1835− }
1836− },
1837− "buyerPrivateData": {
1838− "$ref": "PrivateData",
1839− "description": "Private data for buyer. (hidden from seller)."
1840− },
1841− "hasBuyerSignedOff": {
1842− "type": "boolean",
1843− "description": "When an order is in an accepted state, indicates whether the buyer has signed off Once both sides have signed off on a deal, the order can be finalized by the seller. (seller-readonly)"
1844− },
1845− "hasSellerSignedOff": {
1846− "type": "boolean",
1847− "description": "When an order is in an accepted state, indicates whether the buyer has signed off Once both sides have signed off on a deal, the order can be finalized by the seller. (buyer-readonly)"
1239+ "description": "Resource type.",
1240+ "default": "adexchangebuyer#performanceReport"
18481241 },
1849− "isRenegotiating": {
1850− "type": "boolean",
1851− "description": "True if the order is being renegotiated (readonly)."
1242+ "latency50thPercentile": {
1243+ "type": "number",
1244+ "description": "The 50th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
1245+ "format": "double"
18521246 },
1853− "isSetupComplete": {
1854− "type": "boolean",
1855− "description": "True, if the buyside inventory setup is complete for this order. (readonly)"
1247+ "latency85thPercentile": {
1248+ "type": "number",
1249+ "description": "The 85th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
1250+ "format": "double"
18561251 },
1857− "kind": {
1858− "type": "string",
1859− "description": "Identifies what kind of resource this is. Value: the fixed string \"adexchangebuyer#marketplaceOrder\".",
1860− "default": "adexchangebuyer#marketplaceOrder"
1252+ "latency95thPercentile": {
1253+ "type": "number",
1254+ "description": "The 95th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
1255+ "format": "double"
18611256 },
1862− "labels": {
1863− "type": "array",
1864− "description": "List of labels associated with the order. (readonly)",
1865− "items": {
1866− "$ref": "MarketplaceLabel"
1867− }
1257+ "noQuotaInRegion": {
1258+ "type": "number",
1259+ "description": "Rate of various quota account statuses per quota check.",
1260+ "format": "double"
18681261 },
1869− "lastUpdaterOrCommentorRole": {
1870− "type": "string",
1871− "description": "The role of the last user that either updated the order or left a comment. (readonly)"
1262+ "outOfQuota": {
1263+ "type": "number",
1264+ "description": "Rate of various quota account statuses per quota check.",
1265+ "format": "double"
18721266 },
1873− "lastUpdaterRole": {
1874− "type": "string"
1267+ "pixelMatchRequests": {
1268+ "type": "number",
1269+ "description": "Average QPS for pixel match requests from clients.",
1270+ "format": "double"
18751271 },
1876− "name": {
1877− "type": "string",
1878− "description": "The name for the order (updatable)"
1272+ "pixelMatchResponses": {
1273+ "type": "number",
1274+ "description": "Average QPS for pixel match responses from clients.",
1275+ "format": "double"
18791276 },
1880− "orderId": {
1881− "type": "string",
1882− "description": "The unique id of the order. (readonly)."
1277+ "quotaConfiguredLimit": {
1278+ "type": "number",
1279+ "description": "The configured quota limits for this account.",
1280+ "format": "double"
18831281 },
1884− "orderState": {
1885− "type": "string",
1886− "description": "The current state of the order. (readonly)"
1282+ "quotaThrottledLimit": {
1283+ "type": "number",
1284+ "description": "The throttled quota limits for this account.",
1285+ "format": "double"
18871286 },
1888− "originatorRole": {
1287+ "region": {
18891288 "type": "string",
1890− "description": "Indicates whether the buyer/seller created the offer.(readonly)"
1289+ "description": "The trading location of this data."
18911290 },
1892− "revisionNumber": {
1893− "type": "string",
1894− "description": "The revision number for the order (readonly).",
1895− "format": "int64"
1291+ "successfulRequestRate": {
1292+ "type": "number",
1293+ "description": "The number of properly formed bid responses received by our servers within the deadline.",
1294+ "format": "double"
18961295 },
1897− "revisionTimeMs": {
1296+ "timestamp": {
18981297 "type": "string",
1899− "description": "The time (ms since epoch) when the order was last revised (readonly).",
1298+ "description": "The unix timestamp of the starting time of this performance data.",
19001299 "format": "int64"
19011300 },
1902− "seller": {
1903− "$ref": "Seller",
1904− "description": "Reference to the seller on the order. (readonly, except on create)"
1905− },
1906− "sellerContacts": {
1907− "type": "array",
1908− "description": "Optional contact information for the seller (buyer-readonly).",
1909− "items": {
1910− "$ref": "ContactInformation"
1911− }
1301+ "unsuccessfulRequestRate": {
1302+ "type": "number",
1303+ "description": "The number of bid responses that were unsuccessful due to timeouts, incorrect formatting, etc.",
1304+ "format": "double"
19121305 }
19131306 }
19141307 },
1915− "MoneyDto": {
1916− "id": "MoneyDto",
1308+ "PerformanceReportList": {
1309+ "id": "PerformanceReportList",
19171310 "type": "object",
1311+ "description": "The configuration data for an Ad Exchange performance report list. https://sites.google.com/a/google.com/adx-integration/Home/engineering/binary-releases/rtb-api-release https://cs.corp.google.com/#piper///depot/google3/contentads/adx/tools/rtb_api/adxrtb.py",
19181312 "properties": {
1919− "currencyCode": {
1920− "type": "string"
1921− },
1922− "micros": {
1313+ "kind": {
19231314 "type": "string",
1924− "format": "int64"
1315+ "description": "Resource type.",
1316+ "default": "adexchangebuyer#performanceReportList"
1317+ },
1318+ "performanceReport": {
1319+ "type": "array",
1320+ "description": "A list of performance reports relevant for the account.",
1321+ "items": {
1322+ "$ref": "PerformanceReport"
1323+ }
19251324 }
19261325 }
19271326 },
1928− "NegotiationDto": {
1929− "id": "NegotiationDto",
1327+ "PretargetingConfig": {
1328+ "id": "PretargetingConfig",
19301329 "type": "object",
19311330 "properties": {
1932− "billedBuyer": {
1933− "$ref": "DealPartyDto",
1934− "description": "The billed buyer; Specified by a buyer buying through an intermediary."
1935− },
1936− "buyer": {
1937− "$ref": "DealPartyDto",
1938− "description": "Details of the buyer party in this negotiation."
1939− },
1940− "buyerEmailContacts": {
1941− "type": "array",
1942− "description": "The buyer party's contact email.",
1943− "items": {
1944− "type": "string"
1945− }
1946− },
1947− "dealType": {
1331+ "billingId": {
19481332 "type": "string",
1949− "description": "The type of this deal."
1333+ "description": "The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.",
1334+ "format": "int64"
19501335 },
1951− "externalDealId": {
1336+ "configId": {
19521337 "type": "string",
1953− "description": "For finalized negotiations, the ID of the finalized deal.",
1338+ "description": "The config id; generated automatically. Leave this field blank for insert requests.",
19541339 "format": "int64"
19551340 },
1956− "kind": {
1341+ "configName": {
19571342 "type": "string",
1958− "default": "adexchangebuyer#negotiation"
1343+ "description": "The name of the config. Must be unique. Required for all requests."
19591344 },
1960− "labelNames": {
1345+ "creativeType": {
19611346 "type": "array",
1962− "description": "A list of label names applicable to this negotiation.",
1347+ "description": "List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.",
19631348 "items": {
19641349 "type": "string"
19651350 }
19661351 },
1967− "negotiationId": {
1968− "type": "string",
1969− "description": "The unique ID of this negotiation.",
1970− "format": "int64"
1971− },
1972− "negotiationRounds": {
1352+ "dimensions": {
19731353 "type": "array",
1974− "description": "The series of negotiation rounds for this negotiation.",
1354+ "description": "Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.",
19751355 "items": {
1976− "$ref": "NegotiationRoundDto"
1356+ "type": "object",
1357+ "properties": {
1358+ "height": {
1359+ "type": "string",
1360+ "description": "Height in pixels.",
1361+ "format": "int64"
1362+ },
1363+ "width": {
1364+ "type": "string",
1365+ "description": "Width in pixels.",
1366+ "format": "int64"
1367+ }
1368+ }
19771369 }
19781370 },
1979− "negotiationState": {
1980− "type": "string",
1981− "description": "The state of this negotiation."
1982− },
1983− "offerId": {
1984− "type": "string",
1985− "description": "The ID of this negotiation's original offer.",
1986− "format": "int64"
1987− },
1988− "seller": {
1989− "$ref": "DealPartyDto",
1990− "description": "Details of the seller party in this negotiation."
1371+ "excludedContentLabels": {
1372+ "type": "array",
1373+ "description": "Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.",
1374+ "items": {
1375+ "type": "string",
1376+ "format": "int64"
1377+ }
19911378 },
1992− "sellerEmailContacts": {
1379+ "excludedGeoCriteriaIds": {
19931380 "type": "array",
1994− "description": "The seller party's contact email.",
1381+ "description": "Requests containing any of these geo criteria ids will not match.",
19951382 "items": {
1996− "type": "string"
1383+ "type": "string",
1384+ "format": "int64"
19971385 }
19981386 },
1999− "stats": {
2000− "$ref": "StatsDto",
2001− "description": "The stats for this negotiation."
1387+ "excludedPlacements": {
1388+ "type": "array",
1389+ "description": "Requests containing any of these placements will not match.",
1390+ "items": {
1391+ "type": "object",
1392+ "properties": {
1393+ "token": {
1394+ "type": "string",
1395+ "description": "The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement."
1396+ },
1397+ "type": {
1398+ "type": "string",
1399+ "description": "The type of the placement."
1400+ }
1401+ }
1402+ }
20021403 },
2003− "status": {
2004− "type": "string",
2005− "description": "The status of this negotiation."
2006− }
2007− }
2008− },
2009− "NegotiationRoundDto": {
2010− "id": "NegotiationRoundDto",
2011− "type": "object",
2012− "properties": {
2013− "action": {
2014− "type": "string",
2015− "description": "The action performed by this negotiation round."
2016− },
2017− "dbmPartnerId": {
2018− "type": "string",
2019− "description": "Stores DBM partner ID for use by DBM",
2020− "format": "int64"
2021− },
2022− "editHistory": {
2023− "$ref": "EditHistoryDto",
2024− "description": "The edit history of this negotiation round."
2025− },
2026− "kind": {
2027− "type": "string",
2028− "default": "adexchangebuyer#negotiationRound"
2029− },
2030− "negotiationId": {
2031− "type": "string",
2032− "description": "The ID of the negotiation to which this negotiation round applies.",
2033− "format": "int64"
2034− },
2035− "notes": {
2036− "type": "string",
2037− "description": "Notes regarding this negotiation round."
2038− },
2039− "originatorRole": {
2040− "type": "string",
2041− "description": "The role, either buyer or seller, initiating this negotiation round."
2042− },
2043− "roundNumber": {
2044− "type": "string",
2045− "description": "The number of this negotiation round, in sequence.",
2046− "format": "int64"
2047− },
2048− "terms": {
2049− "$ref": "TermsDto",
2050− "description": "The detailed terms proposed in this negotiation round."
2051− }
2052− }
2053− },
2054− "OfferDto": {
2055− "id": "OfferDto",
2056− "type": "object",
2057− "properties": {
2058− "anonymous": {
2059− "type": "boolean",
2060− "description": "Whether this offer is anonymous."
2061− },
2062− "billedBuyer": {
2063− "$ref": "DealPartyDto",
2064− "description": "The billed buyer; For buyer initiated offers, buying through an intermediary."
2065− },
2066− "closedToDealParties": {
1404+ "excludedUserLists": {
20671405 "type": "array",
2068− "description": "The list of buyer or seller parties this offer is closed to.",
1406+ "description": "Requests containing any of these users list ids will not match.",
20691407 "items": {
2070− "$ref": "DealPartyDto"
1408+ "type": "string",
1409+ "format": "int64"
20711410 }
20721411 },
2073− "creator": {
2074− "$ref": "DealPartyDto",
2075− "description": "The creator of this offer."
1412+ "excludedVerticals": {
1413+ "type": "array",
1414+ "description": "Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.",
1415+ "items": {
1416+ "type": "string",
1417+ "format": "int64"
1418+ }
20761419 },
2077− "emailContacts": {
1420+ "geoCriteriaIds": {
20781421 "type": "array",
2079− "description": "The list of email contacts for this offer.",
1422+ "description": "Requests containing any of these geo criteria ids will match.",
20801423 "items": {
2081− "type": "string"
1424+ "type": "string",
1425+ "format": "int64"
20821426 }
20831427 },
2084− "isOpen": {
1428+ "isActive": {
20851429 "type": "boolean",
2086− "description": "Whether this offer is open."
1430+ "description": "Whether this config is active. Required for all requests."
20871431 },
20881432 "kind": {
20891433 "type": "string",
2090− "default": "adexchangebuyer#offer"
1434+ "description": "The kind of the resource, i.e. \"adexchangebuyer#pretargetingConfig\".",
1435+ "default": "adexchangebuyer#pretargetingConfig"
20911436 },
2092− "labelNames": {
1437+ "languages": {
20931438 "type": "array",
2094− "description": "The list of label names applicable to this offer.",
1439+ "description": "Request containing any of these language codes will match.",
20951440 "items": {
20961441 "type": "string"
20971442 }
20981443 },
2099− "offerId": {
2100− "type": "string",
2101− "description": "The unique ID of this offer.",
2102− "format": "int64"
2103− },
2104− "offerState": {
2105− "type": "string",
2106− "description": "The state of this offer."
2107− },
2108− "openToDealParties": {
1444+ "mobileCarriers": {
21091445 "type": "array",
2110− "description": "The list of buyer or seller parties this offer is open to.",
1446+ "description": "Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.",
21111447 "items": {
2112− "$ref": "DealPartyDto"
1448+ "type": "string",
1449+ "format": "int64"
21131450 }
21141451 },
2115− "pointOfContact": {
2116− "type": "string",
2117− "description": "The point of contact for this offer."
2118− },
2119− "status": {
2120− "type": "string",
2121− "description": "The status of this offer."
1452+ "mobileDevices": {
1453+ "type": "array",
1454+ "description": "Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.",
1455+ "items": {
1456+ "type": "string",
1457+ "format": "int64"
1458+ }
21221459 },
2123− "terms": {
2124− "$ref": "TermsDto",
2125− "description": "The terms of this offer."
2126− }
2127− }
2128− },
2129− "PerformanceReport": {
2130− "id": "PerformanceReport",
2131− "type": "object",
2132− "description": "The configuration data for an Ad Exchange performance report list.",
2133− "properties": {
2134− "bidRate": {
2135− "type": "number",
2136− "description": "The number of bid responses with an ad.",
2137− "format": "double"
1460+ "mobileOperatingSystemVersions": {
1461+ "type": "array",
1462+ "description": "Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.",
1463+ "items": {
1464+ "type": "string",
1465+ "format": "int64"
1466+ }
21381467 },
2139− "bidRequestRate": {
2140− "type": "number",
2141− "description": "The number of bid requests sent to your bidder.",
2142− "format": "double"
1468+ "placements": {
1469+ "type": "array",
1470+ "description": "Requests containing any of these placements will match.",
1471+ "items": {
1472+ "type": "object",
1473+ "properties": {
1474+ "token": {
1475+ "type": "string",
1476+ "description": "The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement."
1477+ },
1478+ "type": {
1479+ "type": "string",
1480+ "description": "The type of the placement."
1481+ }
1482+ }
1483+ }
21431484 },
2144− "calloutStatusRate": {
1485+ "platforms": {
21451486 "type": "array",
2146− "description": "Rate of various prefiltering statuses per match. Please refer to the callout-status-codes.txt file for different statuses.",
1487+ "description": "Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.",
21471488 "items": {
2148− "type": "any"
1489+ "type": "string"
21491490 }
21501491 },
2151− "cookieMatcherStatusRate": {
1492+ "supportedCreativeAttributes": {
21521493 "type": "array",
2153− "description": "Average QPS for cookie matcher operations.",
1494+ "description": "Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.",
21541495 "items": {
2155− "type": "any"
1496+ "type": "string",
1497+ "format": "int64"
21561498 }
21571499 },
2158− "creativeStatusRate": {
1500+ "userLists": {
21591501 "type": "array",
2160− "description": "Rate of ads with a given status. Please refer to the creative-status-codes.txt file for different statuses.",
1502+ "description": "Requests containing any of these user list ids will match.",
21611503 "items": {
2162− "type": "any"
1504+ "type": "string",
1505+ "format": "int64"
21631506 }
21641507 },
2165− "filteredBidRate": {
2166− "type": "number",
2167− "description": "The number of bid responses that were filtered due to a policy violation or other errors.",
2168− "format": "double"
1508+ "vendorTypes": {
1509+ "type": "array",
1510+ "description": "Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.",
1511+ "items": {
1512+ "type": "string",
1513+ "format": "int64"
1514+ }
21691515 },
2170− "hostedMatchStatusRate": {
1516+ "verticals": {
21711517 "type": "array",
2172− "description": "Average QPS for hosted match operations.",
1518+ "description": "Requests containing any of these vertical ids will match.",
21731519 "items": {
2174− "type": "any"
1520+ "type": "string",
1521+ "format": "int64"
21751522 }
21761523 },
2177− "inventoryMatchRate": {
2178− "type": "number",
2179− "description": "The number of potential queries based on your pretargeting settings.",
2180− "format": "double"
1524+ "videoPlayerSizes": {
1525+ "type": "array",
1526+ "description": "Video requests satisfying any of these player size constraints will match.",
1527+ "items": {
1528+ "type": "object",
1529+ "properties": {
1530+ "aspectRatio": {
1531+ "type": "string",
1532+ "description": "The type of aspect ratio. Leave this field blank to match all aspect ratios."
1533+ },
1534+ "minHeight": {
1535+ "type": "string",
1536+ "description": "The minimum player height in pixels. Leave this field blank to match any player height.",
1537+ "format": "int64"
1538+ },
1539+ "minWidth": {
1540+ "type": "string",
1541+ "description": "The minimum player width in pixels. Leave this field blank to match any player width.",
1542+ "format": "int64"
1543+ }
1544+ }
1545+ }
1546+ }
1547+ }
1548+ },
1549+ "PretargetingConfigList": {
1550+ "id": "PretargetingConfigList",
1551+ "type": "object",
1552+ "properties": {
1553+ "items": {
1554+ "type": "array",
1555+ "description": "A list of pretargeting configs",
1556+ "items": {
1557+ "$ref": "PretargetingConfig"
1558+ }
21811559 },
21821560 "kind": {
21831561 "type": "string",
21841562 "description": "Resource type.",
2185− "default": "adexchangebuyer#performanceReport"
2186− },
2187− "latency50thPercentile": {
2188− "type": "number",
2189− "description": "The 50th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
2190− "format": "double"
2191− },
2192− "latency85thPercentile": {
2193− "type": "number",
2194− "description": "The 85th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
2195− "format": "double"
2196− },
2197− "latency95thPercentile": {
2198− "type": "number",
2199− "description": "The 95th percentile round trip latency(ms) as perceived from Google servers for the duration period covered by the report.",
2200− "format": "double"
2201− },
2202− "noQuotaInRegion": {
2203− "type": "number",
2204− "description": "Rate of various quota account statuses per quota check.",
2205− "format": "double"
2206− },
2207− "outOfQuota": {
2208− "type": "number",
2209− "description": "Rate of various quota account statuses per quota check.",
2210− "format": "double"
2211− },
2212− "pixelMatchRequests": {
2213− "type": "number",
2214− "description": "Average QPS for pixel match requests from clients.",
2215− "format": "double"
2216− },
2217− "pixelMatchResponses": {
2218− "type": "number",
2219− "description": "Average QPS for pixel match responses from clients.",
2220− "format": "double"
2221− },
2222− "quotaConfiguredLimit": {
2223− "type": "number",
2224− "description": "The configured quota limits for this account.",
2225− "format": "double"
2226− },
2227− "quotaThrottledLimit": {
1563+ "default": "adexchangebuyer#pretargetingConfigList"
1564+ }
1565+ }
1566+ },
1567+ "Price": {
1568+ "id": "Price",
1569+ "type": "object",
1570+ "properties": {
1571+ "amountMicros": {
22281572 "type": "number",
2229− "description": "The throttled quota limits for this account.",
1573+ "description": "The price value in micros.",
22301574 "format": "double"
22311575 },
2232− "region": {
1576+ "currencyCode": {
22331577 "type": "string",
2234− "description": "The trading location of this data."
2235− },
2236− "successfulRequestRate": {
2237− "type": "number",
2238− "description": "The number of properly formed bid responses received by our servers within the deadline.",
2239− "format": "double"
1578+ "description": "The currency code for the price."
22401579 },
2241− "timestamp": {
1580+ "pricingType": {
22421581 "type": "string",
2243− "description": "The unix timestamp of the starting time of this performance data.",
2244− "format": "int64"
2245− },
2246− "unsuccessfulRequestRate": {
2247− "type": "number",
2248− "description": "The number of bid responses that were unsuccessful due to timeouts, incorrect formatting, etc.",
2249− "format": "double"
1582+ "description": "The pricing type for the deal/product."
22501583 }
22511584 }
22521585 },
2253− "PerformanceReportList": {
2254− "id": "PerformanceReportList",
1586+ "PricePerBuyer": {
1587+ "id": "PricePerBuyer",
22551588 "type": "object",
2256− "description": "The configuration data for an Ad Exchange performance report list. https://sites.google.com/a/google.com/adx-integration/Home/engineering/binary-releases/rtb-api-release https://cs.corp.google.com/#piper///depot/google3/contentads/adx/tools/rtb_api/adxrtb.py",
1589+ "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.",
22571590 "properties": {
2258− "kind": {
2259− "type": "string",
2260− "description": "Resource type.",
2261− "default": "adexchangebuyer#performanceReportList"
1591+ "buyer": {
1592+ "$ref": "Buyer",
1593+ "description": "The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there's no more specific rule matching the buyer)."
22621594 },
2263− "performanceReport": {
2264− "type": "array",
2265− "description": "A list of performance reports relevant for the account.",
2266− "items": {
2267− "$ref": "PerformanceReport"
2268− }
1595+ "price": {
1596+ "$ref": "Price",
1597+ "description": "The specified price"
22691598 }
22701599 }
22711600 },
2272− "PretargetingConfig": {
2273− "id": "PretargetingConfig",
1601+ "PrivateData": {
1602+ "id": "PrivateData",
22741603 "type": "object",
22751604 "properties": {
2276− "billingId": {
1605+ "referenceId": {
1606+ "type": "string"
1607+ },
1608+ "referencePayload": {
22771609 "type": "string",
2278− "description": "The id for billing purposes, provided for reference. Leave this field blank for insert requests; the id will be generated automatically.",
1610+ "format": "byte"
1611+ }
1612+ }
1613+ },
1614+ "Product": {
1615+ "id": "Product",
1616+ "type": "object",
1617+ "description": "A product is segment of inventory that a seller wishes to sell. It is associated with certain terms and targeting information which helps buyer know more about the inventory. Each field in a product can have one of the following setting:\n\n(readonly) - It is an error to try and set this field. (buyer-readonly) - Only the seller can set this field. (seller-readonly) - Only the buyer can set this field. (updatable) - The field is updatable at all times by either buyer or the seller.",
1618+ "properties": {
1619+ "creationTimeMs": {
1620+ "type": "string",
1621+ "description": "Creation time in ms. since epoch (readonly)",
22791622 "format": "int64"
22801623 },
2281− "configId": {
1624+ "creatorContacts": {
1625+ "type": "array",
1626+ "description": "Optional contact information for the creator of this product. (buyer-readonly)",
1627+ "items": {
1628+ "$ref": "ContactInformation"
1629+ }
1630+ },
1631+ "flightEndTimeMs": {
22821632 "type": "string",
2283− "description": "The config id; generated automatically. Leave this field blank for insert requests.",
1633+ "description": "The proposed end time for the deal (ms since epoch) (buyer-readonly)",
22841634 "format": "int64"
22851635 },
2286− "configName": {
1636+ "flightStartTimeMs": {
22871637 "type": "string",
2288− "description": "The name of the config. Must be unique. Required for all requests."
1638+ "description": "Inventory availability dates. (times are in ms since epoch) The granularity is generally in the order of seconds. (buyer-readonly)",
1639+ "format": "int64"
22891640 },
2290− "creativeType": {
2291− "type": "array",
2292− "description": "List must contain exactly one of PRETARGETING_CREATIVE_TYPE_HTML or PRETARGETING_CREATIVE_TYPE_VIDEO.",
2293− "items": {
2294− "type": "string"
2295− }
1641+ "hasCreatorSignedOff": {
1642+ "type": "boolean",
1643+ "description": "If the creator has already signed off on the product, then the buyer can finalize the deal by accepting the product as is. When copying to a proposal, if any of the terms are changed, then auto_finalize is automatically set to false."
22961644 },
2297− "dimensions": {
2298− "type": "array",
2299− "description": "Requests which allow one of these (width, height) pairs will match. All pairs must be supported ad dimensions.",
2300− "items": {
2301− "type": "object",
2302− "properties": {
2303− "height": {
2304− "type": "string",
2305− "description": "Height in pixels.",
2306− "format": "int64"
2307− },
2308− "width": {
2309− "type": "string",
2310− "description": "Width in pixels.",
2311− "format": "int64"
2312− }
2313− }
2314− }
1645+ "inventorySource": {
1646+ "type": "string",
1647+ "description": "What exchange will provide this inventory (readonly, except on create)."
23151648 },
2316− "excludedContentLabels": {
2317− "type": "array",
2318− "description": "Requests with any of these content labels will not match. Values are from content-labels.txt in the downloadable files section.",
2319− "items": {
2320− "type": "string",
2321− "format": "int64"
2322− }
1649+ "kind": {
1650+ "type": "string",
1651+ "description": "Identifies what kind of resource this is. Value: the fixed string \"adexchangebuyer#product\".",
1652+ "default": "adexchangebuyer#product"
23231653 },
2324− "excludedGeoCriteriaIds": {
1654+ "labels": {
23251655 "type": "array",
2326− "description": "Requests containing any of these geo criteria ids will not match.",
1656+ "description": "Optional List of labels for the product (optional, buyer-readonly).",
23271657 "items": {
2328− "type": "string",
2329− "format": "int64"
1658+ "$ref": "MarketplaceLabel"
23301659 }
23311660 },
2332− "excludedPlacements": {
2333− "type": "array",
2334− "description": "Requests containing any of these placements will not match.",
2335− "items": {
2336− "type": "object",
2337− "properties": {
2338− "token": {
2339− "type": "string",
2340− "description": "The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement."
2341− },
2342− "type": {
2343− "type": "string",
2344− "description": "The type of the placement."
2345− }
2346− }
2347− }
1661+ "lastUpdateTimeMs": {
1662+ "type": "string",
1663+ "description": "Time of last update in ms. since epoch (readonly)",
1664+ "format": "int64"
23481665 },
2349− "excludedUserLists": {
2350− "type": "array",
2351− "description": "Requests containing any of these users list ids will not match.",
2352− "items": {
2353− "type": "string",
2354− "format": "int64"
2355− }
1666+ "name": {
1667+ "type": "string",
1668+ "description": "The name for this product as set by the seller. (buyer-readonly)"
23561669 },
2357− "excludedVerticals": {
1670+ "productId": {
1671+ "type": "string",
1672+ "description": "The unique id for the product (readonly)"
1673+ },
1674+ "revisionNumber": {
1675+ "type": "string",
1676+ "description": "The revision number of the product. (readonly)",
1677+ "format": "int64"
1678+ },
1679+ "seller": {
1680+ "$ref": "Seller",
1681+ "description": "Information about the seller that created this product (readonly, except on create)"
1682+ },
1683+ "sharedTargetings": {
23581684 "type": "array",
2359− "description": "Requests containing any of these vertical ids will not match. Values are from the publisher-verticals.txt file in the downloadable files section.",
1685+ "description": "Targeting that is shared between the buyer and the seller. Each targeting criteria has a specified key and for each key there is a list of inclusion value or exclusion values. (buyer-readonly)",
23601686 "items": {
2361− "type": "string",
2362− "format": "int64"
1687+ "$ref": "SharedTargeting"
23631688 }
23641689 },
2365− "geoCriteriaIds": {
1690+ "state": {
1691+ "type": "string",
1692+ "description": "The state of the product. (buyer-readonly)"
1693+ },
1694+ "syndicationProduct": {
1695+ "type": "string",
1696+ "description": "The syndication product associated with the deal. (readonly, except on create)"
1697+ },
1698+ "terms": {
1699+ "$ref": "DealTerms",
1700+ "description": "The negotiable terms of the deal (buyer-readonly)"
1701+ },
1702+ "webPropertyCode": {
1703+ "type": "string"
1704+ }
1705+ }
1706+ },
1707+ "Proposal": {
1708+ "id": "Proposal",
1709+ "type": "object",
1710+ "description": "Represents a proposal in the marketplace. A proposal is the unit of negotiation between a seller and a buyer and contains deals which are served. Each field in a proposal can have one of the following setting:\n\n(readonly) - It is an error to try and set this field. (buyer-readonly) - Only the seller can set this field. (seller-readonly) - Only the buyer can set this field. (updatable) - The field is updatable at all times by either buyer or the seller.",
1711+ "properties": {
1712+ "billedBuyer": {
1713+ "$ref": "Buyer",
1714+ "description": "Reference to the buyer that will get billed for this proposal. (readonly)"
1715+ },
1716+ "buyer": {
1717+ "$ref": "Buyer",
1718+ "description": "Reference to the buyer on the proposal. (readonly, except on create)"
1719+ },
1720+ "buyerContacts": {
23661721 "type": "array",
2367− "description": "Requests containing any of these geo criteria ids will match.",
1722+ "description": "Optional contact information fort the buyer. (seller-readonly)",
23681723 "items": {
2369− "type": "string",
2370− "format": "int64"
1724+ "$ref": "ContactInformation"
23711725 }
23721726 },
2373− "isActive": {
1727+ "buyerPrivateData": {
1728+ "$ref": "PrivateData",
1729+ "description": "Private data for buyer. (hidden from seller)."
1730+ },
1731+ "hasBuyerSignedOff": {
23741732 "type": "boolean",
2375− "description": "Whether this config is active. Required for all requests."
1733+ "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)"
1734+ },
1735+ "hasSellerSignedOff": {
1736+ "type": "boolean",
1737+ "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)"
1738+ },
1739+ "inventorySource": {
1740+ "type": "string",
1741+ "description": "What exchange will provide this inventory (readonly, except on create)."
1742+ },
1743+ "isRenegotiating": {
1744+ "type": "boolean",
1745+ "description": "True if the proposal is being renegotiated (readonly)."
1746+ },
1747+ "isSetupComplete": {
1748+ "type": "boolean",
1749+ "description": "True, if the buyside inventory setup is complete for this proposal. (readonly)"
23761750 },
23771751 "kind": {
23781752 "type": "string",
2379− "description": "The kind of the resource, i.e. \"adexchangebuyer#pretargetingConfig\".",
2380− "default": "adexchangebuyer#pretargetingConfig"
1753+ "description": "Identifies what kind of resource this is. Value: the fixed string \"adexchangebuyer#proposal\".",
1754+ "default": "adexchangebuyer#proposal"
23811755 },
2382− "languages": {
1756+ "labels": {
23831757 "type": "array",
2384− "description": "Request containing any of these language codes will match.",
1758+ "description": "List of labels associated with the proposal. (readonly)",
23851759 "items": {
2386− "type": "string"
1760+ "$ref": "MarketplaceLabel"
23871761 }
23881762 },
2389− "mobileCarriers": {
2390− "type": "array",
2391− "description": "Requests containing any of these mobile carrier ids will match. Values are from mobile-carriers.csv in the downloadable files section.",
2392− "items": {
2393− "type": "string",
2394− "format": "int64"
2395− }
1763+ "lastUpdaterOrCommentorRole": {
1764+ "type": "string",
1765+ "description": "The role of the last user that either updated the proposal or left a comment. (readonly)"
23961766 },
2397− "mobileDevices": {
2398− "type": "array",
2399− "description": "Requests containing any of these mobile device ids will match. Values are from mobile-devices.csv in the downloadable files section.",
2400− "items": {
2401− "type": "string",
2402− "format": "int64"
2403− }
1767+ "lastUpdaterRole": {
1768+ "type": "string"
24041769 },
2405− "mobileOperatingSystemVersions": {
1770+ "name": {
1771+ "type": "string",
1772+ "description": "The name for the proposal (updatable)"
1773+ },
1774+ "originatorRole": {
1775+ "type": "string",
1776+ "description": "Indicates whether the buyer/seller created the proposal.(readonly)"
1777+ },
1778+ "proposalId": {
1779+ "type": "string",
1780+ "description": "The unique id of the proposal. (readonly)."
1781+ },
1782+ "proposalState": {
1783+ "type": "string",
1784+ "description": "The current state of the proposal. (readonly)"
1785+ },
1786+ "revisionNumber": {
1787+ "type": "string",
1788+ "description": "The revision number for the proposal (readonly).",
1789+ "format": "int64"
1790+ },
1791+ "revisionTimeMs": {
1792+ "type": "string",
1793+ "description": "The time (ms since epoch) when the proposal was last revised (readonly).",
1794+ "format": "int64"
1795+ },
1796+ "seller": {
1797+ "$ref": "Seller",
1798+ "description": "Reference to the seller on the proposal. (readonly, except on create)"
1799+ },
1800+ "sellerContacts": {
24061801 "type": "array",
2407− "description": "Requests containing any of these mobile operating system version ids will match. Values are from mobile-os.csv in the downloadable files section.",
1802+ "description": "Optional contact information for the seller (buyer-readonly).",
24081803 "items": {
2409− "type": "string",
2410− "format": "int64"
1804+ "$ref": "ContactInformation"
24111805 }
2412− },
2413− "placements": {
2414− "type": "array",
2415− "description": "Requests containing any of these placements will match.",
2416− "items": {
2417− "type": "object",
2418− "properties": {
2419− "token": {
2420− "type": "string",
2421− "description": "The value of the placement. Interpretation depends on the placement type, e.g. URL for a site placement, channel name for a channel placement, app id for a mobile app placement."
2422− },
2423− "type": {
2424− "type": "string",
2425− "description": "The type of the placement."
2426− }
2427− }
2428− }
2429− },
2430− "platforms": {
2431− "type": "array",
2432− "description": "Requests matching any of these platforms will match. Possible values are PRETARGETING_PLATFORM_MOBILE, PRETARGETING_PLATFORM_DESKTOP, and PRETARGETING_PLATFORM_TABLET.",
2433− "items": {
2434− "type": "string"
2435− }
2436− },
2437− "supportedCreativeAttributes": {
2438− "type": "array",
2439− "description": "Creative attributes should be declared here if all creatives corresponding to this pretargeting configuration have that creative attribute. Values are from pretargetable-creative-attributes.txt in the downloadable files section.",
2440− "items": {
2441− "type": "string",
2442− "format": "int64"
2443− }
2444− },
2445− "userLists": {
2446− "type": "array",
2447− "description": "Requests containing any of these user list ids will match.",
2448− "items": {
2449− "type": "string",
2450− "format": "int64"
2451− }
2452− },
2453− "vendorTypes": {
2454− "type": "array",
2455− "description": "Requests that allow any of these vendor ids will match. Values are from vendors.txt in the downloadable files section.",
2456− "items": {
2457− "type": "string",
2458− "format": "int64"
2459− }
2460− },
2461− "verticals": {
2462− "type": "array",
2463− "description": "Requests containing any of these vertical ids will match.",
2464− "items": {
2465− "type": "string",
2466− "format": "int64"
2467− }
2468− }
2469− }
2470− },
2471− "PretargetingConfigList": {
2472− "id": "PretargetingConfigList",
2473− "type": "object",
2474− "properties": {
2475− "items": {
2476− "type": "array",
2477− "description": "A list of pretargeting configs",
2478− "items": {
2479− "$ref": "PretargetingConfig"
2480− }
2481− },
2482− "kind": {
2483− "type": "string",
2484− "description": "Resource type.",
2485− "default": "adexchangebuyer#pretargetingConfigList"
2486− }
2487− }
2488− },
2489− "Price": {
2490− "id": "Price",
2491− "type": "object",
2492− "properties": {
2493− "amountMicros": {
2494− "type": "number",
2495− "description": "The CPM value in micros.",
2496− "format": "double"
2497− },
2498− "currencyCode": {
2499− "type": "string",
2500− "description": "The currency code for the price."
2501− }
2502− }
2503− },
2504− "PricePerBuyer": {
2505− "id": "PricePerBuyer",
2506− "type": "object",
2507− "description": "Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in an offer 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.",
2508− "properties": {
2509− "buyer": {
2510− "$ref": "Buyer",
2511− "description": "The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there's no more specific rule matching the buyer)."
2512− },
2513− "price": {
2514− "$ref": "Price",
2515− "description": "The specified price"
2516− }
2517− }
2518− },
2519− "PrivateData": {
2520− "id": "PrivateData",
2521− "type": "object",
2522− "properties": {
2523− "referenceId": {
2524− "type": "string"
2525− },
2526− "referencePayload": {
2527− "type": "string",
2528− "format": "byte"
2529− }
2530− }
2531− },
2532− "RuleKeyValuePair": {
2533− "id": "RuleKeyValuePair",
2534− "type": "object",
2535− "properties": {
2536− "keyName": {
2537− "type": "string"
2538− },
2539− "value": {
2540− "type": "string"
2541− }
2542− }
2543− },
2544− "Seller": {
2545− "id": "Seller",
2546− "type": "object",
2547− "properties": {
2548− "accountId": {
2549− "type": "string",
2550− "description": "The unique id for the seller. The seller fills in this field. The seller account id is then available to buyer in the offer."
1806+ }
1807+ }
1808+ },
1809+ "Seller": {
1810+ "id": "Seller",
1811+ "type": "object",
1812+ "properties": {
1813+ "accountId": {
1814+ "type": "string",
1815+ "description": "The unique id for the seller. The seller fills in this field. The seller account id is then available to buyer in the product."
25511816 },
25521817 "subAccountId": {
25531818 "type": "string",
@@ -2579,34 +1844,6 @@
25791844 }
25801845 }
25811846 },
2582− "StatsDto": {
2583− "id": "StatsDto",
2584− "type": "object",
2585− "properties": {
2586− "bids": {
2587− "type": "string",
2588− "format": "int64"
2589− },
2590− "goodBids": {
2591− "type": "string",
2592− "format": "int64"
2593− },
2594− "impressions": {
2595− "type": "string",
2596− "format": "int64"
2597− },
2598− "requests": {
2599− "type": "string",
2600− "format": "int64"
2601− },
2602− "revenue": {
2603− "$ref": "MoneyDto"
2604− },
2605− "spend": {
2606− "$ref": "MoneyDto"
2607− }
2608− }
2609− },
26101847 "TargetingValue": {
26111848 "id": "TargetingValue",
26121849 "type": "object",
@@ -2647,7 +1884,7 @@
26471884 },
26481885 "size": {
26491886 "$ref": "TargetingValueSize",
2650− "description": "For regular creative size type, specifies the size of the creative."
1887+ "description": "For regular or video creative size type, specifies the size of the creative."
26511888 }
26521889 }
26531890 },
@@ -2696,575 +1933,106 @@
26961933 "type": "object",
26971934 "properties": {
26981935 "height": {
2699− "type": "integer",
2700− "description": "The height of the creative.",
2701− "format": "int32"
2702− },
2703− "width": {
2704− "type": "integer",
2705− "description": "The width of the creative.",
2706− "format": "int32"
2707− }
2708− }
2709− },
2710− "TermsDto": {
2711− "id": "TermsDto",
2712− "type": "object",
2713− "properties": {
2714− "adSlots": {
2715− "type": "array",
2716− "description": "The particular ad slots targeted by the offer.",
2717− "items": {
2718− "$ref": "AdSlotDto"
2719− }
2720− },
2721− "advertisers": {
2722− "type": "array",
2723− "description": "A list of advertisers for this offer.",
2724− "items": {
2725− "$ref": "AdvertiserDto"
2726− }
2727− },
2728− "audienceSegment": {
2729− "$ref": "AudienceSegment",
2730− "description": "The audience segment for the offer."
2731− },
2732− "audienceSegmentDescription": {
2733− "type": "string",
2734− "description": "A description of the audience segment for the offer."
2735− },
2736− "billingTerms": {
2737− "type": "string",
2738− "description": "The billing terms."
2739− },
2740− "buyerBillingType": {
2741− "type": "string",
2742− "description": "The buyer billing type."
2743− },
2744− "cpm": {
2745− "$ref": "MoneyDto",
2746− "description": "The cpm terms."
2747− },
2748− "creativeBlockingLevel": {
2749− "type": "string",
2750− "description": "Whether to use or ignore publisher blocking rules."
2751− },
2752− "creativeReviewPolicy": {
2753− "type": "string",
2754− "description": "Whether to use publisher review policy or AdX review policy."
2755− },
2756− "dealPremium": {
2757− "$ref": "MoneyDto",
2758− "description": "The premium terms."
2759− },
2760− "description": {
2761− "type": "string",
2762− "description": "A description for these terms."
2763− },
2764− "descriptiveName": {
2765− "type": "string",
2766− "description": "A descriptive name for these terms."
2767− },
2768− "endDate": {
2769− "$ref": "DateTime",
2770− "description": "The end date for the offer."
2771− },
2772− "estimatedImpressionsPerDay": {
2773− "type": "string",
2774− "description": "The estimated daily impressions for the offer.",
2775− "format": "int64"
2776− },
2777− "estimatedSpend": {
2778− "$ref": "MoneyDto",
2779− "description": "The estimated spend for the offer."
2780− },
2781− "finalizeAutomatically": {
2782− "type": "boolean",
2783− "description": "If true, the offer will finalize automatically when accepted."
2784− },
2785− "inventorySegmentTargeting": {
2786− "$ref": "InventorySegmentTargeting",
2787− "description": "The inventory segment targeting for the offer."
2788− },
2789− "isReservation": {
2790− "type": "boolean",
2791− "description": "Whether the offer is a reservation."
2792− },
2793− "minimumSpendMicros": {
2794− "type": "string",
2795− "description": "The minimum spend for the offer.",
2796− "format": "int64"
2797− },
2798− "minimumTrueLooks": {
2799− "type": "string",
2800− "description": "The minimum true looks for the offer.",
2801− "format": "int64"
2802− },
2803− "monetizerType": {
2804− "type": "string",
2805− "description": "The monetizer type."
2806− },
2807− "semiTransparent": {
2808− "type": "boolean",
2809− "description": "Whether this offer is semi-transparent."
2810− },
2811− "startDate": {
2812− "$ref": "DateTime",
2813− "description": "The start date for the offer."
2814− },
2815− "targetByDealId": {
2816− "type": "boolean",
2817− "description": "Whether to target by deal id."
2818− },
2819− "targetingAllAdSlots": {
2820− "type": "boolean",
2821− "description": "If true, the offer targets all ad slots."
2822− },
2823− "termsAttributes": {
2824− "type": "array",
2825− "description": "A list of terms attributes.",
2826− "items": {
2827− "type": "string"
2828− }
2829− },
2830− "urls": {
2831− "type": "array",
2832− "description": "The urls applicable to the offer.",
2833− "items": {
2834− "type": "string"
2835− }
2836− }
2837− }
2838− },
2839− "WebPropertyDto": {
2840− "id": "WebPropertyDto",
2841− "type": "object",
2842− "properties": {
2843− "allowInterestTargetedAds": {
2844− "type": "boolean"
2845− },
2846− "enabledForPreferredDeals": {
2847− "type": "boolean"
2848− },
2849− "id": {
2850− "type": "integer",
2851− "format": "int32"
2852− },
2853− "name": {
2854− "type": "string"
2855− },
2856− "propertyCode": {
2857− "type": "string"
2858− },
2859− "siteUrls": {
2860− "type": "array",
2861− "items": {
2862− "type": "string"
2863− }
2864− },
2865− "syndicationProduct": {
2866− "type": "string"
2867− }
2868− }
2869− }
2870− },
2871− "resources": {
2872− "accounts": {
2873− "methods": {
2874− "get": {
2875− "id": "adexchangebuyer.accounts.get",
2876− "path": "accounts/{id}",
2877− "httpMethod": "GET",
2878− "description": "Gets one account by ID.",
2879− "parameters": {
2880− "id": {
2881− "type": "integer",
2882− "description": "The account id",
2883− "required": true,
2884− "format": "int32",
2885− "location": "path"
2886− }
2887− },
2888− "parameterOrder": [
2889− "id"
2890− ],
2891− "response": {
2892− "$ref": "Account"
2893− },
2894− "scopes": [
2895− "https://www.googleapis.com/auth/adexchange.buyer"
2896− ]
2897− },
2898− "list": {
2899− "id": "adexchangebuyer.accounts.list",
2900− "path": "accounts",
2901− "httpMethod": "GET",
2902− "description": "Retrieves the authenticated user's list of accounts.",
2903− "response": {
2904− "$ref": "AccountsList"
2905− },
2906− "scopes": [
2907− "https://www.googleapis.com/auth/adexchange.buyer"
2908− ]
2909− },
2910− "patch": {
2911− "id": "adexchangebuyer.accounts.patch",
2912− "path": "accounts/{id}",
2913− "httpMethod": "PATCH",
2914− "description": "Updates an existing account. This method supports patch semantics.",
2915− "parameters": {
2916− "id": {
2917− "type": "integer",
2918− "description": "The account id",
2919− "required": true,
2920− "format": "int32",
2921− "location": "path"
2922− }
2923− },
2924− "parameterOrder": [
2925− "id"
2926− ],
2927− "request": {
2928− "$ref": "Account"
2929− },
2930− "response": {
2931− "$ref": "Account"
2932− },
2933− "scopes": [
2934− "https://www.googleapis.com/auth/adexchange.buyer"
2935− ]
2936− },
2937− "update": {
2938− "id": "adexchangebuyer.accounts.update",
2939− "path": "accounts/{id}",
2940− "httpMethod": "PUT",
2941− "description": "Updates an existing account.",
2942− "parameters": {
2943− "id": {
2944− "type": "integer",
2945− "description": "The account id",
2946− "required": true,
2947− "format": "int32",
2948− "location": "path"
2949− }
2950− },
2951− "parameterOrder": [
2952− "id"
2953− ],
2954− "request": {
2955− "$ref": "Account"
2956− },
2957− "response": {
2958− "$ref": "Account"
2959− },
2960− "scopes": [
2961− "https://www.googleapis.com/auth/adexchange.buyer"
2962− ]
2963− }
2964− }
2965− },
2966− "billingInfo": {
2967− "methods": {
2968− "get": {
2969− "id": "adexchangebuyer.billingInfo.get",
2970− "path": "billinginfo/{accountId}",
2971− "httpMethod": "GET",
2972− "description": "Returns the billing information for one account specified by account ID.",
2973− "parameters": {
2974− "accountId": {
2975− "type": "integer",
2976− "description": "The account id.",
2977− "required": true,
2978− "format": "int32",
2979− "location": "path"
2980− }
2981− },
2982− "parameterOrder": [
2983− "accountId"
2984− ],
2985− "response": {
2986− "$ref": "BillingInfo"
2987− },
2988− "scopes": [
2989− "https://www.googleapis.com/auth/adexchange.buyer"
2990− ]
2991− },
2992− "list": {
2993− "id": "adexchangebuyer.billingInfo.list",
2994− "path": "billinginfo",
2995− "httpMethod": "GET",
2996− "description": "Retrieves a list of billing information for all accounts of the authenticated user.",
2997− "response": {
2998− "$ref": "BillingInfoList"
2999− },
3000− "scopes": [
3001− "https://www.googleapis.com/auth/adexchange.buyer"
3002− ]
3003− }
3004− }
3005− },
3006− "budget": {
3007− "methods": {
3008− "get": {
3009− "id": "adexchangebuyer.budget.get",
3010− "path": "billinginfo/{accountId}/{billingId}",
3011− "httpMethod": "GET",
3012− "description": "Returns the budget information for the adgroup specified by the accountId and billingId.",
3013− "parameters": {
3014− "accountId": {
3015− "type": "string",
3016− "description": "The account id to get the budget information for.",
3017− "required": true,
3018− "format": "int64",
3019− "location": "path"
3020− },
3021− "billingId": {
3022− "type": "string",
3023− "description": "The billing id to get the budget information for.",
3024− "required": true,
3025− "format": "int64",
3026− "location": "path"
3027− }
3028− },
3029− "parameterOrder": [
3030− "accountId",
3031− "billingId"
3032− ],
3033− "response": {
3034− "$ref": "Budget"
3035− },
3036− "scopes": [
3037− "https://www.googleapis.com/auth/adexchange.buyer"
3038− ]
3039− },
3040− "patch": {
3041− "id": "adexchangebuyer.budget.patch",
3042− "path": "billinginfo/{accountId}/{billingId}",
3043− "httpMethod": "PATCH",
3044− "description": "Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request. This method supports patch semantics.",
3045− "parameters": {
3046− "accountId": {
3047− "type": "string",
3048− "description": "The account id associated with the budget being updated.",
3049− "required": true,
3050− "format": "int64",
3051− "location": "path"
3052− },
3053− "billingId": {
3054− "type": "string",
3055− "description": "The billing id associated with the budget being updated.",
3056− "required": true,
3057− "format": "int64",
3058− "location": "path"
3059− }
3060− },
3061− "parameterOrder": [
3062− "accountId",
3063− "billingId"
3064− ],
3065− "request": {
3066− "$ref": "Budget"
3067− },
3068− "response": {
3069− "$ref": "Budget"
3070− },
3071− "scopes": [
3072− "https://www.googleapis.com/auth/adexchange.buyer"
3073− ]
3074− },
3075− "update": {
3076− "id": "adexchangebuyer.budget.update",
3077− "path": "billinginfo/{accountId}/{billingId}",
3078− "httpMethod": "PUT",
3079− "description": "Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request.",
3080− "parameters": {
3081− "accountId": {
3082− "type": "string",
3083− "description": "The account id associated with the budget being updated.",
3084− "required": true,
3085− "format": "int64",
3086− "location": "path"
3087− },
3088− "billingId": {
3089− "type": "string",
3090− "description": "The billing id associated with the budget being updated.",
3091− "required": true,
3092− "format": "int64",
3093− "location": "path"
3094− }
3095− },
3096− "parameterOrder": [
3097− "accountId",
3098− "billingId"
3099− ],
3100− "request": {
3101− "$ref": "Budget"
3102− },
3103− "response": {
3104− "$ref": "Budget"
3105− },
3106− "scopes": [
3107− "https://www.googleapis.com/auth/adexchange.buyer"
3108− ]
3109− }
3110− }
3111− },
3112− "clientaccess": {
3113− "methods": {
3114− "delete": {
3115− "id": "adexchangebuyer.clientaccess.delete",
3116− "path": "clientAccess/{clientAccountId}",
3117− "httpMethod": "DELETE",
3118− "parameters": {
3119− "clientAccountId": {
3120− "type": "string",
3121− "required": true,
3122− "format": "int64",
3123− "location": "path"
3124− },
3125− "sponsorAccountId": {
3126− "type": "integer",
3127− "required": true,
3128− "format": "int32",
3129− "location": "query"
3130− }
3131− },
3132− "parameterOrder": [
3133− "clientAccountId",
3134− "sponsorAccountId"
3135− ],
3136− "scopes": [
3137− "https://www.googleapis.com/auth/adexchange.buyer"
3138− ]
1936+ "type": "integer",
1937+ "description": "The height of the creative.",
1938+ "format": "int32"
31391939 },
1940+ "width": {
1941+ "type": "integer",
1942+ "description": "The width of the creative.",
1943+ "format": "int32"
1944+ }
1945+ }
1946+ }
1947+ },
1948+ "resources": {
1949+ "accounts": {
1950+ "methods": {
31401951 "get": {
3141− "id": "adexchangebuyer.clientaccess.get",
3142− "path": "clientAccess/{clientAccountId}",
1952+ "id": "adexchangebuyer.accounts.get",
1953+ "path": "accounts/{id}",
31431954 "httpMethod": "GET",
1955+ "description": "Gets one account by ID.",
31441956 "parameters": {
3145− "clientAccountId": {
3146− "type": "string",
3147− "required": true,
3148− "format": "int64",
3149− "location": "path"
3150− },
3151− "sponsorAccountId": {
1957+ "id": {
31521958 "type": "integer",
1959+ "description": "The account id",
31531960 "required": true,
31541961 "format": "int32",
3155− "location": "query"
1962+ "location": "path"
31561963 }
31571964 },
31581965 "parameterOrder": [
3159− "clientAccountId",
3160− "sponsorAccountId"
1966+ "id"
31611967 ],
31621968 "response": {
3163− "$ref": "ClientAccessCapabilities"
3164− },
3165− "scopes": [
3166− "https://www.googleapis.com/auth/adexchange.buyer"
3167− ]
3168− },
3169− "insert": {
3170− "id": "adexchangebuyer.clientaccess.insert",
3171− "path": "clientAccess",
3172− "httpMethod": "POST",
3173− "parameters": {
3174− "clientAccountId": {
3175− "type": "string",
3176− "format": "int64",
3177− "location": "query"
3178− },
3179− "sponsorAccountId": {
3180− "type": "integer",
3181− "format": "int32",
3182− "location": "query"
3183− }
3184− },
3185− "request": {
3186− "$ref": "ClientAccessCapabilities"
3187− },
3188− "response": {
3189− "$ref": "ClientAccessCapabilities"
1969+ "$ref": "Account"
31901970 },
31911971 "scopes": [
31921972 "https://www.googleapis.com/auth/adexchange.buyer"
31931973 ]
31941974 },
31951975 "list": {
3196− "id": "adexchangebuyer.clientaccess.list",
3197− "path": "clientAccess",
1976+ "id": "adexchangebuyer.accounts.list",
1977+ "path": "accounts",
31981978 "httpMethod": "GET",
3199− "request": {
3200− "$ref": "ListClientAccessCapabilitiesRequest"
3201− },
1979+ "description": "Retrieves the authenticated user's list of accounts.",
32021980 "response": {
3203− "$ref": "ListClientAccessCapabilitiesResponse"
1981+ "$ref": "AccountsList"
32041982 },
32051983 "scopes": [
32061984 "https://www.googleapis.com/auth/adexchange.buyer"
32071985 ]
32081986 },
32091987 "patch": {
3210− "id": "adexchangebuyer.clientaccess.patch",
3211− "path": "clientAccess/{clientAccountId}",
1988+ "id": "adexchangebuyer.accounts.patch",
1989+ "path": "accounts/{id}",
32121990 "httpMethod": "PATCH",
1991+ "description": "Updates an existing account. This method supports patch semantics.",
32131992 "parameters": {
3214− "clientAccountId": {
3215− "type": "string",
3216− "required": true,
3217− "format": "int64",
3218− "location": "path"
3219− },
3220− "sponsorAccountId": {
1993+ "id": {
32211994 "type": "integer",
1995+ "description": "The account id",
32221996 "required": true,
32231997 "format": "int32",
3224− "location": "query"
1998+ "location": "path"
32251999 }
32262000 },
32272001 "parameterOrder": [
3228− "clientAccountId",
3229− "sponsorAccountId"
2002+ "id"
32302003 ],
32312004 "request": {
3232− "$ref": "ClientAccessCapabilities"
2005+ "$ref": "Account"
32332006 },
32342007 "response": {
3235− "$ref": "ClientAccessCapabilities"
2008+ "$ref": "Account"
32362009 },
32372010 "scopes": [
32382011 "https://www.googleapis.com/auth/adexchange.buyer"
32392012 ]
32402013 },
32412014 "update": {
3242− "id": "adexchangebuyer.clientaccess.update",
3243− "path": "clientAccess/{clientAccountId}",
2015+ "id": "adexchangebuyer.accounts.update",
2016+ "path": "accounts/{id}",
32442017 "httpMethod": "PUT",
2018+ "description": "Updates an existing account.",
32452019 "parameters": {
3246− "clientAccountId": {
3247− "type": "string",
3248− "required": true,
3249− "format": "int64",
3250− "location": "path"
3251− },
3252− "sponsorAccountId": {
2020+ "id": {
32532021 "type": "integer",
2022+ "description": "The account id",
32542023 "required": true,
32552024 "format": "int32",
3256− "location": "query"
2025+ "location": "path"
32572026 }
32582027 },
32592028 "parameterOrder": [
3260− "clientAccountId",
3261− "sponsorAccountId"
2029+ "id"
32622030 ],
32632031 "request": {
3264− "$ref": "ClientAccessCapabilities"
2032+ "$ref": "Account"
32652033 },
32662034 "response": {
3267− "$ref": "ClientAccessCapabilities"
2035+ "$ref": "Account"
32682036 },
32692037 "scopes": [
32702038 "https://www.googleapis.com/auth/adexchange.buyer"
@@ -3272,123 +2040,39 @@
32722040 }
32732041 }
32742042 },
3275− "creatives": {
2043+ "billingInfo": {
32762044 "methods": {
32772045 "get": {
3278− "id": "adexchangebuyer.creatives.get",
3279− "path": "creatives/{accountId}/{buyerCreativeId}",
2046+ "id": "adexchangebuyer.billingInfo.get",
2047+ "path": "billinginfo/{accountId}",
32802048 "httpMethod": "GET",
3281− "description": "Gets the status for a single creative. A creative will be available 30-40 minutes after submission.",
2049+ "description": "Returns the billing information for one account specified by account ID.",
32822050 "parameters": {
32832051 "accountId": {
32842052 "type": "integer",
3285− "description": "The id for the account that will serve this creative.",
2053+ "description": "The account id.",
32862054 "required": true,
32872055 "format": "int32",
32882056 "location": "path"
3289− },
3290− "buyerCreativeId": {
3291− "type": "string",
3292− "description": "The buyer-specific id for this creative.",
3293− "required": true,
3294− "location": "path"
32952057 }
32962058 },
32972059 "parameterOrder": [
3298− "accountId",
3299− "buyerCreativeId"
2060+ "accountId"
33002061 ],
33012062 "response": {
3302− "$ref": "Creative"
3303− },
3304− "scopes": [
3305− "https://www.googleapis.com/auth/adexchange.buyer"
3306− ]
3307− },
3308− "insert": {
3309− "id": "adexchangebuyer.creatives.insert",
3310− "path": "creatives",
3311− "httpMethod": "POST",
3312− "description": "Submit a new creative.",
3313− "request": {
3314− "$ref": "Creative"
3315− },
3316− "response": {
3317− "$ref": "Creative"
2063+ "$ref": "BillingInfo"
33182064 },
33192065 "scopes": [
33202066 "https://www.googleapis.com/auth/adexchange.buyer"
33212067 ]
33222068 },
33232069 "list": {
3324− "id": "adexchangebuyer.creatives.list",
3325− "path": "creatives",
2070+ "id": "adexchangebuyer.billingInfo.list",
2071+ "path": "billinginfo",
33262072 "httpMethod": "GET",
3327− "description": "Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.",
3328− "parameters": {
3329− "accountId": {
3330− "type": "integer",
3331− "description": "When specified, only creatives for the given account ids are returned.",
3332− "format": "int32",
3333− "repeated": true,
3334− "location": "query"
3335− },
3336− "buyerCreativeId": {
3337− "type": "string",
3338− "description": "When specified, only creatives for the given buyer creative ids are returned.",
3339− "repeated": true,
3340− "location": "query"
3341− },
3342− "dealsStatusFilter": {
3343− "type": "string",
3344− "description": "When specified, only creatives having the given direct deals status are returned.",
3345− "enum": [
3346− "approved",
3347− "conditionally_approved",
3348− "disapproved",
3349− "not_checked"
3350− ],
3351− "enumDescriptions": [
3352− "Creatives which have been approved for serving on direct deals.",
3353− "Creatives which have been conditionally approved for serving on direct deals.",
3354− "Creatives which have been disapproved for serving on direct deals.",
3355− "Creatives whose direct deals status is not yet checked."
3356− ],
3357− "location": "query"
3358− },
3359− "maxResults": {
3360− "type": "integer",
3361− "description": "Maximum number of entries returned on one result page. If not set, the default is 100. Optional.",
3362− "format": "uint32",
3363− "minimum": "1",
3364− "maximum": "1000",
3365− "location": "query"
3366− },
3367− "openAuctionStatusFilter": {
3368− "type": "string",
3369− "description": "When specified, only creatives having the given open auction status are returned.",
3370− "enum": [
3371− "approved",
3372− "conditionally_approved",
3373− "disapproved",
3374− "not_checked"
3375− ],
3376− "enumDescriptions": [
3377− "Creatives which have been approved for serving on the open auction.",
3378− "Creatives which have been conditionally approved for serving on the open auction.",
3379− "Creatives which have been disapproved for serving on the open auction.",
3380− "Creatives whose open auction status is not yet checked."
3381− ],
3382− "location": "query"
3383− },
3384− "pageToken": {
3385− "type": "string",
3386− "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.",
3387− "location": "query"
3388− }
3389− },
2073+ "description": "Retrieves a list of billing information for all accounts of the authenticated user.",
33902074 "response": {
3391− "$ref": "CreativesList"
2075+ "$ref": "BillingInfoList"
33922076 },
33932077 "scopes": [
33942078 "https://www.googleapis.com/auth/adexchange.buyer"
@@ -3396,187 +2080,105 @@
33962080 }
33972081 }
33982082 },
3399− "deals": {
2083+ "budget": {
34002084 "methods": {
34012085 "get": {
3402− "id": "adexchangebuyer.deals.get",
3403− "path": "deals/{dealId}",
2086+ "id": "adexchangebuyer.budget.get",
2087+ "path": "billinginfo/{accountId}/{billingId}",
34042088 "httpMethod": "GET",
3405− "description": "Gets the requested deal.",
2089+ "description": "Returns the budget information for the adgroup specified by the accountId and billingId.",
34062090 "parameters": {
3407− "dealId": {
2091+ "accountId": {
34082092 "type": "string",
2093+ "description": "The account id to get the budget information for.",
34092094 "required": true,
34102095 "format": "int64",
34112096 "location": "path"
3412− }
3413− },
3414− "parameterOrder": [
3415− "dealId"
3416− ],
3417− "request": {
3418− "$ref": "GetFinalizedNegotiationByExternalDealIdRequest"
3419− },
3420− "response": {
3421− "$ref": "NegotiationDto"
3422− },
3423− "scopes": [
3424− "https://www.googleapis.com/auth/adexchange.buyer"
3425− ]
3426− }
3427− }
3428− },
3429− "marketplacedeals": {
3430− "methods": {
3431− "delete": {
3432− "id": "adexchangebuyer.marketplacedeals.delete",
3433− "path": "marketplaceOrders/{orderId}/deals/delete",
3434− "httpMethod": "POST",
3435− "description": "Delete the specified deals from the order",
3436− "parameters": {
3437− "orderId": {
3438− "type": "string",
3439− "description": "The orderId to delete deals from.",
3440− "required": true,
3441− "location": "path"
3442− }
3443− },
3444− "parameterOrder": [
3445− "orderId"
3446− ],
3447− "request": {
3448− "$ref": "DeleteOrderDealsRequest"
3449− },
3450− "response": {
3451− "$ref": "DeleteOrderDealsResponse"
3452− },
3453− "scopes": [
3454− "https://www.googleapis.com/auth/adexchange.buyer"
3455− ]
3456− },
3457− "insert": {
3458− "id": "adexchangebuyer.marketplacedeals.insert",
3459− "path": "marketplaceOrders/{orderId}/deals/insert",
3460− "httpMethod": "POST",
3461− "description": "Add new deals for the specified order",
3462− "parameters": {
3463− "orderId": {
3464− "type": "string",
3465− "description": "OrderId for which deals need to be added.",
3466− "required": true,
3467− "location": "path"
3468− }
3469− },
3470− "parameterOrder": [
3471− "orderId"
3472− ],
3473− "request": {
3474− "$ref": "AddOrderDealsRequest"
3475− },
3476− "response": {
3477− "$ref": "AddOrderDealsResponse"
3478− },
3479− "scopes": [
3480− "https://www.googleapis.com/auth/adexchange.buyer"
3481− ]
3482− },
3483− "list": {
3484− "id": "adexchangebuyer.marketplacedeals.list",
3485− "path": "marketplaceOrders/{orderId}/deals",
3486− "httpMethod": "GET",
3487− "description": "List all the deals for a given order",
3488− "parameters": {
3489− "orderId": {
2097+ },
2098+ "billingId": {
34902099 "type": "string",
3491− "description": "The orderId to get deals for.",
2100+ "description": "The billing id to get the budget information for.",
34922101 "required": true,
2102+ "format": "int64",
34932103 "location": "path"
34942104 }
34952105 },
34962106 "parameterOrder": [
3497− "orderId"
2107+ "accountId",
2108+ "billingId"
34982109 ],
34992110 "response": {
3500− "$ref": "GetOrderDealsResponse"
2111+ "$ref": "Budget"
35012112 },
35022113 "scopes": [
35032114 "https://www.googleapis.com/auth/adexchange.buyer"
35042115 ]
35052116 },
3506− "update": {
3507− "id": "adexchangebuyer.marketplacedeals.update",
3508− "path": "marketplaceOrders/{orderId}/deals/update",
3509− "httpMethod": "POST",
3510− "description": "Replaces all the deals in the order with the passed in deals",
2117+ "patch": {
2118+ "id": "adexchangebuyer.budget.patch",
2119+ "path": "billinginfo/{accountId}/{billingId}",
2120+ "httpMethod": "PATCH",
2121+ "description": "Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request. This method supports patch semantics.",
35112122 "parameters": {
3512− "orderId": {
2123+ "accountId": {
35132124 "type": "string",
3514− "description": "The orderId to edit deals on.",
2125+ "description": "The account id associated with the budget being updated.",
35152126 "required": true,
2127+ "format": "int64",
35162128 "location": "path"
3517− }
3518− },
3519− "parameterOrder": [
3520− "orderId"
3521− ],
3522− "request": {
3523− "$ref": "EditAllOrderDealsRequest"
3524− },
3525− "response": {
3526− "$ref": "EditAllOrderDealsResponse"
3527− },
3528− "scopes": [
3529− "https://www.googleapis.com/auth/adexchange.buyer"
3530− ]
3531− }
3532− }
3533− },
3534− "marketplacenotes": {
3535− "methods": {
3536− "insert": {
3537− "id": "adexchangebuyer.marketplacenotes.insert",
3538− "path": "marketplaceOrders/{orderId}/notes/insert",
3539− "httpMethod": "POST",
3540− "description": "Add notes to the order",
3541− "parameters": {
3542− "orderId": {
2129+ },
2130+ "billingId": {
35432131 "type": "string",
3544− "description": "The orderId to add notes for.",
2132+ "description": "The billing id associated with the budget being updated.",
35452133 "required": true,
2134+ "format": "int64",
35462135 "location": "path"
35472136 }
35482137 },
35492138 "parameterOrder": [
3550− "orderId"
2139+ "accountId",
2140+ "billingId"
35512141 ],
35522142 "request": {
3553− "$ref": "AddOrderNotesRequest"
2143+ "$ref": "Budget"
35542144 },
35552145 "response": {
3556− "$ref": "AddOrderNotesResponse"
2146+ "$ref": "Budget"
35572147 },
35582148 "scopes": [
35592149 "https://www.googleapis.com/auth/adexchange.buyer"
35602150 ]
35612151 },
3562− "list": {
3563− "id": "adexchangebuyer.marketplacenotes.list",
3564− "path": "marketplaceOrders/{orderId}/notes",
3565− "httpMethod": "GET",
3566− "description": "Get all the notes associated with an order",
2152+ "update": {
2153+ "id": "adexchangebuyer.budget.update",
2154+ "path": "billinginfo/{accountId}/{billingId}",
2155+ "httpMethod": "PUT",
2156+ "description": "Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request.",
35672157 "parameters": {
3568− "orderId": {
2158+ "accountId": {
2159+ "type": "string",
2160+ "description": "The account id associated with the budget being updated.",
2161+ "required": true,
2162+ "format": "int64",
2163+ "location": "path"
2164+ },
2165+ "billingId": {
35692166 "type": "string",
3570− "description": "The orderId to get notes for.",
2167+ "description": "The billing id associated with the budget being updated.",
35712168 "required": true,
2169+ "format": "int64",
35722170 "location": "path"
35732171 }
35742172 },
35752173 "parameterOrder": [
3576− "orderId"
2174+ "accountId",
2175+ "billingId"
35772176 ],
2177+ "request": {
2178+ "$ref": "Budget"
2179+ },
35782180 "response": {
3579− "$ref": "GetOrderNotesResponse"
2181+ "$ref": "Budget"
35802182 },
35812183 "scopes": [
35822184 "https://www.googleapis.com/auth/adexchange.buyer"
@@ -3584,306 +2186,300 @@
35842186 }
35852187 }
35862188 },
3587− "marketplaceoffers": {
2189+ "creatives": {
35882190 "methods": {
3589− "get": {
3590− "id": "adexchangebuyer.marketplaceoffers.get",
3591− "path": "marketplaceOffers/{offerId}",
3592− "httpMethod": "GET",
3593− "description": "Gets the requested negotiation.",
2191+ "addDeal": {
2192+ "id": "adexchangebuyer.creatives.addDeal",
2193+ "path": "creatives/{accountId}/{buyerCreativeId}/addDeal/{dealId}",
2194+ "httpMethod": "POST",
2195+ "description": "Add a deal id association for the creative.",
35942196 "parameters": {
3595− "offerId": {
2197+ "accountId": {
2198+ "type": "integer",
2199+ "description": "The id for the account that will serve this creative.",
2200+ "required": true,
2201+ "format": "int32",
2202+ "location": "path"
2203+ },
2204+ "buyerCreativeId": {
2205+ "type": "string",
2206+ "description": "The buyer-specific id for this creative.",
2207+ "required": true,
2208+ "location": "path"
2209+ },
2210+ "dealId": {
35962211 "type": "string",
3597− "description": "The offerId for the offer to get the head revision for.",
2212+ "description": "The id of the deal id to associate with this creative.",
35982213 "required": true,
2214+ "format": "int64",
35992215 "location": "path"
36002216 }
36012217 },
36022218 "parameterOrder": [
3603− "offerId"
2219+ "accountId",
2220+ "buyerCreativeId",
2221+ "dealId"
36042222 ],
3605− "response": {
3606− "$ref": "MarketplaceOffer"
3607− },
36082223 "scopes": [
36092224 "https://www.googleapis.com/auth/adexchange.buyer"
36102225 ]
36112226 },
3612− "search": {
3613− "id": "adexchangebuyer.marketplaceoffers.search",
3614− "path": "marketplaceOffers/search",
3615− "httpMethod": "GET",
3616− "description": "Gets the requested negotiation.",
3617− "parameters": {
3618− "pqlQuery": {
3619− "type": "string",
3620− "description": "The pql query used to query for offers.",
3621− "location": "query"
3622− }
3623− },
3624− "response": {
3625− "$ref": "GetOffersResponse"
3626− },
3627− "scopes": [
3628− "https://www.googleapis.com/auth/adexchange.buyer"
3629− ]
3630− }
3631− }
3632− },
3633− "marketplaceorders": {
3634− "methods": {
36352227 "get": {
3636− "id": "adexchangebuyer.marketplaceorders.get",
3637− "path": "marketplaceOrders/{orderId}",
2228+ "id": "adexchangebuyer.creatives.get",
2229+ "path": "creatives/{accountId}/{buyerCreativeId}",
36382230 "httpMethod": "GET",
3639− "description": "Get an order given its id",
2231+ "description": "Gets the status for a single creative. A creative will be available 30-40 minutes after submission.",
36402232 "parameters": {
3641− "orderId": {
2233+ "accountId": {
2234+ "type": "integer",
2235+ "description": "The id for the account that will serve this creative.",
2236+ "required": true,
2237+ "format": "int32",
2238+ "location": "path"
2239+ },
2240+ "buyerCreativeId": {
36422241 "type": "string",
3643− "description": "Id of the order to retrieve.",
2242+ "description": "The buyer-specific id for this creative.",
36442243 "required": true,
36452244 "location": "path"
36462245 }
36472246 },
36482247 "parameterOrder": [
3649− "orderId"
2248+ "accountId",
2249+ "buyerCreativeId"
36502250 ],
36512251 "response": {
3652− "$ref": "MarketplaceOrder"
2252+ "$ref": "Creative"
36532253 },
36542254 "scopes": [
36552255 "https://www.googleapis.com/auth/adexchange.buyer"
36562256 ]
36572257 },
36582258 "insert": {
3659− "id": "adexchangebuyer.marketplaceorders.insert",
3660− "path": "marketplaceOrders/insert",
2259+ "id": "adexchangebuyer.creatives.insert",
2260+ "path": "creatives",
36612261 "httpMethod": "POST",
3662− "description": "Create the given list of orders",
2262+ "description": "Submit a new creative.",
36632263 "request": {
3664− "$ref": "CreateOrdersRequest"
2264+ "$ref": "Creative"
36652265 },
36662266 "response": {
3667− "$ref": "CreateOrdersResponse"
2267+ "$ref": "Creative"
36682268 },
36692269 "scopes": [
36702270 "https://www.googleapis.com/auth/adexchange.buyer"
36712271 ]
36722272 },
3673− "patch": {
3674− "id": "adexchangebuyer.marketplaceorders.patch",
3675− "path": "marketplaceOrders/{orderId}/{revisionNumber}/{updateAction}",
3676− "httpMethod": "PATCH",
3677− "description": "Update the given order. This method supports patch semantics.",
2273+ "list": {
2274+ "id": "adexchangebuyer.creatives.list",
2275+ "path": "creatives",
2276+ "httpMethod": "GET",
2277+ "description": "Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.",
36782278 "parameters": {
3679− "orderId": {
2279+ "accountId": {
2280+ "type": "integer",
2281+ "description": "When specified, only creatives for the given account ids are returned.",
2282+ "format": "int32",
2283+ "repeated": true,
2284+ "location": "query"
2285+ },
2286+ "buyerCreativeId": {
36802287 "type": "string",
3681− "description": "The order id to update.",
3682− "required": true,
3683− "location": "path"
2288+ "description": "When specified, only creatives for the given buyer creative ids are returned.",
2289+ "repeated": true,
2290+ "location": "query"
36842291 },
3685− "revisionNumber": {
2292+ "dealsStatusFilter": {
36862293 "type": "string",
3687− "description": "The last known revision number to update. If the head revision in the marketplace database has since changed, an error will be thrown. The caller should then fetch the lastest order at head revision and retry the update at that revision.",
3688− "required": true,
3689− "format": "int64",
3690− "location": "path"
2294+ "description": "When specified, only creatives having the given deals status are returned.",
2295+ "enum": [
2296+ "approved",
2297+ "conditionally_approved",
2298+ "disapproved",
2299+ "not_checked"
2300+ ],
2301+ "enumDescriptions": [
2302+ "Creatives which have been approved for serving on deals.",
2303+ "Creatives which have been conditionally approved for serving on deals.",
2304+ "Creatives which have been disapproved for serving on deals.",
2305+ "Creatives whose deals status is not yet checked."
2306+ ],
2307+ "location": "query"
36912308 },
3692− "updateAction": {
2309+ "maxResults": {
2310+ "type": "integer",
2311+ "description": "Maximum number of entries returned on one result page. If not set, the default is 100. Optional.",
2312+ "format": "uint32",
2313+ "minimum": "1",
2314+ "maximum": "1000",
2315+ "location": "query"
2316+ },
2317+ "openAuctionStatusFilter": {
36932318 "type": "string",
3694− "description": "The proposed action to take on the order.",
3695− "required": true,
2319+ "description": "When specified, only creatives having the given open auction status are returned.",
36962320 "enum": [
3697− "accept",
3698− "cancel",
3699− "propose",
3700− "unknownAction",
3701− "updateFinalized"
2321+ "approved",
2322+ "conditionally_approved",
2323+ "disapproved",
2324+ "not_checked"
37022325 ],
37032326 "enumDescriptions": [
3704− "",
3705− "",
3706− "",
3707− "",
3708− ""
2327+ "Creatives which have been approved for serving on the open auction.",
2328+ "Creatives which have been conditionally approved for serving on the open auction.",
2329+ "Creatives which have been disapproved for serving on the open auction.",
2330+ "Creatives whose open auction status is not yet checked."
37092331 ],
3710− "location": "path"
3711− }
3712− },
3713− "parameterOrder": [
3714− "orderId",
3715− "revisionNumber",
3716− "updateAction"
3717− ],
3718− "request": {
3719− "$ref": "MarketplaceOrder"
3720− },
3721− "response": {
3722− "$ref": "MarketplaceOrder"
3723− },
3724− "scopes": [
3725− "https://www.googleapis.com/auth/adexchange.buyer"
3726− ]
3727− },
3728− "search": {
3729− "id": "adexchangebuyer.marketplaceorders.search",
3730− "path": "marketplaceOrders/search",
3731− "httpMethod": "GET",
3732− "description": "Search for orders using pql query",
3733− "parameters": {
3734− "pqlQuery": {
2332+ "location": "query"
2333+ },
2334+ "pageToken": {
37352335 "type": "string",
3736− "description": "Query string to retrieve specific orders.",
2336+ "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.",
37372337 "location": "query"
37382338 }
37392339 },
37402340 "response": {
3741− "$ref": "GetOrdersResponse"
2341+ "$ref": "CreativesList"
37422342 },
37432343 "scopes": [
37442344 "https://www.googleapis.com/auth/adexchange.buyer"
37452345 ]
37462346 },
3747− "update": {
3748− "id": "adexchangebuyer.marketplaceorders.update",
3749− "path": "marketplaceOrders/{orderId}/{revisionNumber}/{updateAction}",
3750− "httpMethod": "PUT",
3751− "description": "Update the given order",
2347+ "removeDeal": {
2348+ "id": "adexchangebuyer.creatives.removeDeal",
2349+ "path": "creatives/{accountId}/{buyerCreativeId}/removeDeal/{dealId}",
2350+ "httpMethod": "POST",
2351+ "description": "Remove a deal id associated with the creative.",
37522352 "parameters": {
3753− "orderId": {
3754− "type": "string",
3755− "description": "The order id to update.",
2353+ "accountId": {
2354+ "type": "integer",
2355+ "description": "The id for the account that will serve this creative.",
37562356 "required": true,
2357+ "format": "int32",
37572358 "location": "path"
37582359 },
3759− "revisionNumber": {
2360+ "buyerCreativeId": {
37602361 "type": "string",
3761− "description": "The last known revision number to update. If the head revision in the marketplace database has since changed, an error will be thrown. The caller should then fetch the lastest order at head revision and retry the update at that revision.",
2362+ "description": "The buyer-specific id for this creative.",
37622363 "required": true,
3763− "format": "int64",
37642364 "location": "path"
37652365 },
3766− "updateAction": {
2366+ "dealId": {
37672367 "type": "string",
3768− "description": "The proposed action to take on the order.",
3769− "required": true,
3770− "enum": [
3771− "accept",
3772− "cancel",
3773− "propose",
3774− "unknownAction",
3775− "updateFinalized"
3776− ],
3777− "enumDescriptions": [
3778− "",
3779− "",
3780− "",
3781− "",
3782− ""
3783− ],
2368+ "description": "The id of the deal id to disassociate with this creative.",
2369+ "required": true,
2370+ "format": "int64",
37842371 "location": "path"
37852372 }
37862373 },
37872374 "parameterOrder": [
3788− "orderId",
3789− "revisionNumber",
3790− "updateAction"
2375+ "accountId",
2376+ "buyerCreativeId",
2377+ "dealId"
37912378 ],
3792− "request": {
3793− "$ref": "MarketplaceOrder"
3794− },
3795− "response": {
3796− "$ref": "MarketplaceOrder"
3797− },
37982379 "scopes": [
37992380 "https://www.googleapis.com/auth/adexchange.buyer"
38002381 ]
38012382 }
38022383 }
38032384 },
3804− "negotiationrounds": {
2385+ "marketplacedeals": {
38052386 "methods": {
3806− "insert": {
3807− "id": "adexchangebuyer.negotiationrounds.insert",
3808− "path": "negotiations/{negotiationId}/negotiationrounds",
2387+ "delete": {
2388+ "id": "adexchangebuyer.marketplacedeals.delete",
2389+ "path": "proposals/{proposalId}/deals/delete",
38092390 "httpMethod": "POST",
3810− "description": "Adds the requested negotiationRound to the requested negotiation.",
2391+ "description": "Delete the specified deals from the proposal",
38112392 "parameters": {
3812− "negotiationId": {
2393+ "proposalId": {
38132394 "type": "string",
2395+ "description": "The proposalId to delete deals from.",
38142396 "required": true,
3815− "format": "int64",
38162397 "location": "path"
38172398 }
38182399 },
38192400 "parameterOrder": [
3820− "negotiationId"
2401+ "proposalId"
38212402 ],
38222403 "request": {
3823− "$ref": "NegotiationRoundDto"
2404+ "$ref": "DeleteOrderDealsRequest"
38242405 },
38252406 "response": {
3826− "$ref": "NegotiationRoundDto"
2407+ "$ref": "DeleteOrderDealsResponse"
38272408 },
38282409 "scopes": [
38292410 "https://www.googleapis.com/auth/adexchange.buyer"
38302411 ]
3831− }
3832− }
3833− },
3834− "negotiations": {
3835− "methods": {
3836− "get": {
3837− "id": "adexchangebuyer.negotiations.get",
3838− "path": "negotiations/{negotiationId}",
3839− "httpMethod": "GET",
3840− "description": "Gets the requested negotiation.",
2412+ },
2413+ "insert": {
2414+ "id": "adexchangebuyer.marketplacedeals.insert",
2415+ "path": "proposals/{proposalId}/deals/insert",
2416+ "httpMethod": "POST",
2417+ "description": "Add new deals for the specified proposal",
38412418 "parameters": {
3842− "negotiationId": {
2419+ "proposalId": {
38432420 "type": "string",
2421+ "description": "proposalId for which deals need to be added.",
38442422 "required": true,
3845− "format": "int64",
38462423 "location": "path"
38472424 }
38482425 },
38492426 "parameterOrder": [
3850− "negotiationId"
2427+ "proposalId"
38512428 ],
38522429 "request": {
3853− "$ref": "GetNegotiationByIdRequest"
2430+ "$ref": "AddOrderDealsRequest"
38542431 },
38552432 "response": {
3856− "$ref": "NegotiationDto"
2433+ "$ref": "AddOrderDealsResponse"
38572434 },
38582435 "scopes": [
38592436 "https://www.googleapis.com/auth/adexchange.buyer"
38602437 ]
38612438 },
3862− "insert": {
3863− "id": "adexchangebuyer.negotiations.insert",
3864− "path": "negotiations",
3865− "httpMethod": "POST",
3866− "description": "Creates or updates the requested negotiation.",
3867− "request": {
3868− "$ref": "NegotiationDto"
2439+ "list": {
2440+ "id": "adexchangebuyer.marketplacedeals.list",
2441+ "path": "proposals/{proposalId}/deals",
2442+ "httpMethod": "GET",
2443+ "description": "List all the deals for a given proposal",
2444+ "parameters": {
2445+ "proposalId": {
2446+ "type": "string",
2447+ "description": "The proposalId to get deals for.",
2448+ "required": true,
2449+ "location": "path"
2450+ }
38692451 },
2452+ "parameterOrder": [
2453+ "proposalId"
2454+ ],
38702455 "response": {
3871− "$ref": "NegotiationDto"
2456+ "$ref": "GetOrderDealsResponse"
38722457 },
38732458 "scopes": [
38742459 "https://www.googleapis.com/auth/adexchange.buyer"
38752460 ]
38762461 },
3877− "list": {
3878− "id": "adexchangebuyer.negotiations.list",
3879− "path": "negotiations",
3880− "httpMethod": "GET",
3881− "description": "Lists all negotiations the authenticated user has access to.",
2462+ "update": {
2463+ "id": "adexchangebuyer.marketplacedeals.update",
2464+ "path": "proposals/{proposalId}/deals/update",
2465+ "httpMethod": "POST",
2466+ "description": "Replaces all the deals in the proposal with the passed in deals",
2467+ "parameters": {
2468+ "proposalId": {
2469+ "type": "string",
2470+ "description": "The proposalId to edit deals on.",
2471+ "required": true,
2472+ "location": "path"
2473+ }
2474+ },
2475+ "parameterOrder": [
2476+ "proposalId"
2477+ ],
38822478 "request": {
3883− "$ref": "GetNegotiationsRequest"
2479+ "$ref": "EditAllOrderDealsRequest"
38842480 },
38852481 "response": {
3886− "$ref": "GetNegotiationsResponse"
2482+ "$ref": "EditAllOrderDealsResponse"
38872483 },
38882484 "scopes": [
38892485 "https://www.googleapis.com/auth/adexchange.buyer"
@@ -3891,56 +2487,52 @@
38912487 }
38922488 }
38932489 },
3894− "offers": {
2490+ "marketplacenotes": {
38952491 "methods": {
3896− "get": {
3897− "id": "adexchangebuyer.offers.get",
3898− "path": "offers/{offerId}",
3899− "httpMethod": "GET",
3900− "description": "Gets the requested offer.",
2492+ "insert": {
2493+ "id": "adexchangebuyer.marketplacenotes.insert",
2494+ "path": "proposals/{proposalId}/notes/insert",
2495+ "httpMethod": "POST",
2496+ "description": "Add notes to the proposal",
39012497 "parameters": {
3902− "offerId": {
2498+ "proposalId": {
39032499 "type": "string",
2500+ "description": "The proposalId to add notes for.",
39042501 "required": true,
3905− "format": "int64",
39062502 "location": "path"
39072503 }
39082504 },
39092505 "parameterOrder": [
3910− "offerId"
2506+ "proposalId"
39112507 ],
3912− "response": {
3913− "$ref": "OfferDto"
3914− },
3915− "scopes": [
3916− "https://www.googleapis.com/auth/adexchange.buyer"
3917− ]
3918− },
3919− "insert": {
3920− "id": "adexchangebuyer.offers.insert",
3921− "path": "offers",
3922− "httpMethod": "POST",
3923− "description": "Creates or updates the requested offer.",
39242508 "request": {
3925− "$ref": "OfferDto"
2509+ "$ref": "AddOrderNotesRequest"
39262510 },
39272511 "response": {
3928− "$ref": "OfferDto"
2512+ "$ref": "AddOrderNotesResponse"
39292513 },
39302514 "scopes": [
39312515 "https://www.googleapis.com/auth/adexchange.buyer"
39322516 ]
39332517 },
39342518 "list": {
3935− "id": "adexchangebuyer.offers.list",
3936− "path": "offers",
2519+ "id": "adexchangebuyer.marketplacenotes.list",
2520+ "path": "proposals/{proposalId}/notes",
39372521 "httpMethod": "GET",
3938− "description": "Lists all offers the authenticated user has access to.",
3939− "request": {
3940− "$ref": "ListOffersRequest"
2522+ "description": "Get all the notes associated with a proposal",
2523+ "parameters": {
2524+ "proposalId": {
2525+ "type": "string",
2526+ "description": "The proposalId to get notes for.",
2527+ "required": true,
2528+ "location": "path"
2529+ }
39412530 },
2531+ "parameterOrder": [
2532+ "proposalId"
2533+ ],
39422534 "response": {
3943− "$ref": "ListOffersResponse"
2535+ "$ref": "GetOrderNotesResponse"
39442536 },
39452537 "scopes": [
39462538 "https://www.googleapis.com/auth/adexchange.buyer"
@@ -4188,6 +2780,223 @@
41882780 ]
41892781 }
41902782 }
2783+ },
2784+ "products": {
2785+ "methods": {
2786+ "get": {
2787+ "id": "adexchangebuyer.products.get",
2788+ "path": "products/{productId}",
2789+ "httpMethod": "GET",
2790+ "description": "Gets the requested product by id.",
2791+ "parameters": {
2792+ "productId": {
2793+ "type": "string",
2794+ "description": "The id for the product to get the head revision for.",
2795+ "required": true,
2796+ "location": "path"
2797+ }
2798+ },
2799+ "parameterOrder": [
2800+ "productId"
2801+ ],
2802+ "response": {
2803+ "$ref": "Product"
2804+ },
2805+ "scopes": [
2806+ "https://www.googleapis.com/auth/adexchange.buyer"
2807+ ]
2808+ },
2809+ "search": {
2810+ "id": "adexchangebuyer.products.search",
2811+ "path": "products/search",
2812+ "httpMethod": "GET",
2813+ "description": "Gets the requested product.",
2814+ "parameters": {
2815+ "pqlQuery": {
2816+ "type": "string",
2817+ "description": "The pql query used to query for products.",
2818+ "location": "query"
2819+ }
2820+ },
2821+ "response": {
2822+ "$ref": "GetOffersResponse"
2823+ },
2824+ "scopes": [
2825+ "https://www.googleapis.com/auth/adexchange.buyer"
2826+ ]
2827+ }
2828+ }
2829+ },
2830+ "proposals": {
2831+ "methods": {
2832+ "get": {
2833+ "id": "adexchangebuyer.proposals.get",
2834+ "path": "proposals/{proposalId}",
2835+ "httpMethod": "GET",
2836+ "description": "Get a proposal given its id",
2837+ "parameters": {
2838+ "proposalId": {
2839+ "type": "string",
2840+ "description": "Id of the proposal to retrieve.",
2841+ "required": true,
2842+ "location": "path"
2843+ }
2844+ },
2845+ "parameterOrder": [
2846+ "proposalId"
2847+ ],
2848+ "response": {
2849+ "$ref": "Proposal"
2850+ },
2851+ "scopes": [
2852+ "https://www.googleapis.com/auth/adexchange.buyer"
2853+ ]
2854+ },
2855+ "insert": {
2856+ "id": "adexchangebuyer.proposals.insert",
2857+ "path": "proposals/insert",
2858+ "httpMethod": "POST",
2859+ "description": "Create the given list of proposals",
2860+ "request": {
2861+ "$ref": "CreateOrdersRequest"
2862+ },
2863+ "response": {
2864+ "$ref": "CreateOrdersResponse"
2865+ },
2866+ "scopes": [
2867+ "https://www.googleapis.com/auth/adexchange.buyer"
2868+ ]
2869+ },
2870+ "patch": {
2871+ "id": "adexchangebuyer.proposals.patch",
2872+ "path": "proposals/{proposalId}/{revisionNumber}/{updateAction}",
2873+ "httpMethod": "PATCH",
2874+ "description": "Update the given proposal. This method supports patch semantics.",
2875+ "parameters": {
2876+ "proposalId": {
2877+ "type": "string",
2878+ "description": "The proposal id to update.",
2879+ "required": true,
2880+ "location": "path"
2881+ },
2882+ "revisionNumber": {
2883+ "type": "string",
2884+ "description": "The last known revision number to update. If the head revision in the marketplace database has since changed, an error will be thrown. The caller should then fetch the latest proposal at head revision and retry the update at that revision.",
2885+ "required": true,
2886+ "format": "int64",
2887+ "location": "path"
2888+ },
2889+ "updateAction": {
2890+ "type": "string",
2891+ "description": "The proposed action to take on the proposal.",
2892+ "required": true,
2893+ "enum": [
2894+ "accept",
2895+ "cancel",
2896+ "propose",
2897+ "unknownAction",
2898+ "updateFinalized"
2899+ ],
2900+ "enumDescriptions": [
2901+ "",
2902+ "",
2903+ "",
2904+ "",
2905+ ""
2906+ ],
2907+ "location": "path"
2908+ }
2909+ },
2910+ "parameterOrder": [
2911+ "proposalId",
2912+ "revisionNumber",
2913+ "updateAction"
2914+ ],
2915+ "request": {
2916+ "$ref": "Proposal"
2917+ },
2918+ "response": {
2919+ "$ref": "Proposal"
2920+ },
2921+ "scopes": [
2922+ "https://www.googleapis.com/auth/adexchange.buyer"
2923+ ]
2924+ },
2925+ "search": {
2926+ "id": "adexchangebuyer.proposals.search",
2927+ "path": "proposals/search",
2928+ "httpMethod": "GET",
2929+ "description": "Search for proposals using pql query",
2930+ "parameters": {
2931+ "pqlQuery": {
2932+ "type": "string",
2933+ "description": "Query string to retrieve specific proposals.",
2934+ "location": "query"
2935+ }
2936+ },
2937+ "response": {
2938+ "$ref": "GetOrdersResponse"
2939+ },
2940+ "scopes": [
2941+ "https://www.googleapis.com/auth/adexchange.buyer"
2942+ ]
2943+ },
2944+ "update": {
2945+ "id": "adexchangebuyer.proposals.update",
2946+ "path": "proposals/{proposalId}/{revisionNumber}/{updateAction}",
2947+ "httpMethod": "PUT",
2948+ "description": "Update the given proposal",
2949+ "parameters": {
2950+ "proposalId": {
2951+ "type": "string",
2952+ "description": "The proposal id to update.",
2953+ "required": true,
2954+ "location": "path"
2955+ },
2956+ "revisionNumber": {
2957+ "type": "string",
2958+ "description": "The last known revision number to update. If the head revision in the marketplace database has since changed, an error will be thrown. The caller should then fetch the latest proposal at head revision and retry the update at that revision.",
2959+ "required": true,
2960+ "format": "int64",
2961+ "location": "path"
2962+ },
2963+ "updateAction": {
2964+ "type": "string",
2965+ "description": "The proposed action to take on the proposal.",
2966+ "required": true,
2967+ "enum": [
2968+ "accept",
2969+ "cancel",
2970+ "propose",
2971+ "unknownAction",
2972+ "updateFinalized"
2973+ ],
2974+ "enumDescriptions": [
2975+ "",
2976+ "",
2977+ "",
2978+ "",
2979+ ""
2980+ ],
2981+ "location": "path"
2982+ }
2983+ },
2984+ "parameterOrder": [
2985+ "proposalId",
2986+ "revisionNumber",
2987+ "updateAction"
2988+ ],
2989+ "request": {
2990+ "$ref": "Proposal"
2991+ },
2992+ "response": {
2993+ "$ref": "Proposal"
2994+ },
2995+ "scopes": [
2996+ "https://www.googleapis.com/auth/adexchange.buyer"
2997+ ]
2998+ }
2999+ }
41913000 }
41923001 }
41933002}