@@ -1,11 +1,11 @@
2 "kind": "discovery#restDescription",
2 "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/kUzYRmhKcAnpiKF3q0AnOrMQGIA\"",
3+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/IUIpYIH18PV9NykwTxBMEWqSYmE\"",
4 "discoveryVersion": "v1",
4 "discoveryVersion": "v1",
5 "id": "dfareporting:v2.6",
5 "id": "dfareporting:v2.6",
6 "name": "dfareporting",
6 "name": "dfareporting",
7 "version": "v2.6",
7 "version": "v2.6",
8− "revision": "20160803",
8+ "revision": "20161027",
9 "title": "DCM/DFA Reporting And Trafficking API",
9 "title": "DCM/DFA Reporting And Trafficking API",
10 "description": "Manages your DoubleClick Campaign Manager ad campaigns and reports.",
10 "description": "Manages your DoubleClick Campaign Manager ad campaigns and reports.",
11 "ownerDomain": "google.com",
11 "ownerDomain": "google.com",
@@ -120,6 +120,7 @@
120 "ACTIVE_ADS_TIER_300K",
120 "ACTIVE_ADS_TIER_300K",
121 "ACTIVE_ADS_TIER_40K",
121 "ACTIVE_ADS_TIER_40K",
122 "ACTIVE_ADS_TIER_500K",
122 "ACTIVE_ADS_TIER_500K",
123+ "ACTIVE_ADS_TIER_750K",
123 "ACTIVE_ADS_TIER_75K"
124 "ACTIVE_ADS_TIER_75K"
125 "enumDescriptions": [
126 "enumDescriptions": [
@@ -128,6 +129,7 @@
@@ -228,6 +230,7 @@
228 "ACTIVE_ADS_TIER_300K",
230 "ACTIVE_ADS_TIER_300K",
229 "ACTIVE_ADS_TIER_40K",
231 "ACTIVE_ADS_TIER_40K",
230 "ACTIVE_ADS_TIER_500K",
232 "ACTIVE_ADS_TIER_500K",
233+ "ACTIVE_ADS_TIER_750K",
231 "ACTIVE_ADS_TIER_75K"
234 "ACTIVE_ADS_TIER_75K"
233 "enumDescriptions": [
236 "enumDescriptions": [
@@ -236,6 +239,7 @@
@@ -545,7 +549,7 @@
546 "active": {
550 "active": {
547 "type": "boolean",
551 "type": "boolean",
548− "description": "Whether this ad is active."
552+ "description": "Whether this ad is active. When true, archived must be false."
550 "advertiserId": {
554 "advertiserId": {
551 "type": "string",
555 "type": "string",
@@ -558,7 +562,7 @@
559 "archived": {
563 "archived": {
560 "type": "boolean",
564 "type": "boolean",
561− "description": "Whether this ad is archived."
565+ "description": "Whether this ad is archived. When true, active must be false."
563 "audienceSegmentId": {
567 "audienceSegmentId": {
564 "type": "string",
568 "type": "string",
@@ -1682,7 +1686,7 @@
1683 "limitAdTracking": {
1687 "limitAdTracking": {
1684 "type": "boolean",
1688 "type": "boolean",
1685− "description": "Whether the user has Limit Ad Tracking set."
1689+ "description": "Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing."
1687 "mobileDeviceId": {
1691 "mobileDeviceId": {
1688 "type": "string",
1692 "type": "string",
@@ -10260,7 +10264,7 @@
10260 "id": "dfareporting.accountUserProfiles.list",
10264 "id": "dfareporting.accountUserProfiles.list",
10261 "path": "userprofiles/{profileId}/accountUserProfiles",
10265 "path": "userprofiles/{profileId}/accountUserProfiles",
10262 "httpMethod": "GET",
10266 "httpMethod": "GET",
10263− "description": "Retrieves a list of account user profiles, possibly filtered.",
10267+ "description": "Retrieves a list of account user profiles, possibly filtered. This method supports paging.",
10264 "parameters": {
10268 "parameters": {
10265 "active": {
10269 "active": {
10266 "type": "boolean",
10270 "type": "boolean",
@@ -10448,7 +10452,7 @@
10448 "id": "dfareporting.accounts.list",
10452 "id": "dfareporting.accounts.list",
10449 "path": "userprofiles/{profileId}/accounts",
10453 "path": "userprofiles/{profileId}/accounts",
10450 "httpMethod": "GET",
10454 "httpMethod": "GET",
10451− "description": "Retrieves the list of accounts, possibly filtered.",
10455+ "description": "Retrieves the list of accounts, possibly filtered. This method supports paging.",
10452 "parameters": {
10456 "parameters": {
10453 "active": {
10457 "active": {
10454 "type": "boolean",
10458 "type": "boolean",
@@ -10651,7 +10655,7 @@
10651 "id": "dfareporting.ads.list",
10655 "id": "dfareporting.ads.list",
10652 "path": "userprofiles/{profileId}/ads",
10656 "path": "userprofiles/{profileId}/ads",
10653 "httpMethod": "GET",
10657 "httpMethod": "GET",
10654− "description": "Retrieves a list of ads, possibly filtered.",
10658+ "description": "Retrieves a list of ads, possibly filtered. This method supports paging.",
10655 "parameters": {
10659 "parameters": {
10656 "active": {
10660 "active": {
10657 "type": "boolean",
10661 "type": "boolean",
@@ -11065,7 +11069,7 @@
11065 "id": "dfareporting.advertiserGroups.list",
11069 "id": "dfareporting.advertiserGroups.list",
11066 "path": "userprofiles/{profileId}/advertiserGroups",
11070 "path": "userprofiles/{profileId}/advertiserGroups",
11067 "httpMethod": "GET",
11071 "httpMethod": "GET",
11068− "description": "Retrieves a list of advertiser groups, possibly filtered.",
11072+ "description": "Retrieves a list of advertiser groups, possibly filtered. This method supports paging.",
11069 "parameters": {
11073 "parameters": {
11070 "ids": {
11074 "ids": {
11071 "type": "string",
11075 "type": "string",
@@ -11263,7 +11267,7 @@
11263 "id": "dfareporting.advertisers.list",
11267 "id": "dfareporting.advertisers.list",
11264 "path": "userprofiles/{profileId}/advertisers",
11268 "path": "userprofiles/{profileId}/advertisers",
11265 "httpMethod": "GET",
11269 "httpMethod": "GET",
11266− "description": "Retrieves a list of advertisers, possibly filtered.",
11270+ "description": "Retrieves a list of advertisers, possibly filtered. This method supports paging.",
11267 "parameters": {
11271 "parameters": {
11268 "advertiserGroupIds": {
11272 "advertiserGroupIds": {
11269 "type": "string",
11273 "type": "string",
@@ -11508,7 +11512,7 @@
11508 "id": "dfareporting.campaignCreativeAssociations.list",
11512 "id": "dfareporting.campaignCreativeAssociations.list",
11509 "path": "userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations",
11513 "path": "userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations",
11510 "httpMethod": "GET",
11514 "httpMethod": "GET",
11511− "description": "Retrieves the list of creative IDs associated with the specified campaign.",
11515+ "description": "Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.",
11512 "parameters": {
11516 "parameters": {
11513 "campaignId": {
11517 "campaignId": {
11514 "type": "string",
11518 "type": "string",
@@ -11641,7 +11645,7 @@
11641 "id": "dfareporting.campaigns.list",
11645 "id": "dfareporting.campaigns.list",
11642 "path": "userprofiles/{profileId}/campaigns",
11646 "path": "userprofiles/{profileId}/campaigns",
11643 "httpMethod": "GET",
11647 "httpMethod": "GET",
11644− "description": "Retrieves a list of campaigns, possibly filtered.",
11648+ "description": "Retrieves a list of campaigns, possibly filtered. This method supports paging.",
11645 "parameters": {
11649 "parameters": {
11646 "advertiserGroupIds": {
11650 "advertiserGroupIds": {
11647 "type": "string",
11651 "type": "string",
@@ -11855,7 +11859,7 @@
11855 "id": "dfareporting.changeLogs.list",
11859 "id": "dfareporting.changeLogs.list",
11856 "path": "userprofiles/{profileId}/changeLogs",
11860 "path": "userprofiles/{profileId}/changeLogs",
11857 "httpMethod": "GET",
11861 "httpMethod": "GET",
11858− "description": "Retrieves a list of change logs.",
11862+ "description": "Retrieves a list of change logs. This method supports paging.",
11859 "parameters": {
11863 "parameters": {
11860 "action": {
11864 "action": {
11861 "type": "string",
11865 "type": "string",
@@ -11966,6 +11970,7 @@
11966 "OBJECT_REMARKETING_LIST",
11970 "OBJECT_REMARKETING_LIST",
11967 "OBJECT_RICHMEDIA_CREATIVE",
11971 "OBJECT_RICHMEDIA_CREATIVE",
11968 "OBJECT_SD_SITE",
11972 "OBJECT_SD_SITE",
11973+ "OBJECT_SEARCH_LIFT_STUDY",
11969 "OBJECT_SIZE",
11974 "OBJECT_SIZE",
11970 "OBJECT_SUBACCOUNT",
11975 "OBJECT_SUBACCOUNT",
11971 "OBJECT_TARGETING_TEMPLATE",
11976 "OBJECT_TARGETING_TEMPLATE",
@@ -12011,6 +12016,7 @@
12016 "location": "query"
12022 "location": "query"
@@ -12260,7 +12266,7 @@
12260 "id": "dfareporting.contentCategories.list",
12266 "id": "dfareporting.contentCategories.list",
12261 "path": "userprofiles/{profileId}/contentCategories",
12267 "path": "userprofiles/{profileId}/contentCategories",
12262 "httpMethod": "GET",
12268 "httpMethod": "GET",
12263− "description": "Retrieves a list of content categories, possibly filtered.",
12269+ "description": "Retrieves a list of content categories, possibly filtered. This method supports paging.",
12264 "parameters": {
12270 "parameters": {
12265 "ids": {
12271 "ids": {
12266 "type": "string",
12272 "type": "string",
@@ -12658,7 +12664,7 @@
12658 "id": "dfareporting.creativeFieldValues.list",
12664 "id": "dfareporting.creativeFieldValues.list",
12659 "path": "userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues",
12665 "path": "userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues",
12660 "httpMethod": "GET",
12666 "httpMethod": "GET",
12661− "description": "Retrieves a list of creative field values, possibly filtered.",
12667+ "description": "Retrieves a list of creative field values, possibly filtered. This method supports paging.",
12662 "parameters": {
12668 "parameters": {
12663 "creativeFieldId": {
12669 "creativeFieldId": {
12664 "type": "string",
12670 "type": "string",
@@ -12909,7 +12915,7 @@
12909 "id": "dfareporting.creativeFields.list",
12915 "id": "dfareporting.creativeFields.list",
12910 "path": "userprofiles/{profileId}/creativeFields",
12916 "path": "userprofiles/{profileId}/creativeFields",
12911 "httpMethod": "GET",
12917 "httpMethod": "GET",
12912− "description": "Retrieves a list of creative fields, possibly filtered.",
12918+ "description": "Retrieves a list of creative fields, possibly filtered. This method supports paging.",
12913 "parameters": {
12919 "parameters": {
12914 "advertiserIds": {
12920 "advertiserIds": {
12915 "type": "string",
12921 "type": "string",
@@ -13114,7 +13120,7 @@
13114 "id": "dfareporting.creativeGroups.list",
13120 "id": "dfareporting.creativeGroups.list",
13115 "path": "userprofiles/{profileId}/creativeGroups",
13121 "path": "userprofiles/{profileId}/creativeGroups",
13116 "httpMethod": "GET",
13122 "httpMethod": "GET",
13117− "description": "Retrieves a list of creative groups, possibly filtered.",
13123+ "description": "Retrieves a list of creative groups, possibly filtered. This method supports paging.",
13118 "parameters": {
13124 "parameters": {
13119 "advertiserIds": {
13125 "advertiserIds": {
13120 "type": "string",
13126 "type": "string",
@@ -13325,7 +13331,7 @@
13325 "id": "dfareporting.creatives.list",
13331 "id": "dfareporting.creatives.list",
13326 "path": "userprofiles/{profileId}/creatives",
13332 "path": "userprofiles/{profileId}/creatives",
13327 "httpMethod": "GET",
13333 "httpMethod": "GET",
13328− "description": "Retrieves a list of creatives, possibly filtered.",
13334+ "description": "Retrieves a list of creatives, possibly filtered. This method supports paging.",
13329 "parameters": {
13335 "parameters": {
13330 "active": {
13336 "active": {
13331 "type": "boolean",
13337 "type": "boolean",
@@ -13654,7 +13660,7 @@
13654 "id": "dfareporting.directorySiteContacts.list",
13660 "id": "dfareporting.directorySiteContacts.list",
13655 "path": "userprofiles/{profileId}/directorySiteContacts",
13661 "path": "userprofiles/{profileId}/directorySiteContacts",
13656 "httpMethod": "GET",
13662 "httpMethod": "GET",
13657− "description": "Retrieves a list of directory site contacts, possibly filtered.",
13663+ "description": "Retrieves a list of directory site contacts, possibly filtered. This method supports paging.",
13658 "parameters": {
13664 "parameters": {
13659 "directorySiteIds": {
13665 "directorySiteIds": {
13660 "type": "string",
13666 "type": "string",
@@ -13797,7 +13803,7 @@
13797 "id": "dfareporting.directorySites.list",
13803 "id": "dfareporting.directorySites.list",
13798 "path": "userprofiles/{profileId}/directorySites",
13804 "path": "userprofiles/{profileId}/directorySites",
13799 "httpMethod": "GET",
13805 "httpMethod": "GET",
13800− "description": "Retrieves a list of directory sites, possibly filtered.",
13806+ "description": "Retrieves a list of directory sites, possibly filtered. This method supports paging.",
13801 "parameters": {
13807 "parameters": {
13802 "acceptsInStreamVideoPlacements": {
13808 "acceptsInStreamVideoPlacements": {
13803 "type": "boolean",
13809 "type": "boolean",
@@ -14552,7 +14558,7 @@
14552 "id": "dfareporting.floodlightActivities.list",
14558 "id": "dfareporting.floodlightActivities.list",
14553 "path": "userprofiles/{profileId}/floodlightActivities",
14559 "path": "userprofiles/{profileId}/floodlightActivities",
14554 "httpMethod": "GET",
14560 "httpMethod": "GET",
14555− "description": "Retrieves a list of floodlight activities, possibly filtered.",
14561+ "description": "Retrieves a list of floodlight activities, possibly filtered. This method supports paging.",
14556 "parameters": {
14562 "parameters": {
14557 "advertiserId": {
14563 "advertiserId": {
14558 "type": "string",
14564 "type": "string",
@@ -14797,7 +14803,7 @@
14797 "id": "dfareporting.floodlightActivityGroups.list",
14803 "id": "dfareporting.floodlightActivityGroups.list",
14798 "path": "userprofiles/{profileId}/floodlightActivityGroups",
14804 "path": "userprofiles/{profileId}/floodlightActivityGroups",
14799 "httpMethod": "GET",
14805 "httpMethod": "GET",
14800− "description": "Retrieves a list of floodlight activity groups, possibly filtered.",
14806+ "description": "Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.",
14801 "parameters": {
14807 "parameters": {
14802 "advertiserId": {
14808 "advertiserId": {
14803 "type": "string",
14809 "type": "string",
@@ -15130,7 +15136,7 @@
15130 "id": "dfareporting.inventoryItems.list",
15136 "id": "dfareporting.inventoryItems.list",
15131 "path": "userprofiles/{profileId}/projects/{projectId}/inventoryItems",
15137 "path": "userprofiles/{profileId}/projects/{projectId}/inventoryItems",
15132 "httpMethod": "GET",
15138 "httpMethod": "GET",
15133− "description": "Retrieves a list of inventory items, possibly filtered.",
15139+ "description": "Retrieves a list of inventory items, possibly filtered. This method supports paging.",
15134 "parameters": {
15140 "parameters": {
15135 "ids": {
15141 "ids": {
15136 "type": "string",
15142 "type": "string",
@@ -15744,7 +15750,7 @@
15744 "id": "dfareporting.orderDocuments.list",
15750 "id": "dfareporting.orderDocuments.list",
15745 "path": "userprofiles/{profileId}/projects/{projectId}/orderDocuments",
15751 "path": "userprofiles/{profileId}/projects/{projectId}/orderDocuments",
15746 "httpMethod": "GET",
15752 "httpMethod": "GET",
15747− "description": "Retrieves a list of order documents, possibly filtered.",
15753+ "description": "Retrieves a list of order documents, possibly filtered. This method supports paging.",
15748 "parameters": {
15754 "parameters": {
15749 "approved": {
15755 "approved": {
15750 "type": "boolean",
15756 "type": "boolean",
@@ -15888,7 +15894,7 @@
15888 "id": "dfareporting.orders.list",
15894 "id": "dfareporting.orders.list",
15889 "path": "userprofiles/{profileId}/projects/{projectId}/orders",
15895 "path": "userprofiles/{profileId}/projects/{projectId}/orders",
15890 "httpMethod": "GET",
15896 "httpMethod": "GET",
15891− "description": "Retrieves a list of orders, possibly filtered.",
15897+ "description": "Retrieves a list of orders, possibly filtered. This method supports paging.",
15892 "parameters": {
15898 "parameters": {
15893 "ids": {
15899 "ids": {
15894 "type": "string",
15900 "type": "string",
@@ -16039,7 +16045,7 @@
16039 "id": "dfareporting.placementGroups.list",
16045 "id": "dfareporting.placementGroups.list",
16040 "path": "userprofiles/{profileId}/placementGroups",
16046 "path": "userprofiles/{profileId}/placementGroups",
16041 "httpMethod": "GET",
16047 "httpMethod": "GET",
16042− "description": "Retrieves a list of placement groups, possibly filtered.",
16048+ "description": "Retrieves a list of placement groups, possibly filtered. This method supports paging.",
16043 "parameters": {
16049 "parameters": {
16044 "advertiserIds": {
16050 "advertiserIds": {
16045 "type": "string",
16051 "type": "string",
@@ -16368,7 +16374,7 @@
16368 "id": "dfareporting.placementStrategies.list",
16374 "id": "dfareporting.placementStrategies.list",
16369 "path": "userprofiles/{profileId}/placementStrategies",
16375 "path": "userprofiles/{profileId}/placementStrategies",
16370 "httpMethod": "GET",
16376 "httpMethod": "GET",
16371− "description": "Retrieves a list of placement strategies, possibly filtered.",
16377+ "description": "Retrieves a list of placement strategies, possibly filtered. This method supports paging.",
16372 "parameters": {
16378 "parameters": {
16373 "ids": {
16379 "ids": {
16374 "type": "string",
16380 "type": "string",
@@ -16649,7 +16655,7 @@
16649 "id": "dfareporting.placements.list",
16655 "id": "dfareporting.placements.list",
16650 "path": "userprofiles/{profileId}/placements",
16656 "path": "userprofiles/{profileId}/placements",
16651 "httpMethod": "GET",
16657 "httpMethod": "GET",
16652− "description": "Retrieves a list of placements, possibly filtered.",
16658+ "description": "Retrieves a list of placements, possibly filtered. This method supports paging.",
16653 "parameters": {
16659 "parameters": {
16654 "advertiserIds": {
16660 "advertiserIds": {
16655 "type": "string",
16661 "type": "string",
@@ -17075,7 +17081,7 @@
17075 "id": "dfareporting.projects.list",
17081 "id": "dfareporting.projects.list",
17076 "path": "userprofiles/{profileId}/projects",
17082 "path": "userprofiles/{profileId}/projects",
17077 "httpMethod": "GET",
17083 "httpMethod": "GET",
17078− "description": "Retrieves a list of projects, possibly filtered.",
17084+ "description": "Retrieves a list of projects, possibly filtered. This method supports paging.",
17079 "parameters": {
17085 "parameters": {
17080 "advertiserIds": {
17086 "advertiserIds": {
17081 "type": "string",
17087 "type": "string",
@@ -17344,7 +17350,7 @@
17344 "id": "dfareporting.remarketingLists.list",
17350 "id": "dfareporting.remarketingLists.list",
17345 "path": "userprofiles/{profileId}/remarketingLists",
17351 "path": "userprofiles/{profileId}/remarketingLists",
17346 "httpMethod": "GET",
17352 "httpMethod": "GET",
17347− "description": "Retrieves a list of remarketing lists, possibly filtered.",
17353+ "description": "Retrieves a list of remarketing lists, possibly filtered. This method supports paging.",
17348 "parameters": {
17354 "parameters": {
17349 "active": {
17355 "active": {
17350 "type": "boolean",
17356 "type": "boolean",
@@ -17985,7 +17991,7 @@
17985 "id": "dfareporting.sites.list",
17991 "id": "dfareporting.sites.list",
17986 "path": "userprofiles/{profileId}/sites",
17992 "path": "userprofiles/{profileId}/sites",
17987 "httpMethod": "GET",
17993 "httpMethod": "GET",
17988− "description": "Retrieves a list of sites, possibly filtered.",
17994+ "description": "Retrieves a list of sites, possibly filtered. This method supports paging.",
17989 "parameters": {
17995 "parameters": {
17990 "acceptsInStreamVideoPlacements": {
17996 "acceptsInStreamVideoPlacements": {
17991 "type": "boolean",
17997 "type": "boolean",
@@ -18344,7 +18350,7 @@
18344 "id": "dfareporting.subaccounts.list",
18350 "id": "dfareporting.subaccounts.list",
18345 "path": "userprofiles/{profileId}/subaccounts",
18351 "path": "userprofiles/{profileId}/subaccounts",
18346 "httpMethod": "GET",
18352 "httpMethod": "GET",
18347− "description": "Gets a list of subaccounts, possibly filtered.",
18353+ "description": "Gets a list of subaccounts, possibly filtered. This method supports paging.",
18348 "parameters": {
18354 "parameters": {
18349 "ids": {
18355 "ids": {
18350 "type": "string",
18356 "type": "string",
@@ -18515,7 +18521,7 @@
18515 "id": "dfareporting.targetableRemarketingLists.list",
18521 "id": "dfareporting.targetableRemarketingLists.list",
18516 "path": "userprofiles/{profileId}/targetableRemarketingLists",
18522 "path": "userprofiles/{profileId}/targetableRemarketingLists",
18517 "httpMethod": "GET",
18523 "httpMethod": "GET",
18518− "description": "Retrieves a list of targetable remarketing lists, possibly filtered.",
18524+ "description": "Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.",
18519 "parameters": {
18525 "parameters": {
18520 "active": {
18526 "active": {
18521 "type": "boolean",
18527 "type": "boolean",
@@ -18657,7 +18663,7 @@
18657 "id": "dfareporting.targetingTemplates.list",
18663 "id": "dfareporting.targetingTemplates.list",
18658 "path": "userprofiles/{profileId}/targetingTemplates",
18664 "path": "userprofiles/{profileId}/targetingTemplates",
18659 "httpMethod": "GET",
18665 "httpMethod": "GET",
18660− "description": "Retrieves a list of targeting templates, optionally filtered.",
18666+ "description": "Retrieves a list of targeting templates, optionally filtered. This method supports paging.",
18661 "parameters": {
18667 "parameters": {
18662 "advertiserId": {
18668 "advertiserId": {
18663 "type": "string",
18669 "type": "string",
@@ -19059,7 +19065,7 @@
19059 "id": "dfareporting.userRoles.list",
19065 "id": "dfareporting.userRoles.list",
19060 "path": "userprofiles/{profileId}/userRoles",
19066 "path": "userprofiles/{profileId}/userRoles",
19061 "httpMethod": "GET",
19067 "httpMethod": "GET",
19062− "description": "Retrieves a list of user roles, possibly filtered.",
19068+ "description": "Retrieves a list of user roles, possibly filtered. This method supports paging.",
19063 "parameters": {
19069 "parameters": {
19064 "accountUserRoleOnly": {
19070 "accountUserRoleOnly": {
19065 "type": "boolean",
19071 "type": "boolean",