{ "canonicalName": "Dfareporting", "protocol": "rest", "documentationLink": "https://developers.google.com/doubleclick-advertisers/", "description": "Build applications to efficiently manage large or complex trafficking, reporting, and attribution workflows for Campaign Manager 360.", "kind": "discovery#restDescription", "id": "dfareporting:v5", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "ownerName": "Google", "resources": { "placementGroups": { "methods": { "patch": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PATCH", "parameters": { "id": { "location": "query", "required": true, "format": "int64", "description": "Required. Placement ID.", "type": "string" }, "profileId": { "required": true, "pattern": "^[^/]+$", "location": "path", "format": "int64", "description": "User profile ID associated with this request.", "type": "string" } }, "response": { "$ref": "PlacementGroup" }, "parameterOrder": [ "profileId", "id" ], "id": "dfareporting.placementGroups.patch", "flatPath": "userprofiles/{userprofilesId}/placementGroups", "description": "Updates an existing placement group. This method supports patch semantics.", "request": { "$ref": "PlacementGroup" }, "path": "userprofiles/{+profileId}/placementGroups" }, "list": { "response": { "$ref": "PlacementGroupsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "pricingTypes": { "location": "query", "enumDescriptions": [ "", "", "", "", "", "" ], "repeated": true, "description": "Select only placement groups with these pricing types.", "type": "string", "enum": [ "PRICING_TYPE_CPM", "PRICING_TYPE_CPC", "PRICING_TYPE_CPA", "PRICING_TYPE_FLAT_RATE_IMPRESSIONS", "PRICING_TYPE_FLAT_RATE_CLICKS", "PRICING_TYPE_CPM_ACTIVEVIEW" ] }, "contentCategoryIds": { "format": "int64", "repeated": true, "location": "query", "type": "string", "description": "Select only placement groups that are associated with these content categories." }, "placementStrategyIds": { "description": "Select only placement groups that are associated with these placement strategies.", "type": "string", "format": "int64", "repeated": true, "location": "query" }, "maxEndDate": { "description": "Select only placements or placement groups whose end date is on or before the specified maxEndDate. The date should be formatted as \"yyyy-MM-dd\".", "location": "query", "type": "string" }, "minStartDate": { "type": "string", "description": "Select only placements or placement groups whose start date is on or after the specified minStartDate. The date should be formatted as \"yyyy-MM-dd\".", "location": "query" }, "profileId": { "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string", "description": "User profile ID associated with this request.", "required": true }, "placementGroupType": { "type": "string", "enum": [ "PLACEMENT_PACKAGE", "PLACEMENT_ROADBLOCK" ], "enumDescriptions": [ "A simple group of site-placements (tags). Basically acts as a single pricing point for a group of tags.", "A group of site-placements (tags) that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. This kind of group requires one of its assigned site-placements to be marked as primary for reporting purposes." ], "description": "Select only placement groups belonging with this group type. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting.", "location": "query" }, "ids": { "description": "Select only placement groups with these IDs.", "repeated": true, "type": "string", "location": "query", "format": "int64" }, "minEndDate": { "location": "query", "description": "Select only placements or placement groups whose end date is on or after the specified minEndDate. The date should be formatted as \"yyyy-MM-dd\".", "type": "string" }, "campaignIds": { "type": "string", "description": "Select only placement groups that belong to these campaigns.", "format": "int64", "location": "query", "repeated": true }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "directorySiteIds": { "format": "int64", "repeated": true, "location": "query", "description": "Select only placement groups that are associated with these directory sites.", "type": "string" }, "advertiserIds": { "location": "query", "format": "int64", "repeated": true, "description": "Select only placement groups that belong to these advertisers.", "type": "string" }, "siteIds": { "description": "Select only placement groups that are associated with these sites.", "type": "string", "format": "int64", "location": "query", "repeated": true }, "sortOrder": { "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING" }, "activeStatus": { "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "PLACEMENT_STATUS_UNKNOWN", "PLACEMENT_STATUS_ACTIVE", "PLACEMENT_STATUS_INACTIVE", "PLACEMENT_STATUS_ARCHIVED", "PLACEMENT_STATUS_PERMANENTLY_ARCHIVED" ], "location": "query", "repeated": true, "description": "Select only placements with these active statuses." }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for placement groups by name or ID. Wildcards (*) are allowed. For example, \"placement*2015\" will return placement groups with names like \"placement group June 2015\", \"placement group May 2015\", or simply \"placements 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"placementgroup\" will match placement groups with name \"my placementgroup\", \"placementgroup 2015\", or simply \"placementgroup\"." }, "sortField": { "description": "Field by which to sort the list.", "location": "query", "default": "ID", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "ID", "NAME" ] }, "maxResults": { "type": "integer", "description": "Maximum number of results to return.", "location": "query", "format": "int32", "default": "800" }, "maxStartDate": { "type": "string", "description": "Select only placements or placement groups whose start date is on or before the specified maxStartDate. The date should be formatted as \"yyyy-MM-dd\".", "location": "query" } }, "id": "dfareporting.placementGroups.list", "httpMethod": "GET", "path": "userprofiles/{+profileId}/placementGroups", "description": "Retrieves a list of placement groups, possibly filtered. This method supports paging.", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/placementGroups" }, "get": { "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" }, "id": { "description": "Placement group ID.", "type": "string", "format": "int64", "location": "path", "pattern": "^[^/]+$", "required": true } }, "flatPath": "userprofiles/{userprofilesId}/placementGroups/{placementGroupsId}", "httpMethod": "GET", "description": "Gets one placement group by ID.", "path": "userprofiles/{+profileId}/placementGroups/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "PlacementGroup" }, "parameterOrder": [ "profileId", "id" ], "id": "dfareporting.placementGroups.get" }, "update": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/placementGroups", "id": "dfareporting.placementGroups.update", "httpMethod": "PUT", "parameters": { "profileId": { "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "required": true, "format": "int64" } }, "flatPath": "userprofiles/{userprofilesId}/placementGroups", "response": { "$ref": "PlacementGroup" }, "parameterOrder": [ "profileId" ], "description": "Updates an existing placement group.", "request": { "$ref": "PlacementGroup" } }, "insert": { "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "POST", "request": { "$ref": "PlacementGroup" }, "flatPath": "userprofiles/{userprofilesId}/placementGroups", "response": { "$ref": "PlacementGroup" }, "path": "userprofiles/{+profileId}/placementGroups", "id": "dfareporting.placementGroups.insert", "description": "Inserts a new placement group." } } }, "postalCodes": { "methods": { "get": { "description": "Gets one postal code by ID.", "id": "dfareporting.postalCodes.get", "flatPath": "userprofiles/{userprofilesId}/postalCodes/{postalCodesId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "code" ], "parameters": { "profileId": { "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "location": "path", "type": "string" }, "code": { "location": "path", "description": "Postal code ID.", "type": "string", "required": true, "pattern": "^[^/]+$" } }, "path": "userprofiles/{+profileId}/postalCodes/{+code}", "httpMethod": "GET", "response": { "$ref": "PostalCode" } }, "list": { "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "description": "User profile ID associated with this request.", "location": "path", "format": "int64" } }, "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/postalCodes", "httpMethod": "GET", "path": "userprofiles/{+profileId}/postalCodes", "id": "dfareporting.postalCodes.list", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of postal codes.", "response": { "$ref": "PostalCodesListResponse" } } } }, "reportData": { "methods": { "query": { "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "flatPath": "userprofiles/{profileId}/reportdata/query", "parameterOrder": [ "profileId" ], "path": "userprofiles/{profileId}/reportdata/query", "parameters": { "profileId": { "description": "Required. The Campaign Manager 360 user profile ID.", "location": "path", "format": "int64", "type": "string", "required": true } }, "response": { "$ref": "ReportDataResponse" }, "id": "dfareporting.reportData.query", "request": { "$ref": "ReportDataQueryRequest" }, "description": "Executes an ad-hoc query and returns structured JSON payload data.", "httpMethod": "POST" } } }, "creativeFields": { "methods": { "list": { "response": { "$ref": "CreativeFieldsListResponse" }, "path": "userprofiles/{+profileId}/creativeFields", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/creativeFields", "parameters": { "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "searchString": { "location": "query", "type": "string", "description": "Allows searching for creative fields by name or ID. Wildcards (*) are allowed. For example, \"creativefield*2015\" will return creative fields with names like \"creativefield June 2015\", \"creativefield April 2015\", or simply \"creativefield 2015\". Most of the searches also add wild-cards implicitly at the start and the end of the search string. For example, a search string of \"creativefield\" will match creative fields with the name \"my creativefield\", \"creativefield 2015\", or simply \"creativefield\"." }, "profileId": { "description": "User profile ID associated with this request.", "type": "string", "location": "path", "pattern": "^[^/]+$", "required": true, "format": "int64" }, "advertiserIds": { "type": "string", "format": "int64", "description": "Select only creative fields that belong to these advertisers.", "repeated": true, "location": "query" }, "maxResults": { "format": "int32", "description": "Maximum number of results to return.", "location": "query", "type": "integer", "default": "1000" }, "ids": { "format": "int64", "location": "query", "repeated": true, "description": "Select only creative fields with these IDs.", "type": "string" }, "sortOrder": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "ASCENDING", "location": "query", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ] }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "default": "ID", "enumDescriptions": [ "", "" ], "location": "query", "description": "Field by which to sort the list." } }, "description": "Retrieves a list of creative fields, possibly filtered. This method supports paging.", "id": "dfareporting.creativeFields.list", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "update": { "httpMethod": "PUT", "request": { "$ref": "CreativeField" }, "response": { "$ref": "CreativeField" }, "parameters": { "profileId": { "format": "int64", "pattern": "^[^/]+$", "location": "path", "type": "string", "required": true, "description": "User profile ID associated with this request." } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/creativeFields", "description": "Updates an existing creative field.", "parameterOrder": [ "profileId" ], "id": "dfareporting.creativeFields.update", "flatPath": "userprofiles/{userprofilesId}/creativeFields" }, "delete": { "description": "Deletes an existing creative field.", "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/creativeFields/{+id}", "httpMethod": "DELETE", "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}", "id": "dfareporting.creativeFields.delete", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "format": "int64", "location": "path", "required": true, "pattern": "^[^/]+$" }, "id": { "pattern": "^[^/]+$", "description": "Creative Field ID", "type": "string", "location": "path", "required": true, "format": "int64" } } }, "patch": { "id": "dfareporting.creativeFields.patch", "response": { "$ref": "CreativeField" }, "httpMethod": "PATCH", "flatPath": "userprofiles/{userprofilesId}/creativeFields", "request": { "$ref": "CreativeField" }, "parameterOrder": [ "profileId", "id" ], "parameters": { "id": { "location": "query", "description": "CreativeField ID.", "required": true, "type": "string", "format": "int64" }, "profileId": { "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "location": "path", "type": "string" } }, "description": "Updates an existing creative field. This method supports patch semantics.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/creativeFields" }, "get": { "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "type": "string", "location": "path", "format": "int64" }, "id": { "location": "path", "type": "string", "required": true, "format": "int64", "description": "Creative Field ID", "pattern": "^[^/]+$" } }, "httpMethod": "GET", "path": "userprofiles/{+profileId}/creativeFields/{+id}", "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}", "response": { "$ref": "CreativeField" }, "id": "dfareporting.creativeFields.get", "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one creative field by ID." }, "insert": { "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request.", "location": "path", "format": "int64", "required": true } }, "flatPath": "userprofiles/{userprofilesId}/creativeFields", "id": "dfareporting.creativeFields.insert", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Inserts a new creative field.", "request": { "$ref": "CreativeField" }, "path": "userprofiles/{+profileId}/creativeFields", "parameterOrder": [ "profileId" ], "response": { "$ref": "CreativeField" } } } }, "floodlightActivityGroups": { "methods": { "insert": { "description": "Inserts a new floodlight activity group.", "flatPath": "userprofiles/{userprofilesId}/floodlightActivityGroups", "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/floodlightActivityGroups", "id": "dfareporting.floodlightActivityGroups.insert", "httpMethod": "POST", "parameters": { "profileId": { "format": "int64", "required": true, "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string" } }, "request": { "$ref": "FloodlightActivityGroup" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "FloodlightActivityGroup" } }, "list": { "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "FloodlightActivityGroupsListResponse" }, "flatPath": "userprofiles/{userprofilesId}/floodlightActivityGroups", "description": "Retrieves a list of floodlight activity groups, possibly filtered. This method supports paging.", "id": "dfareporting.floodlightActivityGroups.list", "httpMethod": "GET", "parameters": { "ids": { "location": "query", "repeated": true, "type": "string", "description": "Select only floodlight activity groups with the specified IDs. Must specify either advertiserId or floodlightConfigurationId for a non-empty result.", "format": "int64" }, "maxResults": { "type": "integer", "location": "query", "format": "int32", "default": "1000", "description": "Maximum number of results to return." }, "profileId": { "type": "string", "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "location": "path", "format": "int64" }, "floodlightConfigurationId": { "location": "query", "description": "Select only floodlight activity groups with the specified floodlight configuration ID. Must specify either advertiserId, or floodlightConfigurationId for a non-empty result.", "type": "string", "format": "int64" }, "advertiserId": { "location": "query", "format": "int64", "type": "string", "description": "Select only floodlight activity groups with the specified advertiser ID. Must specify either advertiserId or floodlightConfigurationId for a non-empty result." }, "sortField": { "enumDescriptions": [ "", "" ], "default": "ID", "location": "query", "type": "string", "enum": [ "ID", "NAME" ], "description": "Field by which to sort the list." }, "type": { "location": "query", "type": "string", "enum": [ "COUNTER", "SALE" ], "enumDescriptions": [ "", "" ], "description": "Select only floodlight activity groups with the specified floodlight activity group type." }, "searchString": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"floodlightactivitygroup*2015\" will return objects with names like \"floodlightactivitygroup June 2015\", \"floodlightactivitygroup April 2015\", or simply \"floodlightactivitygroup 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"floodlightactivitygroup\" will match objects with name \"my floodlightactivitygroup activity\", \"floodlightactivitygroup 2015\", or simply \"floodlightactivitygroup\".", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "Value of the nextPageToken from the previous result page.", "type": "string" }, "sortOrder": { "location": "query", "description": "Order of sorted results.", "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ] } }, "path": "userprofiles/{+profileId}/floodlightActivityGroups" }, "get": { "parameters": { "id": { "format": "int64", "pattern": "^[^/]+$", "location": "path", "type": "string", "required": true, "description": "Floodlight activity Group ID." }, "profileId": { "required": true, "format": "int64", "location": "path", "type": "string", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } }, "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivityGroups/{floodlightActivityGroupsId}", "httpMethod": "GET", "path": "userprofiles/{+profileId}/floodlightActivityGroups/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one floodlight activity group by ID.", "id": "dfareporting.floodlightActivityGroups.get", "response": { "$ref": "FloodlightActivityGroup" } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "FloodlightActivityGroup" }, "description": "Updates an existing floodlight activity group. This method supports patch semantics.", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivityGroups", "id": "dfareporting.floodlightActivityGroups.patch", "request": { "$ref": "FloodlightActivityGroup" }, "path": "userprofiles/{+profileId}/floodlightActivityGroups", "parameters": { "id": { "type": "string", "description": "Required. EventTag ID.", "format": "int64", "required": true, "location": "query" }, "profileId": { "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "format": "int64", "required": true, "location": "path" } }, "httpMethod": "PATCH" }, "update": { "request": { "$ref": "FloodlightActivityGroup" }, "description": "Updates an existing floodlight activity group.", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivityGroups", "path": "userprofiles/{+profileId}/floodlightActivityGroups", "response": { "$ref": "FloodlightActivityGroup" }, "parameters": { "profileId": { "required": true, "location": "path", "format": "int64", "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request." } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PUT", "id": "dfareporting.floodlightActivityGroups.update" } } }, "ads": { "methods": { "get": { "id": "dfareporting.ads.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "Ad" }, "parameters": { "profileId": { "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "id": { "location": "path", "required": true, "format": "int64", "description": "Ad ID.", "pattern": "^[^/]+$", "type": "string" } }, "path": "userprofiles/{+profileId}/ads/{+id}", "description": "Gets one ad by ID.", "flatPath": "userprofiles/{userprofilesId}/ads/{adsId}", "httpMethod": "GET", "parameterOrder": [ "profileId", "id" ] }, "update": { "id": "dfareporting.ads.update", "path": "userprofiles/{+profileId}/ads", "flatPath": "userprofiles/{userprofilesId}/ads", "request": { "$ref": "Ad" }, "parameterOrder": [ "profileId" ], "response": { "$ref": "Ad" }, "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "location": "path", "format": "int64", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PUT", "description": "Updates an existing ad." }, "list": { "description": "Retrieves a list of ads, possibly filtered. This method supports paging.", "parameters": { "archived": { "description": "Select only archived ads.", "type": "boolean", "location": "query" }, "active": { "description": "Select only active ads.", "location": "query", "type": "boolean" }, "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "type": "string", "location": "path", "required": true, "pattern": "^[^/]+$" }, "sslCompliant": { "type": "boolean", "description": "Select only ads that are SSL-compliant.", "location": "query" }, "campaignIds": { "location": "query", "repeated": true, "type": "string", "description": "Select only ads with these campaign IDs.", "format": "int64" }, "dynamicClickTracker": { "description": "Select only dynamic click trackers. Applicable when type is AD_SERVING_CLICK_TRACKER. If true, select dynamic click trackers. If false, select static click trackers. Leave unset to select both.", "type": "boolean", "location": "query" }, "remarketingListIds": { "format": "int64", "description": "Select only ads whose list targeting expression use these remarketing list IDs.", "location": "query", "type": "string", "repeated": true }, "placementIds": { "format": "int64", "type": "string", "repeated": true, "description": "Select only ads with these placement IDs assigned.", "location": "query" }, "sslRequired": { "location": "query", "type": "boolean", "description": "Select only ads that require SSL." }, "advertiserId": { "description": "Select only ads with this advertiser ID.", "type": "string", "format": "int64", "location": "query" }, "maxResults": { "location": "query", "type": "integer", "default": "1000", "description": "Maximum number of results to return.", "format": "int32" }, "overriddenEventTagId": { "type": "string", "format": "int64", "location": "query", "description": "Select only ads with this event tag override ID." }, "searchString": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"ad*2015\" will return objects with names like \"ad June 2015\", \"ad April 2015\", or simply \"ad 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"ad\" will match objects with name \"my ad\", \"ad 2015\", or simply \"ad\".", "type": "string", "location": "query" }, "audienceSegmentIds": { "location": "query", "repeated": true, "type": "string", "description": "Select only ads with these audience segment IDs.", "format": "int64" }, "compatibility": { "description": "Select default ads with the specified compatibility. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering an in-stream video ads developed with the VAST standard.", "enumDescriptions": [ "", "", "Deprecated enum value. No longer supported.", "Deprecated enum value. No longer supported.", "", "" ], "type": "string", "enum": [ "DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO" ], "location": "query" }, "type": { "type": "string", "enum": [ "AD_SERVING_STANDARD_AD", "AD_SERVING_DEFAULT_AD", "AD_SERVING_CLICK_TRACKER", "AD_SERVING_TRACKING", "AD_SERVING_BRAND_SAFE_AD" ], "description": "Select only ads with these types.", "location": "query", "repeated": true, "enumDescriptions": [ "", "", "", "", "" ] }, "sortField": { "default": "ID", "description": "Field by which to sort the list.", "location": "query", "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ] }, "landingPageIds": { "type": "string", "description": "Select only ads with these landing page IDs.", "format": "int64", "repeated": true, "location": "query" }, "ids": { "format": "int64", "repeated": true, "description": "Select only ads with these IDs.", "location": "query", "type": "string" }, "creativeOptimizationConfigurationIds": { "format": "int64", "type": "string", "repeated": true, "location": "query", "description": "Select only ads with these creative optimization configuration IDs." }, "sortOrder": { "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "default": "ASCENDING" }, "creativeIds": { "repeated": true, "location": "query", "type": "string", "format": "int64", "description": "Select only ads with these creative IDs assigned." }, "sizeIds": { "description": "Select only ads with these size IDs.", "location": "query", "format": "int64", "repeated": true, "type": "string" }, "pageToken": { "location": "query", "description": "Value of the nextPageToken from the previous result page.", "type": "string" } }, "flatPath": "userprofiles/{userprofilesId}/ads", "httpMethod": "GET", "path": "userprofiles/{+profileId}/ads", "id": "dfareporting.ads.list", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "AdsListResponse" }, "parameterOrder": [ "profileId" ] }, "patch": { "response": { "$ref": "Ad" }, "path": "userprofiles/{+profileId}/ads", "parameters": { "id": { "type": "string", "description": "Required. RemarketingList ID.", "required": true, "location": "query", "format": "int64" }, "profileId": { "pattern": "^[^/]+$", "format": "int64", "type": "string", "description": "User profile ID associated with this request.", "required": true, "location": "path" } }, "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ], "description": "Updates an existing ad. This method supports patch semantics.", "id": "dfareporting.ads.patch", "request": { "$ref": "Ad" }, "flatPath": "userprofiles/{userprofilesId}/ads" }, "insert": { "response": { "$ref": "Ad" }, "request": { "$ref": "Ad" }, "description": "Inserts a new ad.", "path": "userprofiles/{+profileId}/ads", "id": "dfareporting.ads.insert", "parameterOrder": [ "profileId" ], "httpMethod": "POST", "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64", "required": true, "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/ads" } } }, "targetableRemarketingLists": { "methods": { "get": { "flatPath": "userprofiles/{userprofilesId}/targetableRemarketingLists/{targetableRemarketingListsId}", "description": "Gets one remarketing list by ID.", "id": "dfareporting.targetableRemarketingLists.get", "httpMethod": "GET", "parameters": { "profileId": { "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request.", "required": true, "pattern": "^[^/]+$" }, "id": { "pattern": "^[^/]+$", "description": "Remarketing list ID.", "type": "string", "required": true, "location": "path", "format": "int64" } }, "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/targetableRemarketingLists/{+id}", "response": { "$ref": "TargetableRemarketingList" } }, "list": { "parameters": { "name": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"remarketing list*2015\" will return objects with names like \"remarketing list June 2015\", \"remarketing list April 2015\", or simply \"remarketing list 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"remarketing list\" will match objects with name \"my remarketing list\", \"remarketing list 2015\", or simply \"remarketing list\".", "type": "string", "location": "query" }, "maxResults": { "format": "int32", "location": "query", "type": "integer", "default": "1000", "description": "Maximum number of results to return." }, "active": { "type": "boolean", "location": "query", "description": "Select only active or only inactive targetable remarketing lists." }, "sortOrder": { "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ] }, "sortField": { "description": "Field by which to sort the list.", "location": "query", "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ], "default": "ID" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "advertiserId": { "type": "string", "description": "Required. Select only targetable remarketing lists targetable by these advertisers.", "format": "int64", "location": "query", "required": true }, "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "type": "string", "location": "path", "format": "int64" } }, "flatPath": "userprofiles/{userprofilesId}/targetableRemarketingLists", "parameterOrder": [ "profileId", "advertiserId" ], "httpMethod": "GET", "path": "userprofiles/{+profileId}/targetableRemarketingLists", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of targetable remarketing lists, possibly filtered. This method supports paging.", "id": "dfareporting.targetableRemarketingLists.list", "response": { "$ref": "TargetableRemarketingListsListResponse" } } } }, "advertiserInvoices": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/advertisers/{+advertiserId}/invoices", "response": { "$ref": "AdvertiserInvoicesListResponse" }, "id": "dfareporting.advertiserInvoices.list", "flatPath": "userprofiles/{userprofilesId}/advertisers/{advertisersId}/invoices", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "profileId": { "location": "path", "required": true, "format": "int64", "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "advertiserId": { "pattern": "^[^/]+$", "format": "int64", "required": true, "description": "Advertiser ID of this invoice.", "type": "string", "location": "path" }, "maxResults": { "format": "int32", "type": "integer", "default": "1000", "description": "Maximum number of results to return.", "location": "query" }, "issueMonth": { "location": "query", "description": "Month for which invoices are needed in the format YYYYMM. Required field", "type": "string" } }, "parameterOrder": [ "profileId", "advertiserId" ], "description": "Retrieves a list of invoices for a particular issue month. The api only works if the billing profile invoice level is set to either advertiser or campaign non-consolidated invoice level." } } }, "connectionTypes": { "methods": { "get": { "response": { "$ref": "ConnectionType" }, "parameters": { "profileId": { "format": "int64", "type": "string", "location": "path", "required": true, "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "id": { "format": "int64", "description": "Connection type ID.", "location": "path", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one connection type by ID.", "path": "userprofiles/{+profileId}/connectionTypes/{+id}", "flatPath": "userprofiles/{userprofilesId}/connectionTypes/{connectionTypesId}", "id": "dfareporting.connectionTypes.get", "parameterOrder": [ "profileId", "id" ] }, "list": { "path": "userprofiles/{+profileId}/connectionTypes", "flatPath": "userprofiles/{userprofilesId}/connectionTypes", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.connectionTypes.list", "httpMethod": "GET", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "location": "path", "required": true, "format": "int64", "pattern": "^[^/]+$" } }, "parameterOrder": [ "profileId" ], "description": "Retrieves a list of connection types.", "response": { "$ref": "ConnectionTypesListResponse" } } } }, "mobileCarriers": { "methods": { "list": { "flatPath": "userprofiles/{userprofilesId}/mobileCarriers", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of mobile carriers.", "httpMethod": "GET", "parameters": { "profileId": { "location": "path", "required": true, "description": "User profile ID associated with this request.", "format": "int64", "pattern": "^[^/]+$", "type": "string" } }, "path": "userprofiles/{+profileId}/mobileCarriers", "response": { "$ref": "MobileCarriersListResponse" }, "id": "dfareporting.mobileCarriers.list", "parameterOrder": [ "profileId" ] }, "get": { "id": "dfareporting.mobileCarriers.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/mobileCarriers/{mobileCarriersId}", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "type": "string", "location": "path", "description": "User profile ID associated with this request.", "format": "int64" }, "id": { "type": "string", "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "Mobile carrier ID.", "location": "path" } }, "httpMethod": "GET", "parameterOrder": [ "profileId", "id" ], "path": "userprofiles/{+profileId}/mobileCarriers/{+id}", "description": "Gets one mobile carrier by ID.", "response": { "$ref": "MobileCarrier" } } } }, "sites": { "methods": { "update": { "description": "Updates an existing site.", "path": "userprofiles/{+profileId}/sites", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/sites", "response": { "$ref": "Site" }, "id": "dfareporting.sites.update", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PUT", "request": { "$ref": "Site" }, "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "required": true, "type": "string", "pattern": "^[^/]+$" } } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "Site" }, "httpMethod": "PATCH", "parameters": { "profileId": { "required": true, "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "type": "string" }, "id": { "required": true, "location": "query", "description": "Required. Site ID.", "type": "string", "format": "int64" } }, "parameterOrder": [ "profileId", "id" ], "id": "dfareporting.sites.patch", "flatPath": "userprofiles/{userprofilesId}/sites", "path": "userprofiles/{+profileId}/sites", "request": { "$ref": "Site" }, "description": "Updates an existing site. This method supports patch semantics." }, "get": { "httpMethod": "GET", "path": "userprofiles/{+profileId}/sites/{+id}", "id": "dfareporting.sites.get", "parameterOrder": [ "profileId", "id" ], "parameters": { "profileId": { "required": true, "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "format": "int64" }, "id": { "location": "path", "pattern": "^[^/]+$", "type": "string", "required": true, "format": "int64", "description": "Site ID." } }, "description": "Gets one site by ID.", "flatPath": "userprofiles/{userprofilesId}/sites/{sitesId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "Site" } }, "insert": { "path": "userprofiles/{+profileId}/sites", "flatPath": "userprofiles/{userprofilesId}/sites", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "Site" }, "id": "dfareporting.sites.insert", "httpMethod": "POST", "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "location": "path", "description": "User profile ID associated with this request.", "type": "string", "required": true, "format": "int64", "pattern": "^[^/]+$" } }, "description": "Inserts a new site.", "response": { "$ref": "Site" } }, "list": { "parameters": { "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "acceptsInterstitialPlacements": { "description": "This search filter is no longer supported and will have no effect on the results returned.", "type": "boolean", "location": "query" }, "acceptsInStreamVideoPlacements": { "type": "boolean", "description": "This search filter is no longer supported and will have no effect on the results returned.", "location": "query" }, "unmappedSite": { "type": "boolean", "description": "Select only sites that have not been mapped to a directory site.", "location": "query" }, "sortOrder": { "description": "Order of sorted results.", "default": "ASCENDING", "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query" }, "acceptsPublisherPaidPlacements": { "description": "Select only sites that accept publisher paid placements.", "location": "query", "type": "boolean" }, "ids": { "repeated": true, "format": "int64", "location": "query", "type": "string", "description": "Select only sites with these IDs." }, "campaignIds": { "type": "string", "location": "query", "repeated": true, "format": "int64", "description": "Select only sites with these campaign IDs." }, "sortField": { "default": "ID", "location": "query", "type": "string", "enum": [ "ID", "NAME" ], "description": "Field by which to sort the list.", "enumDescriptions": [ "", "" ] }, "approved": { "location": "query", "type": "boolean", "description": "Select only approved sites." }, "subaccountId": { "location": "query", "format": "int64", "description": "Select only sites with this subaccount ID.", "type": "string" }, "adWordsSite": { "type": "boolean", "description": "Select only AdWords sites.", "location": "query" }, "directorySiteIds": { "repeated": true, "location": "query", "format": "int64", "description": "Select only sites with these directory site IDs.", "type": "string" }, "profileId": { "pattern": "^[^/]+$", "format": "int64", "required": true, "location": "path", "description": "User profile ID associated with this request.", "type": "string" }, "maxResults": { "type": "integer", "format": "int32", "default": "1000", "description": "Maximum number of results to return.", "location": "query" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name, ID or keyName. Wildcards (*) are allowed. For example, \"site*2015\" will return objects with names like \"site June 2015\", \"site April 2015\", or simply \"site 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"site\" will match objects with name \"my site\", \"site 2015\", or simply \"site\"." } }, "id": "dfareporting.sites.list", "path": "userprofiles/{+profileId}/sites", "httpMethod": "GET", "response": { "$ref": "SitesListResponse" }, "flatPath": "userprofiles/{userprofilesId}/sites", "description": "Retrieves a list of sites, possibly filtered. This method supports paging.", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] } } }, "placements": { "methods": { "insert": { "request": { "$ref": "Placement" }, "parameters": { "profileId": { "required": true, "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string" } }, "description": "Inserts a new placement.", "httpMethod": "POST", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/placements", "id": "dfareporting.placements.insert", "response": { "$ref": "Placement" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/placements" }, "patch": { "path": "userprofiles/{+profileId}/placements", "request": { "$ref": "Placement" }, "flatPath": "userprofiles/{userprofilesId}/placements", "parameterOrder": [ "profileId", "id" ], "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "type": "string", "location": "path", "required": true, "pattern": "^[^/]+$" }, "id": { "location": "query", "required": true, "description": "Required. Placement ID.", "type": "string", "format": "int64" } }, "description": "Updates an existing placement. This method supports patch semantics.", "httpMethod": "PATCH", "id": "dfareporting.placements.patch", "response": { "$ref": "Placement" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "generatetags": { "parameters": { "profileId": { "type": "string", "format": "int64", "pattern": "^[^/]+$", "required": true, "location": "path", "description": "User profile ID associated with this request." }, "tagProperties.dcDbmMacroIncluded": { "type": "boolean", "location": "query", "description": "Optional. Indicates whether to include the dc_dbm macro in the generated tags. [Learn more](https://support.google.com/campaignmanager/answer/9280273) about this macro." }, "tagFormats": { "type": "string", "enum": [ "PLACEMENT_TAG_STANDARD", "PLACEMENT_TAG_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_IFRAME_ILAYER", "PLACEMENT_TAG_INTERNAL_REDIRECT", "PLACEMENT_TAG_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT", "PLACEMENT_TAG_CLICK_COMMANDS", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH", "PLACEMENT_TAG_TRACKING", "PLACEMENT_TAG_TRACKING_IFRAME", "PLACEMENT_TAG_TRACKING_JAVASCRIPT", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3", "PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4", "PLACEMENT_TAG_TRACKING_THIRD_PARTY_MEASUREMENT" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "location": "query", "repeated": true, "description": "Tag formats to generate for these placements. *Note:* PLACEMENT_TAG_STANDARD can only be generated for 1x1 placements." }, "placementIds": { "repeated": true, "description": "Generate tags for these placements.", "location": "query", "format": "int64", "type": "string" }, "tagProperties.tcfGdprMacrosIncluded": { "location": "query", "type": "boolean", "description": "Optional. Indicates whether to include the TCF macro in the generated tags. Default true. [Learn more](https://support.google.com/campaignmanager/answer/10031693) about this macro.", "default": "true" }, "campaignId": { "type": "string", "location": "query", "description": "Generate placements belonging to this campaign. This is a required field.", "format": "int64" }, "tagProperties.gppMacrosIncluded": { "location": "query", "type": "boolean", "description": "Optional. Indicates whether to include the GPP macro in the generated tags. [Learn more](https://support.google.com/campaignmanager/answer/10031693) about this macro." } }, "description": "Generates tags for a placement.", "flatPath": "userprofiles/{userprofilesId}/placements/generatetags", "httpMethod": "POST", "path": "userprofiles/{+profileId}/placements/generatetags", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "PlacementsGenerateTagsResponse" }, "id": "dfareporting.placements.generatetags" }, "list": { "flatPath": "userprofiles/{userprofilesId}/placements", "description": "Retrieves a list of placements, possibly filtered. This method supports paging.", "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/placements", "parameters": { "siteIds": { "type": "string", "location": "query", "repeated": true, "description": "Select only placements that are associated with these sites.", "format": "int64" }, "sizeIds": { "type": "string", "location": "query", "repeated": true, "format": "int64", "description": "Select only placements that are associated with these sizes." }, "profileId": { "format": "int64", "pattern": "^[^/]+$", "type": "string", "required": true, "description": "User profile ID associated with this request.", "location": "path" }, "pricingTypes": { "description": "Select only placements with these pricing types.", "type": "string", "enum": [ "PRICING_TYPE_CPM", "PRICING_TYPE_CPC", "PRICING_TYPE_CPA", "PRICING_TYPE_FLAT_RATE_IMPRESSIONS", "PRICING_TYPE_FLAT_RATE_CLICKS", "PRICING_TYPE_CPM_ACTIVEVIEW" ], "enumDescriptions": [ "", "", "", "", "", "" ], "repeated": true, "location": "query" }, "contentCategoryIds": { "location": "query", "repeated": true, "type": "string", "description": "Select only placements that are associated with these content categories.", "format": "int64" }, "minEndDate": { "description": "Select only placements or placement groups whose end date is on or after the specified minEndDate. The date should be formatted as \"yyyy-MM-dd\".", "location": "query", "type": "string" }, "minStartDate": { "type": "string", "location": "query", "description": "Select only placements or placement groups whose start date is on or after the specified minStartDate. The date should be formatted as \"yyyy-MM-dd\"." }, "maxEndDate": { "description": "Select only placements or placement groups whose end date is on or before the specified maxEndDate. The date should be formatted as \"yyyy-MM-dd\".", "type": "string", "location": "query" }, "directorySiteIds": { "format": "int64", "description": "Select only placements that are associated with these directory sites.", "type": "string", "repeated": true, "location": "query" }, "campaignIds": { "format": "int64", "type": "string", "repeated": true, "location": "query", "description": "Select only placements that belong to these campaigns." }, "ids": { "description": "Select only placements with these IDs.", "location": "query", "repeated": true, "type": "string", "format": "int64" }, "groupIds": { "format": "int64", "description": "Select only placements that belong to these placement groups.", "repeated": true, "location": "query", "type": "string" }, "placementStrategyIds": { "format": "int64", "type": "string", "repeated": true, "description": "Select only placements that are associated with these placement strategies.", "location": "query" }, "paymentSource": { "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "PLACEMENT_AGENCY_PAID", "PLACEMENT_PUBLISHER_PAID" ], "location": "query", "description": "Select only placements with this payment source." }, "advertiserIds": { "description": "Select only placements that belong to these advertisers.", "format": "int64", "location": "query", "type": "string", "repeated": true }, "sortField": { "description": "Field by which to sort the list.", "type": "string", "enum": [ "ID", "NAME" ], "location": "query", "enumDescriptions": [ "", "" ], "default": "ID" }, "searchString": { "type": "string", "description": "Allows searching for placements by name or ID. Wildcards (*) are allowed. For example, \"placement*2015\" will return placements with names like \"placement June 2015\", \"placement May 2015\", or simply \"placements 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"placement\" will match placements with name \"my placement\", \"placement 2015\", or simply \"placement\" .", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "activeStatus": { "type": "string", "enum": [ "PLACEMENT_STATUS_UNKNOWN", "PLACEMENT_STATUS_ACTIVE", "PLACEMENT_STATUS_INACTIVE", "PLACEMENT_STATUS_ARCHIVED", "PLACEMENT_STATUS_PERMANENTLY_ARCHIVED" ], "location": "query", "enumDescriptions": [ "", "", "", "", "" ], "repeated": true, "description": "Select only placements with these active statuses." }, "maxResults": { "type": "integer", "description": "Maximum number of results to return.", "format": "int32", "default": "1000", "location": "query" }, "sortOrder": { "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "default": "ASCENDING" }, "compatibilities": { "repeated": true, "enumDescriptions": [ "", "", "Deprecated enum value. No longer supported.", "Deprecated enum value. No longer supported.", "", "" ], "location": "query", "description": "Select only placements that are associated with these compatibilities. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard.", "type": "string", "enum": [ "DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO" ] }, "maxStartDate": { "description": "Select only placements or placement groups whose start date is on or before the specified maxStartDate. The date should be formatted as \"yyyy-MM-dd\".", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "id": "dfareporting.placements.list", "response": { "$ref": "PlacementsListResponse" } }, "update": { "path": "userprofiles/{+profileId}/placements", "id": "dfareporting.placements.update", "description": "Updates an existing placement.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "Placement" }, "flatPath": "userprofiles/{userprofilesId}/placements", "httpMethod": "PUT", "response": { "$ref": "Placement" }, "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "location": "path", "required": true, "format": "int64", "type": "string" } } }, "get": { "response": { "$ref": "Placement" }, "description": "Gets one placement by ID.", "path": "userprofiles/{+profileId}/placements/{+id}", "parameters": { "profileId": { "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "required": true, "format": "int64" }, "id": { "location": "path", "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$", "description": "Placement ID." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.placements.get", "flatPath": "userprofiles/{userprofilesId}/placements/{placementsId}", "parameterOrder": [ "profileId", "id" ] } } }, "conversions": { "methods": { "batchinsert": { "flatPath": "userprofiles/{profileId}/conversions/batchinsert", "path": "userprofiles/{profileId}/conversions/batchinsert", "httpMethod": "POST", "parameters": { "profileId": { "type": "string", "description": "User profile ID associated with this request.", "required": true, "location": "path", "format": "int64" } }, "id": "dfareporting.conversions.batchinsert", "request": { "$ref": "ConversionsBatchInsertRequest" }, "description": "Inserts conversions.", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/ddmconversions" ], "response": { "$ref": "ConversionsBatchInsertResponse" } }, "batchupdate": { "response": { "$ref": "ConversionsBatchUpdateResponse" }, "path": "userprofiles/{profileId}/conversions/batchupdate", "scopes": [ "https://www.googleapis.com/auth/ddmconversions" ], "request": { "$ref": "ConversionsBatchUpdateRequest" }, "httpMethod": "POST", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "location": "path", "required": true, "format": "int64", "type": "string" } }, "parameterOrder": [ "profileId" ], "description": "Updates existing conversions.", "flatPath": "userprofiles/{profileId}/conversions/batchupdate", "id": "dfareporting.conversions.batchupdate" } } }, "tvCampaignSummaries": { "methods": { "list": { "flatPath": "userprofiles/{userprofilesId}/tvCampaignSummaries", "description": "Retrieves a list of TV campaign summaries.", "path": "userprofiles/{+profileId}/tvCampaignSummaries", "parameterOrder": [ "profileId" ], "id": "dfareporting.tvCampaignSummaries.list", "parameters": { "tvDataProvider": { "description": "Optional. TV data provider. If not specified, defaults to `COMSCORE_NATIONAL_US`.", "enumDescriptions": [ "", "Allows populating multiple tvCampaignId filters and tvCampaignEndDate filter on the report.", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "INVALID_TV_DATA_PROVIDER", "INTAGE_JP", "IBOPE_AR", "IBOPE_BR", "IBOPE_CL", "IBOPE_CO", "TNS_VN", "COMSCORE_NATIONAL_US", "COMSCORE_CA", "SAMBA_AU" ], "location": "query" }, "profileId": { "description": "Required. User profile ID associated with this request.", "type": "string", "location": "path", "format": "int64", "pattern": "^[^/]+$", "required": true }, "name": { "location": "query", "type": "string", "description": "Required. Search string to filter the list of TV campaign summaries. Matches any substring. Required field." }, "countryDartId": { "type": "string", "description": "Optional. Country Dart ID. If not specified, defaults to 256 (US).", "location": "query", "format": "int64" }, "accountId": { "location": "query", "type": "string", "description": "Required. Account ID associated with this request.", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "response": { "$ref": "TvCampaignSummariesListResponse" } } } }, "dynamicFeeds": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "dynamicFeedId": { "format": "int64", "location": "path", "type": "string", "required": true, "description": "Required. Dynamic feed ID.", "pattern": "^[^/]+$" } }, "response": { "$ref": "DynamicFeed" }, "httpMethod": "GET", "flatPath": "studio/dynamicFeeds/{dynamicFeedsId}", "id": "dfareporting.dynamicFeeds.get", "parameterOrder": [ "dynamicFeedId" ], "path": "studio/dynamicFeeds/{+dynamicFeedId}", "description": "Gets a dynamic feed by ID." }, "update": { "httpMethod": "PUT", "response": { "$ref": "DynamicFeed" }, "parameters": {}, "path": "studio/dynamicFeeds", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "DynamicFeed" }, "id": "dfareporting.dynamicFeeds.update", "parameterOrder": [], "description": "Updates a new dynamic feed. For draft feeds, only Element can be updated. For published feeds, only FeedSchedule can be updated. Other fields will be ignored.", "flatPath": "studio/dynamicFeeds" }, "insert": { "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": {}, "httpMethod": "POST", "path": "studio/dynamicFeeds", "response": { "$ref": "DynamicFeed" }, "description": "Inserts a new dynamic feed.", "request": { "$ref": "DynamicFeedsInsertRequest" }, "flatPath": "studio/dynamicFeeds", "id": "dfareporting.dynamicFeeds.insert" }, "retransform": { "parameterOrder": [ "dynamicFeedId" ], "flatPath": "studio/dynamicFeeds/{dynamicFeedsId}/retransform", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retransforms a dynamic feed. Only draft feeds can be retransformed (i.e. the feed has not been published).", "httpMethod": "POST", "parameters": { "dynamicFeedId": { "location": "path", "format": "int64", "type": "string", "required": true, "pattern": "^[^/]+$", "description": "Required. Dynamic feed ID." } }, "path": "studio/dynamicFeeds/{+dynamicFeedId}/retransform", "response": { "$ref": "DynamicFeed" }, "id": "dfareporting.dynamicFeeds.retransform" } } }, "studioCreativeAssets": { "methods": { "insert": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "supportsMediaUpload": true, "mediaUpload": { "protocols": { "simple": { "multipart": true, "path": "/upload/dfareporting/v5/studio/creativeAssets" } }, "accept": [ "*/*" ], "maxSize": "1073741824" }, "path": "studio/creativeAssets", "parameters": {}, "response": { "$ref": "StudioCreativeAssetsResponse" }, "parameterOrder": [], "httpMethod": "POST", "description": "Inserts a new studio creative asset.", "request": { "$ref": "DfareportingStudioCreativeAssetsInsertRequest" }, "flatPath": "studio/creativeAssets", "id": "dfareporting.studioCreativeAssets.insert" } } }, "languages": { "methods": { "list": { "flatPath": "userprofiles/{userprofilesId}/languages", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "type": "string", "required": true, "pattern": "^[^/]+$", "location": "path" } }, "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/languages", "description": "Retrieves a list of languages.", "response": { "$ref": "LanguagesListResponse" }, "id": "dfareporting.languages.list" } } }, "targetingTemplates": { "methods": { "list": { "id": "dfareporting.targetingTemplates.list", "flatPath": "userprofiles/{userprofilesId}/targetingTemplates", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "advertiserId": { "location": "query", "type": "string", "description": "Select only targeting templates with this advertiser ID.", "format": "int64" }, "searchString": { "location": "query", "type": "string", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"template*2015\" will return objects with names like \"template June 2015\", \"template April 2015\", or simply \"template 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"template\" will match objects with name \"my template\", \"template 2015\", or simply \"template\"." }, "profileId": { "type": "string", "location": "path", "required": true, "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "ids": { "type": "string", "description": "Select only targeting templates with these IDs.", "location": "query", "repeated": true, "format": "int64" }, "maxResults": { "format": "int32", "default": "1000", "type": "integer", "description": "Maximum number of results to return.", "location": "query" }, "sortOrder": { "description": "Order of sorted results.", "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING" }, "sortField": { "default": "ID", "enumDescriptions": [ "", "" ], "description": "Field by which to sort the list.", "location": "query", "type": "string", "enum": [ "ID", "NAME" ] } }, "parameterOrder": [ "profileId" ], "httpMethod": "GET", "description": "Retrieves a list of targeting templates, optionally filtered. This method supports paging.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/targetingTemplates", "response": { "$ref": "TargetingTemplatesListResponse" } }, "get": { "id": "dfareporting.targetingTemplates.get", "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string", "required": true, "format": "int64", "location": "path" }, "id": { "type": "string", "description": "Targeting template ID.", "location": "path", "required": true, "pattern": "^[^/]+$", "format": "int64" } }, "response": { "$ref": "TargetingTemplate" }, "httpMethod": "GET", "description": "Gets one targeting template by ID.", "path": "userprofiles/{+profileId}/targetingTemplates/{+id}", "flatPath": "userprofiles/{userprofilesId}/targetingTemplates/{targetingTemplatesId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ] }, "insert": { "description": "Inserts a new targeting template.", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "location": "path", "pattern": "^[^/]+$", "format": "int64", "required": true } }, "response": { "$ref": "TargetingTemplate" }, "httpMethod": "POST", "path": "userprofiles/{+profileId}/targetingTemplates", "request": { "$ref": "TargetingTemplate" }, "id": "dfareporting.targetingTemplates.insert", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/targetingTemplates" }, "update": { "flatPath": "userprofiles/{userprofilesId}/targetingTemplates", "description": "Updates an existing targeting template.", "request": { "$ref": "TargetingTemplate" }, "path": "userprofiles/{+profileId}/targetingTemplates", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "format": "int64", "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true } }, "id": "dfareporting.targetingTemplates.update", "httpMethod": "PUT", "response": { "$ref": "TargetingTemplate" } }, "patch": { "description": "Updates an existing targeting template. This method supports patch semantics.", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/targetingTemplates", "httpMethod": "PATCH", "path": "userprofiles/{+profileId}/targetingTemplates", "response": { "$ref": "TargetingTemplate" }, "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$" }, "id": { "format": "int64", "description": "Required. RemarketingList ID.", "type": "string", "location": "query", "required": true } }, "request": { "$ref": "TargetingTemplate" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.targetingTemplates.patch" } } }, "creativeAssets": { "methods": { "insert": { "flatPath": "userprofiles/{userprofilesId}/creativeAssets/{creativeAssetsId}/creativeAssets", "supportsMediaUpload": true, "description": "Inserts a new creative asset.", "mediaUpload": { "accept": [ "*/*" ], "maxSize": "1073741824", "protocols": { "simple": { "multipart": true, "path": "/upload/dfareporting/v5/userprofiles/{+profileId}/creativeAssets/{+advertiserId}/creativeAssets" } } }, "path": "userprofiles/{+profileId}/creativeAssets/{+advertiserId}/creativeAssets", "id": "dfareporting.creativeAssets.insert", "request": { "$ref": "CreativeAssetMetadata" }, "parameterOrder": [ "profileId", "advertiserId" ], "httpMethod": "POST", "parameters": { "profileId": { "type": "string", "format": "int64", "location": "path", "required": true, "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "advertiserId": { "description": "Advertiser ID of this creative. This is a required field.", "pattern": "^[^/]+$", "format": "int64", "required": true, "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "CreativeAssetMetadata" } } } }, "files": { "methods": { "get": { "httpMethod": "GET", "id": "dfareporting.files.get", "response": { "$ref": "File" }, "parameters": { "reportId": { "type": "string", "required": true, "description": "The ID of the report.", "location": "path", "format": "int64" }, "fileId": { "required": true, "location": "path", "format": "int64", "description": "The ID of the report file.", "type": "string" } }, "path": "reports/{reportId}/files/{fileId}", "parameterOrder": [ "reportId", "fileId" ], "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "description": "Retrieves a report file by its report ID and file ID. This method supports media download.", "flatPath": "reports/{reportId}/files/{fileId}", "supportsMediaDownload": true }, "list": { "path": "userprofiles/{profileId}/files", "id": "dfareporting.files.list", "flatPath": "userprofiles/{profileId}/files", "parameterOrder": [ "profileId" ], "parameters": { "maxResults": { "description": "Maximum number of results to return.", "type": "integer", "default": "10", "location": "query", "format": "int32" }, "sortField": { "location": "query", "default": "LAST_MODIFIED_TIME", "description": "The field by which to sort the list.", "enumDescriptions": [ "Sort by file ID.", "Sort by 'lastmodifiedAt' field." ], "type": "string", "enum": [ "ID", "LAST_MODIFIED_TIME" ] }, "sortOrder": { "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "DESCENDING", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ] }, "profileId": { "description": "The Campaign Manager 360 user profile ID.", "format": "int64", "location": "path", "required": true, "type": "string" }, "pageToken": { "description": "The value of the nextToken from the previous result page.", "location": "query", "type": "string" }, "scope": { "type": "string", "enum": [ "ALL", "MINE", "SHARED_WITH_ME" ], "default": "MINE", "enumDescriptions": [ "All files in account.", "My files.", "Files shared with me." ], "location": "query", "description": "The scope that defines which results are returned." } }, "description": "Lists files for a user profile.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "response": { "$ref": "FileList" } } } }, "metros": { "methods": { "list": { "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "type": "string", "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "pattern": "^[^/]+$", "required": true } }, "response": { "$ref": "MetrosListResponse" }, "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/metros", "id": "dfareporting.metros.list", "path": "userprofiles/{+profileId}/metros", "description": "Retrieves a list of metros.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] } } }, "sizes": { "methods": { "insert": { "httpMethod": "POST", "parameters": { "profileId": { "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string", "required": true, "location": "path" } }, "path": "userprofiles/{+profileId}/sizes", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Inserts a new size.", "parameterOrder": [ "profileId" ], "id": "dfareporting.sizes.insert", "response": { "$ref": "Size" }, "flatPath": "userprofiles/{userprofilesId}/sizes", "request": { "$ref": "Size" } }, "get": { "parameterOrder": [ "profileId", "id" ], "httpMethod": "GET", "path": "userprofiles/{+profileId}/sizes/{+id}", "id": "dfareporting.sizes.get", "response": { "$ref": "Size" }, "parameters": { "id": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "Size ID.", "type": "string", "format": "int64" }, "profileId": { "pattern": "^[^/]+$", "format": "int64", "type": "string", "required": true, "description": "User profile ID associated with this request.", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one size by ID.", "flatPath": "userprofiles/{userprofilesId}/sizes/{sizesId}" }, "list": { "id": "dfareporting.sizes.list", "parameterOrder": [ "profileId" ], "response": { "$ref": "SizesListResponse" }, "description": "Retrieves a list of sizes, possibly filtered. Retrieved sizes are globally unique and may include values not currently in use by your account. Due to this, the list of sizes returned by this method may differ from the list seen in the Trafficking UI.", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "location": "path", "format": "int64", "type": "string" }, "iabStandard": { "location": "query", "description": "Select only IAB standard sizes.", "type": "boolean" }, "width": { "description": "Select only sizes with this width.", "location": "query", "type": "integer", "format": "int32" }, "ids": { "repeated": true, "format": "int64", "location": "query", "type": "string", "description": "Select only sizes with these IDs." }, "height": { "type": "integer", "format": "int32", "location": "query", "description": "Select only sizes with this height." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/sizes", "flatPath": "userprofiles/{userprofilesId}/sizes" } } }, "remarketingListShares": { "methods": { "get": { "parameterOrder": [ "profileId", "remarketingListId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/remarketingListShares/{remarketingListSharesId}", "response": { "$ref": "RemarketingListShare" }, "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string", "description": "User profile ID associated with this request." }, "remarketingListId": { "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "description": "Remarketing list ID.", "format": "int64" } }, "httpMethod": "GET", "id": "dfareporting.remarketingListShares.get", "path": "userprofiles/{+profileId}/remarketingListShares/{+remarketingListId}", "description": "Gets one remarketing list share by remarketing list ID." }, "update": { "response": { "$ref": "RemarketingListShare" }, "parameterOrder": [ "profileId" ], "request": { "$ref": "RemarketingListShare" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/remarketingListShares", "id": "dfareporting.remarketingListShares.update", "httpMethod": "PUT", "path": "userprofiles/{+profileId}/remarketingListShares", "description": "Updates an existing remarketing list share.", "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "required": true, "pattern": "^[^/]+$", "type": "string" } } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/remarketingListShares", "parameterOrder": [ "profileId", "id" ], "request": { "$ref": "RemarketingListShare" }, "description": "Updates an existing remarketing list share. This method supports patch semantics.", "path": "userprofiles/{+profileId}/remarketingListShares", "response": { "$ref": "RemarketingListShare" }, "id": "dfareporting.remarketingListShares.patch", "httpMethod": "PATCH", "parameters": { "id": { "format": "int64", "description": "Required. RemarketingList ID.", "required": true, "type": "string", "location": "query" }, "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" } } } } }, "dimensionValues": { "methods": { "query": { "path": "userprofiles/{profileId}/dimensionvalues/query", "request": { "$ref": "DimensionValueRequest" }, "flatPath": "userprofiles/{profileId}/dimensionvalues/query", "parameterOrder": [ "profileId" ], "description": "Retrieves list of report dimension values for a list of filters.", "response": { "$ref": "DimensionValueList" }, "id": "dfareporting.dimensionValues.query", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "parameters": { "pageToken": { "location": "query", "description": "The value of the nextToken from the previous result page.", "type": "string" }, "maxResults": { "location": "query", "default": "100", "format": "int32", "description": "Maximum number of results to return.", "type": "integer" }, "profileId": { "type": "string", "description": "The Campaign Manager 360 user profile ID.", "format": "int64", "required": true, "location": "path" } } } } }, "billingRates": { "methods": { "list": { "parameters": { "billingProfileId": { "pattern": "^[^/]+$", "description": "Billing profile ID of this billing rate.", "required": true, "location": "path", "type": "string", "format": "int64" }, "profileId": { "location": "path", "required": true, "type": "string", "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } }, "description": "Retrieves a list of billing rates. This method supports paging.", "id": "dfareporting.billingRates.list", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "response": { "$ref": "BillingRatesListResponse" }, "path": "userprofiles/{+profileId}/billingProfiles/{+billingProfileId}/billingRates", "parameterOrder": [ "profileId", "billingProfileId" ], "flatPath": "userprofiles/{userprofilesId}/billingProfiles/{billingProfilesId}/billingRates" } } }, "studioCreatives": { "methods": { "get": { "description": "Gets a studio creative by ID.", "response": { "$ref": "StudioCreative" }, "id": "dfareporting.studioCreatives.get", "flatPath": "studio/creatives/{creativesId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "studioCreativeId": { "pattern": "^[^/]+$", "type": "string", "format": "int64", "location": "path", "required": true, "description": "Required. Studio creative ID." } }, "parameterOrder": [ "studioCreativeId" ], "httpMethod": "GET", "path": "studio/creatives/{+studioCreativeId}" }, "insert": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Inserts a new studio creative.", "response": { "$ref": "StudioCreative" }, "path": "studio/creatives", "parameterOrder": [], "flatPath": "studio/creatives", "parameters": {}, "request": { "$ref": "StudioCreative" }, "httpMethod": "POST", "id": "dfareporting.studioCreatives.insert" }, "publish": { "description": "Publish for a studio creative.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "studio/creatives/{creativesId}/publish", "path": "studio/creatives/{+studioCreativeId}/publish", "httpMethod": "POST", "parameterOrder": [ "studioCreativeId" ], "parameters": { "studioCreativeId": { "description": "Required. Studio creative ID.", "type": "string", "location": "path", "format": "int64", "pattern": "^[^/]+$", "required": true } }, "id": "dfareporting.studioCreatives.publish" } } }, "userRolePermissions": { "methods": { "list": { "response": { "$ref": "UserRolePermissionsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets a list of user role permissions, possibly filtered.", "parameterOrder": [ "profileId" ], "httpMethod": "GET", "parameters": { "ids": { "description": "Select only user role permissions with these IDs.", "repeated": true, "location": "query", "format": "int64", "type": "string" }, "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request." } }, "path": "userprofiles/{+profileId}/userRolePermissions", "id": "dfareporting.userRolePermissions.list", "flatPath": "userprofiles/{userprofilesId}/userRolePermissions" }, "get": { "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/userRolePermissions/{userRolePermissionsId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "UserRolePermission" }, "description": "Gets one user role permission by ID.", "path": "userprofiles/{+profileId}/userRolePermissions/{+id}", "id": "dfareporting.userRolePermissions.get", "httpMethod": "GET", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "User profile ID associated with this request.", "type": "string", "format": "int64" }, "id": { "location": "path", "required": true, "type": "string", "pattern": "^[^/]+$", "description": "User role permission ID.", "format": "int64" } } } } }, "creatives": { "methods": { "insert": { "description": "Inserts a new creative.", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "required": true, "pattern": "^[^/]+$", "type": "string" } }, "request": { "$ref": "Creative" }, "response": { "$ref": "Creative" }, "path": "userprofiles/{+profileId}/creatives", "httpMethod": "POST", "flatPath": "userprofiles/{userprofilesId}/creatives", "id": "dfareporting.creatives.insert", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "patch": { "id": "dfareporting.creatives.patch", "description": "Updates an existing creative. This method supports patch semantics.", "parameters": { "profileId": { "type": "string", "pattern": "^[^/]+$", "required": true, "format": "int64", "location": "path", "description": "User profile ID associated with this request." }, "id": { "location": "query", "required": true, "type": "string", "description": "Required. Creative ID.", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/creatives", "httpMethod": "PATCH", "response": { "$ref": "Creative" }, "request": { "$ref": "Creative" }, "path": "userprofiles/{+profileId}/creatives", "parameterOrder": [ "profileId", "id" ] }, "list": { "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/creatives", "id": "dfareporting.creatives.list", "flatPath": "userprofiles/{userprofilesId}/creatives", "parameters": { "campaignId": { "type": "string", "description": "Select only creatives with this campaign ID.", "format": "int64", "location": "query" }, "sortField": { "description": "Field by which to sort the list.", "location": "query", "default": "ID", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "ID", "NAME" ] }, "ids": { "location": "query", "repeated": true, "format": "int64", "description": "Select only creatives with these IDs.", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"creative*2015\" will return objects with names like \"creative June 2015\", \"creative April 2015\", or simply \"creative 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"creative\" will match objects with name \"my creative\", \"creative 2015\", or simply \"creative\"." }, "renderingIds": { "location": "query", "repeated": true, "type": "string", "format": "int64", "description": "Select only creatives with these rendering IDs." }, "active": { "description": "Select only active creatives. Leave blank to select active and inactive creatives.", "location": "query", "type": "boolean" }, "types": { "location": "query", "repeated": true, "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "description": "Select only creatives with these creative types.", "type": "string", "enum": [ "IMAGE", "DISPLAY_REDIRECT", "CUSTOM_DISPLAY", "INTERNAL_REDIRECT", "CUSTOM_DISPLAY_INTERSTITIAL", "INTERSTITIAL_INTERNAL_REDIRECT", "TRACKING_TEXT", "RICH_MEDIA_DISPLAY_BANNER", "RICH_MEDIA_INPAGE_FLOATING", "RICH_MEDIA_IM_EXPAND", "RICH_MEDIA_DISPLAY_EXPANDING", "RICH_MEDIA_DISPLAY_INTERSTITIAL", "RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL", "RICH_MEDIA_MOBILE_IN_APP", "FLASH_INPAGE", "INSTREAM_VIDEO", "VPAID_LINEAR_VIDEO", "VPAID_NON_LINEAR_VIDEO", "INSTREAM_VIDEO_REDIRECT", "RICH_MEDIA_PEEL_DOWN", "HTML5_BANNER", "DISPLAY", "DISPLAY_IMAGE_GALLERY", "BRAND_SAFE_DEFAULT_INSTREAM_VIDEO", "INSTREAM_AUDIO" ] }, "studioCreativeId": { "description": "Select only creatives corresponding to this Studio creative ID.", "type": "string", "location": "query", "format": "int64" }, "advertiserId": { "type": "string", "format": "int64", "description": "Select only creatives with this advertiser ID.", "location": "query" }, "sizeIds": { "description": "Select only creatives with these size IDs.", "location": "query", "repeated": true, "format": "int64", "type": "string" }, "sortOrder": { "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "description": "Order of sorted results.", "default": "ASCENDING", "location": "query" }, "profileId": { "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request.", "required": true, "location": "path" }, "companionCreativeIds": { "location": "query", "description": "Select only in-stream video creatives with these companion IDs.", "repeated": true, "type": "string", "format": "int64" }, "archived": { "description": "Select only archived creatives. Leave blank to select archived and unarchived creatives.", "location": "query", "type": "boolean" }, "maxResults": { "type": "integer", "description": "Maximum number of results to return.", "format": "int32", "default": "1000", "location": "query" }, "creativeFieldIds": { "description": "Select only creatives with these creative field IDs.", "type": "string", "repeated": true, "location": "query", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "description": "Retrieves a list of creatives, possibly filtered. This method supports paging.", "response": { "$ref": "CreativesListResponse" } }, "get": { "path": "userprofiles/{+profileId}/creatives/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "response": { "$ref": "Creative" }, "parameterOrder": [ "profileId", "id" ], "parameters": { "id": { "pattern": "^[^/]+$", "required": true, "description": "Creative ID.", "location": "path", "format": "int64", "type": "string" }, "profileId": { "description": "User profile ID associated with this request.", "location": "path", "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$" } }, "id": "dfareporting.creatives.get", "description": "Gets one creative by ID.", "flatPath": "userprofiles/{userprofilesId}/creatives/{creativesId}" }, "update": { "description": "Updates an existing creative.", "response": { "$ref": "Creative" }, "httpMethod": "PUT", "request": { "$ref": "Creative" }, "flatPath": "userprofiles/{userprofilesId}/creatives", "parameters": { "profileId": { "type": "string", "location": "path", "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request." } }, "id": "dfareporting.creatives.update", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/creatives" } } }, "reports": { "methods": { "run": { "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "parameterOrder": [ "profileId", "reportId" ], "parameters": { "profileId": { "required": true, "location": "path", "description": "The Campaign Manager 360 user profile ID.", "type": "string", "format": "int64" }, "reportId": { "required": true, "format": "int64", "location": "path", "description": "The ID of the report.", "type": "string" }, "synchronous": { "default": "false", "location": "query", "type": "boolean", "description": "If set and true, tries to run the report synchronously." } }, "flatPath": "userprofiles/{profileId}/reports/{reportId}/run", "httpMethod": "POST", "response": { "$ref": "File" }, "id": "dfareporting.reports.run", "path": "userprofiles/{profileId}/reports/{reportId}/run", "description": "Runs a report." }, "insert": { "response": { "$ref": "Report" }, "parameterOrder": [ "profileId" ], "description": "Creates a report.", "id": "dfareporting.reports.insert", "parameters": { "profileId": { "location": "path", "type": "string", "format": "int64", "description": "The Campaign Manager 360 user profile ID.", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "path": "userprofiles/{profileId}/reports", "request": { "$ref": "Report" }, "flatPath": "userprofiles/{profileId}/reports" }, "update": { "response": { "$ref": "Report" }, "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "parameterOrder": [ "profileId", "reportId" ], "path": "userprofiles/{profileId}/reports/{reportId}", "parameters": { "profileId": { "format": "int64", "description": "The Campaign Manager 360 user profile ID.", "required": true, "type": "string", "location": "path" }, "reportId": { "type": "string", "description": "The ID of the report.", "location": "path", "format": "int64", "required": true } }, "description": "Updates a report.", "httpMethod": "PUT", "request": { "$ref": "Report" }, "flatPath": "userprofiles/{profileId}/reports/{reportId}", "id": "dfareporting.reports.update" }, "delete": { "httpMethod": "DELETE", "parameterOrder": [ "profileId", "reportId" ], "flatPath": "userprofiles/{profileId}/reports/{reportId}", "parameters": { "profileId": { "description": "The Campaign Manager 360 user profile ID.", "format": "int64", "location": "path", "required": true, "type": "string" }, "reportId": { "location": "path", "required": true, "description": "The ID of the report.", "type": "string", "format": "int64" } }, "description": "Deletes a report by its ID.", "path": "userprofiles/{profileId}/reports/{reportId}", "id": "dfareporting.reports.delete", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ] }, "list": { "flatPath": "userprofiles/{profileId}/reports", "path": "userprofiles/{profileId}/reports", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "description": "Retrieves list of reports.", "parameters": { "profileId": { "type": "string", "format": "int64", "description": "The Campaign Manager 360 user profile ID.", "location": "path", "required": true }, "maxResults": { "location": "query", "description": "Maximum number of results to return.", "default": "10", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "description": "The value of the nextToken from the previous result page.", "location": "query" }, "sortField": { "default": "LAST_MODIFIED_TIME", "enumDescriptions": [ "Sort by report ID.", "Sort by 'lastModifiedTime' field.", "Sort by name of reports." ], "location": "query", "type": "string", "enum": [ "ID", "LAST_MODIFIED_TIME", "NAME" ], "description": "The field by which to sort the list." }, "sortOrder": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "description": "Order of sorted results.", "default": "DESCENDING", "location": "query", "enumDescriptions": [ "Ascending order.", "Descending order." ] }, "scope": { "default": "MINE", "description": "The scope that defines which results are returned.", "location": "query", "enumDescriptions": [ "All reports in account.", "My reports." ], "type": "string", "enum": [ "ALL", "MINE" ] } }, "response": { "$ref": "ReportList" }, "id": "dfareporting.reports.list", "httpMethod": "GET" }, "get": { "description": "Retrieves a report by its ID.", "parameterOrder": [ "profileId", "reportId" ], "flatPath": "userprofiles/{profileId}/reports/{reportId}", "path": "userprofiles/{profileId}/reports/{reportId}", "parameters": { "reportId": { "location": "path", "description": "The ID of the report.", "type": "string", "required": true, "format": "int64" }, "profileId": { "location": "path", "required": true, "description": "The Campaign Manager 360 user profile ID.", "format": "int64", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "response": { "$ref": "Report" }, "id": "dfareporting.reports.get" } }, "resources": { "files": { "methods": { "get": { "flatPath": "userprofiles/{profileId}/reports/{reportId}/files/{fileId}", "supportsMediaDownload": true, "parameterOrder": [ "profileId", "reportId", "fileId" ], "httpMethod": "GET", "parameters": { "reportId": { "format": "int64", "type": "string", "required": true, "description": "The ID of the report.", "location": "path" }, "fileId": { "required": true, "location": "path", "type": "string", "description": "The ID of the report file.", "format": "int64" }, "profileId": { "type": "string", "required": true, "format": "int64", "location": "path", "description": "The Campaign Manager 360 user profile ID." } }, "description": "Retrieves a report file by its report ID and file ID. This method supports media download.", "path": "userprofiles/{profileId}/reports/{reportId}/files/{fileId}", "id": "dfareporting.reports.files.get", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "response": { "$ref": "File" } }, "list": { "response": { "$ref": "FileList" }, "parameterOrder": [ "profileId", "reportId" ], "id": "dfareporting.reports.files.list", "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "httpMethod": "GET", "path": "userprofiles/{profileId}/reports/{reportId}/files", "parameters": { "sortField": { "type": "string", "enum": [ "ID", "LAST_MODIFIED_TIME" ], "default": "LAST_MODIFIED_TIME", "enumDescriptions": [ "", "" ], "location": "query", "description": "The field by which to sort the list." }, "reportId": { "description": "The ID of the parent report.", "format": "int64", "required": true, "location": "path", "type": "string" }, "sortOrder": { "location": "query", "enumDescriptions": [ "Ascending order.", "Descending order." ], "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "DESCENDING" }, "maxResults": { "format": "int32", "type": "integer", "default": "10", "location": "query", "description": "Maximum number of results to return." }, "profileId": { "type": "string", "description": "The Campaign Manager 360 user profile ID.", "required": true, "format": "int64", "location": "path" }, "pageToken": { "type": "string", "location": "query", "description": "The value of the nextToken from the previous result page." } }, "description": "Lists files for a report.", "flatPath": "userprofiles/{profileId}/reports/{reportId}/files" } } }, "compatibleFields": { "methods": { "query": { "httpMethod": "POST", "path": "userprofiles/{profileId}/reports/compatiblefields/query", "flatPath": "userprofiles/{profileId}/reports/compatiblefields/query", "parameterOrder": [ "profileId" ], "id": "dfareporting.reports.compatibleFields.query", "parameters": { "profileId": { "format": "int64", "description": "The Campaign Manager 360 user profile ID.", "required": true, "location": "path", "type": "string" } }, "request": { "$ref": "Report" }, "scopes": [ "https://www.googleapis.com/auth/dfareporting" ], "response": { "$ref": "CompatibleFields" }, "description": "Returns the fields that are compatible to be selected in the respective sections of a report criteria, given the fields already selected in the input report and user permissions." } } } } }, "billingAssignments": { "methods": { "list": { "id": "dfareporting.billingAssignments.list", "path": "userprofiles/{+profileId}/billingProfiles/{+billingProfileId}/billingAssignments", "response": { "$ref": "BillingAssignmentsListResponse" }, "parameterOrder": [ "profileId", "billingProfileId" ], "parameters": { "billingProfileId": { "pattern": "^[^/]+$", "description": "Billing profile ID of this billing assignment.", "required": true, "type": "string", "location": "path", "format": "int64" }, "profileId": { "description": "User profile ID associated with this request.", "required": true, "location": "path", "format": "int64", "type": "string", "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/billingProfiles/{billingProfilesId}/billingAssignments", "httpMethod": "GET", "description": "Retrieves a list of billing assignments.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "insert": { "parameterOrder": [ "profileId", "billingProfileId" ], "response": { "$ref": "BillingAssignment" }, "description": "Inserts a new billing assignment and returns the new assignment. Only one of advertiser_id or campaign_id is support per request. If the new assignment has no effect (assigning a campaign to the parent advertiser billing profile or assigning an advertiser to the account billing profile), no assignment will be returned.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/billingProfiles/{+billingProfileId}/billingAssignments", "httpMethod": "POST", "flatPath": "userprofiles/{userprofilesId}/billingProfiles/{billingProfilesId}/billingAssignments", "request": { "$ref": "BillingAssignment" }, "id": "dfareporting.billingAssignments.insert", "parameters": { "profileId": { "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string", "description": "User profile ID associated with this request.", "required": true }, "billingProfileId": { "location": "path", "description": "Billing profile ID of this billing assignment.", "required": true, "pattern": "^[^/]+$", "type": "string", "format": "int64" } } } } }, "advertiserGroups": { "methods": { "update": { "description": "Updates an existing advertiser group.", "httpMethod": "PUT", "id": "dfareporting.advertiserGroups.update", "flatPath": "userprofiles/{userprofilesId}/advertiserGroups", "parameters": { "profileId": { "location": "path", "description": "User profile ID associated with this request.", "required": true, "pattern": "^[^/]+$", "format": "int64", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/advertiserGroups", "response": { "$ref": "AdvertiserGroup" }, "parameterOrder": [ "profileId" ], "request": { "$ref": "AdvertiserGroup" } }, "get": { "path": "userprofiles/{+profileId}/advertiserGroups/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.advertiserGroups.get", "httpMethod": "GET", "parameters": { "profileId": { "required": true, "type": "string", "format": "int64", "location": "path", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "id": { "format": "int64", "location": "path", "description": "Advertiser group ID.", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "response": { "$ref": "AdvertiserGroup" }, "flatPath": "userprofiles/{userprofilesId}/advertiserGroups/{advertiserGroupsId}", "description": "Gets one advertiser group by ID.", "parameterOrder": [ "profileId", "id" ] }, "delete": { "description": "Deletes an existing advertiser group.", "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "DELETE", "parameters": { "profileId": { "required": true, "description": "User profile ID associated with this request.", "location": "path", "type": "string", "pattern": "^[^/]+$", "format": "int64" }, "id": { "format": "int64", "type": "string", "location": "path", "description": "Advertiser group ID.", "required": true, "pattern": "^[^/]+$" } }, "id": "dfareporting.advertiserGroups.delete", "path": "userprofiles/{+profileId}/advertiserGroups/{+id}", "flatPath": "userprofiles/{userprofilesId}/advertiserGroups/{advertiserGroupsId}" }, "patch": { "parameters": { "id": { "type": "string", "location": "query", "description": "Required. Advertiser Group ID.", "required": true, "format": "int64" }, "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "format": "int64", "type": "string", "description": "User profile ID associated with this request." } }, "httpMethod": "PATCH", "description": "Updates an existing advertiser group. This method supports patch semantics.", "response": { "$ref": "AdvertiserGroup" }, "request": { "$ref": "AdvertiserGroup" }, "flatPath": "userprofiles/{userprofilesId}/advertiserGroups", "id": "dfareporting.advertiserGroups.patch", "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/advertiserGroups" }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "id": "dfareporting.advertiserGroups.list", "parameters": { "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "location": "query", "type": "string" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"advertiser*2015\" will return objects with names like \"advertiser group June 2015\", \"advertiser group April 2015\", or simply \"advertiser group 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"advertisergroup\" will match objects with name \"my advertisergroup\", \"advertisergroup 2015\", or simply \"advertisergroup\"." }, "ids": { "description": "Select only advertiser groups with these IDs.", "type": "string", "location": "query", "format": "int64", "repeated": true }, "profileId": { "description": "User profile ID associated with this request.", "location": "path", "required": true, "format": "int64", "pattern": "^[^/]+$", "type": "string" }, "sortOrder": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "default": "ASCENDING", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ] }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ], "location": "query", "default": "ID", "description": "Field by which to sort the list." }, "maxResults": { "default": "1000", "description": "Maximum number of results to return.", "type": "integer", "location": "query", "format": "int32" } }, "description": "Retrieves a list of advertiser groups, possibly filtered. This method supports paging.", "response": { "$ref": "AdvertiserGroupsListResponse" }, "flatPath": "userprofiles/{userprofilesId}/advertiserGroups", "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/advertiserGroups" }, "insert": { "response": { "$ref": "AdvertiserGroup" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "request": { "$ref": "AdvertiserGroup" }, "description": "Inserts a new advertiser group.", "flatPath": "userprofiles/{userprofilesId}/advertiserGroups", "httpMethod": "POST", "parameters": { "profileId": { "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string", "format": "int64", "description": "User profile ID associated with this request." } }, "path": "userprofiles/{+profileId}/advertiserGroups", "id": "dfareporting.advertiserGroups.insert" } } }, "userRolePermissionGroups": { "methods": { "get": { "description": "Gets one user role permission group by ID.", "parameters": { "profileId": { "pattern": "^[^/]+$", "format": "int64", "required": true, "description": "User profile ID associated with this request.", "location": "path", "type": "string" }, "id": { "format": "int64", "location": "path", "pattern": "^[^/]+$", "description": "User role permission group ID.", "type": "string", "required": true } }, "httpMethod": "GET", "path": "userprofiles/{+profileId}/userRolePermissionGroups/{+id}", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/userRolePermissionGroups/{userRolePermissionGroupsId}", "response": { "$ref": "UserRolePermissionGroup" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.userRolePermissionGroups.get" }, "list": { "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "type": "string", "required": true } }, "parameterOrder": [ "profileId" ], "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/userRolePermissionGroups", "description": "Gets a list of all supported user role permission groups.", "id": "dfareporting.userRolePermissionGroups.list", "response": { "$ref": "UserRolePermissionGroupsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/userRolePermissionGroups" } } }, "billingProfiles": { "methods": { "list": { "id": "dfareporting.billingProfiles.list", "path": "userprofiles/{+profileId}/billingProfiles", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/billingProfiles", "response": { "$ref": "BillingProfilesListResponse" }, "description": "Retrieves a list of billing profiles, possibly filtered. This method supports paging.", "parameters": { "profileId": { "format": "int64", "type": "string", "location": "path", "description": "User profile ID associated with this request.", "required": true, "pattern": "^[^/]+$" }, "status": { "type": "string", "enum": [ "UNDER_REVIEW", "ACTIVE", "ARCHIVED" ], "description": "Select only billing profile with the specified status.", "location": "query", "enumDescriptions": [ "", "", "" ], "repeated": true }, "subaccountIds": { "format": "int64", "description": "Select only billing profile with the specified subaccount.When only_suggestion is true, only a single subaccount_id is supported.", "repeated": true, "type": "string", "location": "query" }, "maxResults": { "format": "int32", "default": "1000", "type": "integer", "description": "Maximum number of results to return.", "location": "query" }, "onlySuggestion": { "type": "boolean", "description": "Select only billing profile which is suggested for the currency_code & subaccount_id using the Billing Suggestion API.", "location": "query" }, "ids": { "format": "int64", "type": "string", "repeated": true, "location": "query", "description": "Select only billing profile with these IDs." }, "sortField": { "location": "query", "description": "Field by which to sort the list.", "enumDescriptions": [ "", "" ], "default": "ID", "type": "string", "enum": [ "ID", "NAME" ] }, "currency_code": { "description": "Select only billing profile with currency.", "location": "query", "type": "string" }, "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "type": "string", "location": "query" }, "name": { "description": "Allows searching for billing profiles by name. Wildcards (*) are allowed. For example, \"profile*2020\" will return objects with names like \"profile June 2020\", \"profile April 2020\", or simply \"profile 2020\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"profile\" will match objects with name \"my profile\", \"profile 2021\", or simply \"profile\".", "type": "string", "location": "query" }, "sortOrder": { "description": "Order of sorted results.", "location": "query", "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ] } }, "httpMethod": "GET" }, "get": { "path": "userprofiles/{+profileId}/billingProfiles/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.billingProfiles.get", "response": { "$ref": "BillingProfile" }, "flatPath": "userprofiles/{userprofilesId}/billingProfiles/{billingProfilesId}", "parameterOrder": [ "profileId", "id" ], "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request.", "required": true, "location": "path", "format": "int64" }, "id": { "type": "string", "pattern": "^[^/]+$", "required": true, "format": "int64", "location": "path", "description": "Billing Profile ID." } }, "httpMethod": "GET", "description": "Gets one billing profile by ID." }, "update": { "parameterOrder": [ "profileId" ], "request": { "$ref": "BillingProfile" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "type": "string", "format": "int64", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true } }, "flatPath": "userprofiles/{userprofilesId}/billingProfiles", "httpMethod": "PUT", "id": "dfareporting.billingProfiles.update", "description": "Updates an existing billing profile.", "path": "userprofiles/{+profileId}/billingProfiles", "response": { "$ref": "BillingProfile" } } } }, "contentCategories": { "methods": { "update": { "parameterOrder": [ "profileId" ], "request": { "$ref": "ContentCategory" }, "flatPath": "userprofiles/{userprofilesId}/contentCategories", "response": { "$ref": "ContentCategory" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.contentCategories.update", "httpMethod": "PUT", "description": "Updates an existing content category.", "path": "userprofiles/{+profileId}/contentCategories", "parameters": { "profileId": { "required": true, "type": "string", "location": "path", "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request." } } }, "patch": { "path": "userprofiles/{+profileId}/contentCategories", "response": { "$ref": "ContentCategory" }, "description": "Updates an existing content category. This method supports patch semantics.", "request": { "$ref": "ContentCategory" }, "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.contentCategories.patch", "parameters": { "id": { "type": "string", "location": "query", "description": "Required. ContentCategory ID.", "format": "int64", "required": true }, "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "format": "int64" } }, "httpMethod": "PATCH", "flatPath": "userprofiles/{userprofilesId}/contentCategories" }, "delete": { "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" }, "id": { "type": "string", "description": "Content category ID.", "location": "path", "pattern": "^[^/]+$", "format": "int64", "required": true } }, "httpMethod": "DELETE", "parameterOrder": [ "profileId", "id" ], "description": "Deletes an existing content category.", "flatPath": "userprofiles/{userprofilesId}/contentCategories/{contentCategoriesId}", "id": "dfareporting.contentCategories.delete", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/contentCategories/{+id}" }, "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "ContentCategory" }, "parameterOrder": [ "profileId", "id" ], "path": "userprofiles/{+profileId}/contentCategories/{+id}", "description": "Gets one content category by ID.", "id": "dfareporting.contentCategories.get", "httpMethod": "GET", "parameters": { "id": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "Content category ID.", "type": "string", "format": "int64" }, "profileId": { "format": "int64", "location": "path", "required": true, "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/contentCategories/{contentCategoriesId}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.contentCategories.list", "flatPath": "userprofiles/{userprofilesId}/contentCategories", "httpMethod": "GET", "parameters": { "ids": { "type": "string", "location": "query", "description": "Select only content categories with these IDs.", "repeated": true, "format": "int64" }, "profileId": { "type": "string", "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "required": true, "pattern": "^[^/]+$" }, "maxResults": { "type": "integer", "location": "query", "description": "Maximum number of results to return.", "default": "1000", "format": "int32" }, "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "sortField": { "default": "ID", "description": "Field by which to sort the list.", "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ], "location": "query" }, "searchString": { "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"contentcategory*2015\" will return objects with names like \"contentcategory June 2015\", \"contentcategory April 2015\", or simply \"contentcategory 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"contentcategory\" will match objects with name \"my contentcategory\", \"contentcategory 2015\", or simply \"contentcategory\".", "type": "string" }, "sortOrder": { "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING", "description": "Order of sorted results." } }, "path": "userprofiles/{+profileId}/contentCategories", "parameterOrder": [ "profileId" ], "description": "Retrieves a list of content categories, possibly filtered. This method supports paging.", "response": { "$ref": "ContentCategoriesListResponse" } }, "insert": { "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "type": "string", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "request": { "$ref": "ContentCategory" }, "id": "dfareporting.contentCategories.insert", "httpMethod": "POST", "description": "Inserts a new content category.", "response": { "$ref": "ContentCategory" }, "path": "userprofiles/{+profileId}/contentCategories", "flatPath": "userprofiles/{userprofilesId}/contentCategories", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ] } } }, "advertisers": { "methods": { "insert": { "request": { "$ref": "Advertiser" }, "response": { "$ref": "Advertiser" }, "path": "userprofiles/{+profileId}/advertisers", "parameterOrder": [ "profileId" ], "id": "dfareporting.advertisers.insert", "description": "Inserts a new advertiser.", "flatPath": "userprofiles/{userprofilesId}/advertisers", "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "pattern": "^[^/]+$", "type": "string", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "POST" }, "patch": { "httpMethod": "PATCH", "response": { "$ref": "Advertiser" }, "parameters": { "profileId": { "location": "path", "format": "int64", "required": true, "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "type": "string" }, "id": { "format": "int64", "location": "query", "type": "string", "required": true, "description": "Required. Advertiser ID." } }, "description": "Updates an existing advertiser. This method supports patch semantics.", "id": "dfareporting.advertisers.patch", "request": { "$ref": "Advertiser" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/advertisers", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/advertisers" }, "update": { "parameters": { "profileId": { "location": "path", "pattern": "^[^/]+$", "required": true, "format": "int64", "type": "string", "description": "User profile ID associated with this request." } }, "description": "Updates an existing advertiser.", "id": "dfareporting.advertisers.update", "parameterOrder": [ "profileId" ], "httpMethod": "PUT", "response": { "$ref": "Advertiser" }, "path": "userprofiles/{+profileId}/advertisers", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/advertisers", "request": { "$ref": "Advertiser" } }, "get": { "parameters": { "id": { "pattern": "^[^/]+$", "description": "Advertiser ID.", "required": true, "format": "int64", "location": "path", "type": "string" }, "profileId": { "type": "string", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "location": "path", "format": "int64" } }, "response": { "$ref": "Advertiser" }, "description": "Gets one advertiser by ID.", "parameterOrder": [ "profileId", "id" ], "httpMethod": "GET", "path": "userprofiles/{+profileId}/advertisers/{+id}", "id": "dfareporting.advertisers.get", "flatPath": "userprofiles/{userprofilesId}/advertisers/{advertisersId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "list": { "id": "dfareporting.advertisers.list", "parameterOrder": [ "profileId" ], "response": { "$ref": "AdvertisersListResponse" }, "parameters": { "status": { "location": "query", "enumDescriptions": [ "Approved (ads can deliver)", "On-hold (all ads are stopped)" ], "description": "Select only advertisers with the specified status.", "type": "string", "enum": [ "APPROVED", "ON_HOLD" ] }, "profileId": { "required": true, "pattern": "^[^/]+$", "format": "int64", "location": "path", "description": "User profile ID associated with this request.", "type": "string" }, "subaccountId": { "description": "Select only advertisers with these subaccount IDs.", "format": "int64", "type": "string", "location": "query" }, "ids": { "repeated": true, "location": "query", "type": "string", "format": "int64", "description": "Select only advertisers with these IDs." }, "advertiserGroupIds": { "repeated": true, "location": "query", "description": "Select only advertisers with these advertiser group IDs.", "format": "int64", "type": "string" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"advertiser*2015\" will return objects with names like \"advertiser June 2015\", \"advertiser April 2015\", or simply \"advertiser 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"advertiser\" will match objects with name \"my advertiser\", \"advertiser 2015\", or simply \"advertiser\" ." }, "includeAdvertisersWithoutGroupsOnly": { "type": "boolean", "location": "query", "description": "Select only advertisers which do not belong to any advertiser group." }, "onlyParent": { "location": "query", "type": "boolean", "description": "Select only advertisers which use another advertiser's floodlight configuration." }, "sortField": { "description": "Field by which to sort the list.", "default": "ID", "location": "query", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "ID", "NAME" ] }, "floodlightConfigurationIds": { "format": "int64", "type": "string", "description": "Select only advertisers with these floodlight configuration IDs.", "repeated": true, "location": "query" }, "maxResults": { "location": "query", "description": "Maximum number of results to return.", "format": "int32", "type": "integer", "default": "1000" }, "pageToken": { "location": "query", "description": "Value of the nextPageToken from the previous result page.", "type": "string" }, "sortOrder": { "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ] } }, "flatPath": "userprofiles/{userprofilesId}/advertisers", "path": "userprofiles/{+profileId}/advertisers", "httpMethod": "GET", "description": "Retrieves a list of advertisers, possibly filtered. This method supports paging.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] } } }, "userProfiles": { "methods": { "list": { "description": "Retrieves list of user profiles for a user.", "id": "dfareporting.userProfiles.list", "flatPath": "userprofiles", "response": { "$ref": "UserProfileList" }, "parameters": {}, "scopes": [ "https://www.googleapis.com/auth/ddmconversions", "https://www.googleapis.com/auth/dfareporting", "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "path": "userprofiles", "parameterOrder": [] }, "get": { "response": { "$ref": "UserProfile" }, "parameters": { "profileId": { "location": "path", "type": "string", "required": true, "description": "The user profile ID.", "format": "int64" } }, "httpMethod": "GET", "id": "dfareporting.userProfiles.get", "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/ddmconversions", "https://www.googleapis.com/auth/dfareporting", "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{profileId}", "flatPath": "userprofiles/{profileId}", "description": "Gets one user profile by ID." } } }, "cities": { "methods": { "list": { "flatPath": "userprofiles/{userprofilesId}/cities", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of cities, possibly filtered.", "id": "dfareporting.cities.list", "httpMethod": "GET", "parameters": { "countryDartIds": { "location": "query", "description": "Select only cities from these countries.", "repeated": true, "type": "string", "format": "int64" }, "regionDartIds": { "format": "int64", "type": "string", "repeated": true, "location": "query", "description": "Select only cities from these regions." }, "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "format": "int64", "required": true, "description": "User profile ID associated with this request." }, "namePrefix": { "type": "string", "description": "Select only cities with names starting with this prefix.", "location": "query" }, "dartIds": { "format": "int64", "description": "Select only cities with these DART IDs.", "repeated": true, "type": "string", "location": "query" } }, "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/cities", "response": { "$ref": "CitiesListResponse" } } } }, "remarketingLists": { "methods": { "get": { "id": "dfareporting.remarketingLists.get", "response": { "$ref": "RemarketingList" }, "path": "userprofiles/{+profileId}/remarketingLists/{+id}", "httpMethod": "GET", "parameterOrder": [ "profileId", "id" ], "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "description": "User profile ID associated with this request.", "format": "int64" }, "id": { "type": "string", "description": "Remarketing list ID.", "format": "int64", "required": true, "pattern": "^[^/]+$", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one remarketing list by ID.", "flatPath": "userprofiles/{userprofilesId}/remarketingLists/{remarketingListsId}" }, "list": { "response": { "$ref": "RemarketingListsListResponse" }, "path": "userprofiles/{+profileId}/remarketingLists", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "advertiserId": { "description": "Required. Select only remarketing lists owned by this advertiser.", "required": true, "location": "query", "type": "string", "format": "int64" }, "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "type": "string", "location": "query" }, "floodlightActivityId": { "type": "string", "format": "int64", "description": "Select only remarketing lists that have this floodlight activity ID.", "location": "query" }, "sortOrder": { "default": "ASCENDING", "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "description": "Order of sorted results." }, "maxResults": { "description": "Maximum number of results to return.", "default": "1000", "location": "query", "type": "integer", "format": "int32" }, "active": { "type": "boolean", "description": "Select only active or only inactive remarketing lists.", "location": "query" }, "profileId": { "type": "string", "required": true, "format": "int64", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ], "location": "query", "default": "ID", "description": "Field by which to sort the list." }, "name": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"remarketing list*2015\" will return objects with names like \"remarketing list June 2015\", \"remarketing list April 2015\", or simply \"remarketing list 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"remarketing list\" will match objects with name \"my remarketing list\", \"remarketing list 2015\", or simply \"remarketing list\".", "location": "query", "type": "string" } }, "httpMethod": "GET", "id": "dfareporting.remarketingLists.list", "parameterOrder": [ "profileId", "advertiserId" ], "description": "Retrieves a list of remarketing lists, possibly filtered. This method supports paging.", "flatPath": "userprofiles/{userprofilesId}/remarketingLists" }, "update": { "description": "Updates an existing remarketing list.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/remarketingLists", "parameterOrder": [ "profileId" ], "response": { "$ref": "RemarketingList" }, "id": "dfareporting.remarketingLists.update", "request": { "$ref": "RemarketingList" }, "httpMethod": "PUT", "flatPath": "userprofiles/{userprofilesId}/remarketingLists", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "pattern": "^[^/]+$", "required": true, "type": "string", "location": "path" } } }, "patch": { "request": { "$ref": "RemarketingList" }, "httpMethod": "PATCH", "parameters": { "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64", "required": true }, "id": { "location": "query", "description": "Required. RemarketingList ID.", "format": "int64", "type": "string", "required": true } }, "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/remarketingLists", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "RemarketingList" }, "description": "Updates an existing remarketing list. This method supports patch semantics.", "path": "userprofiles/{+profileId}/remarketingLists", "id": "dfareporting.remarketingLists.patch" }, "insert": { "request": { "$ref": "RemarketingList" }, "response": { "$ref": "RemarketingList" }, "httpMethod": "POST", "id": "dfareporting.remarketingLists.insert", "description": "Inserts a new remarketing list.", "parameters": { "profileId": { "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request." } }, "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/remarketingLists", "flatPath": "userprofiles/{userprofilesId}/remarketingLists", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] } } }, "dynamicProfiles": { "methods": { "update": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "DynamicProfile" }, "request": { "$ref": "DynamicProfile" }, "httpMethod": "PUT", "parameterOrder": [], "parameters": {}, "path": "studio/dynamicProfiles", "description": "Updates an existing dynamic profile.", "flatPath": "studio/dynamicProfiles", "id": "dfareporting.dynamicProfiles.update" }, "insert": { "description": "Inserts a new dynamic profile.", "request": { "$ref": "DynamicProfile" }, "flatPath": "studio/dynamicProfiles", "parameterOrder": [], "response": { "$ref": "DynamicProfile" }, "id": "dfareporting.dynamicProfiles.insert", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": {}, "path": "studio/dynamicProfiles" }, "generateCode": { "flatPath": "studio/dynamicProfiles/{dynamicProfilesId}/generateCode", "parameters": { "dynamicProfileId": { "location": "path", "format": "int64", "pattern": "^[^/]+$", "description": "Required. Dynamic profile ID.", "required": true, "type": "string" } }, "parameterOrder": [ "dynamicProfileId" ], "httpMethod": "GET", "path": "studio/dynamicProfiles/{+dynamicProfileId}/generateCode", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.dynamicProfiles.generateCode", "response": { "$ref": "DynamicProfileGenerateCodeResponse" }, "description": "Generates code for a dynamic profile, which will need unescaping." }, "publish": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Publish for a dynamic profile.", "id": "dfareporting.dynamicProfiles.publish", "parameters": { "dynamicProfileId": { "type": "string", "description": "Required. Dynamic profile ID.", "location": "path", "required": true, "pattern": "^[^/]+$", "format": "int64" } }, "parameterOrder": [ "dynamicProfileId" ], "path": "studio/dynamicProfiles/{+dynamicProfileId}/publish", "flatPath": "studio/dynamicProfiles/{dynamicProfilesId}/publish" }, "get": { "description": "Gets a dynamic profile by ID.", "parameterOrder": [ "dynamicProfileId" ], "id": "dfareporting.dynamicProfiles.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "studio/dynamicProfiles/{+dynamicProfileId}", "response": { "$ref": "DynamicProfile" }, "flatPath": "studio/dynamicProfiles/{dynamicProfilesId}", "httpMethod": "GET", "parameters": { "dynamicProfileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "format": "int64", "type": "string", "description": "Required. Dynamic profile ID." } } } } }, "advertiserLandingPages": { "methods": { "patch": { "request": { "$ref": "LandingPage" }, "parameterOrder": [ "profileId", "id" ], "response": { "$ref": "LandingPage" }, "id": "dfareporting.advertiserLandingPages.patch", "path": "userprofiles/{+profileId}/advertiserLandingPages", "description": "Updates an existing landing page. This method supports patch semantics.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PATCH", "parameters": { "id": { "required": true, "type": "string", "location": "query", "format": "int64", "description": "Required. Landing Page ID." }, "profileId": { "format": "int64", "type": "string", "description": "User profile ID associated with this request.", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/advertiserLandingPages" }, "list": { "path": "userprofiles/{+profileId}/advertiserLandingPages", "id": "dfareporting.advertiserLandingPages.list", "flatPath": "userprofiles/{userprofilesId}/advertiserLandingPages", "parameterOrder": [ "profileId" ], "description": "Retrieves a list of landing pages.", "parameters": { "sortField": { "description": "Field by which to sort the list.", "location": "query", "default": "ID", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "ID", "NAME" ] }, "subaccountId": { "type": "string", "description": "Select only landing pages that belong to this subaccount.", "location": "query", "format": "int64" }, "archived": { "type": "boolean", "description": "Select only archived landing pages. Don't set this field to select both archived and non-archived landing pages.", "location": "query" }, "campaignIds": { "location": "query", "format": "int64", "repeated": true, "description": "Select only landing pages that are associated with these campaigns.", "type": "string" }, "profileId": { "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request.", "required": true, "location": "path", "type": "string" }, "sortOrder": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "ASCENDING", "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "description": "Order of sorted results." }, "advertiserIds": { "location": "query", "repeated": true, "type": "string", "description": "Select only landing pages that belong to these advertisers.", "format": "int64" }, "maxResults": { "description": "Maximum number of results to return.", "default": "1000", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "ids": { "repeated": true, "location": "query", "type": "string", "format": "int64", "description": "Select only landing pages with these IDs." }, "searchString": { "description": "Allows searching for landing pages by name or ID. Wildcards (*) are allowed. For example, \"landingpage*2017\" will return landing pages with names like \"landingpage July 2017\", \"landingpage March 2017\", or simply \"landingpage 2017\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"landingpage\" will match campaigns with name \"my landingpage\", \"landingpage 2015\", or simply \"landingpage\".", "location": "query", "type": "string" } }, "response": { "$ref": "AdvertiserLandingPagesListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET" }, "update": { "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path" } }, "request": { "$ref": "LandingPage" }, "parameterOrder": [ "profileId" ], "id": "dfareporting.advertiserLandingPages.update", "flatPath": "userprofiles/{userprofilesId}/advertiserLandingPages", "response": { "$ref": "LandingPage" }, "description": "Updates an existing landing page.", "path": "userprofiles/{+profileId}/advertiserLandingPages" }, "insert": { "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" } }, "id": "dfareporting.advertiserLandingPages.insert", "path": "userprofiles/{+profileId}/advertiserLandingPages", "httpMethod": "POST", "parameterOrder": [ "profileId" ], "description": "Inserts a new landing page.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "LandingPage" }, "flatPath": "userprofiles/{userprofilesId}/advertiserLandingPages", "request": { "$ref": "LandingPage" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.advertiserLandingPages.get", "path": "userprofiles/{+profileId}/advertiserLandingPages/{+id}", "response": { "$ref": "LandingPage" }, "parameterOrder": [ "profileId", "id" ], "parameters": { "id": { "format": "int64", "location": "path", "required": true, "description": "Landing page ID.", "type": "string", "pattern": "^[^/]+$" }, "profileId": { "location": "path", "type": "string", "required": true, "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } }, "flatPath": "userprofiles/{userprofilesId}/advertiserLandingPages/{advertiserLandingPagesId}", "httpMethod": "GET", "description": "Gets one landing page by ID." } } }, "accountPermissionGroups": { "methods": { "list": { "path": "userprofiles/{+profileId}/accountPermissionGroups", "flatPath": "userprofiles/{userprofilesId}/accountPermissionGroups", "parameterOrder": [ "profileId" ], "id": "dfareporting.accountPermissionGroups.list", "description": "Retrieves the list of account permission groups.", "response": { "$ref": "AccountPermissionGroupsListResponse" }, "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/accountPermissionGroups/{accountPermissionGroupsId}", "parameterOrder": [ "profileId", "id" ], "description": "Gets one account permission group by ID.", "httpMethod": "GET", "parameters": { "profileId": { "location": "path", "type": "string", "required": true, "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "id": { "location": "path", "type": "string", "format": "int64", "pattern": "^[^/]+$", "description": "Account permission group ID.", "required": true } }, "path": "userprofiles/{+profileId}/accountPermissionGroups/{+id}", "id": "dfareporting.accountPermissionGroups.get", "response": { "$ref": "AccountPermissionGroup" } } } }, "accountPermissions": { "methods": { "list": { "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/accountPermissions", "id": "dfareporting.accountPermissions.list", "description": "Retrieves the list of account permissions.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "location": "path", "type": "string", "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true } }, "path": "userprofiles/{+profileId}/accountPermissions", "response": { "$ref": "AccountPermissionsListResponse" } }, "get": { "httpMethod": "GET", "path": "userprofiles/{+profileId}/accountPermissions/{+id}", "parameterOrder": [ "profileId", "id" ], "parameters": { "id": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "Account permission ID.", "type": "string", "format": "int64" }, "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "location": "path", "format": "int64", "type": "string" } }, "response": { "$ref": "AccountPermission" }, "description": "Gets one account permission by ID.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/accountPermissions/{accountPermissionsId}", "id": "dfareporting.accountPermissions.get" } } }, "mobileApps": { "methods": { "get": { "path": "userprofiles/{+profileId}/mobileApps/{+id}", "parameters": { "profileId": { "type": "string", "location": "path", "required": true, "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "id": { "required": true, "location": "path", "pattern": "^[^/]+$", "description": "Mobile app ID.", "type": "string" } }, "httpMethod": "GET", "id": "dfareporting.mobileApps.get", "parameterOrder": [ "profileId", "id" ], "response": { "$ref": "MobileApp" }, "flatPath": "userprofiles/{userprofilesId}/mobileApps/{mobileAppsId}", "description": "Gets one mobile app by ID.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "list": { "parameters": { "profileId": { "pattern": "^[^/]+$", "format": "int64", "required": true, "description": "User profile ID associated with this request.", "location": "path", "type": "string" }, "searchString": { "location": "query", "type": "string", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"app*2015\" will return objects with names like \"app Jan 2018\", \"app Jan 2018\", or simply \"app 2018\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"app\" will match objects with name \"my app\", \"app 2018\", or simply \"app\"." }, "pageToken": { "type": "string", "location": "query", "description": "Value of the nextPageToken from the previous result page." }, "directories": { "type": "string", "enum": [ "UNKNOWN", "APPLE_APP_STORE", "GOOGLE_PLAY_STORE", "ROKU_APP_STORE", "AMAZON_FIRETV_APP_STORE", "PLAYSTATION_APP_STORE", "APPLE_TV_APP_STORE", "XBOX_APP_STORE", "SAMSUNG_TV_APP_STORE", "ANDROID_TV_APP_STORE", "GENERIC_CTV_APP_STORE" ], "location": "query", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "" ], "repeated": true, "description": "Select only apps from these directories." }, "ids": { "repeated": true, "location": "query", "description": "Select only apps with these IDs.", "type": "string" }, "maxResults": { "default": "1000", "description": "Maximum number of results to return.", "format": "int32", "type": "integer", "location": "query" } }, "description": "Retrieves list of available mobile apps.", "flatPath": "userprofiles/{userprofilesId}/mobileApps", "httpMethod": "GET", "path": "userprofiles/{+profileId}/mobileApps", "id": "dfareporting.mobileApps.list", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "response": { "$ref": "MobileAppsListResponse" } } } }, "videoFormats": { "methods": { "get": { "parameters": { "id": { "pattern": "^[^/]+$", "type": "integer", "format": "int32", "description": "Video format ID.", "required": true, "location": "path" }, "profileId": { "required": true, "pattern": "^[^/]+$", "format": "int64", "location": "path", "description": "User profile ID associated with this request.", "type": "string" } }, "httpMethod": "GET", "id": "dfareporting.videoFormats.get", "response": { "$ref": "VideoFormat" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/videoFormats/{videoFormatsId}", "path": "userprofiles/{+profileId}/videoFormats/{+id}", "description": "Gets one video format by ID.", "parameterOrder": [ "profileId", "id" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/videoFormats", "path": "userprofiles/{+profileId}/videoFormats", "parameters": { "profileId": { "type": "string", "required": true, "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64" } }, "parameterOrder": [ "profileId" ], "httpMethod": "GET", "description": "Lists available video formats.", "id": "dfareporting.videoFormats.list", "response": { "$ref": "VideoFormatsListResponse" } } } }, "operatingSystems": { "methods": { "list": { "description": "Retrieves a list of operating systems.", "flatPath": "userprofiles/{userprofilesId}/operatingSystems", "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64" } }, "id": "dfareporting.operatingSystems.list", "httpMethod": "GET", "response": { "$ref": "OperatingSystemsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/operatingSystems" }, "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "type": "string", "location": "path", "description": "User profile ID associated with this request.", "format": "int64" }, "dartId": { "type": "string", "required": true, "location": "path", "format": "int64", "description": "Operating system DART ID.", "pattern": "^[^/]+$" } }, "response": { "$ref": "OperatingSystem" }, "parameterOrder": [ "profileId", "dartId" ], "description": "Gets one operating system by DART ID.", "id": "dfareporting.operatingSystems.get", "flatPath": "userprofiles/{userprofilesId}/operatingSystems/{operatingSystemsId}", "path": "userprofiles/{+profileId}/operatingSystems/{+dartId}" } } }, "accounts": { "methods": { "patch": { "description": "Updates an existing account. This method supports patch semantics.", "parameterOrder": [ "profileId", "id" ], "response": { "$ref": "Account" }, "id": "dfareporting.accounts.patch", "flatPath": "userprofiles/{userprofilesId}/accounts", "request": { "$ref": "Account" }, "path": "userprofiles/{+profileId}/accounts", "httpMethod": "PATCH", "parameters": { "profileId": { "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string", "required": true, "description": "User profile ID associated with this request." }, "id": { "type": "string", "description": "Required. Account ID.", "format": "int64", "required": true, "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "get": { "flatPath": "userprofiles/{userprofilesId}/accounts/{accountsId}", "httpMethod": "GET", "id": "dfareporting.accounts.get", "parameters": { "id": { "pattern": "^[^/]+$", "format": "int64", "required": true, "location": "path", "description": "Account ID.", "type": "string" }, "profileId": { "type": "string", "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "pattern": "^[^/]+$", "required": true } }, "description": "Gets one account by ID.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ], "path": "userprofiles/{+profileId}/accounts/{+id}", "response": { "$ref": "Account" } }, "update": { "httpMethod": "PUT", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "format": "int64", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/accounts", "id": "dfareporting.accounts.update", "path": "userprofiles/{+profileId}/accounts", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Updates an existing account.", "parameterOrder": [ "profileId" ], "response": { "$ref": "Account" }, "request": { "$ref": "Account" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "AccountsListResponse" }, "parameterOrder": [ "profileId" ], "id": "dfareporting.accounts.list", "description": "Retrieves the list of accounts, possibly filtered. This method supports paging.", "path": "userprofiles/{+profileId}/accounts", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/accounts", "parameters": { "sortField": { "enumDescriptions": [ "", "" ], "location": "query", "description": "Field by which to sort the list.", "type": "string", "enum": [ "ID", "NAME" ], "default": "ID" }, "searchString": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"account*2015\" will return objects with names like \"account June 2015\", \"account April 2015\", or simply \"account 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"account\" will match objects with name \"my account\", \"account 2015\", or simply \"account\".", "type": "string", "location": "query" }, "active": { "location": "query", "description": "Select only active accounts. Don't set this field to select both active and non-active accounts.", "type": "boolean" }, "sortOrder": { "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "ASCENDING", "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query" }, "ids": { "location": "query", "repeated": true, "description": "Select only accounts with these IDs.", "type": "string", "format": "int64" }, "profileId": { "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "required": true, "type": "string", "location": "path", "format": "int64" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "maxResults": { "default": "1000", "format": "int32", "type": "integer", "description": "Maximum number of results to return.", "location": "query" } } } } }, "tvCampaignDetails": { "methods": { "get": { "flatPath": "userprofiles/{userprofilesId}/tvCampaignDetails/{tvCampaignDetailsId}", "parameterOrder": [ "profileId", "id" ], "response": { "$ref": "TvCampaignDetail" }, "description": "Gets one TvCampaignDetail by ID.", "path": "userprofiles/{+profileId}/tvCampaignDetails/{+id}", "id": "dfareporting.tvCampaignDetails.get", "parameters": { "tvDataProvider": { "type": "string", "enum": [ "INVALID_TV_DATA_PROVIDER", "INTAGE_JP", "IBOPE_AR", "IBOPE_BR", "IBOPE_CL", "IBOPE_CO", "TNS_VN", "COMSCORE_NATIONAL_US", "COMSCORE_CA", "SAMBA_AU" ], "description": "Optional. TV data provider. If not specified, defaults to `COMSCORE_NATIONAL_US`.", "location": "query", "enumDescriptions": [ "", "Allows populating multiple tvCampaignId filters and tvCampaignEndDate filter on the report.", "", "", "", "", "", "", "", "" ] }, "id": { "required": true, "description": "Required. TV Campaign ID.", "pattern": "^[^/]+$", "location": "path", "type": "string" }, "accountId": { "format": "int64", "location": "query", "type": "string", "description": "Required. Account ID associated with this request." }, "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "Required. User profile ID associated with this request.", "required": true, "format": "int64" }, "countryDartId": { "description": "Optional. Country Dart ID. If not specified, defaults to 256 (US).", "location": "query", "type": "string", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "GET" } } }, "changeLogs": { "methods": { "get": { "path": "userprofiles/{+profileId}/changeLogs/{+id}", "response": { "$ref": "ChangeLog" }, "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/changeLogs/{changeLogsId}", "description": "Gets one change log by ID.", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "User profile ID associated with this request.", "type": "string", "format": "int64" }, "id": { "required": true, "description": "Change log ID.", "location": "path", "type": "string", "pattern": "^[^/]+$", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ], "id": "dfareporting.changeLogs.get" }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "ChangeLogsListResponse" }, "parameterOrder": [ "profileId" ], "description": "Retrieves a list of change logs. This method supports paging.", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/changeLogs", "path": "userprofiles/{+profileId}/changeLogs", "parameters": { "action": { "location": "query", "description": "Select only change logs with the specified action.", "type": "string", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "enum": [ "ACTION_CREATE", "ACTION_UPDATE", "ACTION_DELETE", "ACTION_ENABLE", "ACTION_DISABLE", "ACTION_ADD", "ACTION_REMOVE", "ACTION_MARK_AS_DEFAULT", "ACTION_ASSOCIATE", "ACTION_ASSIGN", "ACTION_UNASSIGN", "ACTION_SEND", "ACTION_LINK", "ACTION_UNLINK", "ACTION_PUSH", "ACTION_EMAIL_TAGS", "ACTION_SHARE" ] }, "maxResults": { "default": "1000", "type": "integer", "format": "int32", "description": "Maximum number of results to return.", "location": "query" }, "userProfileIds": { "description": "Select only change logs with these user profile IDs.", "type": "string", "location": "query", "format": "int64", "repeated": true }, "maxChangeTime": { "type": "string", "description": "Select only change logs whose change time is before the specified maxChangeTime.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is \"2015-07-18T22:54:00-04:00\". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "searchString": { "location": "query", "type": "string", "description": "Select only change logs whose object ID, user name, old or new values match the search string." }, "objectType": { "location": "query", "description": "Select only change logs with the specified object type.", "type": "string", "enum": [ "OBJECT_ADVERTISER", "OBJECT_FLOODLIGHT_CONFIGURATION", "OBJECT_AD", "OBJECT_FLOODLIGHT_ACTVITY", "OBJECT_CAMPAIGN", "OBJECT_FLOODLIGHT_ACTIVITY_GROUP", "OBJECT_CREATIVE", "OBJECT_PLACEMENT", "OBJECT_DFA_SITE", "OBJECT_USER_ROLE", "OBJECT_USER_PROFILE", "OBJECT_ADVERTISER_GROUP", "OBJECT_ACCOUNT", "OBJECT_SUBACCOUNT", "OBJECT_RICHMEDIA_CREATIVE", "OBJECT_INSTREAM_CREATIVE", "OBJECT_MEDIA_ORDER", "OBJECT_CONTENT_CATEGORY", "OBJECT_PLACEMENT_STRATEGY", "OBJECT_SD_SITE", "OBJECT_SIZE", "OBJECT_CREATIVE_GROUP", "OBJECT_CREATIVE_ASSET", "OBJECT_USER_PROFILE_FILTER", "OBJECT_LANDING_PAGE", "OBJECT_CREATIVE_FIELD", "OBJECT_REMARKETING_LIST", "OBJECT_PROVIDED_LIST_CLIENT", "OBJECT_EVENT_TAG", "OBJECT_CREATIVE_BUNDLE", "OBJECT_BILLING_ACCOUNT_GROUP", "OBJECT_BILLING_FEATURE", "OBJECT_RATE_CARD", "OBJECT_ACCOUNT_BILLING_FEATURE", "OBJECT_BILLING_MINIMUM_FEE", "OBJECT_BILLING_PROFILE", "OBJECT_PLAYSTORE_LINK", "OBJECT_TARGETING_TEMPLATE", "OBJECT_SEARCH_LIFT_STUDY", "OBJECT_FLOODLIGHT_DV360_LINK", "OBJECT_ADVERTISER_CUSTOMER_LINK", "OBJECT_CONVERSION_DOMAIN", "OBJECT_ACCOUNT_CONVERSION_DOMAIN" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ] }, "objectIds": { "type": "string", "repeated": true, "location": "query", "format": "int64", "description": "Select only change logs with these object IDs." }, "profileId": { "type": "string", "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "location": "path" }, "ids": { "description": "Select only change logs with these IDs.", "location": "query", "type": "string", "format": "int64", "repeated": true }, "minChangeTime": { "type": "string", "description": "Select only change logs whose change time is after the specified minChangeTime.The time should be formatted as an RFC3339 date/time string. For example, for 10:54 PM on July 18th, 2015, in the America/New York time zone, the format is \"2015-07-18T22:54:00-04:00\". In other words, the year, month, day, the letter T, the hour (24-hour clock system), minute, second, and then the time zone offset.", "location": "query" } }, "id": "dfareporting.changeLogs.list" } } }, "eventTags": { "methods": { "update": { "flatPath": "userprofiles/{userprofilesId}/eventTags", "parameters": { "profileId": { "type": "string", "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "httpMethod": "PUT", "parameterOrder": [ "profileId" ], "id": "dfareporting.eventTags.update", "description": "Updates an existing event tag.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "EventTag" }, "path": "userprofiles/{+profileId}/eventTags", "response": { "$ref": "EventTag" } }, "delete": { "description": "Deletes an existing event tag.", "parameterOrder": [ "profileId", "id" ], "httpMethod": "DELETE", "path": "userprofiles/{+profileId}/eventTags/{+id}", "flatPath": "userprofiles/{userprofilesId}/eventTags/{eventTagsId}", "parameters": { "profileId": { "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$", "location": "path", "description": "User profile ID associated with this request." }, "id": { "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$", "location": "path", "description": "Event tag ID." } }, "id": "dfareporting.eventTags.delete", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "patch": { "path": "userprofiles/{+profileId}/eventTags", "response": { "$ref": "EventTag" }, "id": "dfareporting.eventTags.patch", "parameterOrder": [ "profileId", "id" ], "request": { "$ref": "EventTag" }, "httpMethod": "PATCH", "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string", "location": "path", "format": "int64", "required": true }, "id": { "required": true, "description": "Required. EventTag ID.", "type": "string", "location": "query", "format": "int64" } }, "flatPath": "userprofiles/{userprofilesId}/eventTags", "description": "Updates an existing event tag. This method supports patch semantics.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "required": true, "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "location": "path", "type": "string" }, "id": { "format": "int64", "required": true, "description": "Event tag ID.", "location": "path", "pattern": "^[^/]+$", "type": "string" } }, "response": { "$ref": "EventTag" }, "httpMethod": "GET", "id": "dfareporting.eventTags.get", "parameterOrder": [ "profileId", "id" ], "path": "userprofiles/{+profileId}/eventTags/{+id}", "flatPath": "userprofiles/{userprofilesId}/eventTags/{eventTagsId}", "description": "Gets one event tag by ID." }, "list": { "flatPath": "userprofiles/{userprofilesId}/eventTags", "path": "userprofiles/{+profileId}/eventTags", "parameterOrder": [ "profileId" ], "httpMethod": "GET", "parameters": { "adId": { "type": "string", "description": "Select only event tags that belong to this ad.", "location": "query", "format": "int64" }, "campaignId": { "type": "string", "location": "query", "format": "int64", "description": "Select only event tags that belong to this campaign." }, "sortField": { "location": "query", "default": "ID", "type": "string", "enum": [ "ID", "NAME" ], "description": "Field by which to sort the list.", "enumDescriptions": [ "", "" ] }, "definitionsOnly": { "description": "Examine only the specified campaign or advertiser's event tags for matching selector criteria. When set to false, the parent advertiser and parent campaign of the specified ad or campaign is examined as well. In addition, when set to false, the status field is examined as well, along with the enabledByDefault field. This parameter can not be set to true when adId is specified as ads do not define their own even tags.", "location": "query", "type": "boolean" }, "profileId": { "description": "User profile ID associated with this request.", "type": "string", "location": "path", "pattern": "^[^/]+$", "format": "int64", "required": true }, "enabled": { "type": "boolean", "description": "Select only enabled event tags. What is considered enabled or disabled depends on the definitionsOnly parameter. When definitionsOnly is set to true, only the specified advertiser or campaign's event tags' enabledByDefault field is examined. When definitionsOnly is set to false, the specified ad or specified campaign's parent advertiser's or parent campaign's event tags' enabledByDefault and status fields are examined as well.", "location": "query" }, "advertiserId": { "description": "Select only event tags that belong to this advertiser.", "format": "int64", "type": "string", "location": "query" }, "searchString": { "type": "string", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"eventtag*2015\" will return objects with names like \"eventtag June 2015\", \"eventtag April 2015\", or simply \"eventtag 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"eventtag\" will match objects with name \"my eventtag\", \"eventtag 2015\", or simply \"eventtag\".", "location": "query" }, "sortOrder": { "default": "ASCENDING", "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "description": "Order of sorted results.", "location": "query" }, "eventTagTypes": { "description": "Select only event tags with the specified event tag types. Event tag types can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking.", "location": "query", "repeated": true, "enumDescriptions": [ "A third-party pixel for impression tracking.", "A third-party JavaScript URL for impression tracking.", "A third-party URL for click tracking that redirects to the landing page." ], "type": "string", "enum": [ "IMPRESSION_IMAGE_EVENT_TAG", "IMPRESSION_JAVASCRIPT_EVENT_TAG", "CLICK_THROUGH_EVENT_TAG" ] }, "ids": { "format": "int64", "description": "Select only event tags with these IDs.", "repeated": true, "type": "string", "location": "query" } }, "id": "dfareporting.eventTags.list", "response": { "$ref": "EventTagsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of event tags, possibly filtered." }, "insert": { "httpMethod": "POST", "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "required": true, "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "EventTag" }, "description": "Inserts a new event tag.", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/eventTags", "path": "userprofiles/{+profileId}/eventTags", "request": { "$ref": "EventTag" }, "id": "dfareporting.eventTags.insert" } } }, "creativeFieldValues": { "methods": { "insert": { "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request." }, "creativeFieldId": { "type": "string", "description": "Creative field ID for this creative field value.", "pattern": "^[^/]+$", "location": "path", "required": true, "format": "int64" } }, "httpMethod": "POST", "request": { "$ref": "CreativeFieldValue" }, "response": { "$ref": "CreativeFieldValue" }, "id": "dfareporting.creativeFieldValues.insert", "parameterOrder": [ "profileId", "creativeFieldId" ], "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues", "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Inserts a new creative field value." }, "update": { "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues", "response": { "$ref": "CreativeFieldValue" }, "request": { "$ref": "CreativeFieldValue" }, "parameters": { "profileId": { "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64", "required": true, "pattern": "^[^/]+$" }, "creativeFieldId": { "description": "Creative field ID for this creative field value.", "pattern": "^[^/]+$", "format": "int64", "required": true, "type": "string", "location": "path" } }, "parameterOrder": [ "profileId", "creativeFieldId" ], "httpMethod": "PUT", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.creativeFieldValues.update", "description": "Updates an existing creative field value.", "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues" }, "get": { "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string" }, "id": { "description": "Creative Field Value ID", "location": "path", "format": "int64", "pattern": "^[^/]+$", "type": "string", "required": true }, "creativeFieldId": { "format": "int64", "required": true, "description": "Creative field ID for this creative field value.", "location": "path", "pattern": "^[^/]+$", "type": "string" } }, "description": "Gets one creative field value by ID.", "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues/{creativeFieldValuesId}", "httpMethod": "GET", "id": "dfareporting.creativeFieldValues.get", "parameterOrder": [ "profileId", "creativeFieldId", "id" ], "response": { "$ref": "CreativeFieldValue" }, "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "delete": { "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues/{creativeFieldValuesId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "DELETE", "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues/{+id}", "description": "Deletes an existing creative field value.", "parameters": { "id": { "format": "int64", "description": "Creative Field Value ID", "location": "path", "type": "string", "pattern": "^[^/]+$", "required": true }, "creativeFieldId": { "required": true, "format": "int64", "pattern": "^[^/]+$", "location": "path", "description": "Creative field ID for this creative field value.", "type": "string" }, "profileId": { "location": "path", "type": "string", "required": true, "format": "int64", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } }, "id": "dfareporting.creativeFieldValues.delete", "parameterOrder": [ "profileId", "creativeFieldId", "id" ] }, "list": { "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues", "id": "dfareporting.creativeFieldValues.list", "parameters": { "sortOrder": { "default": "ASCENDING", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ] }, "creativeFieldId": { "location": "path", "required": true, "description": "Creative field ID for this creative field value.", "pattern": "^[^/]+$", "format": "int64", "type": "string" }, "sortField": { "location": "query", "type": "string", "enum": [ "ID", "VALUE" ], "default": "ID", "enumDescriptions": [ "", "" ], "description": "Field by which to sort the list." }, "maxResults": { "default": "1000", "location": "query", "type": "integer", "description": "Maximum number of results to return.", "format": "int32" }, "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "searchString": { "location": "query", "type": "string", "description": "Allows searching for creative field values by their values. Wildcards (e.g. *) are not allowed." }, "profileId": { "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64" }, "ids": { "format": "int64", "type": "string", "repeated": true, "location": "query", "description": "Select only creative field values with these IDs." } }, "httpMethod": "GET", "parameterOrder": [ "profileId", "creativeFieldId" ], "description": "Retrieves a list of creative field values, possibly filtered. This method supports paging.", "response": { "$ref": "CreativeFieldValuesListResponse" }, "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "patch": { "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/creativeFields/{creativeFieldsId}/creativeFieldValues", "parameters": { "profileId": { "required": true, "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "type": "string" }, "creativeFieldId": { "format": "int64", "type": "string", "location": "path", "description": "CreativeField ID.", "required": true, "pattern": "^[^/]+$" }, "id": { "format": "int64", "required": true, "location": "query", "type": "string", "description": "CreativeFieldValue ID." } }, "id": "dfareporting.creativeFieldValues.patch", "description": "Updates an existing creative field value. This method supports patch semantics.", "parameterOrder": [ "profileId", "creativeFieldId", "id" ], "path": "userprofiles/{+profileId}/creativeFields/{+creativeFieldId}/creativeFieldValues", "request": { "$ref": "CreativeFieldValue" }, "response": { "$ref": "CreativeFieldValue" } } } }, "dynamicTargetingKeys": { "methods": { "insert": { "response": { "$ref": "DynamicTargetingKey" }, "id": "dfareporting.dynamicTargetingKeys.insert", "httpMethod": "POST", "parameterOrder": [ "profileId" ], "description": "Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There is a maximum of 1000 keys per advertiser, out of which a maximum of 20 keys can be assigned per ad, creative, or placement.", "parameters": { "profileId": { "location": "path", "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/dynamicTargetingKeys", "request": { "$ref": "DynamicTargetingKey" }, "flatPath": "userprofiles/{userprofilesId}/dynamicTargetingKeys" }, "list": { "id": "dfareporting.dynamicTargetingKeys.list", "flatPath": "userprofiles/{userprofilesId}/dynamicTargetingKeys", "parameterOrder": [ "profileId" ], "httpMethod": "GET", "path": "userprofiles/{+profileId}/dynamicTargetingKeys", "parameters": { "names": { "type": "string", "description": "Select only dynamic targeting keys exactly matching these names.", "location": "query", "repeated": true }, "profileId": { "format": "int64", "pattern": "^[^/]+$", "required": true, "type": "string", "description": "User profile ID associated with this request.", "location": "path" }, "objectId": { "description": "Select only dynamic targeting keys with this object ID.", "format": "int64", "type": "string", "location": "query" }, "objectType": { "type": "string", "enum": [ "OBJECT_ADVERTISER", "OBJECT_AD", "OBJECT_CREATIVE", "OBJECT_PLACEMENT" ], "description": "Select only dynamic targeting keys with this object type.", "enumDescriptions": [ "", "", "", "" ], "location": "query" }, "advertiserId": { "location": "query", "type": "string", "format": "int64", "description": "Select only dynamic targeting keys whose object has this advertiser ID." } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of dynamic targeting keys.", "response": { "$ref": "DynamicTargetingKeysListResponse" } }, "delete": { "id": "dfareporting.dynamicTargetingKeys.delete", "path": "userprofiles/{+profileId}/dynamicTargetingKeys/{+objectId}", "description": "Deletes an existing dynamic targeting key.", "parameterOrder": [ "profileId", "objectId", "name", "objectType" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "location": "path", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" }, "name": { "type": "string", "location": "query", "required": true, "description": "Required. Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase." }, "objectType": { "description": "Required. Type of the object of this dynamic targeting key. This is a required field.", "required": true, "enumDescriptions": [ "", "", "", "" ], "location": "query", "type": "string", "enum": [ "OBJECT_ADVERTISER", "OBJECT_AD", "OBJECT_CREATIVE", "OBJECT_PLACEMENT" ] }, "objectId": { "required": true, "type": "string", "description": "ID of the object of this dynamic targeting key. This is a required field.", "location": "path", "format": "int64", "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/dynamicTargetingKeys/{dynamicTargetingKeysId}", "httpMethod": "DELETE" } } }, "creativeGroups": { "methods": { "insert": { "path": "userprofiles/{+profileId}/creativeGroups", "id": "dfareporting.creativeGroups.insert", "response": { "$ref": "CreativeGroup" }, "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "description": "User profile ID associated with this request.", "format": "int64" } }, "flatPath": "userprofiles/{userprofilesId}/creativeGroups", "parameterOrder": [ "profileId" ], "description": "Inserts a new creative group.", "httpMethod": "POST", "request": { "$ref": "CreativeGroup" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "list": { "id": "dfareporting.creativeGroups.list", "response": { "$ref": "CreativeGroupsListResponse" }, "parameters": { "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "type": "string", "location": "query" }, "sortOrder": { "default": "ASCENDING", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query" }, "searchString": { "description": "Allows searching for creative groups by name or ID. Wildcards (*) are allowed. For example, \"creativegroup*2015\" will return creative groups with names like \"creativegroup June 2015\", \"creativegroup April 2015\", or simply \"creativegroup 2015\". Most of the searches also add wild-cards implicitly at the start and the end of the search string. For example, a search string of \"creativegroup\" will match creative groups with the name \"my creativegroup\", \"creativegroup 2015\", or simply \"creativegroup\".", "type": "string", "location": "query" }, "advertiserIds": { "description": "Select only creative groups that belong to these advertisers.", "location": "query", "repeated": true, "type": "string", "format": "int64" }, "groupNumber": { "location": "query", "format": "int32", "description": "Select only creative groups that belong to this subgroup.", "type": "integer" }, "profileId": { "required": true, "pattern": "^[^/]+$", "type": "string", "location": "path", "description": "User profile ID associated with this request.", "format": "int64" }, "maxResults": { "location": "query", "type": "integer", "format": "int32", "default": "1000", "description": "Maximum number of results to return." }, "ids": { "description": "Select only creative groups with these IDs.", "format": "int64", "location": "query", "type": "string", "repeated": true }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "default": "ID", "enumDescriptions": [ "", "" ], "location": "query", "description": "Field by which to sort the list." } }, "flatPath": "userprofiles/{userprofilesId}/creativeGroups", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/creativeGroups", "description": "Retrieves a list of creative groups, possibly filtered. This method supports paging.", "parameterOrder": [ "profileId" ] }, "patch": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Updates an existing creative group. This method supports patch semantics.", "flatPath": "userprofiles/{userprofilesId}/creativeGroups", "request": { "$ref": "CreativeGroup" }, "id": "dfareporting.creativeGroups.patch", "path": "userprofiles/{+profileId}/creativeGroups", "response": { "$ref": "CreativeGroup" }, "parameterOrder": [ "profileId", "id" ], "httpMethod": "PATCH", "parameters": { "id": { "description": "Required. Creative Group ID.", "type": "string", "required": true, "format": "int64", "location": "query" }, "profileId": { "description": "User profile ID associated with this request.", "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$" } } }, "get": { "response": { "$ref": "CreativeGroup" }, "path": "userprofiles/{+profileId}/creativeGroups/{+id}", "description": "Gets one creative group by ID.", "parameterOrder": [ "profileId", "id" ], "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/creativeGroups/{creativeGroupsId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "id": { "pattern": "^[^/]+$", "type": "string", "description": "Creative group ID.", "required": true, "location": "path", "format": "int64" }, "profileId": { "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "format": "int64", "required": true } }, "id": "dfareporting.creativeGroups.get" }, "update": { "flatPath": "userprofiles/{userprofilesId}/creativeGroups", "id": "dfareporting.creativeGroups.update", "parameterOrder": [ "profileId" ], "request": { "$ref": "CreativeGroup" }, "description": "Updates an existing creative group.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/creativeGroups", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "httpMethod": "PUT", "response": { "$ref": "CreativeGroup" } } } }, "campaignCreativeAssociations": { "methods": { "list": { "description": "Retrieves the list of creative IDs associated with the specified campaign. This method supports paging.", "flatPath": "userprofiles/{userprofilesId}/campaigns/{campaignsId}/campaignCreativeAssociations", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.campaignCreativeAssociations.list", "path": "userprofiles/{+profileId}/campaigns/{+campaignId}/campaignCreativeAssociations", "response": { "$ref": "CampaignCreativeAssociationsListResponse" }, "parameters": { "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "type": "string", "location": "query" }, "campaignId": { "location": "path", "description": "Campaign ID in this association.", "pattern": "^[^/]+$", "type": "string", "format": "int64", "required": true }, "profileId": { "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request.", "required": true, "location": "path" }, "sortOrder": { "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "default": "ASCENDING", "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ] }, "maxResults": { "default": "1000", "type": "integer", "location": "query", "description": "Maximum number of results to return.", "format": "int32" } }, "parameterOrder": [ "profileId", "campaignId" ], "httpMethod": "GET" }, "insert": { "request": { "$ref": "CampaignCreativeAssociation" }, "flatPath": "userprofiles/{userprofilesId}/campaigns/{campaignsId}/campaignCreativeAssociations", "httpMethod": "POST", "description": "Associates a creative with the specified campaign. This method creates a default ad with dimensions matching the creative in the campaign if such a default ad does not exist already.", "parameters": { "campaignId": { "type": "string", "format": "int64", "pattern": "^[^/]+$", "description": "Campaign ID in this association.", "required": true, "location": "path" }, "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "format": "int64", "location": "path", "description": "User profile ID associated with this request." } }, "id": "dfareporting.campaignCreativeAssociations.insert", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "campaignId" ], "response": { "$ref": "CampaignCreativeAssociation" }, "path": "userprofiles/{+profileId}/campaigns/{+campaignId}/campaignCreativeAssociations" } } }, "userRoles": { "methods": { "insert": { "flatPath": "userprofiles/{userprofilesId}/userRoles", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "UserRole" }, "description": "Inserts a new user role.", "httpMethod": "POST", "path": "userprofiles/{+profileId}/userRoles", "parameters": { "profileId": { "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "required": true, "type": "string", "format": "int64", "location": "path" } }, "parameterOrder": [ "profileId" ], "response": { "$ref": "UserRole" }, "id": "dfareporting.userRoles.insert" }, "get": { "path": "userprofiles/{+profileId}/userRoles/{+id}", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/userRoles/{userRolesId}", "id": "dfareporting.userRoles.get", "httpMethod": "GET", "description": "Gets one user role by ID.", "response": { "$ref": "UserRole" }, "parameters": { "profileId": { "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "location": "path", "type": "string", "format": "int64", "required": true }, "id": { "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path", "format": "int64", "description": "User role ID." } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "update": { "parameterOrder": [ "profileId" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Updates an existing user role.", "httpMethod": "PUT", "id": "dfareporting.userRoles.update", "flatPath": "userprofiles/{userprofilesId}/userRoles", "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "description": "User profile ID associated with this request.", "location": "path", "format": "int64" } }, "response": { "$ref": "UserRole" }, "path": "userprofiles/{+profileId}/userRoles", "request": { "$ref": "UserRole" } }, "delete": { "path": "userprofiles/{+profileId}/userRoles/{+id}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.userRoles.delete", "flatPath": "userprofiles/{userprofilesId}/userRoles/{userRolesId}", "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "location": "path", "format": "int64", "required": true, "description": "User profile ID associated with this request." }, "id": { "description": "User role ID.", "required": true, "pattern": "^[^/]+$", "location": "path", "type": "string", "format": "int64" } }, "parameterOrder": [ "profileId", "id" ], "httpMethod": "DELETE", "description": "Deletes an existing user role." }, "list": { "parameterOrder": [ "profileId" ], "response": { "$ref": "UserRolesListResponse" }, "path": "userprofiles/{+profileId}/userRoles", "id": "dfareporting.userRoles.list", "description": "Retrieves a list of user roles, possibly filtered. This method supports paging.", "parameters": { "sortOrder": { "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "description": "Order of sorted results.", "default": "ASCENDING" }, "ids": { "type": "string", "format": "int64", "description": "Select only user roles with the specified IDs.", "repeated": true, "location": "query" }, "subaccountId": { "description": "Select only user roles that belong to this subaccount.", "location": "query", "type": "string", "format": "int64" }, "maxResults": { "description": "Maximum number of results to return.", "location": "query", "format": "int32", "type": "integer", "default": "1000" }, "pageToken": { "type": "string", "location": "query", "description": "Value of the nextPageToken from the previous result page." }, "accountUserRoleOnly": { "description": "Select only account level user roles not associated with any specific subaccount.", "location": "query", "type": "boolean" }, "sortField": { "enumDescriptions": [ "", "" ], "location": "query", "description": "Field by which to sort the list.", "default": "ID", "type": "string", "enum": [ "ID", "NAME" ] }, "profileId": { "location": "path", "format": "int64", "required": true, "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"userrole*2015\" will return objects with names like \"userrole June 2015\", \"userrole April 2015\", or simply \"userrole 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"userrole\" will match objects with name \"my userrole\", \"userrole 2015\", or simply \"userrole\"." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/userRoles" }, "patch": { "flatPath": "userprofiles/{userprofilesId}/userRoles", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ], "request": { "$ref": "UserRole" }, "httpMethod": "PATCH", "id": "dfareporting.userRoles.patch", "parameters": { "profileId": { "location": "path", "description": "User profile ID associated with this request.", "required": true, "format": "int64", "pattern": "^[^/]+$", "type": "string" }, "id": { "format": "int64", "description": "Required. UserRole ID.", "required": true, "type": "string", "location": "query" } }, "path": "userprofiles/{+profileId}/userRoles", "description": "Updates an existing user role. This method supports patch semantics.", "response": { "$ref": "UserRole" } } } }, "directorySites": { "methods": { "get": { "parameterOrder": [ "profileId", "id" ], "description": "Gets one directory site by ID.", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/directorySites/{directorySitesId}", "id": "dfareporting.directorySites.get", "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "format": "int64", "pattern": "^[^/]+$", "required": true, "location": "path" }, "id": { "location": "path", "description": "Directory site ID.", "type": "string", "required": true, "pattern": "^[^/]+$", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/directorySites/{+id}", "response": { "$ref": "DirectorySite" } }, "insert": { "response": { "$ref": "DirectorySite" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/directorySites", "parameterOrder": [ "profileId" ], "httpMethod": "POST", "parameters": { "profileId": { "type": "string", "pattern": "^[^/]+$", "format": "int64", "required": true, "location": "path", "description": "User profile ID associated with this request." } }, "request": { "$ref": "DirectorySite" }, "id": "dfareporting.directorySites.insert", "path": "userprofiles/{+profileId}/directorySites", "description": "Inserts a new directory site." }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "id": "dfareporting.directorySites.list", "response": { "$ref": "DirectorySitesListResponse" }, "path": "userprofiles/{+profileId}/directorySites", "flatPath": "userprofiles/{userprofilesId}/directorySites", "description": "Retrieves a list of directory sites, possibly filtered. This method supports paging.", "httpMethod": "GET", "parameters": { "profileId": { "location": "path", "required": true, "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" }, "ids": { "location": "query", "type": "string", "repeated": true, "format": "int64", "description": "Select only directory sites with these IDs." }, "dfpNetworkCode": { "type": "string", "description": "Select only directory sites with this Ad Manager network code.", "location": "query" }, "acceptsInStreamVideoPlacements": { "description": "This search filter is no longer supported and will have no effect on the results returned.", "type": "boolean", "location": "query" }, "sortField": { "description": "Field by which to sort the list.", "type": "string", "enum": [ "ID", "NAME" ], "location": "query", "default": "ID", "enumDescriptions": [ "", "" ] }, "maxResults": { "format": "int32", "description": "Maximum number of results to return.", "location": "query", "type": "integer", "default": "1000" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name, ID or URL. Wildcards (*) are allowed. For example, \"directory site*2015\" will return objects with names like \"directory site June 2015\", \"directory site April 2015\", or simply \"directory site 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"directory site\" will match objects with name \"my directory site\", \"directory site 2015\" or simply, \"directory site\"." }, "pageToken": { "type": "string", "description": "Value of the nextPageToken from the previous result page.", "location": "query" }, "acceptsInterstitialPlacements": { "location": "query", "type": "boolean", "description": "This search filter is no longer supported and will have no effect on the results returned." }, "sortOrder": { "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING", "location": "query", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ] }, "active": { "location": "query", "description": "Select only active directory sites. Leave blank to retrieve both active and inactive directory sites.", "type": "boolean" }, "acceptsPublisherPaidPlacements": { "type": "boolean", "description": "Select only directory sites that accept publisher paid placements. This field can be left blank.", "location": "query" } } } } }, "subaccounts": { "methods": { "patch": { "request": { "$ref": "Subaccount" }, "id": "dfareporting.subaccounts.patch", "path": "userprofiles/{+profileId}/subaccounts", "flatPath": "userprofiles/{userprofilesId}/subaccounts", "parameterOrder": [ "profileId", "id" ], "description": "Updates an existing subaccount. This method supports patch semantics.", "response": { "$ref": "Subaccount" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "httpMethod": "PATCH", "parameters": { "id": { "location": "query", "type": "string", "description": "Required. Subaccount ID.", "format": "int64", "required": true }, "profileId": { "required": true, "format": "int64", "location": "path", "type": "string", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } } }, "list": { "description": "Gets a list of subaccounts, possibly filtered. This method supports paging.", "id": "dfareporting.subaccounts.list", "response": { "$ref": "SubaccountsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/subaccounts", "parameters": { "sortOrder": { "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "default": "ASCENDING", "description": "Order of sorted results.", "location": "query" }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "location": "query", "default": "ID", "description": "Field by which to sort the list.", "enumDescriptions": [ "", "" ] }, "searchString": { "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"subaccount*2015\" will return objects with names like \"subaccount June 2015\", \"subaccount April 2015\", or simply \"subaccount 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"subaccount\" will match objects with name \"my subaccount\", \"subaccount 2015\", or simply \"subaccount\" .", "type": "string", "location": "query" }, "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "type": "string", "location": "query" }, "ids": { "repeated": true, "location": "query", "type": "string", "format": "int64", "description": "Select only subaccounts with these IDs." }, "profileId": { "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "location": "path", "type": "string", "format": "int64" }, "maxResults": { "location": "query", "description": "Maximum number of results to return.", "format": "int32", "type": "integer", "default": "1000" } }, "flatPath": "userprofiles/{userprofilesId}/subaccounts", "httpMethod": "GET" }, "insert": { "response": { "$ref": "Subaccount" }, "request": { "$ref": "Subaccount" }, "description": "Inserts a new subaccount.", "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "location": "path", "format": "int64", "type": "string" } }, "id": "dfareporting.subaccounts.insert", "flatPath": "userprofiles/{userprofilesId}/subaccounts", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/subaccounts" }, "update": { "flatPath": "userprofiles/{userprofilesId}/subaccounts", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Updates an existing subaccount.", "id": "dfareporting.subaccounts.update", "httpMethod": "PUT", "parameterOrder": [ "profileId" ], "path": "userprofiles/{+profileId}/subaccounts", "response": { "$ref": "Subaccount" }, "parameters": { "profileId": { "location": "path", "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." } }, "request": { "$ref": "Subaccount" } }, "get": { "id": "dfareporting.subaccounts.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/subaccounts/{subaccountsId}", "parameterOrder": [ "profileId", "id" ], "description": "Gets one subaccount by ID.", "response": { "$ref": "Subaccount" }, "parameters": { "profileId": { "location": "path", "required": true, "format": "int64", "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request." }, "id": { "location": "path", "description": "Subaccount ID.", "format": "int64", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "httpMethod": "GET", "path": "userprofiles/{+profileId}/subaccounts/{+id}" } } }, "placementStrategies": { "methods": { "insert": { "path": "userprofiles/{+profileId}/placementStrategies", "flatPath": "userprofiles/{userprofilesId}/placementStrategies", "request": { "$ref": "PlacementStrategy" }, "parameters": { "profileId": { "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "format": "int64", "required": true, "type": "string", "location": "path" } }, "response": { "$ref": "PlacementStrategy" }, "parameterOrder": [ "profileId" ], "id": "dfareporting.placementStrategies.insert", "httpMethod": "POST", "description": "Inserts a new placement strategy.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "patch": { "httpMethod": "PATCH", "description": "Updates an existing placement strategy. This method supports patch semantics.", "parameters": { "profileId": { "format": "int64", "description": "User profile ID associated with this request.", "required": true, "type": "string", "location": "path", "pattern": "^[^/]+$" }, "id": { "location": "query", "type": "string", "description": "Required. PlacementStrategy ID.", "required": true, "format": "int64" } }, "request": { "$ref": "PlacementStrategy" }, "path": "userprofiles/{+profileId}/placementStrategies", "flatPath": "userprofiles/{userprofilesId}/placementStrategies", "response": { "$ref": "PlacementStrategy" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.placementStrategies.patch", "parameterOrder": [ "profileId", "id" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "PlacementStrategiesListResponse" }, "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Value of the nextPageToken from the previous result page." }, "ids": { "description": "Select only placement strategies with these IDs.", "repeated": true, "location": "query", "format": "int64", "type": "string" }, "profileId": { "location": "path", "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "type": "string" }, "sortOrder": { "enumDescriptions": [ "Ascending order.", "Descending order." ], "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "description": "Order of sorted results.", "default": "ASCENDING", "location": "query" }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"placementstrategy*2015\" will return objects with names like \"placementstrategy June 2015\", \"placementstrategy April 2015\", or simply \"placementstrategy 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"placementstrategy\" will match objects with name \"my placementstrategy\", \"placementstrategy 2015\", or simply \"placementstrategy\"." }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "default": "ID", "description": "Field by which to sort the list.", "location": "query", "enumDescriptions": [ "", "" ] }, "maxResults": { "default": "1000", "location": "query", "description": "Maximum number of results to return.", "format": "int32", "type": "integer" } }, "id": "dfareporting.placementStrategies.list", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/placementStrategies", "path": "userprofiles/{+profileId}/placementStrategies", "description": "Retrieves a list of placement strategies, possibly filtered. This method supports paging." }, "get": { "parameterOrder": [ "profileId", "id" ], "id": "dfareporting.placementStrategies.get", "path": "userprofiles/{+profileId}/placementStrategies/{+id}", "response": { "$ref": "PlacementStrategy" }, "parameters": { "profileId": { "format": "int64", "required": true, "description": "User profile ID associated with this request.", "location": "path", "type": "string", "pattern": "^[^/]+$" }, "id": { "format": "int64", "location": "path", "required": true, "pattern": "^[^/]+$", "description": "Placement strategy ID.", "type": "string" } }, "description": "Gets one placement strategy by ID.", "flatPath": "userprofiles/{userprofilesId}/placementStrategies/{placementStrategiesId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "delete": { "flatPath": "userprofiles/{userprofilesId}/placementStrategies/{placementStrategiesId}", "path": "userprofiles/{+profileId}/placementStrategies/{+id}", "parameterOrder": [ "profileId", "id" ], "parameters": { "profileId": { "location": "path", "required": true, "format": "int64", "type": "string", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "id": { "description": "Placement strategy ID.", "format": "int64", "type": "string", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "id": "dfareporting.placementStrategies.delete", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Deletes an existing placement strategy.", "httpMethod": "DELETE" }, "update": { "flatPath": "userprofiles/{userprofilesId}/placementStrategies", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "type": "string", "pattern": "^[^/]+$", "required": true, "format": "int64", "location": "path", "description": "User profile ID associated with this request." } }, "path": "userprofiles/{+profileId}/placementStrategies", "id": "dfareporting.placementStrategies.update", "httpMethod": "PUT", "parameterOrder": [ "profileId" ], "request": { "$ref": "PlacementStrategy" }, "description": "Updates an existing placement strategy.", "response": { "$ref": "PlacementStrategy" } } } }, "countries": { "methods": { "get": { "path": "userprofiles/{+profileId}/countries/{+dartId}", "response": { "$ref": "Country" }, "httpMethod": "GET", "parameters": { "dartId": { "type": "string", "required": true, "format": "int64", "description": "Country DART ID.", "pattern": "^[^/]+$", "location": "path" }, "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "type": "string", "required": true, "pattern": "^[^/]+$" } }, "parameterOrder": [ "profileId", "dartId" ], "flatPath": "userprofiles/{userprofilesId}/countries/{countriesId}", "id": "dfareporting.countries.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Gets one country by ID." }, "list": { "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "CountriesListResponse" }, "path": "userprofiles/{+profileId}/countries", "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/countries", "description": "Retrieves a list of countries.", "id": "dfareporting.countries.list" } } }, "campaigns": { "methods": { "get": { "description": "Gets one campaign by ID.", "id": "dfareporting.campaigns.get", "response": { "$ref": "Campaign" }, "parameterOrder": [ "profileId", "id" ], "httpMethod": "GET", "path": "userprofiles/{+profileId}/campaigns/{+id}", "parameters": { "id": { "location": "path", "required": true, "description": "Campaign ID.", "format": "int64", "type": "string", "pattern": "^[^/]+$" }, "profileId": { "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "required": true, "format": "int64", "location": "path" } }, "flatPath": "userprofiles/{userprofilesId}/campaigns/{campaignsId}", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "insert": { "flatPath": "userprofiles/{userprofilesId}/campaigns", "parameters": { "profileId": { "location": "path", "required": true, "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string", "format": "int64" } }, "httpMethod": "POST", "path": "userprofiles/{+profileId}/campaigns", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Inserts a new campaign.", "id": "dfareporting.campaigns.insert", "response": { "$ref": "Campaign" }, "parameterOrder": [ "profileId" ], "request": { "$ref": "Campaign" } }, "patch": { "description": "Updates an existing campaign. This method supports patch semantics.", "path": "userprofiles/{+profileId}/campaigns", "request": { "$ref": "Campaign" }, "flatPath": "userprofiles/{userprofilesId}/campaigns", "id": "dfareporting.campaigns.patch", "httpMethod": "PATCH", "parameters": { "profileId": { "required": true, "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "type": "string", "location": "path", "format": "int64" }, "id": { "description": "Required. Campaign ID.", "format": "int64", "type": "string", "location": "query", "required": true } }, "response": { "$ref": "Campaign" }, "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "list": { "response": { "$ref": "CampaignsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.campaigns.list", "description": "Retrieves a list of campaigns, possibly filtered. This method supports paging.", "path": "userprofiles/{+profileId}/campaigns", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/campaigns", "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "location": "path", "required": true, "format": "int64", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$", "type": "string" }, "archived": { "description": "Select only archived campaigns. Don't set this field to select both archived and non-archived campaigns.", "type": "boolean", "location": "query" }, "subaccountId": { "location": "query", "format": "int64", "type": "string", "description": "Select only campaigns that belong to this subaccount." }, "excludedIds": { "format": "int64", "description": "Exclude campaigns with these IDs.", "type": "string", "repeated": true, "location": "query" }, "searchString": { "description": "Allows searching for campaigns by name or ID. Wildcards (*) are allowed. For example, \"campaign*2015\" will return campaigns with names like \"campaign June 2015\", \"campaign April 2015\", or simply \"campaign 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"campaign\" will match campaigns with name \"my campaign\", \"campaign 2015\", or simply \"campaign\".", "location": "query", "type": "string" }, "overriddenEventTagId": { "location": "query", "format": "int64", "description": "Select only campaigns that have overridden this event tag ID.", "type": "string" }, "maxResults": { "description": "Maximum number of results to return.", "default": "1000", "format": "int32", "location": "query", "type": "integer" }, "advertiserIds": { "location": "query", "type": "string", "repeated": true, "description": "Select only campaigns that belong to these advertisers.", "format": "int64" }, "advertiserGroupIds": { "description": "Select only campaigns whose advertisers belong to these advertiser groups.", "repeated": true, "format": "int64", "location": "query", "type": "string" }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "description": "Field by which to sort the list.", "location": "query", "default": "ID", "enumDescriptions": [ "", "" ] }, "ids": { "description": "Select only campaigns with these IDs.", "location": "query", "type": "string", "format": "int64", "repeated": true }, "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "location": "query", "type": "string" }, "atLeastOneOptimizationActivity": { "description": "Select only campaigns that have at least one optimization activity.", "location": "query", "type": "boolean" }, "sortOrder": { "description": "Order of sorted results.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "location": "query", "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING" } } }, "update": { "request": { "$ref": "Campaign" }, "parameters": { "profileId": { "type": "string", "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "required": true, "pattern": "^[^/]+$" } }, "flatPath": "userprofiles/{userprofilesId}/campaigns", "httpMethod": "PUT", "id": "dfareporting.campaigns.update", "description": "Updates an existing campaign.", "path": "userprofiles/{+profileId}/campaigns", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "Campaign" }, "parameterOrder": [ "profileId" ] } } }, "platformTypes": { "methods": { "get": { "id": "dfareporting.platformTypes.get", "description": "Gets one platform type by ID.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "PlatformType" }, "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/platformTypes/{platformTypesId}", "path": "userprofiles/{+profileId}/platformTypes/{+id}", "httpMethod": "GET", "parameters": { "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "format": "int64", "required": true, "description": "User profile ID associated with this request." }, "id": { "format": "int64", "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "description": "Platform type ID." } } }, "list": { "path": "userprofiles/{+profileId}/platformTypes", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/platformTypes", "httpMethod": "GET", "parameters": { "profileId": { "location": "path", "description": "User profile ID associated with this request.", "required": true, "pattern": "^[^/]+$", "type": "string", "format": "int64" } }, "id": "dfareporting.platformTypes.list", "description": "Retrieves a list of platform types.", "response": { "$ref": "PlatformTypesListResponse" }, "parameterOrder": [ "profileId" ] } } }, "accountActiveAdSummaries": { "methods": { "get": { "response": { "$ref": "AccountActiveAdSummary" }, "parameters": { "profileId": { "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$", "format": "int64", "required": true, "location": "path" }, "summaryAccountId": { "location": "path", "description": "Account ID.", "required": true, "pattern": "^[^/]+$", "format": "int64", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.accountActiveAdSummaries.get", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/accountActiveAdSummaries/{accountActiveAdSummariesId}", "description": "Gets the account's active ad summary by account ID.", "path": "userprofiles/{+profileId}/accountActiveAdSummaries/{+summaryAccountId}", "parameterOrder": [ "profileId", "summaryAccountId" ] } } }, "floodlightConfigurations": { "methods": { "get": { "id": "dfareporting.floodlightConfigurations.get", "description": "Gets one floodlight configuration by ID.", "response": { "$ref": "FloodlightConfiguration" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "location": "path", "required": true, "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request.", "format": "int64" }, "id": { "pattern": "^[^/]+$", "type": "string", "format": "int64", "required": true, "location": "path", "description": "Floodlight configuration ID." } }, "httpMethod": "GET", "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/floodlightConfigurations/{floodlightConfigurationsId}", "path": "userprofiles/{+profileId}/floodlightConfigurations/{+id}" }, "list": { "flatPath": "userprofiles/{userprofilesId}/floodlightConfigurations", "path": "userprofiles/{+profileId}/floodlightConfigurations", "id": "dfareporting.floodlightConfigurations.list", "httpMethod": "GET", "parameters": { "ids": { "type": "string", "description": "Set of IDs of floodlight configurations to retrieve. Required field; otherwise an empty list will be returned.", "format": "int64", "location": "query", "repeated": true }, "profileId": { "format": "int64", "pattern": "^[^/]+$", "location": "path", "required": true, "description": "User profile ID associated with this request.", "type": "string" } }, "parameterOrder": [ "profileId" ], "description": "Retrieves a list of floodlight configurations, possibly filtered.", "response": { "$ref": "FloodlightConfigurationsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "update": { "path": "userprofiles/{+profileId}/floodlightConfigurations", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "FloodlightConfiguration" }, "parameters": { "profileId": { "required": true, "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$", "format": "int64", "location": "path" } }, "request": { "$ref": "FloodlightConfiguration" }, "flatPath": "userprofiles/{userprofilesId}/floodlightConfigurations", "id": "dfareporting.floodlightConfigurations.update", "httpMethod": "PUT", "parameterOrder": [ "profileId" ], "description": "Updates an existing floodlight configuration." }, "patch": { "parameters": { "profileId": { "description": "User profile ID associated with this request.", "format": "int64", "location": "path", "type": "string", "pattern": "^[^/]+$", "required": true }, "id": { "type": "string", "description": "Required. EventTag ID.", "required": true, "location": "query", "format": "int64" } }, "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "path": "userprofiles/{+profileId}/floodlightConfigurations", "parameterOrder": [ "profileId", "id" ], "request": { "$ref": "FloodlightConfiguration" }, "id": "dfareporting.floodlightConfigurations.patch", "flatPath": "userprofiles/{userprofilesId}/floodlightConfigurations", "description": "Updates an existing floodlight configuration. This method supports patch semantics.", "response": { "$ref": "FloodlightConfiguration" } } } }, "operatingSystemVersions": { "methods": { "list": { "parameterOrder": [ "profileId" ], "description": "Retrieves a list of operating system versions.", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/operatingSystemVersions", "id": "dfareporting.operatingSystemVersions.list", "parameters": { "profileId": { "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "format": "int64", "required": true } }, "path": "userprofiles/{+profileId}/operatingSystemVersions", "response": { "$ref": "OperatingSystemVersionsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "get": { "id": "dfareporting.operatingSystemVersions.get", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "OperatingSystemVersion" }, "parameters": { "profileId": { "location": "path", "format": "int64", "required": true, "type": "string", "description": "User profile ID associated with this request.", "pattern": "^[^/]+$" }, "id": { "format": "int64", "type": "string", "pattern": "^[^/]+$", "required": true, "location": "path", "description": "Operating system version ID." } }, "parameterOrder": [ "profileId", "id" ], "description": "Gets one operating system version by ID.", "httpMethod": "GET", "flatPath": "userprofiles/{userprofilesId}/operatingSystemVersions/{operatingSystemVersionsId}", "path": "userprofiles/{+profileId}/operatingSystemVersions/{+id}" } } }, "regions": { "methods": { "list": { "path": "userprofiles/{+profileId}/regions", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/regions", "parameters": { "profileId": { "required": true, "pattern": "^[^/]+$", "format": "int64", "location": "path", "type": "string", "description": "User profile ID associated with this request." } }, "httpMethod": "GET", "parameterOrder": [ "profileId" ], "response": { "$ref": "RegionsListResponse" }, "id": "dfareporting.regions.list", "description": "Retrieves a list of regions." } } }, "browsers": { "methods": { "list": { "path": "userprofiles/{+profileId}/browsers", "flatPath": "userprofiles/{userprofilesId}/browsers", "parameterOrder": [ "profileId" ], "parameters": { "profileId": { "format": "int64", "required": true, "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request.", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.browsers.list", "response": { "$ref": "BrowsersListResponse" }, "description": "Retrieves a list of browsers." } } }, "accountUserProfiles": { "methods": { "update": { "httpMethod": "PUT", "response": { "$ref": "AccountUserProfile" }, "parameters": { "profileId": { "pattern": "^[^/]+$", "format": "int64", "type": "string", "location": "path", "description": "User profile ID associated with this request.", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "AccountUserProfile" }, "path": "userprofiles/{+profileId}/accountUserProfiles", "parameterOrder": [ "profileId" ], "description": "Updates an existing account user profile.", "id": "dfareporting.accountUserProfiles.update", "flatPath": "userprofiles/{userprofilesId}/accountUserProfiles" }, "patch": { "httpMethod": "PATCH", "parameters": { "profileId": { "format": "int64", "pattern": "^[^/]+$", "required": true, "description": "User profile ID associated with this request.", "type": "string", "location": "path" }, "id": { "location": "query", "type": "string", "required": true, "description": "Required. AccountUserProfile ID.", "format": "int64" } }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.accountUserProfiles.patch", "response": { "$ref": "AccountUserProfile" }, "flatPath": "userprofiles/{userprofilesId}/accountUserProfiles", "path": "userprofiles/{+profileId}/accountUserProfiles", "description": "Updates an existing account user profile. This method supports patch semantics.", "request": { "$ref": "AccountUserProfile" }, "parameterOrder": [ "profileId", "id" ] }, "get": { "description": "Gets one account user profile by ID.", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameterOrder": [ "profileId", "id" ], "path": "userprofiles/{profileId}/accountUserProfiles/{+id}", "response": { "$ref": "AccountUserProfile" }, "flatPath": "userprofiles/{profileId}/accountUserProfiles/{accountUserProfilesId}", "httpMethod": "GET", "parameters": { "id": { "description": "User profile ID.", "pattern": "^[^/]+$", "type": "string", "format": "int64", "required": true, "location": "path" }, "profileId": { "required": true, "format": "int64", "location": "path", "description": "User profile ID associated with this request.", "type": "string" } }, "id": "dfareporting.accountUserProfiles.get" }, "insert": { "description": "Inserts a new account user profile.", "flatPath": "userprofiles/{userprofilesId}/accountUserProfiles", "parameterOrder": [ "profileId" ], "id": "dfareporting.accountUserProfiles.insert", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "request": { "$ref": "AccountUserProfile" }, "response": { "$ref": "AccountUserProfile" }, "parameters": { "profileId": { "format": "int64", "location": "path", "description": "User profile ID associated with this request.", "type": "string", "pattern": "^[^/]+$", "required": true } }, "httpMethod": "POST", "path": "userprofiles/{+profileId}/accountUserProfiles" }, "list": { "path": "userprofiles/{+profileId}/accountUserProfiles", "response": { "$ref": "AccountUserProfilesListResponse" }, "parameters": { "active": { "type": "boolean", "description": "Select only active user profiles.", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "Value of the nextPageToken from the previous result page." }, "searchString": { "type": "string", "location": "query", "description": "Allows searching for objects by name, ID or email. Wildcards (*) are allowed. For example, \"user profile*2015\" will return objects with names like \"user profile June 2015\", \"user profile April 2015\", or simply \"user profile 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"user profile\" will match objects with name \"my user profile\", \"user profile 2015\", or simply \"user profile\"." }, "ids": { "location": "query", "repeated": true, "type": "string", "format": "int64", "description": "Select only user profiles with these IDs." }, "sortOrder": { "location": "query", "description": "Order of sorted results.", "enumDescriptions": [ "Ascending order.", "Descending order." ], "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ] }, "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "description": "User profile ID associated with this request.", "format": "int64" }, "userRoleId": { "type": "string", "description": "Select only user profiles with the specified user role ID.", "location": "query", "format": "int64" }, "maxResults": { "location": "query", "description": "Maximum number of results to return.", "default": "1000", "format": "int32", "type": "integer" }, "sortField": { "description": "Field by which to sort the list.", "location": "query", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "ID", "NAME" ], "default": "ID" }, "subaccountId": { "description": "Select only user profiles with the specified subaccount ID.", "type": "string", "format": "int64", "location": "query" } }, "httpMethod": "GET", "parameterOrder": [ "profileId" ], "id": "dfareporting.accountUserProfiles.list", "flatPath": "userprofiles/{userprofilesId}/accountUserProfiles", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Retrieves a list of account user profiles, possibly filtered. This method supports paging." } } }, "floodlightActivities": { "methods": { "generatetag": { "parameterOrder": [ "profileId" ], "httpMethod": "POST", "path": "userprofiles/{+profileId}/floodlightActivities/generatetag", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivities/generatetag", "id": "dfareporting.floodlightActivities.generatetag", "parameters": { "profileId": { "required": true, "format": "int64", "type": "string", "location": "path", "pattern": "^[^/]+$", "description": "User profile ID associated with this request." }, "floodlightActivityId": { "type": "string", "location": "query", "description": "Floodlight activity ID for which we want to generate a tag.", "format": "int64" } }, "response": { "$ref": "FloodlightActivitiesGenerateTagResponse" }, "description": "Generates a tag for a floodlight activity." }, "insert": { "response": { "$ref": "FloodlightActivity" }, "id": "dfareporting.floodlightActivities.insert", "httpMethod": "POST", "parameters": { "profileId": { "pattern": "^[^/]+$", "type": "string", "required": true, "location": "path", "format": "int64", "description": "User profile ID associated with this request." } }, "parameterOrder": [ "profileId" ], "description": "Inserts a new floodlight activity.", "path": "userprofiles/{+profileId}/floodlightActivities", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivities", "request": { "$ref": "FloodlightActivity" } }, "update": { "path": "userprofiles/{+profileId}/floodlightActivities", "description": "Updates an existing floodlight activity.", "response": { "$ref": "FloodlightActivity" }, "id": "dfareporting.floodlightActivities.update", "request": { "$ref": "FloodlightActivity" }, "parameterOrder": [ "profileId" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivities", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "parameters": { "profileId": { "type": "string", "required": true, "pattern": "^[^/]+$", "format": "int64", "location": "path", "description": "User profile ID associated with this request." } }, "httpMethod": "PUT" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "id": "dfareporting.floodlightActivities.delete", "description": "Deletes an existing floodlight activity.", "path": "userprofiles/{+profileId}/floodlightActivities/{+id}", "flatPath": "userprofiles/{userprofilesId}/floodlightActivities/{floodlightActivitiesId}", "parameters": { "id": { "pattern": "^[^/]+$", "description": "Floodlight activity ID.", "type": "string", "required": true, "format": "int64", "location": "path" }, "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "description": "User profile ID associated with this request.", "format": "int64", "type": "string" } }, "parameterOrder": [ "profileId", "id" ], "httpMethod": "DELETE" }, "get": { "response": { "$ref": "FloodlightActivity" }, "httpMethod": "GET", "id": "dfareporting.floodlightActivities.get", "description": "Gets one floodlight activity by ID.", "parameters": { "profileId": { "pattern": "^[^/]+$", "required": true, "location": "path", "type": "string", "format": "int64", "description": "User profile ID associated with this request." }, "id": { "format": "int64", "description": "Floodlight activity ID.", "pattern": "^[^/]+$", "type": "string", "location": "path", "required": true } }, "path": "userprofiles/{+profileId}/floodlightActivities/{+id}", "flatPath": "userprofiles/{userprofilesId}/floodlightActivities/{floodlightActivitiesId}", "parameterOrder": [ "profileId", "id" ], "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ] }, "patch": { "id": "dfareporting.floodlightActivities.patch", "request": { "$ref": "FloodlightActivity" }, "parameterOrder": [ "profileId", "id" ], "flatPath": "userprofiles/{userprofilesId}/floodlightActivities", "path": "userprofiles/{+profileId}/floodlightActivities", "parameters": { "id": { "format": "int64", "description": "Required. EventTag ID.", "required": true, "type": "string", "location": "query" }, "profileId": { "required": true, "pattern": "^[^/]+$", "format": "int64", "description": "User profile ID associated with this request.", "location": "path", "type": "string" } }, "httpMethod": "PATCH", "response": { "$ref": "FloodlightActivity" }, "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "description": "Updates an existing floodlight activity. This method supports patch semantics." }, "list": { "description": "Retrieves a list of floodlight activities, possibly filtered. This method supports paging.", "flatPath": "userprofiles/{userprofilesId}/floodlightActivities", "id": "dfareporting.floodlightActivities.list", "parameters": { "tagString": { "description": "Select only floodlight activities with the specified tag string.", "location": "query", "type": "string" }, "sortField": { "type": "string", "enum": [ "ID", "NAME" ], "enumDescriptions": [ "", "" ], "default": "ID", "description": "Field by which to sort the list.", "location": "query" }, "floodlightConfigurationId": { "location": "query", "format": "int64", "type": "string", "description": "Select only floodlight activities for the specified floodlight configuration ID. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result." }, "pageToken": { "description": "Value of the nextPageToken from the previous result page.", "location": "query", "type": "string" }, "searchString": { "type": "string", "description": "Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, \"floodlightactivity*2015\" will return objects with names like \"floodlightactivity June 2015\", \"floodlightactivity April 2015\", or simply \"floodlightactivity 2015\". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of \"floodlightactivity\" will match objects with name \"my floodlightactivity activity\", \"floodlightactivity 2015\", or simply \"floodlightactivity\".", "location": "query" }, "sortOrder": { "default": "ASCENDING", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ], "location": "query", "description": "Order of sorted results." }, "advertiserId": { "type": "string", "format": "int64", "description": "Select only floodlight activities for the specified advertiser ID. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result.", "location": "query" }, "floodlightActivityGroupType": { "location": "query", "description": "Select only floodlight activities with the specified floodlight activity group type.", "type": "string", "enum": [ "COUNTER", "SALE" ], "enumDescriptions": [ "", "" ] }, "profileId": { "required": true, "format": "int64", "pattern": "^[^/]+$", "type": "string", "description": "User profile ID associated with this request.", "location": "path" }, "floodlightActivityGroupName": { "description": "Select only floodlight activities with the specified floodlight activity group name.", "location": "query", "type": "string" }, "maxResults": { "format": "int32", "location": "query", "description": "Maximum number of results to return.", "type": "integer", "default": "1000" }, "floodlightActivityGroupTagString": { "location": "query", "type": "string", "description": "Select only floodlight activities with the specified floodlight activity group tag string." }, "ids": { "location": "query", "repeated": true, "type": "string", "format": "int64", "description": "Select only floodlight activities with the specified IDs. Must specify either ids, advertiserId, or floodlightConfigurationId for a non-empty result." }, "floodlightActivityGroupIds": { "description": "Select only floodlight activities with the specified floodlight activity group IDs.", "location": "query", "repeated": true, "format": "int64", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/dfatrafficking" ], "response": { "$ref": "FloodlightActivitiesListResponse" }, "path": "userprofiles/{+profileId}/floodlightActivities", "parameterOrder": [ "profileId" ] } } } }, "fullyEncodeReservedExpansion": true, "mtlsRootUrl": "https://dfareporting.mtls.googleapis.com/", "discoveryVersion": "v1", "parameters": { "oauth_token": { "type": "string", "location": "query", "description": "OAuth 2.0 token for the current user." }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string", "location": "query" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query", "type": "string" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "fields": { "location": "query", "type": "string", "description": "Selector specifying which fields to include in a partial response." }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "description": "V1 error format.", "type": "string", "enum": [ "1", "2" ] }, "access_token": { "location": "query", "type": "string", "description": "OAuth access token." }, "alt": { "type": "string", "enum": [ "json", "media", "proto" ], "location": "query", "default": "json", "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "prettyPrint": { "location": "query", "description": "Returns response with indentations and line breaks.", "type": "boolean", "default": "true" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" } }, "servicePath": "dfareporting/v5/", "ownerDomain": "google.com", "basePath": "/dfareporting/v5/", "revision": "20261023", "baseUrl": "https://dfareporting.googleapis.com/dfareporting/v5/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/ddmconversions": { "description": "Manage DoubleClick Digital Marketing conversions" }, "https://www.googleapis.com/auth/dfatrafficking": { "description": "View and manage your DoubleClick Campaign Manager's (DCM) display ad campaigns" }, "https://www.googleapis.com/auth/dfareporting": { "description": "View and manage DoubleClick for Advertisers reports" } } } }, "batchPath": "batch", "rootUrl": "https://dfareporting.googleapis.com/", "title": "Campaign Manager 360 API", "schemas": { "CustomValueField": { "properties": { "fieldId": { "format": "int32", "type": "integer", "description": "Optional. Field ID in the element." }, "requestKey": { "description": "Optional. Custom key used to match for auto filtering.", "type": "string" } }, "id": "CustomValueField", "description": "Contains custom value field information.", "type": "object" }, "CreativeAsset": { "description": "Creative Asset.", "type": "object", "properties": { "windowMode": { "description": "Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING.", "enumDescriptions": [ "Allows overlapping of Html and SWF content.", "Default", "Used for non-square borders. Allows overlapping of Html and SWF content." ], "type": "string", "enum": [ "OPAQUE", "WINDOW", "TRANSPARENT" ] }, "zipFilesize": { "description": "Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.", "type": "string" }, "childAssetType": { "description": "Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID.", "enumDescriptions": [ "swf files", "flv and any other video files types", "image files", "rest of the supported file types .txt, .xml etc." ], "type": "string", "enum": [ "CHILD_ASSET_TYPE_FLASH", "CHILD_ASSET_TYPE_VIDEO", "CHILD_ASSET_TYPE_IMAGE", "CHILD_ASSET_TYPE_DATA" ] }, "hideFlashObjects": { "type": "boolean", "description": "Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA." }, "idDimensionValue": { "description": "Dimension value for the ID of the asset. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "horizontallyLocked": { "type": "boolean", "description": "Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA." }, "mediaDuration": { "type": "number", "description": "Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID.", "format": "float" }, "additionalSizes": { "type": "array", "description": "Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render.", "items": { "$ref": "Size" } }, "bitRate": { "type": "integer", "format": "int32", "description": "Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID." }, "zIndex": { "format": "int32", "description": "zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive.", "type": "integer" }, "orientation": { "type": "string", "enum": [ "LANDSCAPE", "PORTRAIT", "SQUARE" ], "description": "Orientation of video asset. This is a read-only, auto-generated field.", "enumDescriptions": [ "", "", "" ] }, "zipFilename": { "description": "File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER.", "type": "string" }, "position": { "description": "Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA.", "$ref": "OffsetPosition" }, "duration": { "type": "integer", "description": "Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1.", "format": "int32" }, "audioBitRate": { "format": "int32", "type": "integer", "description": "Audio stream bit rate in kbps. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID." }, "hideSelectionBoxes": { "description": "Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA.", "type": "boolean" }, "fileSize": { "description": "File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.", "type": "string", "format": "int64" }, "mimeType": { "type": "string", "description": "Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID." }, "displayType": { "type": "string", "enum": [ "ASSET_DISPLAY_TYPE_INPAGE", "ASSET_DISPLAY_TYPE_FLOATING", "ASSET_DISPLAY_TYPE_OVERLAY", "ASSET_DISPLAY_TYPE_EXPANDING", "ASSET_DISPLAY_TYPE_FLASH_IN_FLASH", "ASSET_DISPLAY_TYPE_FLASH_IN_FLASH_EXPANDING", "ASSET_DISPLAY_TYPE_PEEL_DOWN", "ASSET_DISPLAY_TYPE_VPAID_LINEAR", "ASSET_DISPLAY_TYPE_VPAID_NON_LINEAR", "ASSET_DISPLAY_TYPE_BACKDROP" ], "description": "Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.", "enumDescriptions": [ "Asset exists in a box and stays within the box.", "Asset exists at a self described location on the page.", "Special display type for IM clients.", "Asset changes size.", "Not applicable for HTML5.", "Not applicable for HTML5.", "Asset sits on the top right and expands.", "VPAID linear asset.", "VPAID non linear asset.", "Backdrop (skin) asset." ] }, "startTimeType": { "description": "Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA.", "type": "string", "enum": [ "ASSET_START_TIME_TYPE_NONE", "ASSET_START_TIME_TYPE_CUSTOM" ], "enumDescriptions": [ "Asset is not automatically displayed.", "Asset is automatically displayed after a fixed period of time." ] }, "assetIdentifier": { "$ref": "CreativeAssetId", "description": "Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT." }, "detectedFeatures": { "items": { "type": "string", "enum": [ "CSS_FONT_FACE", "CSS_BACKGROUND_SIZE", "CSS_BORDER_IMAGE", "CSS_BORDER_RADIUS", "CSS_BOX_SHADOW", "CSS_FLEX_BOX", "CSS_HSLA", "CSS_MULTIPLE_BGS", "CSS_OPACITY", "CSS_RGBA", "CSS_TEXT_SHADOW", "CSS_ANIMATIONS", "CSS_COLUMNS", "CSS_GENERATED_CONTENT", "CSS_GRADIENTS", "CSS_REFLECTIONS", "CSS_TRANSFORMS", "CSS_TRANSFORMS3D", "CSS_TRANSITIONS", "APPLICATION_CACHE", "CANVAS", "CANVAS_TEXT", "DRAG_AND_DROP", "HASH_CHANGE", "HISTORY", "AUDIO", "VIDEO", "INDEXED_DB", "INPUT_ATTR_AUTOCOMPLETE", "INPUT_ATTR_AUTOFOCUS", "INPUT_ATTR_LIST", "INPUT_ATTR_PLACEHOLDER", "INPUT_ATTR_MAX", "INPUT_ATTR_MIN", "INPUT_ATTR_MULTIPLE", "INPUT_ATTR_PATTERN", "INPUT_ATTR_REQUIRED", "INPUT_ATTR_STEP", "INPUT_TYPE_SEARCH", "INPUT_TYPE_TEL", "INPUT_TYPE_URL", "INPUT_TYPE_EMAIL", "INPUT_TYPE_DATETIME", "INPUT_TYPE_DATE", "INPUT_TYPE_MONTH", "INPUT_TYPE_WEEK", "INPUT_TYPE_TIME", "INPUT_TYPE_DATETIME_LOCAL", "INPUT_TYPE_NUMBER", "INPUT_TYPE_RANGE", "INPUT_TYPE_COLOR", "LOCAL_STORAGE", "POST_MESSAGE", "SESSION_STORAGE", "WEB_SOCKETS", "WEB_SQL_DATABASE", "WEB_WORKERS", "GEO_LOCATION", "INLINE_SVG", "SMIL", "SVG_HREF", "SVG_CLIP_PATHS", "TOUCH", "WEBGL", "SVG_FILTERS", "SVG_FE_IMAGE" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "POST_MESSAGE always required due to html5 implementation.", "", "", "", "", "", "", "", "", "", "", "", "", "" ] }, "description": "List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "array" }, "pushdown": { "type": "boolean", "description": "Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height." }, "progressiveServingUrl": { "description": "Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.", "type": "string" }, "alignment": { "description": "Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL .", "enumDescriptions": [ "", "", "", "" ], "type": "string", "enum": [ "ALIGNMENT_TOP", "ALIGNMENT_RIGHT", "ALIGNMENT_BOTTOM", "ALIGNMENT_LEFT" ] }, "durationType": { "type": "string", "enum": [ "ASSET_DURATION_TYPE_AUTO", "ASSET_DURATION_TYPE_NONE", "ASSET_DURATION_TYPE_CUSTOM" ], "description": "Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA.", "enumDescriptions": [ "Asset is displayed for the single run of the time line.", "Asset is displayed indefinitely and it loops on the timeline.", "User entered duration value in seconds." ] }, "frameRate": { "description": "Video frame rate for video asset in frames per second. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.", "type": "number", "format": "float" }, "pushdownDuration": { "description": "Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive.", "format": "float", "type": "number" }, "flashVersion": { "format": "int32", "description": "Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "integer" }, "actionScript3": { "description": "Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "boolean" }, "originalBackup": { "description": "Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA.", "type": "boolean" }, "size": { "$ref": "Size", "description": "Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE." }, "collapsedSize": { "$ref": "Size", "description": "Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN." }, "transparency": { "type": "boolean", "description": "Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets." }, "positionLeftUnit": { "description": "Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.", "type": "string", "enum": [ "OFFSET_UNIT_PIXEL", "OFFSET_UNIT_PERCENT", "OFFSET_UNIT_PIXEL_FROM_CENTER" ], "enumDescriptions": [ "Pixels on a screen.", "Percent offset for center asset (rather than top and left).", "Pixel offset for center of asset from center of browser window." ] }, "role": { "type": "string", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "Cover image.", "Headline.", "Long headline.", "Description.", "Long description.", "Call to action." ], "enum": [ "PRIMARY", "BACKUP_IMAGE", "ADDITIONAL_IMAGE", "ADDITIONAL_FLASH", "PARENT_VIDEO", "TRANSCODED_VIDEO", "OTHER", "ALTERNATE_VIDEO", "PARENT_AUDIO", "TRANSCODED_AUDIO", "COVER_IMAGE", "HEADLINE", "LONG_HEADLINE", "DESCRIPTION", "LONG_DESCRIPTION", "CALL_TO_ACTION" ], "description": "Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. " }, "positionTopUnit": { "type": "string", "enum": [ "OFFSET_UNIT_PIXEL", "OFFSET_UNIT_PERCENT", "OFFSET_UNIT_PIXEL_FROM_CENTER" ], "description": "Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA.", "enumDescriptions": [ "Pixels on a screen.", "Percent offset for center asset (rather than top and left).", "Pixel offset for center of asset from center of browser window." ] }, "sslCompliant": { "description": "Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT.", "type": "boolean" }, "active": { "description": "Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID.", "type": "boolean" }, "id": { "type": "string", "format": "int64", "description": "Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT." }, "expandedDimension": { "$ref": "Size", "description": "Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID." }, "customStartTimeValue": { "type": "integer", "format": "int32", "description": "Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0." }, "companionCreativeIds": { "description": "List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true.", "items": { "type": "string", "format": "int64" }, "type": "array" }, "artworkType": { "enumDescriptions": [ "The creative is a Flash creative.", "The creative is HTML5.", "The creative is HTML5 if available, Flash otherwise.", "The creative is Image." ], "description": "Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA.", "type": "string", "enum": [ "ARTWORK_TYPE_FLASH", "ARTWORK_TYPE_HTML5", "ARTWORK_TYPE_MIXED", "ARTWORK_TYPE_IMAGE" ] }, "verticallyLocked": { "type": "boolean", "description": "Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA." }, "offset": { "$ref": "OffsetPosition", "description": "Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN." }, "streamingServingUrl": { "description": "Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID.", "type": "string" }, "politeLoad": { "description": "Whether this asset is used as a polite load asset.", "type": "boolean" }, "audioSampleRate": { "format": "int32", "description": "Audio sample bit rate in hertz. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID.", "type": "integer" }, "backupImageExit": { "description": "Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA.", "$ref": "CreativeCustomEvent" } }, "id": "CreativeAsset" }, "TagSetting": { "id": "TagSetting", "properties": { "includeClickThroughUrls": { "type": "boolean", "description": "Whether static landing page URLs should be included in the tags. New placements will default to the value set on their site." }, "includeUnescapedlpurlMacro": { "description": "Optional. Indicates that the unescapedlpurl macro should be included in the tag for the static landing page. New placements will default to the value set on their site.", "type": "boolean" }, "keywordOption": { "description": "Option specifying how keywords are embedded in ad tags. This setting can be used to specify whether keyword placeholders are inserted in placement tags for this site. Publishers can then add keywords to those placeholders.", "enumDescriptions": [ "Creates DART ad tags with a placeholder, such as kw=[keyword] and a list of keywords. The site trafficker must replace [keyword] with the keywords targeted by an ad.", "Creates DART ad tags that do not have a placeholder for keywords and creates a list of keywords separately from the DART ad tags. Use this option if the site uses a keyword referrer or is a site that uses DART for Publishers.", "Results in unique tag generation for each relevant keyword during tag export. For example, an ad with three keywords will generate three tags with each tag having its kw= parameter filled in with the relevant keyword values." ], "type": "string", "enum": [ "PLACEHOLDER_WITH_LIST_OF_KEYWORDS", "IGNORE", "GENERATE_SEPARATE_TAG_FOR_EACH_KEYWORD" ] }, "additionalKeyValues": { "type": "string", "description": "Additional key-values to be included in tags. Each key-value pair must be of the form key=value, and pairs must be separated by a semicolon (;). Keys and values must not contain commas. For example, id=2;color=red is a valid value for this field." }, "includeClickTracking": { "description": "Whether click-tracking string should be included in the tags.", "type": "boolean" } }, "type": "object", "description": "Tag Settings" }, "MobileApp": { "id": "MobileApp", "type": "object", "description": "Contains information about a mobile app. Used as a landing page deep link.", "properties": { "title": { "description": "Title of this mobile app.", "type": "string" }, "id": { "type": "string", "description": "ID of this mobile app." }, "directory": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "" ], "description": "Mobile app directory.", "type": "string", "enum": [ "UNKNOWN", "APPLE_APP_STORE", "GOOGLE_PLAY_STORE", "ROKU_APP_STORE", "AMAZON_FIRETV_APP_STORE", "PLAYSTATION_APP_STORE", "APPLE_TV_APP_STORE", "XBOX_APP_STORE", "SAMSUNG_TV_APP_STORE", "ANDROID_TV_APP_STORE", "GENERIC_CTV_APP_STORE" ] }, "publisherName": { "type": "string", "description": "Publisher name." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#mobileApp\".", "type": "string" } } }, "Dimension": { "description": "Represents a dimension.", "id": "Dimension", "properties": { "name": { "description": "The dimension name, e.g. advertiser", "type": "string" }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#dimension." } }, "type": "object" }, "ConversionsBatchInsertResponse": { "description": "Insert Conversions Response.", "id": "ConversionsBatchInsertResponse", "type": "object", "properties": { "status": { "type": "array", "description": "The insert status of each conversion. Statuses are returned in the same order that conversions are inserted.", "items": { "$ref": "ConversionStatus" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionsBatchInsertResponse\".", "type": "string" }, "hasFailures": { "description": "Indicates that some or all conversions failed to insert.", "type": "boolean" } } }, "UniversalAdId": { "type": "object", "properties": { "registry": { "description": "Registry used for the Ad ID value.", "enumDescriptions": [ "", "", "", "", "", "" ], "type": "string", "enum": [ "OTHER", "AD_ID_OFFICIAL", "CLEARCAST", "DCM", "ARPP", "CUSV" ] }, "value": { "type": "string", "description": "ID value for this creative. Only alphanumeric characters and the following symbols are valid: \"_/\\-\". Maximum length is 64 characters. Read only when registry is DCM." } }, "id": "UniversalAdId", "description": "A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID." }, "FieldError": { "id": "FieldError", "type": "object", "properties": { "fieldId": { "description": "Output only. The ID of the field.", "format": "int32", "type": "integer", "readOnly": true }, "isError": { "readOnly": true, "description": "Output only. Incidcates whether the field has error or warning.", "type": "boolean" }, "fieldName": { "readOnly": true, "description": "Output only. The name of the field.", "type": "string" }, "fieldValues": { "description": "Output only. The list of values of the field.", "type": "array", "readOnly": true, "items": { "type": "string" } }, "ingestionError": { "enumDescriptions": [ "The ingestion error is unknown.", "The ingestion error when the ID value is missing.", "The ingestion error when the element value name used for reporting is missing.", "The ingestion error when a required value is empty", "The ingestion error when asset retrieval fails for a particular image or asset.", "The ingestion error when the ID value exceeds the string length limit.", "The ingestion error when the ID value is duplicate.", "The ingestion error when parsing the field fails.", "The ingestion error when parsing the country code fails.", "The ingestion error when parsing the long value fails.", "The ingestion error when parsing the boolean value fails.", "The ingestion error when parsing the expanded url fails.", "The ingestion error when parsing the float value fails.", "The ingestion error when parsing the datetime value fails.", "The ingestion error when the preference value is not a positive float.", "The ingestion error when a geo location is not found.", "The ingestion error when parsing the geo field fails.", "The ingestion error when a feed row has multiple geotargets with proximity targeting enabled.", "The ingestion error when parsing the postal code value fails.", "The ingestion error when parsing the metro code value fails.", "The ingestion error when parsing the datetime value fails.", "The ingestion error when parsing the weight value fails.", "The ingestion error when parsing the creative dimension value fails.", "The ingestion error when a STRING_LIST type ID has multiple values.", "The ingestion error when the end time is before the start time.", "The ingestion error when the asset library handle is invalid.", "The ingestion error when the asset library video handle is invalid.", "The ingestion error when the asset library directory handle is invalid.", "The ingestion error when a targeting key used but not defined for the CM360 Advertiser.", "The ingestion error when the userlist ID is not accessible for the CM360 Advertiser.", "The ingestion error when the end time is passed.", "The ingestion error when the end time is in the near future (i.e., \u003c7 days).", "The ingestion error when a text field specifies a reference to an asset.", "The ingestion error when Image field specifies a reference to an asset hosted on SCS (s0.2mdn.net/s0qa.2mdn.net).", "The ingestion error when a geo target is an airport.", "The ingestion error when the geo target's canonical name does not match the query string used to obtain it.", "The ingestion error or warning when the default row is not set.", "The ingestion error or warning when the default row is not active.", "The ingestion error or warning when the default row is not in the date range.", "The ingestion error or warning when the default row is not in the date range.", "The ingestion error when when the payload of the record is above a threshold.", "The ingestion error or warning when the field is not SSL compliant." ], "type": "string", "enum": [ "UNKNOWN_PARSING_ERROR", "MISSING_ID", "MISSING_REPORTING_LABEL", "EMPTY_VALUE", "ASSET_DOWNLOAD_ERROR", "ID_TOO_LONG", "DUPLICATE_ID", "PARSING_ERROR", "COUNTRY_PARSING_ERROR", "LONG_PARSING_ERROR", "BOOL_PARSING_ERROR", "EXPANDED_URL_PARSING_ERROR", "FLOAT_PARSING_ERROR", "DATETIME_PARSING_ERROR", "INVALID_PREFERENCE_VALUE", "GEO_NOT_FOUND_ERROR", "GEO_PARSING_ERROR", "GEO_PROXIMITY_TARGETING_MULTIPLE_LOCATION_ERROR", "POSTAL_CODE_PARSING_ERROR", "METRO_CODE_PARSING_ERROR", "DATETIME_WITHOUT_TIMEZONE_PARSING_ERROR", "WEIGHT_PARSING_ERROR", "CREATIVE_DIMENSION_PARSING_ERROR", "MULTIVALUE_ID", "ENDTIME_BEFORE_STARTTIME", "INVALID_ASSET_LIBRARY_HANDLE", "INVALID_ASSET_LIBRARY_VIDEO_HANDLE", "INVALID_ASSET_LIBRARY_DIRECTORY_HANDLE", "DYNAMIC_TARGETING_KEY_NOT_DEFINED_FOR_ADVERTISER", "USERLIST_ID_NOT_ACCESSIBLE_FOR_ADVERTISER", "ENDTIME_PASSED", "ENDTIME_TOO_SOON", "TEXT_ASSET_REFERENCE", "IMAGE_ASSET_SCS_REFERENCE", "AIRPORT_GEO_TARGET", "CANONICAL_NAME_QUERY_MISMATCH", "NO_DEFAULT_ROW", "NO_ACTIVE_DEFAULT_ROW", "NO_DEFAULT_ROW_IN_DATE_RANGE", "NO_ACTIVE_DEFAULT_ROW_IN_DATE_RANGE", "PAYLOAD_LIMIT_EXCEEDED", "SSL_NOT_COMPLIANT" ], "readOnly": true, "description": "Output only. The ingestion error of the field." } }, "description": "Contains the field error of the dynamic feed." }, "CampaignCreativeAssociation": { "type": "object", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#campaignCreativeAssociation\"." }, "creativeId": { "format": "int64", "type": "string", "description": "ID of the creative associated with the campaign. This is a required field." } }, "description": "Identifies a creative which has been associated with a given campaign.", "id": "CampaignCreativeAssociation" }, "OffsetPosition": { "type": "object", "id": "OffsetPosition", "description": "Offset Position.", "properties": { "top": { "format": "int32", "description": "Offset distance from top side of an asset or a window.", "type": "integer" }, "left": { "format": "int32", "description": "Offset distance from left side of an asset or a window.", "type": "integer" } } }, "VideoOffset": { "properties": { "offsetSeconds": { "description": "Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive.", "format": "int32", "type": "integer" }, "offsetPercentage": { "format": "int32", "description": "Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive.", "type": "integer" } }, "id": "VideoOffset", "type": "object", "description": "Video Offset" }, "ProximityFilter": { "id": "ProximityFilter", "description": "Contains proximity filter information.", "type": "object", "properties": { "fieldId": { "format": "int32", "description": "Optional. Field ID in the element.", "type": "integer" }, "radiusBucketType": { "type": "string", "enum": [ "RADIUS_BUCKET_TYPE_UNKNOWN", "SMALL", "MEDIUM", "LARGE", "MULTI_REGIONAL", "NATIONAL" ], "enumDescriptions": [ "The radius bucket type is unknown.", "The radius bucket type is small.", "The radius bucket type is medium.", "The radius bucket type is large.", "The radius bucket type is multi-regional.", "The radius bucket type is national." ], "description": "Optional. The radius bucket type of the proximity filter" }, "radiusUnitType": { "description": "Optional. The units of the radius value", "type": "string", "enum": [ "RADIUS_UNIT_TYPE_UNKNOWN", "KILOMETERS", "MILES" ], "enumDescriptions": [ "The units of the radius value are unknown. This value is unused.", "The units of the radius value are kilometers.", "The units of the radius value are miles." ] }, "radiusValue": { "format": "int32", "type": "integer", "description": "Optional. Radius length in units defined by radius_units." } } }, "VideoFormatsListResponse": { "id": "VideoFormatsListResponse", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#videoFormatsListResponse\"." }, "videoFormats": { "description": "Video format collection.", "items": { "$ref": "VideoFormat" }, "type": "array" } }, "type": "object", "description": "Video Format List Response" }, "CompanionSetting": { "properties": { "imageOnly": { "type": "boolean", "description": "Whether to serve only static images as companions." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#companionSetting\".", "type": "string" }, "companionsDisabled": { "description": "Whether companions are disabled for this placement.", "type": "boolean" }, "enabledSizes": { "type": "array", "items": { "$ref": "Size" }, "description": "Allowlist of companion sizes to be served to this placement. Set this list to null or empty to serve all companion sizes." } }, "type": "object", "id": "CompanionSetting", "description": "Companion Settings" }, "DynamicProfile": { "description": " *Beta:* This API resource is available only to a very limited number of customers. If you'd like to use this resource, please reach out to your Google sales representative. Contains dynamic profile information.", "properties": { "status": { "description": "Optional. Status of this dynamic profile.", "enumDescriptions": [ "The dynamic profile status is unknown. This value is unused.", "The dynamic profile is active.", "The dynamic profile is inactive.", "The dynamic profile is deleted." ], "type": "string", "enum": [ "STATUS_UNKNOWN", "ACTIVE", "INACTIVE", "DELETED" ] }, "lastModifiedInfo": { "description": "Output only. The last modified timestamp of the dynamic profile. This is a read-only field.", "readOnly": true, "$ref": "LastModifiedInfo" }, "createInfo": { "description": "Output only. The creation timestamp of the dynamic profile. This is a read-only field.", "readOnly": true, "$ref": "LastModifiedInfo" }, "draft": { "$ref": "DynamicProfileVersion", "description": "Optional. Draft version of the dynamic profile." }, "dynamicProfileId": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. Unique ID of this dynamic profile. This is a read-only, auto-generated field." }, "studioAdvertiserId": { "description": "Required. Advertiser ID of this dynamic profile. This is a required field on insertion.", "type": "string", "format": "int64" }, "kind": { "description": "Output only. Identifies what kind of resource this is. Value: the fixed string \"dfareporting#dynamicProfile\".", "readOnly": true, "type": "string" }, "name": { "description": "Required. Identifier. Name of this dynamic profile. This is a required field and must be less than 256 characters long.", "type": "string" }, "archiveStatus": { "enumDescriptions": [ "The dynamic profile archive status is unknown. This value is unused.", "The dynamic profile archive status is unarchived.", "The dynamic profile archive status is archived." ], "description": "Optional. Archive status of this dynamic profile.", "type": "string", "enum": [ "ARCHIVE_STATUS_UNKNOWN", "UNARCHIVED", "ARCHIVED" ] }, "description": { "description": "Optional. Description of this dynamic profile.", "type": "string" }, "active": { "description": "Optional. Active version of the dynamic profile.", "$ref": "DynamicProfileVersion" } }, "id": "DynamicProfile", "type": "object" }, "CompatibleFields": { "properties": { "crossMediaReachReportCompatibleFields": { "$ref": "CrossMediaReachReportCompatibleFields", "description": "Contains items that are compatible to be selected for a report of type \"CROSS_MEDIA_REACH\"." }, "crossDimensionReachReportCompatibleFields": { "description": "Contains items that are compatible to be selected for a report of type \"CROSS_DIMENSION_REACH\".", "$ref": "CrossDimensionReachReportCompatibleFields" }, "pathToConversionReportCompatibleFields": { "description": "Contains items that are compatible to be selected for a report of type \"PATH_TO_CONVERSION\".", "$ref": "PathToConversionReportCompatibleFields" }, "floodlightReportCompatibleFields": { "description": "Contains items that are compatible to be selected for a report of type \"FLOODLIGHT\".", "$ref": "FloodlightReportCompatibleFields" }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#compatibleFields." }, "reachReportCompatibleFields": { "description": "Contains items that are compatible to be selected for a report of type \"REACH\".", "$ref": "ReachReportCompatibleFields" }, "reportCompatibleFields": { "$ref": "ReportCompatibleFields", "description": "Contains items that are compatible to be selected for a report of type \"STANDARD\"." } }, "id": "CompatibleFields", "type": "object", "description": "Represents a response to the queryCompatibleFields method. Next ID: 10" }, "BillingRateTieredRate": { "properties": { "rateInMicros": { "format": "int64", "type": "string", "description": "Rate in micros for this tier." }, "lowValue": { "type": "string", "description": "The minimum for this tier range.", "format": "int64" }, "highValue": { "description": "The maximum for this tier range.", "format": "int64", "type": "string" } }, "id": "BillingRateTieredRate", "type": "object" }, "DynamicFeed": { "description": " *Beta:* This API resource is available only to a very limited number of customers. If you'd like to use this resource, please reach out to your Google sales representative. Contains dynamic feed information.", "type": "object", "id": "DynamicFeed", "properties": { "studioAdvertiserId": { "type": "string", "description": "Required. Advertiser ID of this dynamic feed. This is a required field.", "format": "int64" }, "status": { "type": "string", "enum": [ "STATUS_UNKNOWN", "ACTIVE", "INACTIVE", "DELETED" ], "readOnly": true, "description": "Output only. The status of the feed. It is a read-only field that depends on the the feed ingestion status. The default value is INACTIVE, and it will be updated to ACTIVE once the feed is ingested successfully.", "enumDescriptions": [ "The status is unknown.", "The feedstatus is active.", "The feed status is inactive.", "The feed status is deleted." ] }, "feedIngestionStatus": { "description": "Output only. The ingestion status of the dynamic feed. This is a read-only field.", "readOnly": true, "$ref": "FeedIngestionStatus" }, "dynamicFeedName": { "description": "Optional. Name of this dynamic feed. It is defaulted to content source file name if not provided.", "type": "string" }, "lastModifiedInfo": { "readOnly": true, "$ref": "LastModifiedInfo", "description": "Output only. The last modified timestamp of the dynamic feed. This is a read-only field." }, "element": { "description": "Required. The element of the dynamic feed that is to specify the schema of the feed. This is a required field.", "$ref": "Element" }, "contentSource": { "description": "Required. The content source of the dynamic feed. This is a required field.", "$ref": "ContentSource" }, "dynamicFeedId": { "readOnly": true, "type": "string", "description": "Output only. Unique ID of this dynamic feed. This is a read-only, auto-generated field.", "format": "int64" }, "hasPublished": { "description": "Output only. Indicates whether the dynamic feed has a published version. This is a read-only field.", "type": "boolean", "readOnly": true }, "feedSchedule": { "$ref": "FeedSchedule", "description": "Optional. The schedule of the dynamic feed. It can be set if the feed is published." }, "createInfo": { "description": "Output only. The creation timestamp of the dynamic feed. This is a read-only field.", "$ref": "LastModifiedInfo", "readOnly": true } } }, "AccountUserProfile": { "description": "AccountUserProfiles contains properties of a Campaign Manager user profile. This resource is specifically for managing user profiles, whereas UserProfiles is for accessing the API.", "id": "AccountUserProfile", "properties": { "userAccessType": { "type": "string", "enum": [ "NORMAL_USER", "SUPER_USER", "INTERNAL_ADMINISTRATOR", "READ_ONLY_SUPER_USER" ], "description": "User type of the user profile. This is a read-only field that can be left blank.", "enumDescriptions": [ "Normal user managed by the customer.", "Super user managed by internal support teams.", "Internal administrator having super user access to only a specific set of networks.", "A super-user without permission to mutate any data." ] }, "userRoleFilter": { "description": "Filter that describes which user roles are visible to the user profile.", "$ref": "ObjectFilter" }, "subaccountId": { "description": "Subaccount ID of the user profile. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "id": { "format": "int64", "description": "ID of the user profile. This is a read-only, auto-generated field.", "type": "string" }, "userRoleId": { "type": "string", "format": "int64", "description": "User role ID of the user profile. This is a required field." }, "name": { "description": "Name of the user profile. This is a required field. Must be less than 64 characters long, must be globally unique, and cannot contain whitespace or any of the following characters: \"&;\u003c\u003e\"#%,\".", "type": "string" }, "traffickerType": { "description": "Trafficker type of this user profile. This is a read-only field.", "enumDescriptions": [ "Internal profile, but is not a trafficker.", "Internal profile who is a trafficker.", "External profile who is a trafficker." ], "type": "string", "enum": [ "INTERNAL_NON_TRAFFICKER", "INTERNAL_TRAFFICKER", "EXTERNAL_TRAFFICKER" ] }, "comments": { "type": "string", "description": "Comments for this user profile." }, "accountId": { "type": "string", "format": "int64", "description": "Account ID of the user profile. This is a read-only field that can be left blank." }, "siteFilter": { "description": "Filter that describes which sites are visible to the user profile.", "$ref": "ObjectFilter" }, "email": { "description": "Email of the user profile. The email address must be linked to a Google Account. This field is required on insertion and is read-only after insertion.", "type": "string" }, "locale": { "type": "string", "description": "Locale of the user profile. This is a required field. Acceptable values are: - \"cs\" (Czech) - \"de\" (German) - \"en\" (English) - \"en-GB\" (English United Kingdom) - \"es\" (Spanish) - \"fr\" (French) - \"it\" (Italian) - \"ja\" (Japanese) - \"ko\" (Korean) - \"pl\" (Polish) - \"pt-BR\" (Portuguese Brazil) - \"ru\" (Russian) - \"sv\" (Swedish) - \"tr\" (Turkish) - \"zh-CN\" (Chinese Simplified) - \"zh-TW\" (Chinese Traditional) " }, "active": { "description": "Whether this user profile is active. This defaults to false, and must be set true on insert for the user profile to be usable.", "type": "boolean" }, "advertiserFilter": { "$ref": "ObjectFilter", "description": "Filter that describes which advertisers are visible to the user profile." }, "campaignFilter": { "$ref": "ObjectFilter", "description": "Filter that describes which campaigns are visible to the user profile." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountUserProfile\".", "type": "string" } }, "type": "object" }, "VideoFormat": { "description": "Contains information about supported video formats.", "id": "VideoFormat", "properties": { "targetBitRate": { "description": "The target bit rate of this video format.", "format": "int32", "type": "integer" }, "fileType": { "description": "File type of the video format.", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "FLV", "THREEGPP", "MP4", "WEBM", "M3U8" ] }, "resolution": { "description": "The resolution of this video format.", "$ref": "Size" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#videoFormat\".", "type": "string" }, "id": { "description": "ID of the video format.", "format": "int32", "type": "integer" } }, "type": "object" }, "TvCampaignSummary": { "properties": { "type": { "description": "\"CampaignComponentType\" of this TV campaign.", "type": "string", "enum": [ "CAMPAIGN_COMPONENT_TYPE_UNSPECIFIED", "COMPANY", "BRAND", "PRODUCT", "CAMPAIGN" ], "enumDescriptions": [ "Required to exist; do not use.", "Company.", "Brand.", "Product.", "Campaign." ] }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#tvCampaignSummary\".", "type": "string" }, "startDate": { "description": "The start date of the TV campaign, inclusive. A string of the format: \"yyyy-MM-dd\".", "type": "string" }, "spend": { "description": "Spend across the entire TV campaign.", "type": "number", "format": "double" }, "name": { "description": "Identifier. Name of this TV campaign.", "type": "string" }, "impressions": { "type": "string", "format": "int64", "description": "Impressions across the entire TV campaign." }, "endDate": { "type": "string", "description": "The end date of the TV campaign, inclusive. A string of the format: \"yyyy-MM-dd\"." }, "grp": { "format": "int64", "type": "string", "description": "GRP of this TV campaign." }, "id": { "description": "ID of this TV campaign.", "type": "string" } }, "type": "object", "id": "TvCampaignSummary", "description": "TvCampaignSummary contains aggregate data from a TV campaign." }, "BillingAssignment": { "description": "List account, subaccount, advertiser, and campaign associated with a given Billing Profile.", "type": "object", "id": "BillingAssignment", "properties": { "accountId": { "description": "ID of the account associated with the billing assignment.This is a read-only, auto-generated field.", "type": "string" }, "subaccountId": { "description": "ID of the subaccount associated with the billing assignment.Wildcard (*) means this assignment is not limited to a single subaccountThis is a read-only, auto-generated field.", "type": "string" }, "advertiserId": { "type": "string", "description": "ID of the advertiser associated with the billing assignment.Wildcard (*) means this assignment is not limited to a single advertiser" }, "campaignId": { "description": "ID of the campaign associated with the billing assignment. Wildcard (*) means this assignment is not limited to a single campaign", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#billingAssignment\"." } } }, "AccountUserProfilesListResponse": { "id": "AccountUserProfilesListResponse", "description": "Account User Profile List Response", "type": "object", "properties": { "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountUserProfilesListResponse\".", "type": "string" }, "accountUserProfiles": { "items": { "$ref": "AccountUserProfile" }, "description": "Account user profile collection.", "type": "array" } } }, "DynamicRules": { "type": "object", "id": "DynamicRules", "properties": { "customRules": { "type": "array", "description": "Optional. The custom rules of the dynamic feed, only applicable when rule type is CUSTOM.", "items": { "$ref": "CustomRule" } }, "customValueFields": { "description": "Optional. Mapping between field ID and custom key that are used to match for auto filtering.", "items": { "$ref": "CustomValueField" }, "type": "array" }, "remarketingValueAttributes": { "items": { "$ref": "RemarketingValueAttribute" }, "type": "array", "description": "Optional. The link between an element field ID and a list of user attribute IDs." }, "proximityFilter": { "$ref": "ProximityFilter", "description": "Optional. The proximity targeting rules of the dynamic feed, only applicable when rule type is PROXIMITY_TARGETING." }, "autoTargetedFieldIds": { "description": "Optional. List of field IDs in this element that should be auto-targeted. Applicable when rule type is AUTO.", "type": "array", "items": { "type": "integer", "format": "int32" } }, "ruleType": { "type": "string", "enum": [ "RULE_SET_TYPE_UNKNOWN", "OPEN", "AUTO", "CUSTOM", "PROXIMITY_TARGETING" ], "enumDescriptions": [ "The rule type is unknown. This value is unused.", "The rule type is open, all feed rows are eligible for selection. This is the default value.", "The rule type is auto, the feed rows are eligible for selection based on the automatic rules.", "The rule type is custom, the feed rows are eligible for selection based on the custom rules.", "The rule type is proximity targeting, the feed rows are eligible for selection based on the proximity targeting rules." ], "description": "Optional. The type of the rule, the default value is OPEN." }, "weightFieldId": { "format": "int32", "description": "Optional. The field ID for the feed that will be used for weighted rotation, only applicable when rotation type is WEIGHTED.", "type": "integer" }, "rotationType": { "description": "Optional. The rotation type to select from eligible rows. Rotation type only apply when the filtering rule results in more than one eligible rows.", "type": "string", "enum": [ "ROTATION_TYPE_UNKNOWN", "RANDOM", "OPTIMIZED", "WEIGHTED" ], "enumDescriptions": [ "The rotation type is unknown. This value is unused.", "The rotation type is random. It is the default value.", "The rotation type is optimized.", "The rotation type is weighted." ] } }, "description": "Contains dynamic rules information." }, "RequestValue": { "properties": { "userAttributeIds": { "type": "array", "items": { "type": "string", "format": "int64" }, "description": "Optional. User attribute IDs in the request. Used only when the field type is REMARKETING_VALUE or USER_ATTRIBUTE_ID." }, "excludeFromUserAttributeIds": { "type": "array", "description": "Optional. User attribute IDs in the request that should be excluded. Used only when the field type is REMARKETING_VALUE or USER_ATTRIBUTE_ID.", "items": { "type": "string", "format": "int64" } }, "key": { "type": "string", "description": "Optional. Custom key in the request. Used only when the field type is CUSTOM_VALUE." } }, "type": "object", "id": "RequestValue", "description": "Contains request value information." }, "TargetableRemarketingList": { "description": "Contains properties of a targetable remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource is a read-only view of a remarketing list to be used to facilitate targeting ads to specific lists. Remarketing lists that are owned by your advertisers and those that are shared to your advertisers or account are accessible via this resource. To manage remarketing lists that are owned by your advertisers, use the RemarketingLists resource.", "type": "object", "properties": { "advertiserId": { "type": "string", "format": "int64", "description": "Dimension value for the advertiser ID that owns this targetable remarketing list." }, "active": { "description": "Whether this targetable remarketing list is active.", "type": "boolean" }, "listSource": { "description": "Product from which this targetable remarketing list was originated.", "enumDescriptions": [ "covers sources not supported in DCM other than those listed below", "ADX", "DFP", "XFP", "DoubleClick Campaign Manager", "Google Analytics Premium", "Youtube", "DoubleClick Bid Manager", "G+", "DoubleClick Audience Center", "Playstore" ], "type": "string", "enum": [ "REMARKETING_LIST_SOURCE_OTHER", "REMARKETING_LIST_SOURCE_ADX", "REMARKETING_LIST_SOURCE_DFP", "REMARKETING_LIST_SOURCE_XFP", "REMARKETING_LIST_SOURCE_DFA", "REMARKETING_LIST_SOURCE_GA", "REMARKETING_LIST_SOURCE_YOUTUBE", "REMARKETING_LIST_SOURCE_DBM", "REMARKETING_LIST_SOURCE_GPLUS", "REMARKETING_LIST_SOURCE_DMP", "REMARKETING_LIST_SOURCE_PLAY_STORE" ] }, "name": { "description": "Name of the targetable remarketing list. Is no greater than 128 characters long.", "type": "string" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser.", "$ref": "DimensionValue" }, "lifeSpan": { "description": "Number of days that a user should remain in the targetable remarketing list without an impression.", "type": "string", "format": "int64" }, "id": { "description": "Targetable remarketing list ID.", "type": "string", "format": "int64" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#targetableRemarketingList\".", "type": "string" }, "subaccountId": { "type": "string", "description": "Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.", "format": "int64" }, "accountId": { "type": "string", "format": "int64", "description": "Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests." }, "description": { "type": "string", "description": "Targetable remarketing list description." }, "listSize": { "type": "string", "description": "Number of users currently in the list. This is a read-only field.", "format": "int64" } }, "id": "TargetableRemarketingList" }, "AdsListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#adsListResponse\"." }, "ads": { "items": { "$ref": "Ad" }, "type": "array", "description": "Ad collection." }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } }, "type": "object", "id": "AdsListResponse", "description": "Ad List Response" }, "PlacementStrategy": { "type": "object", "properties": { "name": { "description": "Name of this placement strategy. This is a required field. It must be less than 256 characters long and unique among placement strategies of the same account.", "type": "string" }, "id": { "description": "ID of this placement strategy. This is a read-only, auto-generated field.", "type": "string", "format": "int64" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementStrategy\".", "type": "string" }, "accountId": { "format": "int64", "description": "Account ID of this placement strategy.This is a read-only field that can be left blank.", "type": "string" } }, "description": "Contains properties of a placement strategy.", "id": "PlacementStrategy" }, "CustomViewabilityMetric": { "description": "Custom Viewability Metric", "type": "object", "id": "CustomViewabilityMetric", "properties": { "name": { "description": "Name of the custom viewability metric.", "type": "string" }, "configuration": { "description": "Configuration of the custom viewability metric.", "$ref": "CustomViewabilityMetricConfiguration" }, "id": { "format": "int64", "description": "ID of the custom viewability metric.", "type": "string" } } }, "FileList": { "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#fileList\".", "type": "string" }, "etag": { "description": "Etag of this resource.", "type": "string" }, "items": { "type": "array", "items": { "$ref": "File" }, "description": "The files returned in this response." }, "nextPageToken": { "description": "Continuation token used to page through files. To retrieve the next page of results, set the next request's \"pageToken\" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.", "type": "string" } }, "id": "FileList", "description": "List of files for a report." }, "TranscodeSetting": { "type": "object", "id": "TranscodeSetting", "description": "Transcode Settings", "properties": { "enabledVideoFormats": { "items": { "type": "integer", "format": "int32" }, "description": "Allowlist of video formats to be served to this placement. Set this list to null or empty to serve all video formats.", "type": "array" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#transcodeSetting\"." } } }, "AccountPermissionGroup": { "type": "object", "id": "AccountPermissionGroup", "properties": { "name": { "description": "Name of this account permission group.", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountPermissionGroup\"." }, "id": { "type": "string", "description": "ID of this account permission group.", "format": "int64" } }, "description": "AccountPermissionGroups contains a mapping of permission group IDs to names. A permission group is a grouping of account permissions." }, "Metric": { "id": "Metric", "description": "Represents a metric.", "type": "object", "properties": { "name": { "description": "The metric name, e.g. impressions", "type": "string" }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#metric." } } }, "CrossDimensionReachReportCompatibleFields": { "properties": { "breakdown": { "type": "array", "description": "Dimensions which are compatible to be selected in the \"breakdown\" section of the report.", "items": { "$ref": "Dimension" } }, "dimensionFilters": { "items": { "$ref": "Dimension" }, "type": "array", "description": "Dimensions which are compatible to be selected in the \"dimensionFilters\" section of the report." }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#crossDimensionReachReportCompatibleFields." }, "overlapMetrics": { "items": { "$ref": "Metric" }, "type": "array", "description": "Metrics which are compatible to be selected in the \"overlapMetricNames\" section of the report." }, "metrics": { "type": "array", "items": { "$ref": "Metric" }, "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report." } }, "id": "CrossDimensionReachReportCompatibleFields", "type": "object", "description": "Represents fields that are compatible to be selected for a report of type \"CROSS_DIMENSION_REACH\"." }, "CartDataItem": { "type": "object", "description": "Contains data of the items purchased.", "id": "CartDataItem", "properties": { "unitPrice": { "description": "Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.", "type": "number", "format": "double" }, "quantity": { "type": "integer", "format": "int32", "description": "Number of items sold. This is a required field." }, "itemId": { "description": "The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.", "type": "string" } } }, "TargetingTemplatesListResponse": { "properties": { "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#targetingTemplatesListResponse\"." }, "targetingTemplates": { "type": "array", "items": { "$ref": "TargetingTemplate" }, "description": "Targeting template collection." } }, "id": "TargetingTemplatesListResponse", "description": "Targeting Template List Response", "type": "object" }, "AdvertiserInvoicesListResponse": { "id": "AdvertiserInvoicesListResponse", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertiserInvoicesListResponse\"." }, "invoices": { "type": "array", "items": { "$ref": "Invoice" }, "description": "Invoice collection" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "type": "object", "description": "Invoice List Response" }, "OfflineUserAddressInfo": { "type": "object", "description": "Identify a user by name and address.", "properties": { "city": { "description": "City of the address.", "type": "string" }, "hashedFirstName": { "type": "string", "description": "First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between)." }, "state": { "description": "State code of the address.", "type": "string" }, "countryCode": { "description": "2-letter country code in ISO-3166-1 alpha-2 of the user's address.", "type": "string" }, "hashedStreetAddress": { "type": "string", "description": "The street address of the user hashed using SHA-256 hash function after normalization (lower case only)." }, "postalCode": { "description": "Postal code of the user's address.", "type": "string" }, "hashedLastName": { "type": "string", "description": "Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation)." } }, "id": "OfflineUserAddressInfo" }, "ColumnHeader": { "properties": { "name": { "type": "string", "description": "Output only. The column name.", "readOnly": true }, "type": { "description": "Output only. The column type.", "readOnly": true, "enumDescriptions": [ "Default value. This value is unused.", "Dimension.", "Metric." ], "type": "string", "enum": [ "COLUMN_TYPE_UNSPECIFIED", "DIMENSION", "METRIC" ] } }, "id": "ColumnHeader", "description": "A column header in the report.", "type": "object" }, "FloodlightActivityDynamicTag": { "properties": { "id": { "type": "string", "description": "ID of this dynamic tag. This is a read-only, auto-generated field.", "format": "int64" }, "name": { "type": "string", "description": "Name of this tag." }, "tag": { "description": "Tag code.", "type": "string" } }, "type": "object", "id": "FloodlightActivityDynamicTag", "description": "Dynamic Tag" }, "LookbackConfiguration": { "description": "Lookback configuration settings.", "properties": { "postImpressionActivitiesDuration": { "format": "int32", "type": "integer", "description": "Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive." }, "clickDuration": { "description": "Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.", "format": "int32", "type": "integer" } }, "type": "object", "id": "LookbackConfiguration" }, "DayPartTargeting": { "description": "Day Part Targeting.", "type": "object", "properties": { "hoursOfDay": { "items": { "type": "integer", "format": "int32" }, "description": "Hours of the day when the ad will serve, where 0 is midnight to 1 AM and 23 is 11 PM to midnight. Can be specified with days of week, in which case the ad would serve during these hours on the specified days. For example if Monday, Wednesday, Friday are the days of week specified and 9-10am, 3-5pm (hours 9, 15, and 16) is specified, the ad would serve Monday, Wednesdays, and Fridays at 9-10am and 3-5pm. Acceptable values are 0 to 23, inclusive.", "type": "array" }, "daysOfWeek": { "items": { "enumDescriptions": [ "", "", "", "", "", "", "" ], "type": "string", "enum": [ "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" ] }, "description": "Days of the week when the ad will serve. Acceptable values are: - \"SUNDAY\" - \"MONDAY\" - \"TUESDAY\" - \"WEDNESDAY\" - \"THURSDAY\" - \"FRIDAY\" - \"SATURDAY\" ", "type": "array" }, "userLocalTime": { "type": "boolean", "description": "Whether or not to use the user's local time. If false, the America/New York time zone applies." } }, "id": "DayPartTargeting" }, "FloodlightActivityGroupsListResponse": { "description": "Floodlight Activity Group List Response", "type": "object", "id": "FloodlightActivityGroupsListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightActivityGroupsListResponse\".", "type": "string" }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "floodlightActivityGroups": { "items": { "$ref": "FloodlightActivityGroup" }, "description": "Floodlight activity group collection.", "type": "array" } } }, "YoutubeSettings": { "type": "object", "description": "Contains the YouTube settings.", "properties": { "longHeadlines": { "description": "Optional. The long headlines. Currently only one long headline is supported.", "type": "array", "items": { "type": "string" } }, "callToActions": { "description": "Optional. The call to actions. Currently only one call to action is supported.", "items": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "CALL_TO_ACTION_UNKNOWN", "CALL_TO_ACTION_LEARN_MORE", "CALL_TO_ACTION_GET_QUOTE", "CALL_TO_ACTION_APPLY_NOW", "CALL_TO_ACTION_SIGN_UP", "CALL_TO_ACTION_CONTACT_US", "CALL_TO_ACTION_SUBSCRIBE", "CALL_TO_ACTION_DOWNLOAD", "CALL_TO_ACTION_BOOK_NOW", "CALL_TO_ACTION_GET_OFFER", "CALL_TO_ACTION_SHOP_NOW", "CALL_TO_ACTION_VISIT_STORE", "CALL_TO_ACTION_CALL_NOW", "CALL_TO_ACTION_VIEW_MENU", "CALL_TO_ACTION_TEST_DRIVE", "CALL_TO_ACTION_SCHEDULE_NOW", "CALL_TO_ACTION_BUY_NOW", "CALL_TO_ACTION_DONATE_NOW", "CALL_TO_ACTION_ORDER_NOW", "CALL_TO_ACTION_PLAY_NOW", "CALL_TO_ACTION_SEE_MORE", "CALL_TO_ACTION_START_NOW", "CALL_TO_ACTION_VISIT_SITE", "CALL_TO_ACTION_WATCH_NOW" ] }, "type": "array" }, "businessName": { "type": "string", "description": "Optional. The business name." }, "headlines": { "type": "array", "items": { "type": "string" }, "description": "Optional. The headlines associated with the call to actions. Currently only one headline is supported." }, "businessLogoCreativeIds": { "type": "array", "items": { "format": "int64", "type": "string" }, "description": "Optional. The IDs of the creatives to use for the business logo. Currently only one creative is supported." }, "descriptions": { "items": { "type": "string" }, "type": "array", "description": "Optional. The descriptions. Currently only one description is supported." } }, "id": "YoutubeSettings" }, "TargetWindow": { "id": "TargetWindow", "description": "Target Window.", "properties": { "customHtml": { "description": "User-entered value.", "type": "string" }, "targetWindowOption": { "enumDescriptions": [ "Open up a new window to display the backup image Corresponds to \"_blank\" in html", "Use the current window to display the backup image Corresponds to \"_top\" in html", "User-defined HTML used to display the backup image Corresponds to \"other\"" ], "description": "Type of browser window for which the backup image of the flash creative can be displayed.", "type": "string", "enum": [ "NEW_WINDOW", "CURRENT_WINDOW", "CUSTOM" ] } }, "type": "object" }, "AdditionalAsset": { "properties": { "displayUrl": { "type": "string", "description": "Optional. Display URL for the creative." }, "coverImages": { "items": { "$ref": "CreativeAsset" }, "description": "Optional. Cover images for the creative.", "type": "array" }, "headlines": { "type": "array", "items": { "type": "string" }, "description": "Optional. Headlines for the creative." }, "descriptions": { "description": "Optional. Descriptions for the creative.", "type": "array", "items": { "type": "string" } }, "longDescriptions": { "description": "Optional. Long descriptions for the creative.", "type": "array", "items": { "type": "string" } }, "longHeadlines": { "items": { "type": "string" }, "description": "Optional. Long headlines for the creative.", "type": "array" }, "callToActions": { "items": { "type": "string" }, "description": "Optional. Call to actions for the creative.", "type": "array" } }, "description": "Additional assets for a creative.", "type": "object", "id": "AdditionalAsset" }, "DimensionFilter": { "type": "object", "description": "Represents a dimension filter.", "id": "DimensionFilter", "properties": { "dimensionName": { "type": "string", "description": "The name of the dimension to filter." }, "value": { "type": "string", "description": "The value of the dimension to filter." }, "kind": { "description": "The kind of resource this is, in this case dfareporting#dimensionFilter.", "type": "string" } } }, "UserRolePermissionGroup": { "properties": { "id": { "format": "int64", "type": "string", "description": "ID of this user role permission." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRolePermissionGroup\".", "type": "string" }, "name": { "description": "Name of this user role permission group.", "type": "string" } }, "id": "UserRolePermissionGroup", "description": "Represents a grouping of related user role permissions.", "type": "object" }, "Advertiser": { "description": "Contains properties of a Campaign Manager advertiser.", "properties": { "measurementPartnerLink": { "$ref": "MeasurementPartnerAdvertiserLink", "description": "Measurement partner advertiser link for tag wrapping." }, "name": { "description": "Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account.", "type": "string" }, "defaultClickThroughEventTagId": { "description": "ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns.", "type": "string", "format": "int64" }, "euPoliticalAdsDeclaration": { "enumDescriptions": [ "You'll need to confirm if your campaign contains EU political advertising.", "All new campaigns will have “No” selected for the question that asks if your campaign has EU political ads. You can change this for any campaign at any time." ], "description": "Optional. Whether the advertiser plans to serve EU political ads.", "type": "string", "enum": [ "ADVERTISER_PLANS_TO_SERVE_EU_POLITICAL_ADS", "ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS" ] }, "suspended": { "description": "Suspension status of this advertiser.", "type": "boolean" }, "subaccountId": { "format": "int64", "type": "string", "description": "Subaccount ID of this advertiser.This is a read-only field that can be left blank." }, "accountId": { "type": "string", "format": "int64", "description": "Account ID of this advertiser.This is a read-only field that can be left blank." }, "id": { "type": "string", "format": "int64", "description": "ID of this advertiser. This is a read-only, auto-generated field." }, "idDimensionValue": { "description": "Dimension value for the ID of this advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "clickThroughUrlSuffix": { "description": "Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long.", "type": "string" }, "floodlightConfigurationIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field." }, "status": { "enumDescriptions": [ "Approved (ads can deliver)", "On-hold (all ads are stopped)" ], "description": "Status of this advertiser.", "type": "string", "enum": [ "APPROVED", "ON_HOLD" ] }, "advertiserGroupId": { "type": "string", "format": "int64", "description": "ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertiser\".", "type": "string" }, "defaultEmail": { "type": "string", "description": "Default email address used in sender field for tag emails." }, "originalFloodlightConfigurationId": { "description": "Original floodlight configuration before any sharing occurred. Set the floodlightConfigurationId of this advertiser to originalFloodlightConfigurationId to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement.", "type": "string", "format": "int64" }, "floodlightConfigurationId": { "format": "int64", "description": "Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as: - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups. - This advertiser's original floodlight configuration is not already shared with another advertiser. ", "type": "string" } }, "type": "object", "id": "Advertiser" }, "RegionsListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#regionsListResponse\"." }, "regions": { "description": "Region collection.", "type": "array", "items": { "$ref": "Region" } } }, "description": "Region List Response", "type": "object", "id": "RegionsListResponse" }, "BillingRate": { "type": "object", "properties": { "endDate": { "description": "End date of this billing rate.", "type": "string" }, "startDate": { "description": "Start date of this billing rate.", "type": "string" }, "currencyCode": { "type": "string", "description": "Billing currency code in ISO 4217 format." }, "id": { "format": "int64", "type": "string", "description": "ID of this billing rate." }, "rateInMicros": { "type": "string", "format": "int64", "description": "Flat rate in micros of this billing rate. This cannot co-exist with tiered rate." }, "name": { "description": "Name of this billing rate. This must be less than 256 characters long.", "type": "string" }, "tieredRates": { "type": "array", "description": "Tiered rate of this billing rate. This cannot co-exist with flat rate.", "items": { "$ref": "BillingRateTieredRate" } }, "type": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "AD_SERVING", "CLICKS", "MINIMUM_SERVICE", "PATH_TO_CONVERSION", "RICH_MEDIA_INPAGE", "RICH_MEDIA_EXPANDING", "RICH_MEDIA_FLOATING", "RICH_MEDIA_VIDEO", "RICH_MEDIA_TEASER", "RICH_MEDIA_VPAID", "INSTREAM_VIDEO", "PIXEL", "TRACKING", "TRAFFICKING_FEATURE", "CUSTOM_REPORTS", "EXPOSURE_TO_CONVERSION", "DATA_TRANSFER", "DATA_TRANSFER_SETUP", "STARTUP", "STATEMENT_OF_WORK", "PROVIDED_LIST", "PROVIDED_LIST_SETUP", "ENHANCED_FORMATS", "TRACKING_AD_IMPRESSIONS", "TRACKING_AD_CLICKS", "NIELSEN_DIGITAL_AD_RATINGS_FEE", "INSTREAM_VIDEO_REDIRECT", "INSTREAM_VIDEO_VPAID", "DISPLAY_AD_SERVING", "VIDEO_AD_SERVING", "AUDIO_AD_SERVING", "ADVANCED_DISPLAY_AD_SERVING" ], "description": "Type of this billing rate." }, "unitOfMeasure": { "type": "string", "enum": [ "CPM", "CPC", "EA", "P2C" ], "enumDescriptions": [ "", "", "", "" ], "description": "Unit of measure for this billing rate." } }, "id": "BillingRate" }, "Language": { "description": "Contains information about a language that can be targeted by ads.", "id": "Language", "properties": { "name": { "description": "Name of this language.", "type": "string" }, "languageCode": { "description": "Format of language code is an ISO 639 two-letter language code optionally followed by an underscore followed by an ISO 3166 code. Examples are \"en\" for English or \"zh_CN\" for Simplified Chinese.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#language\".", "type": "string" }, "id": { "format": "int64", "description": "Language ID of this language. This is the ID used for targeting and generating reports.", "type": "string" } }, "type": "object" }, "CartData": { "id": "CartData", "description": "Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788)", "properties": { "items": { "description": "Data of the items purchased.", "type": "array", "items": { "$ref": "CartDataItem" } }, "merchantId": { "format": "int64", "description": "The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details.", "type": "string" }, "merchantFeedLabel": { "type": "string", "description": "The feed labels associated with the feed where your items are uploaded. For more information, please refer to \u200b\u200b https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details." }, "merchantFeedLanguage": { "description": "The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details.", "type": "string" } }, "type": "object" }, "CreativeFieldAssignment": { "type": "object", "description": "Creative Field Assignment.", "id": "CreativeFieldAssignment", "properties": { "creativeFieldId": { "description": "ID of the creative field.", "format": "int64", "type": "string" }, "creativeFieldValueId": { "format": "int64", "description": "ID of the creative field value.", "type": "string" } } }, "TvCampaignTimepoint": { "properties": { "spend": { "type": "number", "format": "double", "description": "The spend within the time range of the timepoint." }, "dateWindow": { "description": "The date window of the timepoint.", "type": "string", "enum": [ "WEEKS_UNSPECIFIED", "DAYS_ONE", "WEEKS_ONE", "WEEKS_FOUR", "WEEKS_EIGHT", "WEEKS_TWELVE" ], "enumDescriptions": [ "Default value, should never be set.", "One Day.", "One week.", "Four weeks.", "Eight weeks.", "Twelve weeks." ] }, "startDate": { "type": "string", "description": "The start date of the timepoint. A string in the format of \"yyyy-MM-dd\"." } }, "description": "A single data point for TvCampaignDetail, which holds information about the TV campaign for a specific start date and date window.", "id": "TvCampaignTimepoint", "type": "object" }, "PlacementConversionDomainOverride": { "properties": { "conversionDomains": { "type": "array", "items": { "$ref": "PlacementSingleConversionDomain" } } }, "id": "PlacementConversionDomainOverride", "type": "object" }, "SiteVideoSettings": { "type": "object", "description": "Video Settings", "id": "SiteVideoSettings", "properties": { "publisherSpecificationId": { "description": "Publisher specification ID used to identify site-associated publisher requirements and automatically populate transcode settings. If publisher specification ID is specified, it will take precedence over transcode settings. Possible values are: * `1`, Hulu * `2`, NBC * `3`, CBS * `4`, CBS Desktop * `5`, Discovery * `6`, VEVO HD * `7`, VEVO Vertical * `8`, Fox * `9`, CW Network * `10`, Disney * `11`, IGN * `12`, NFL.com * `13`, Turner Broadcasting * `14`, Tubi on Fox * `15`, Hearst Corporation * `16`, Twitch Desktop * `17`, ABC * `18`, Univision * `19`, MLB.com * `20`, MLB.com Mobile * `21`, MLB.com OTT * `22`, Polsat * `23`, TVN * `24`, Mediaset * `25`, Antena 3 * `26`, Mediamond * `27`, Sky Italia * `28`, Tubi on CBS * `29`, Spotify * `30`, Paramount * `31`, Max", "type": "string", "format": "int64" }, "companionSettings": { "description": "Settings for the companion creatives of video creatives served to this site.", "$ref": "SiteCompanionSetting" }, "transcodeSettings": { "$ref": "SiteTranscodeSetting", "description": "Settings for the transcodes of video creatives served to this site. This will act as default for new placements created under this site." }, "orientation": { "enumDescriptions": [ "", "", "" ], "description": "Orientation of a site template used for video. This will act as default for new placements created under this site.", "type": "string", "enum": [ "ANY", "LANDSCAPE", "PORTRAIT" ] }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#siteVideoSettings\".", "type": "string" }, "obaSettings": { "description": "Settings for the OBA icon of video creatives served to this site. This will act as default for new placements created under this site.", "$ref": "ObaIcon" }, "obaEnabled": { "type": "boolean", "description": "Whether OBA icons are enabled for this placement." }, "skippableSettings": { "description": "Settings for the skippability of video creatives served to this site. This will act as default for new placements created under this site.", "$ref": "SiteSkippableSetting" } } }, "RemarketingValueAttribute": { "description": "Contains remarketing value attribute information.", "type": "object", "id": "RemarketingValueAttribute", "properties": { "userAttributeIds": { "type": "array", "items": { "format": "int64", "type": "string" }, "description": "Optional. Remarketing user attribute IDs for auto filtering." }, "fieldId": { "type": "integer", "format": "int32", "description": "Optional. Field ID in the element." } } }, "ChangeLog": { "type": "object", "id": "ChangeLog", "description": "Describes a change that a user has made to a resource.", "properties": { "objectType": { "description": "Object type of the change log.", "type": "string" }, "subaccountId": { "format": "int64", "type": "string", "description": "Subaccount ID of the modified object." }, "id": { "format": "int64", "type": "string", "description": "ID of this change log." }, "oldValue": { "description": "Old value of the object field.", "type": "string" }, "objectId": { "format": "int64", "type": "string", "description": "ID of the object of this change log. The object could be a campaign, placement, ad, or other type." }, "newValue": { "type": "string", "description": "New value of the object field." }, "userProfileName": { "type": "string", "description": "User profile name of the user who modified the object." }, "fieldName": { "description": "Field name of the object which changed.", "type": "string" }, "accountId": { "format": "int64", "type": "string", "description": "Account ID of the modified object." }, "action": { "type": "string", "description": "Action which caused the change." }, "transactionId": { "format": "int64", "type": "string", "description": "Transaction ID of this change log. When a single API call results in many changes, each change will have a separate ID in the change log but will share the same transactionId." }, "changeTime": { "format": "date-time", "type": "string" }, "userProfileId": { "type": "string", "format": "int64", "description": "ID of the user who modified the object." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#changeLog\"." } } }, "CreativeGroupsListResponse": { "id": "CreativeGroupsListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeGroupsListResponse\".", "type": "string" }, "creativeGroups": { "items": { "$ref": "CreativeGroup" }, "description": "Creative group collection.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "description": "Creative Group List Response", "type": "object" }, "DynamicTargetingKey": { "type": "object", "id": "DynamicTargetingKey", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#dynamicTargetingKey\".", "type": "string" }, "name": { "description": "Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.", "type": "string" }, "objectId": { "description": "ID of the object of this dynamic targeting key. This is a required field.", "format": "int64", "type": "string" }, "objectType": { "type": "string", "enum": [ "OBJECT_ADVERTISER", "OBJECT_AD", "OBJECT_CREATIVE", "OBJECT_PLACEMENT" ], "description": "Type of the object of this dynamic targeting key. This is a required field.", "enumDescriptions": [ "", "", "", "" ] } }, "description": "Contains properties of a dynamic targeting key. Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with Studio dynamic creatives. Use these labels instead of numeric Campaign Manager IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds." }, "CreativeField": { "description": "Contains properties of a creative field.", "id": "CreativeField", "type": "object", "properties": { "accountId": { "type": "string", "description": "Account ID of this creative field. This is a read-only field that can be left blank.", "format": "int64" }, "advertiserId": { "type": "string", "description": "Advertiser ID of this creative field. This is a required field on insertion.", "format": "int64" }, "id": { "type": "string", "format": "int64", "description": "ID of this creative field. This is a read-only, auto-generated field." }, "subaccountId": { "description": "Subaccount ID of this creative field. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeField\".", "type": "string" }, "name": { "type": "string", "description": "Name of this creative field. This is a required field and must be less than 256 characters long and unique among creative fields of the same advertiser." } } }, "PlacementSingleConversionDomain": { "properties": { "conversionDomainValue": { "type": "string" }, "conversionDomainId": { "type": "string", "format": "int64" } }, "id": "PlacementSingleConversionDomain", "type": "object" }, "AudienceSegmentGroup": { "description": "Audience Segment Group.", "id": "AudienceSegmentGroup", "type": "object", "properties": { "name": { "description": "Name of this audience segment group. This is a required field and must be less than 65 characters long.", "type": "string" }, "audienceSegments": { "type": "array", "description": "Audience segments assigned to this group. The number of segments must be between 2 and 100.", "items": { "$ref": "AudienceSegment" } }, "id": { "format": "int64", "description": "ID of this audience segment group. This is a read-only, auto-generated field.", "type": "string" } } }, "ListPopulationClause": { "properties": { "terms": { "items": { "$ref": "ListPopulationTerm" }, "description": "Terms of this list population clause. Each clause is made up of list population terms representing constraints and are joined by ORs.", "type": "array" } }, "type": "object", "id": "ListPopulationClause", "description": "A group clause made up of list population terms representing constraints joined by ORs." }, "BillingProfilesListResponse": { "type": "object", "id": "BillingProfilesListResponse", "description": "Billing profile List Response", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#billingProfilesListResponse\"." }, "billingProfiles": { "type": "array", "description": "Billing profiles collection.", "items": { "$ref": "BillingProfile" } }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } } }, "ConversionStatus": { "properties": { "conversion": { "$ref": "Conversion", "description": "The original conversion that was inserted or updated." }, "errors": { "description": "A list of errors related to this conversion.", "items": { "$ref": "ConversionError" }, "type": "array" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionStatus\".", "type": "string" } }, "type": "object", "description": "The original conversion that was inserted or updated and whether there were any errors.", "id": "ConversionStatus" }, "CreativeGroupAssignment": { "id": "CreativeGroupAssignment", "description": "Creative Group Assignment.", "type": "object", "properties": { "creativeGroupId": { "format": "int64", "description": "ID of the creative group to be assigned.", "type": "string" }, "creativeGroupNumber": { "type": "string", "enum": [ "CREATIVE_GROUP_ONE", "CREATIVE_GROUP_TWO" ], "description": "Creative group number of the creative group assignment.", "enumDescriptions": [ "", "" ] } } }, "Conversion": { "description": "A Conversion represents when a user successfully performs a desired action after seeing an ad.", "type": "object", "properties": { "matchId": { "description": "The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field.", "type": "string" }, "floodlightActivityId": { "format": "int64", "description": "Floodlight Activity ID of this conversion. This is a required field.", "type": "string" }, "limitAdTracking": { "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.", "type": "boolean" }, "encryptedUserIdCandidates": { "items": { "type": "string" }, "type": "array", "description": "A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field." }, "customVariables": { "items": { "$ref": "CustomFloodlightVariable" }, "description": "Custom floodlight variables.", "type": "array" }, "encryptedUserId": { "description": "The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.", "type": "string" }, "mobileDeviceId": { "type": "string", "description": "The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field." }, "cartData": { "description": "The cart data associated with this conversion.", "$ref": "CartData" }, "sessionAttributesEncoded": { "description": "Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.", "format": "byte", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversion\"." }, "adUserDataConsent": { "type": "string", "enum": [ "GRANTED", "DENIED" ], "enumDescriptions": [ "Granted.", "Denied." ], "description": "This represents consent for ad user data." }, "gclid": { "type": "string", "description": "The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field." }, "userIdentifiers": { "items": { "$ref": "UserIdentifier" }, "type": "array", "description": "The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5." }, "quantity": { "description": "The quantity of the conversion. This is a required field.", "format": "int64", "type": "string" }, "treatmentForUnderage": { "type": "boolean", "description": "Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR)." }, "timestampMicros": { "format": "int64", "description": "The timestamp of conversion, in Unix epoch micros. This is a required field.", "type": "string" }, "floodlightConfigurationId": { "type": "string", "description": "Floodlight Configuration ID of this conversion. This is a required field.", "format": "int64" }, "value": { "type": "number", "description": "The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.", "format": "double" }, "ordinal": { "type": "string", "description": "The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field." }, "dclid": { "description": "The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field.", "type": "string" }, "impressionId": { "description": "The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set.", "type": "string" }, "nonPersonalizedAd": { "type": "boolean", "description": "Whether the conversion was for a non personalized ad." }, "childDirectedTreatment": { "type": "boolean", "description": "Whether this particular request may come from a user under the age of 13, under COPPA compliance." } }, "id": "Conversion" }, "ConnectionTypesListResponse": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#connectionTypesListResponse\".", "type": "string" }, "connectionTypes": { "items": { "$ref": "ConnectionType" }, "description": "Collection of connection types such as broadband and mobile.", "type": "array" } }, "id": "ConnectionTypesListResponse", "description": "Connection Type List Response", "type": "object" }, "DynamicFeedsInsertRequest": { "type": "object", "id": "DynamicFeedsInsertRequest", "properties": { "dynamicProfileId": { "type": "string", "format": "int64", "description": "Required. Dynamic profile ID of the inserted dynamic feed." }, "dynamicFeed": { "description": "Required. Dynamic feed to insert.", "$ref": "DynamicFeed" } }, "description": "Dynamic profile ID is required for dynamic feed insert as the current GPA API only can create a dynamic feed under profile context,even though the dynamic feed itself don't need the dynamic profile id." }, "SiteSettings": { "properties": { "disableNewCookie": { "description": "Whether new cookies are disabled for this site.", "type": "boolean" }, "vpaidAdapterChoiceTemplate": { "enumDescriptions": [ "DEFAULT means Google chooses which adapter, if any, to serve.", "", "", "" ], "description": "Default VPAID adapter setting for new placements created under this site. This value will be used to populate the placements.vpaidAdapterChoice field, when no value is specified for the new placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to the placement. The publisher's specifications will typically determine this setting. For VPAID creatives, the adapter format will match the VPAID format (HTML5 VPAID creatives use the HTML5 adapter). *Note:* Flash is no longer supported. This field now defaults to HTML5 when the following values are provided: FLASH, BOTH.", "type": "string", "enum": [ "DEFAULT", "FLASH", "HTML5", "BOTH" ] }, "videoActiveViewOptOutTemplate": { "description": "Whether Verification and ActiveView for in-stream video creatives are disabled by default for new placements created under this site. This value will be used to populate the placement.videoActiveViewOptOut field, when no value is specified for the new placement.", "type": "boolean" }, "adBlockingOptOut": { "type": "boolean", "description": "Whether this site opts out of ad blocking. When true, ad blocking is disabled for all placements under the site, regardless of the individual placement settings. When false, the campaign and placement settings take effect." }, "tagSetting": { "description": "Configuration settings for dynamic and image floodlight tags.", "$ref": "TagSetting" }, "activeViewOptOut": { "type": "boolean", "description": "Whether active view creatives are disabled for this site." } }, "description": "Site Settings", "id": "SiteSettings", "type": "object" }, "BillingRatesListResponse": { "properties": { "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "billingRates": { "description": "Billing rates collection.", "type": "array", "items": { "$ref": "BillingRate" } }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#billingRatesListResponse\"." } }, "id": "BillingRatesListResponse", "description": "Billing Rate List Response", "type": "object" }, "TagData": { "id": "TagData", "type": "object", "properties": { "adId": { "description": "Ad associated with this placement tag. Applicable only when format is PLACEMENT_TAG_TRACKING.", "type": "string", "format": "int64" }, "format": { "type": "string", "enum": [ "PLACEMENT_TAG_STANDARD", "PLACEMENT_TAG_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_IFRAME_ILAYER", "PLACEMENT_TAG_INTERNAL_REDIRECT", "PLACEMENT_TAG_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT", "PLACEMENT_TAG_CLICK_COMMANDS", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH", "PLACEMENT_TAG_TRACKING", "PLACEMENT_TAG_TRACKING_IFRAME", "PLACEMENT_TAG_TRACKING_JAVASCRIPT", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3", "PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4", "PLACEMENT_TAG_TRACKING_THIRD_PARTY_MEASUREMENT" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "description": "TagData tag format of this tag." }, "creativeId": { "format": "int64", "type": "string", "description": "Creative associated with this placement tag. Applicable only when format is PLACEMENT_TAG_TRACKING." }, "clickTag": { "type": "string", "description": "Tag string to record a click." }, "impressionTag": { "type": "string", "description": "Tag string for serving an ad." } }, "description": "Placement Tag Data" }, "DfareportingStudioCreativeAssetsInsertRequest": { "description": "Request message for DfareportingStudioCreativeAssets.Insert.", "type": "object", "id": "DfareportingStudioCreativeAssetsInsertRequest", "properties": { "studioAdvertiserId": { "description": "Required. Studio advertiser ID of the studio creative asset. It is a required field on insertion.", "type": "string", "format": "int64" }, "studioAccountId": { "type": "string", "description": "Optional. Studio account ID of the studio creative asset. It is a optional.", "format": "int64" }, "studioCreativeId": { "format": "int64", "type": "string", "description": "Optional. Studio creative ID of the studio creative asset. It is a optional field. If it is set, the asset will be associated to the creative." } } }, "ChangeLogsListResponse": { "properties": { "changeLogs": { "items": { "$ref": "ChangeLog" }, "description": "Change log collection.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#changeLogsListResponse\"." } }, "type": "object", "id": "ChangeLogsListResponse", "description": "Change Log List Response" }, "DynamicProfileVersion": { "properties": { "dynamicProfileFeedSettings": { "type": "array", "description": "Optional. Associated dynamic feeds and their settings (including dynamic rules) for this dynamic profile version.", "items": { "$ref": "DynamicProfileFeedSettings" } }, "versionId": { "readOnly": true, "type": "string", "description": "Output only. Version ID of this dynamic profile version. This is a read-only, auto-generated field. -1 for draft version, 0+ for published versions.", "format": "int64" } }, "description": "Contains dynamic profile version information.", "id": "DynamicProfileVersion", "type": "object" }, "FloodlightConfiguration": { "properties": { "lookbackConfiguration": { "description": "Lookback window settings for this floodlight configuration.", "$ref": "LookbackConfiguration" }, "exposureToConversionEnabled": { "type": "boolean", "description": "Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting." }, "inAppAttributionTrackingEnabled": { "description": "Whether in-app attribution tracking is enabled.", "type": "boolean" }, "tagSettings": { "$ref": "TagSettings", "description": "Configuration settings for dynamic and image floodlight tags." }, "naturalSearchConversionAttributionOption": { "description": "Types of attribution options for natural search conversions.", "type": "string", "enum": [ "EXCLUDE_NATURAL_SEARCH_CONVERSION_ATTRIBUTION", "INCLUDE_NATURAL_SEARCH_CONVERSION_ATTRIBUTION", "INCLUDE_NATURAL_SEARCH_TIERED_CONVERSION_ATTRIBUTION" ], "enumDescriptions": [ "", "", "" ] }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightConfiguration\"." }, "firstDayOfWeek": { "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "SUNDAY", "MONDAY" ] }, "advertiserIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field." }, "omnitureSettings": { "$ref": "OmnitureSettings", "description": "Settings for Campaign Manager Omniture integration." }, "accountId": { "format": "int64", "description": "Account ID of this floodlight configuration. This is a read-only field that can be left blank.", "type": "string" }, "userDefinedVariableConfigurations": { "type": "array", "description": "List of user defined variables enabled for this configuration.", "items": { "$ref": "UserDefinedVariableConfiguration" } }, "advertiserId": { "type": "string", "description": "Advertiser ID of the parent advertiser of this floodlight configuration.", "format": "int64" }, "customViewabilityMetric": { "description": "Custom Viewability metric for the floodlight configuration.", "$ref": "CustomViewabilityMetric" }, "idDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field." }, "id": { "description": "ID of this floodlight configuration. This is a read-only, auto-generated field.", "format": "int64", "type": "string" }, "analyticsDataSharingEnabled": { "description": "Whether advertiser data is shared with Google Analytics.", "type": "boolean" }, "subaccountId": { "description": "Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "thirdPartyAuthenticationTokens": { "items": { "$ref": "ThirdPartyAuthenticationToken" }, "description": "List of third-party authentication tokens enabled for this configuration.", "type": "array" } }, "type": "object", "description": "Contains properties of a Floodlight configuration.", "id": "FloodlightConfiguration" }, "PlatformTypesListResponse": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#platformTypesListResponse\".", "type": "string" }, "platformTypes": { "items": { "$ref": "PlatformType" }, "description": "Platform type collection.", "type": "array" } }, "id": "PlatformTypesListResponse", "description": "Platform Type List Response", "type": "object" }, "Account": { "description": "Contains properties of a Campaign Manager account.", "type": "object", "id": "Account", "properties": { "name": { "description": "Name of this account. This is a required field, and must be less than 128 characters long and be globally unique.", "type": "string" }, "teaserSizeLimit": { "description": "File size limit in kilobytes of Rich Media teaser creatives. Acceptable values are 1 to 10240, inclusive.", "type": "string", "format": "int64" }, "accountProfile": { "description": "Profile for this account. This is a read-only field that can be left blank.", "type": "string", "enum": [ "ACCOUNT_PROFILE_BASIC", "ACCOUNT_PROFILE_STANDARD" ], "enumDescriptions": [ "Basic profile has fewer features and lower CPM.", "Standard profile as a higher CPM and all the features." ] }, "maximumImageSize": { "description": "Maximum image size allowed for this account, in kilobytes. Value must be greater than or equal to 1.", "type": "string", "format": "int64" }, "availablePermissionIds": { "items": { "type": "string", "format": "int64" }, "description": "User role permissions available to the user roles of this account.", "type": "array" }, "locale": { "description": "Locale of this account. Acceptable values are: - \"cs\" (Czech) - \"de\" (German) - \"en\" (English) - \"en-GB\" (English United Kingdom) - \"es\" (Spanish) - \"fr\" (French) - \"it\" (Italian) - \"ja\" (Japanese) - \"ko\" (Korean) - \"pl\" (Polish) - \"pt-BR\" (Portuguese Brazil) - \"ru\" (Russian) - \"sv\" (Swedish) - \"tr\" (Turkish) - \"zh-CN\" (Chinese Simplified) - \"zh-TW\" (Chinese Traditional) ", "type": "string" }, "defaultCreativeSizeId": { "description": "Default placement dimensions for this account.", "format": "int64", "type": "string" }, "shareReportsWithTwitter": { "type": "boolean", "description": "Share Path to Conversion reports with Twitter." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#account\"." }, "reportsConfiguration": { "description": "Reporting configuration of this account.", "$ref": "ReportsConfiguration" }, "id": { "format": "int64", "description": "ID of this account. This is a read-only, auto-generated field.", "type": "string" }, "description": { "type": "string", "description": "Description of this account." }, "nielsenOcrEnabled": { "type": "boolean", "description": "Whether campaigns created in this account will be enabled for Nielsen OCR reach ratings by default." }, "countryId": { "format": "int64", "type": "string", "description": "ID of the country associated with this account." }, "activeViewOptOut": { "description": "Whether to serve creatives with Active View tags. If disabled, viewability data will not be available for any impressions.", "type": "boolean" }, "active": { "type": "boolean", "description": "Whether this account is active." }, "accountPermissionIds": { "items": { "format": "int64", "type": "string" }, "type": "array", "description": "Account permissions assigned to this account." }, "currencyId": { "format": "int64", "type": "string", "description": "ID of currency associated with this account. This is a required field. Acceptable values are: - \"1\" for USD - \"2\" for GBP - \"3\" for ESP - \"4\" for SEK - \"5\" for CAD - \"6\" for JPY - \"7\" for DEM - \"8\" for AUD - \"9\" for FRF - \"10\" for ITL - \"11\" for DKK - \"12\" for NOK - \"13\" for FIM - \"14\" for ZAR - \"15\" for IEP - \"16\" for NLG - \"17\" for EUR - \"18\" for KRW - \"19\" for TWD - \"20\" for SGD - \"21\" for CNY - \"22\" for HKD - \"23\" for NZD - \"24\" for MYR - \"25\" for BRL - \"26\" for PTE - \"28\" for CLP - \"29\" for TRY - \"30\" for ARS - \"31\" for PEN - \"32\" for ILS - \"33\" for CHF - \"34\" for VEF - \"35\" for COP - \"36\" for GTQ - \"37\" for PLN - \"39\" for INR - \"40\" for THB - \"41\" for IDR - \"42\" for CZK - \"43\" for RON - \"44\" for HUF - \"45\" for RUB - \"46\" for AED - \"47\" for BGN - \"48\" for HRK - \"49\" for MXN - \"50\" for NGN - \"51\" for EGP " }, "activeAdsLimitTier": { "type": "string", "enum": [ "ACTIVE_ADS_TIER_40K", "ACTIVE_ADS_TIER_75K", "ACTIVE_ADS_TIER_100K", "ACTIVE_ADS_TIER_200K", "ACTIVE_ADS_TIER_300K", "ACTIVE_ADS_TIER_500K", "ACTIVE_ADS_TIER_750K", "ACTIVE_ADS_TIER_1M" ], "description": "Maximum number of active ads allowed for this account.", "enumDescriptions": [ "", "", "", "", "", "", "", "" ] } } }, "CampaignsListResponse": { "description": "Campaign List Response", "properties": { "campaigns": { "description": "Campaign collection.", "type": "array", "items": { "$ref": "Campaign" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#campaignsListResponse\".", "type": "string" }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } }, "type": "object", "id": "CampaignsListResponse" }, "SubaccountsListResponse": { "id": "SubaccountsListResponse", "properties": { "subaccounts": { "description": "Subaccount collection.", "type": "array", "items": { "$ref": "Subaccount" } }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#subaccountsListResponse\".", "type": "string" } }, "type": "object", "description": "Subaccount List Response" }, "Element": { "type": "object", "id": "Element", "description": "Contains the element of the dynamic feed.", "properties": { "createInfo": { "$ref": "LastModifiedInfo", "description": "Output only. The creation timestamp of the element. This is a read-only field.", "readOnly": true }, "isLocalTimestamp": { "description": "Optional. Whether the start and end timestamp is local timestamp. The default value is false which means start and end timestamp is in UTC.", "type": "boolean" }, "elementName": { "type": "string", "description": "Optional. The name of the element. It is defaulted to resource file name if not provided." }, "proximityTargetingFieldId": { "description": "Optional. The field ID that specify field used for proximity targeting.", "type": "integer", "format": "int32" }, "endTimestampFieldId": { "format": "int32", "description": "Optional. The field ID to specify the field that represents the end timestamp. Only applicable if you're planning to use scheduling in your dynamic creative.", "type": "integer" }, "defaultFieldId": { "type": "integer", "description": "Optional. The field ID to specify the field that represents the default field in the feed.", "format": "int32" }, "activeFieldId": { "type": "integer", "format": "int32", "description": "Optional. The field ID to specify the active field in the feed." }, "lastModifiedInfo": { "readOnly": true, "description": "Output only. The last modified timestamp of the element. This is a read-only field.", "$ref": "LastModifiedInfo" }, "reportingLabelFieldId": { "type": "integer", "description": "Required. The field ID to specify the field used for dynamic reporting in Campaign Manager 360.", "format": "int32" }, "startTimestampFieldId": { "type": "integer", "format": "int32", "description": "Optional. The field ID to specify the field that represents the start timestamp. Only applicable if you're planning to use scheduling in your dynamic creative." }, "feedFields": { "description": "Required. The list of fields of the element. The field order and name should match the meta data in the content source source.", "items": { "$ref": "FeedField" }, "type": "array" }, "externalIdFieldId": { "format": "int32", "description": "Required. The field ID to specify the field used for uniquely identifying the feed row. This is a required field.", "type": "integer" } } }, "DirectorySite": { "id": "DirectorySite", "type": "object", "properties": { "settings": { "$ref": "DirectorySiteSettings", "description": "Directory site settings." }, "idDimensionValue": { "description": "Dimension value for the ID of this directory site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "id": { "type": "string", "description": "ID of this directory site. This is a read-only, auto-generated field.", "format": "int64" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#directorySite\".", "type": "string" }, "interstitialTagFormats": { "type": "array", "description": "Tag types for interstitial placements. Acceptable values are: - \"IFRAME_JAVASCRIPT_INTERSTITIAL\" - \"INTERNAL_REDIRECT_INTERSTITIAL\" - \"JAVASCRIPT_INTERSTITIAL\" ", "items": { "type": "string", "enum": [ "IFRAME_JAVASCRIPT_INTERSTITIAL", "INTERNAL_REDIRECT_INTERSTITIAL", "JAVASCRIPT_INTERSTITIAL" ], "enumDescriptions": [ "", "", "" ] } }, "name": { "description": "Name of this directory site.", "type": "string" }, "inpageTagFormats": { "items": { "type": "string", "enum": [ "STANDARD", "IFRAME_JAVASCRIPT_INPAGE", "INTERNAL_REDIRECT_INPAGE", "JAVASCRIPT_INPAGE" ], "enumDescriptions": [ "", "", "", "" ] }, "description": "Tag types for regular placements. Acceptable values are: - \"STANDARD\" - \"IFRAME_JAVASCRIPT_INPAGE\" - \"INTERNAL_REDIRECT_INPAGE\" - \"JAVASCRIPT_INPAGE\" ", "type": "array" }, "publisherSpecificationId": { "format": "int64", "readOnly": true, "description": "Output only. Default publisher specification ID of video placements under this directory site. Possible values are: * `1`, Hulu * `2`, NBC * `3`, CBS * `4`, CBS Desktop * `5`, Discovery * `6`, VEVO HD * `7`, VEVO Vertical * `8`, Fox * `9`, CW Network * `10`, Disney * `11`, IGN * `12`, NFL.com * `13`, Turner Broadcasting * `14`, Tubi on Fox * `15`, Hearst Corporation * `16`, Twitch Desktop * `17`, ABC * `18`, Univision * `19`, MLB.com * `20`, MLB.com Mobile * `21`, MLB.com OTT * `22`, Polsat * `23`, TVN * `24`, Mediaset * `25`, Antena 3 * `26`, Mediamond * `27`, Sky Italia * `28`, Tubi on CBS * `29`, Spotify * `30`, Paramount * `31`, Max", "type": "string" }, "url": { "description": "URL of this directory site.", "type": "string" } }, "description": "DirectorySites contains properties of a website from the Site Directory. Sites need to be added to an account via the Sites resource before they can be assigned to a placement." }, "PlacementStrategiesListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementStrategiesListResponse\"." }, "placementStrategies": { "items": { "$ref": "PlacementStrategy" }, "type": "array", "description": "Placement strategy collection." }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } }, "type": "object", "description": "Placement Strategy List Response", "id": "PlacementStrategiesListResponse" }, "OperatingSystem": { "description": "Contains information about an operating system that can be targeted by ads.", "type": "object", "id": "OperatingSystem", "properties": { "dartId": { "type": "string", "format": "int64", "description": "DART ID of this operating system. This is the ID used for targeting." }, "name": { "description": "Name of this operating system.", "type": "string" }, "mobile": { "type": "boolean", "description": "Whether this operating system is for mobile." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#operatingSystem\".", "type": "string" }, "desktop": { "description": "Whether this operating system is for desktop.", "type": "boolean" } } }, "CustomRichMediaEvents": { "properties": { "filteredEventIds": { "description": "List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName.", "type": "array", "items": { "$ref": "DimensionValue" } }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#customRichMediaEvents." } }, "type": "object", "id": "CustomRichMediaEvents", "description": "Represents a Custom Rich Media Events group." }, "UserDefinedVariableConfiguration": { "description": "User Defined Variable configuration.", "id": "UserDefinedVariableConfiguration", "properties": { "reportName": { "description": "User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: \"\"\u003c\u003e\".", "type": "string" }, "variableType": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "description": "Variable name in the tag. This is a required field.", "type": "string", "enum": [ "U1", "U2", "U3", "U4", "U5", "U6", "U7", "U8", "U9", "U10", "U11", "U12", "U13", "U14", "U15", "U16", "U17", "U18", "U19", "U20", "U21", "U22", "U23", "U24", "U25", "U26", "U27", "U28", "U29", "U30", "U31", "U32", "U33", "U34", "U35", "U36", "U37", "U38", "U39", "U40", "U41", "U42", "U43", "U44", "U45", "U46", "U47", "U48", "U49", "U50", "U51", "U52", "U53", "U54", "U55", "U56", "U57", "U58", "U59", "U60", "U61", "U62", "U63", "U64", "U65", "U66", "U67", "U68", "U69", "U70", "U71", "U72", "U73", "U74", "U75", "U76", "U77", "U78", "U79", "U80", "U81", "U82", "U83", "U84", "U85", "U86", "U87", "U88", "U89", "U90", "U91", "U92", "U93", "U94", "U95", "U96", "U97", "U98", "U99", "U100" ] }, "dataType": { "type": "string", "enum": [ "STRING", "NUMBER" ], "enumDescriptions": [ "", "" ], "description": "Data type for the variable. This is a required field." } }, "type": "object" }, "MobileCarriersListResponse": { "properties": { "mobileCarriers": { "description": "Mobile carrier collection.", "type": "array", "items": { "$ref": "MobileCarrier" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#mobileCarriersListResponse\".", "type": "string" } }, "id": "MobileCarriersListResponse", "type": "object", "description": "Mobile Carrier List Response" }, "FloodlightActivityGroup": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "COUNTER", "SALE" ], "enumDescriptions": [ "", "" ], "description": "Type of the floodlight activity group. This is a required field that is read-only after insertion." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightActivityGroup\"." }, "floodlightConfigurationIdDimensionValue": { "description": "Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "advertiserId": { "type": "string", "description": "Advertiser ID of this floodlight activity group. If this field is left blank, the value will be copied over either from the floodlight configuration's advertiser or from the existing activity group's advertiser.", "format": "int64" }, "name": { "description": "Name of this floodlight activity group. This is a required field. Must be less than 65 characters long and cannot contain quotes.", "type": "string" }, "tagString": { "description": "Value of the type= parameter in the floodlight tag, which the ad servers use to identify the activity group that the activity belongs to. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being a-z0-9[ _ ]. This tag string must also be unique among activity groups of the same floodlight configuration. This field is read-only after insertion.", "type": "string" }, "idDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of this floodlight activity group. This is a read-only, auto-generated field." }, "id": { "description": "ID of this floodlight activity group. This is a read-only, auto-generated field.", "format": "int64", "type": "string" }, "floodlightConfigurationId": { "description": "Floodlight configuration ID of this floodlight activity group. This is a required field.", "format": "int64", "type": "string" }, "accountId": { "description": "Account ID of this floodlight activity group. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "advertiserIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field." }, "subaccountId": { "format": "int64", "description": "Subaccount ID of this floodlight activity group. This is a read-only field that can be left blank.", "type": "string" } }, "id": "FloodlightActivityGroup", "description": "Contains properties of a Floodlight activity group." }, "ReportsConfiguration": { "properties": { "exposureToConversionEnabled": { "description": "Whether the exposure to conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.", "type": "boolean" }, "reportGenerationTimeZoneId": { "description": "Report generation time zone ID of this account. This is a required field that cannot be changed on update. Acceptable values are: - \"1\" for \"America/New_York\" - \"2\" for \"Europe/London\" - \"3\" for \"Europe/Paris\" - \"4\" for \"Africa/Johannesburg\" - \"5\" for \"Asia/Jerusalem\" - \"6\" for \"Asia/Shanghai\" - \"7\" for \"Asia/Hong_Kong\" - \"8\" for \"Asia/Tokyo\" - \"9\" for \"Australia/Sydney\" - \"10\" for \"Asia/Dubai\" - \"11\" for \"America/Los_Angeles\" - \"12\" for \"Pacific/Auckland\" - \"13\" for \"America/Sao_Paulo\" - \"16\" for \"America/Asuncion\" - \"17\" for \"America/Chicago\" - \"18\" for \"America/Denver\" - \"19\" for \"America/St_Johns\" - \"20\" for \"Asia/Dhaka\" - \"21\" for \"Asia/Jakarta\" - \"22\" for \"Asia/Kabul\" - \"23\" for \"Asia/Karachi\" - \"24\" for \"Asia/Calcutta\" - \"25\" for \"Asia/Pyongyang\" - \"26\" for \"Asia/Rangoon\" - \"27\" for \"Atlantic/Cape_Verde\" - \"28\" for \"Atlantic/South_Georgia\" - \"29\" for \"Australia/Adelaide\" - \"30\" for \"Australia/Lord_Howe\" - \"31\" for \"Europe/Moscow\" - \"32\" for \"Pacific/Kiritimati\" - \"35\" for \"Pacific/Norfolk\" - \"36\" for \"Pacific/Tongatapu\" ", "type": "string", "format": "int64" }, "lookbackConfiguration": { "$ref": "LookbackConfiguration", "description": "Default lookback windows for new advertisers in this account." } }, "description": "Reporting Configuration", "type": "object", "id": "ReportsConfiguration" }, "BillingProfile": { "properties": { "currencyCode": { "type": "string", "description": "Billing currency code in ISO 4217 format.This is a read-only field." }, "purchaseOrder": { "type": "string", "description": "Purchase order (PO) for this billing profile. This PO number is used in the invoices for all of the advertisers in this billing profile." }, "paymentsCustomerId": { "description": "The ID of the payment customer the billing profile belongs to. This is a read-only field.", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#billingProfile\"." }, "consolidatedInvoice": { "description": "Consolidated invoice option for this billing profile. Used to get a single, consolidated invoice across the chosen invoice level.", "type": "boolean" }, "id": { "type": "string", "format": "int64", "description": "ID of this billing profile. This is a read-only, auto-generated field." }, "secondaryPaymentsCustomerId": { "type": "string", "description": "The ID of the secondary payment customer the billing profile belongs to. This is a read-only field." }, "name": { "type": "string", "description": "Name of this billing profile. This is a required field and must be less than 256 characters long and must be unique among billing profile in the same account." }, "invoiceLevel": { "type": "string", "enum": [ "ACCOUNT_LEVEL", "ADVERTISER_LEVEL", "CAMPAIGN_LEVEL" ], "description": "Invoice level for this billing profile. Used to group fees into separate invoices by account, advertiser, or campaign.", "enumDescriptions": [ "", "", "" ] }, "countryCode": { "description": "Country code of this billing profile.This is a read-only field.", "type": "string" }, "paymentsAccountId": { "description": "The ID of the payment account the billing profile belongs to. This is a read-only field.", "type": "string" }, "isDefault": { "description": "True if the billing profile is the account default profile. This is a read-only field.", "type": "boolean" }, "status": { "enumDescriptions": [ "", "", "" ], "description": "Status of this billing profile.This is a read-only field.", "type": "string", "enum": [ "UNDER_REVIEW", "ACTIVE", "ARCHIVED" ] } }, "type": "object", "id": "BillingProfile", "description": "Contains properties of a Campaign Manager Billing Profile." }, "PlacementAssignment": { "type": "object", "properties": { "placementIdDimensionValue": { "description": "Dimension value for the ID of the placement. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "placementId": { "format": "int64", "type": "string", "description": "ID of the placement to be assigned. This is a required field." }, "sslRequired": { "description": "Whether the placement to be assigned requires SSL. This is a read-only field that is auto-generated when the ad is inserted or updated.", "type": "boolean" }, "active": { "description": "Whether this placement assignment is active. When true, the placement will be included in the ad's rotation.", "type": "boolean" } }, "id": "PlacementAssignment", "description": "Placement Assignment." }, "CreativeAssetId": { "properties": { "type": { "description": "Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE.", "type": "string", "enum": [ "IMAGE", "FLASH", "VIDEO", "HTML", "HTML_IMAGE", "AUDIO" ], "enumDescriptions": [ "", "", "", "", "", "" ] }, "name": { "description": "Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: \".-_ \". Spaces are allowed.", "type": "string" } }, "type": "object", "id": "CreativeAssetId", "description": "Creative Asset ID." }, "CrossMediaReachReportCompatibleFields": { "properties": { "dimensions": { "items": { "$ref": "Dimension" }, "type": "array", "description": "Dimensions which are compatible to be selected in the \"dimensions\" section of the report." }, "kind": { "description": "The kind of resource this is, in this case dfareporting#crossMediaReachReportCompatibleFields.", "type": "string" }, "dimensionFilters": { "items": { "$ref": "Dimension" }, "description": "Dimensions which are compatible to be selected in the \"dimensionFilters\" section of the report.", "type": "array" }, "metrics": { "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report.", "type": "array", "items": { "$ref": "Metric" } } }, "id": "CrossMediaReachReportCompatibleFields", "type": "object", "description": "Represents fields that are compatible to be selected for a report of type \"CROSS_MEDIA_REACH\"." }, "SortedDimension": { "description": "Represents a sorted dimension.", "properties": { "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#sortedDimension." }, "name": { "description": "The name of the dimension.", "type": "string" }, "sortOrder": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "", "" ], "description": "An optional sort order for the dimension column." } }, "type": "object", "id": "SortedDimension" }, "ReportList": { "id": "ReportList", "description": "Represents the list of reports.", "type": "object", "properties": { "kind": { "description": "The kind of list this is, in this case dfareporting#reportList.", "type": "string" }, "etag": { "description": "The eTag of this response for caching purposes.", "type": "string" }, "items": { "description": "The reports returned in this response.", "items": { "$ref": "Report" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "Continuation token used to page through reports. To retrieve the next page of results, set the next request's \"pageToken\" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted." } } }, "CreativeFieldValuesListResponse": { "description": "Creative Field Value List Response", "properties": { "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "creativeFieldValues": { "items": { "$ref": "CreativeFieldValue" }, "type": "array", "description": "Creative field value collection." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeFieldValuesListResponse\"." } }, "id": "CreativeFieldValuesListResponse", "type": "object" }, "FsCommand": { "id": "FsCommand", "description": "FsCommand.", "properties": { "positionOption": { "type": "string", "enum": [ "CENTERED", "DISTANCE_FROM_TOP_LEFT_CORNER" ], "description": "Position in the browser where the window will open.", "enumDescriptions": [ "Center of the window Corresponds to \"center\" in UI", "user-defined distance from top left-hand corner of the window Corresponds to \"top-left\" in UI" ] }, "windowHeight": { "description": "Height of the window.", "type": "integer", "format": "int32" }, "top": { "type": "integer", "description": "Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER.", "format": "int32" }, "windowWidth": { "format": "int32", "description": "Width of the window.", "type": "integer" }, "left": { "format": "int32", "type": "integer", "description": "Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER." } }, "type": "object" }, "StudioCreative": { "id": "StudioCreative", "description": " *Beta:* This API resource is available only to a very limited number of customers. If you'd like to use this resource, please reach out to your Google sales representative. Contains studio creative information.", "type": "object", "properties": { "studioAdvertiserId": { "format": "int64", "type": "string", "description": "Studio advertiser ID of this studio creative. This is a required field on insertion." }, "dimension": { "$ref": "StudioCreativeDimension", "description": "Dimension of this studio creative. This is a required field on insertion if format is BANNER or EXPANDING." }, "dynamicProfileId": { "format": "int64", "description": "Dynamic profile ID of this studio creative.", "type": "string" }, "name": { "description": "Identifier. Name of this studio creative. This is a required field on insertion.", "type": "string" }, "format": { "description": "Format of this studio creative. This is a required field on insertion.", "enumDescriptions": [ "The format of the studio creative is unknown. This value is unused.", "Banner format.", "Expanding format.", "Intertitial format.", "VPAID linear video creative format." ], "type": "string", "enum": [ "UNKNOWN", "BANNER", "EXPANDING", "INTERSTITIAL", "VPAID_LINEAR_VIDEO" ] }, "status": { "readOnly": true, "enumDescriptions": [ "The status of the studio creative is unknown. This value is unused.", "The creative is still being developed.", "The creative has been published and is ready for QA.", "The creative has failed QA and must be corrected.", "The creative has passed QA and is ready to be trafficked.", "The creative has been trafficked to an adserver." ], "type": "string", "enum": [ "UNKNOWN_STATUS", "IN_DEVELOPMENT", "PUBLISHED", "QA_REJECTED", "QA_APPROVED", "TRAFFICKED" ], "description": "Output only. Status of this studio creative. It is a read-only field." }, "studioAccountId": { "type": "string", "description": "Studio account ID of this creative. This field, if left unset, will be auto-populated.", "format": "int64" }, "id": { "format": "int64", "type": "string", "readOnly": true, "description": "Output only. Unique ID of this studio creative. This is a read-only, auto-generated field." }, "createdInfo": { "description": "The timestamp when the studio creative was created. This is a read-only, auto-generated field.", "$ref": "LastModifiedInfo" }, "backupImageAssetId": { "format": "int64", "description": "Backup image asset ID of this studio creative. It is a required field on insertion.", "type": "string" }, "lastModifiedInfo": { "description": "The timestamp when the studio creative was last modified. This is a read-only, auto-generated field.", "$ref": "LastModifiedInfo" }, "studioCampaignId": { "format": "int64", "type": "string", "description": "Studio campaign ID of this studio creative. This is a required field on insertion." }, "assetIds": { "items": { "format": "int64", "type": "string" }, "type": "array", "description": "List of assets associated with this studio creative. It is a required field on insertion." } } }, "DeliverySchedule": { "properties": { "hardCutoff": { "description": "Whether or not hard cutoff is enabled. If true, the ad will not serve after the end date and time. Otherwise the ad will continue to be served until it has reached its delivery goals.", "type": "boolean" }, "frequencyCap": { "description": "Limit on the number of times an individual user can be served the ad within a specified period of time.", "$ref": "FrequencyCap" }, "impressionRatio": { "description": "Impression ratio for this ad. This ratio determines how often each ad is served relative to the others. For example, if ad A has an impression ratio of 1 and ad B has an impression ratio of 3, then Campaign Manager will serve ad B three times as often as ad A. Acceptable values are 1 to 10, inclusive.", "format": "int64", "type": "string" }, "priority": { "type": "string", "enum": [ "AD_PRIORITY_01", "AD_PRIORITY_02", "AD_PRIORITY_03", "AD_PRIORITY_04", "AD_PRIORITY_05", "AD_PRIORITY_06", "AD_PRIORITY_07", "AD_PRIORITY_08", "AD_PRIORITY_09", "AD_PRIORITY_10", "AD_PRIORITY_11", "AD_PRIORITY_12", "AD_PRIORITY_13", "AD_PRIORITY_14", "AD_PRIORITY_15", "AD_PRIORITY_16" ], "description": "Serving priority of an ad, with respect to other ads. The lower the priority number, the greater the priority with which it is served.", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ] } }, "id": "DeliverySchedule", "description": "Delivery Schedule.", "type": "object" }, "PathToConversionReportCompatibleFields": { "description": "Represents fields that are compatible to be selected for a report of type \"PATH_TO_CONVERSION\".", "type": "object", "properties": { "customFloodlightVariables": { "items": { "$ref": "Dimension" }, "description": "Custom floodlight variables which are compatible to be selected in the \"customFloodlightVariables\" section of the report.", "type": "array" }, "conversionDimensions": { "type": "array", "items": { "$ref": "Dimension" }, "description": "Conversion dimensions which are compatible to be selected in the \"conversionDimensions\" section of the report." }, "kind": { "description": "The kind of resource this is, in this case dfareporting#pathToConversionReportCompatibleFields.", "type": "string" }, "perInteractionDimensions": { "description": "Per-interaction dimensions which are compatible to be selected in the \"perInteractionDimensions\" section of the report.", "type": "array", "items": { "$ref": "Dimension" } }, "metrics": { "items": { "$ref": "Metric" }, "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report.", "type": "array" } }, "id": "PathToConversionReportCompatibleFields" }, "AccountActiveAdSummary": { "description": "Gets a summary of active ads in an account.", "type": "object", "properties": { "activeAdsLimitTier": { "description": "Maximum number of active ads allowed for the account.", "type": "string", "enum": [ "ACTIVE_ADS_TIER_40K", "ACTIVE_ADS_TIER_75K", "ACTIVE_ADS_TIER_100K", "ACTIVE_ADS_TIER_200K", "ACTIVE_ADS_TIER_300K", "ACTIVE_ADS_TIER_500K", "ACTIVE_ADS_TIER_750K", "ACTIVE_ADS_TIER_1M" ], "enumDescriptions": [ "", "", "", "", "", "", "", "" ] }, "activeAds": { "format": "int64", "description": "Ads that have been activated for the account", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountActiveAdSummary\"." }, "availableAds": { "format": "int64", "type": "string", "description": "Ads that can be activated for the account." }, "accountId": { "type": "string", "description": "ID of the account.", "format": "int64" } }, "id": "AccountActiveAdSummary" }, "TagSettings": { "type": "object", "description": "Dynamic and Image Tag Settings.", "properties": { "dynamicTagEnabled": { "type": "boolean", "description": "Whether dynamic floodlight tags are enabled." }, "imageTagEnabled": { "description": "Whether image tags are enabled.", "type": "boolean" } }, "id": "TagSettings" }, "CustomViewabilityMetricConfiguration": { "description": "The attributes, like playtime and percent onscreen, that define the Custom Viewability Metric.", "type": "object", "properties": { "timeMillis": { "description": "The time in milliseconds the video must play for the Custom Viewability Metric to count an impression. If both this and timePercent are specified, the earlier of the two will be used.", "type": "integer", "format": "int32" }, "viewabilityPercent": { "format": "int32", "type": "integer", "description": "The percentage of video that must be on screen for the Custom Viewability Metric to count an impression." }, "audible": { "description": "Whether the video must be audible to count an impression.", "type": "boolean" }, "timePercent": { "description": "The percentage of video that must play for the Custom Viewability Metric to count an impression. If both this and timeMillis are specified, the earlier of the two will be used.", "format": "int32", "type": "integer" } }, "id": "CustomViewabilityMetricConfiguration" }, "EventTagsListResponse": { "id": "EventTagsListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#eventTagsListResponse\".", "type": "string" }, "eventTags": { "type": "array", "description": "Event tag collection.", "items": { "$ref": "EventTag" } } }, "description": "Event Tag List Response", "type": "object" }, "OmnitureSettings": { "description": "Omniture Integration Settings.", "type": "object", "id": "OmnitureSettings", "properties": { "omnitureIntegrationEnabled": { "description": "Whether Omniture integration is enabled. This property can be enabled only when the \"Advanced Ad Serving\" account setting is enabled.", "type": "boolean" }, "omnitureCostDataEnabled": { "description": "Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.", "type": "boolean" } } }, "Subaccount": { "id": "Subaccount", "description": "Contains properties of a Campaign Manager subaccount.", "type": "object", "properties": { "availablePermissionIds": { "description": "IDs of the available user role permissions for this subaccount.", "type": "array", "items": { "format": "int64", "type": "string" } }, "name": { "type": "string", "description": "Name of this subaccount. This is a required field. Must be less than 128 characters long and be unique among subaccounts of the same account." }, "id": { "description": "ID of this subaccount. This is a read-only, auto-generated field.", "type": "string", "format": "int64" }, "accountId": { "description": "ID of the account that contains this subaccount. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#subaccount\".", "type": "string" } } }, "City": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#city\"." }, "countryDartId": { "type": "string", "description": "DART ID of the country to which this city belongs.", "format": "int64" }, "regionCode": { "type": "string", "description": "Region code of the region to which this city belongs." }, "dartId": { "description": "DART ID of this city. This is the ID used for targeting and generating reports.", "type": "string", "format": "int64" }, "regionDartId": { "format": "int64", "type": "string", "description": "DART ID of the region to which this city belongs." }, "name": { "description": "Name of this city.", "type": "string" }, "metroCode": { "description": "Metro region code of the metro region (DMA) to which this city belongs.", "type": "string" }, "metroDmaId": { "format": "int64", "description": "ID of the metro region (DMA) to which this city belongs.", "type": "string" }, "countryCode": { "type": "string", "description": "Country code of the country to which this city belongs." } }, "id": "City", "description": "Contains information about a city that can be targeted by ads.", "type": "object" }, "TvCampaignSummariesListResponse": { "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#tvCampaignSummariesListResponse\".", "type": "string" }, "tvCampaignSummaries": { "description": "List of TV campaign summaries.", "items": { "$ref": "TvCampaignSummary" }, "type": "array" } }, "id": "TvCampaignSummariesListResponse", "description": "Response message for TvCampaignSummariesService.List." }, "StudioCreativeAsset": { "type": "object", "properties": { "lastModifiedInfo": { "$ref": "LastModifiedInfo", "readOnly": true, "description": "Output only. The last modified timestamp of the studio creative asset. This is a read-only field." }, "filesize": { "format": "int64", "description": "The filesize of the studio creative asset. This is a read-only field.", "type": "string" }, "studioCreativeId": { "format": "int64", "type": "string", "description": "Studio creative ID of this studio creative asset. The asset will be associated to the creative if creative id is set." }, "createInfo": { "description": "Output only. The creation timestamp of the studio creative asset. This is a read-only field.", "$ref": "LastModifiedInfo", "readOnly": true }, "filename": { "description": "The filename of the studio creative asset. It is default to the original filename of the asset.", "type": "string" }, "id": { "type": "string", "description": "Output only. Unique ID of this studio creative asset. This is a read-only, auto-generated field.", "readOnly": true, "format": "int64" }, "studioAdvertiserId": { "type": "string", "description": "Studio advertiser ID of this studio creative asset. This is a required field on insertion.", "format": "int64" }, "studioAccountId": { "type": "string", "description": "Studio account ID of this studio creative asset. This field, if left unset, will be auto-populated..", "format": "int64" }, "type": { "description": "The type of the studio creative asset. It is a auto-generated, read-only field.", "enumDescriptions": [ "Unknown type of asset.", "The asset is an HTML file.", "The asset is a video file.", "The asset is an image file.", "The asset is a font file." ], "type": "string", "enum": [ "UNKNOWN_TYPE", "HTML", "VIDEO", "IMAGE", "FONT" ] }, "videoProcessingData": { "$ref": "VideoProcessingData", "description": "The processing data of the studio creative asset. This is a read-only field." } }, "id": "StudioCreativeAsset", "description": " *Beta:* This API resource is available only to a very limited number of customers. If you'd like to use this resource, please reach out to your Google sales representative. Contains studio creative asset information." }, "CreativeAssignment": { "id": "CreativeAssignment", "properties": { "sequence": { "format": "int32", "description": "Sequence number of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_SEQUENTIAL. Acceptable values are 1 to 65535, inclusive.", "type": "integer" }, "sslCompliant": { "type": "boolean", "description": "Whether the creative to be assigned is SSL-compliant. This is a read-only field that is auto-generated when the ad is inserted or updated." }, "endTime": { "type": "string", "format": "date-time" }, "creativeGroupAssignments": { "type": "array", "items": { "$ref": "CreativeGroupAssignment" }, "description": "Creative group assignments for this creative assignment. Only one assignment per creative group number is allowed for a maximum of two assignments." }, "creativeIdDimensionValue": { "description": "Dimension value for the ID of the creative. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "richMediaExitOverrides": { "items": { "$ref": "RichMediaExitOverride" }, "type": "array", "description": "Rich media exit overrides for this creative assignment. Applicable when the creative type is any of the following: - DISPLAY - RICH_MEDIA_INPAGE - RICH_MEDIA_INPAGE_FLOATING - RICH_MEDIA_IM_EXPAND - RICH_MEDIA_EXPANDING - RICH_MEDIA_INTERSTITIAL_FLOAT - RICH_MEDIA_MOBILE_IN_APP - RICH_MEDIA_MULTI_FLOATING - RICH_MEDIA_PEEL_DOWN - VPAID_LINEAR - VPAID_NON_LINEAR " }, "active": { "type": "boolean", "description": "Whether this creative assignment is active. When true, the creative will be included in the ad's rotation." }, "weight": { "type": "integer", "format": "int32", "description": "Weight of the creative assignment, applicable when the rotation type is CREATIVE_ROTATION_TYPE_RANDOM. Value must be greater than or equal to 1." }, "startTime": { "type": "string", "format": "date-time" }, "creativeId": { "type": "string", "format": "int64", "description": "ID of the creative to be assigned. This is a required field." }, "clickThroughUrl": { "$ref": "ClickThroughUrl", "description": "Click-through URL of the creative assignment." }, "companionCreativeOverrides": { "type": "array", "items": { "$ref": "CompanionClickThroughOverride" }, "description": "Companion creative overrides for this creative assignment. Applicable to video ads." }, "applyEventTags": { "description": "Whether applicable event tags should fire when this creative assignment is rendered. If this value is unset when the ad is inserted or updated, it will default to true for all creative types EXCEPT for INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO.", "type": "boolean" } }, "description": "Creative Assignment.", "type": "object" }, "ListPopulationRule": { "id": "ListPopulationRule", "type": "object", "description": "Remarketing List Population Rule.", "properties": { "floodlightActivityName": { "description": "Name of floodlight activity associated with this rule. This is a read-only, auto-generated field.", "type": "string" }, "listPopulationClauses": { "type": "array", "items": { "$ref": "ListPopulationClause" }, "description": "Clauses that make up this list population rule. Clauses are joined by ANDs, and the clauses themselves are made up of list population terms which are joined by ORs." }, "floodlightActivityId": { "description": "Floodlight activity ID associated with this rule. This field can be left blank.", "format": "int64", "type": "string" } } }, "UserProfile": { "description": "A UserProfile resource lets you list all DFA user profiles that are associated with a Google user account. The profile_id needs to be specified in other API requests. ", "id": "UserProfile", "properties": { "profileId": { "description": "The unique ID of the user profile.", "format": "int64", "type": "string" }, "etag": { "description": "Etag of this resource.", "type": "string" }, "subAccountName": { "type": "string", "description": "The sub account name this profile belongs to if applicable." }, "subAccountId": { "format": "int64", "type": "string", "description": "The sub account ID this profile belongs to if applicable." }, "accountName": { "description": "The account name this profile belongs to.", "type": "string" }, "accountId": { "description": "The account ID to which this profile belongs.", "type": "string", "format": "int64" }, "userName": { "type": "string", "description": "The user name." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userProfile\"." } }, "type": "object" }, "CreativeCustomEvent": { "properties": { "targetType": { "description": "Target type used by the event.", "enumDescriptions": [ "New tab", "Current tab", "Same frame", "Parent frame", "New window with properties specified in window_properties" ], "type": "string", "enum": [ "TARGET_BLANK", "TARGET_TOP", "TARGET_SELF", "TARGET_PARENT", "TARGET_POPUP" ] }, "advertiserCustomEventType": { "description": "Type of the event. This is a read-only field.", "type": "string", "enum": [ "ADVERTISER_EVENT_TIMER", "ADVERTISER_EVENT_EXIT", "ADVERTISER_EVENT_COUNTER" ], "enumDescriptions": [ "", "", "" ] }, "exitClickThroughUrl": { "description": "Exit click-through URL for the event. This field is used only for exit events.", "$ref": "CreativeClickThroughUrl" }, "advertiserCustomEventName": { "description": "User-entered name for the event.", "type": "string" }, "id": { "format": "int64", "description": "ID of this event. This is a required field and should not be modified after insertion.", "type": "string" }, "advertiserCustomEventId": { "format": "int64", "description": "Unique ID of this event used by Reporting and Data Transfer. This is a read-only field.", "type": "string" }, "popupWindowProperties": { "description": "Properties for rich media popup windows. This field is used only for exit events.", "$ref": "PopupWindowProperties" }, "artworkLabel": { "description": "Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion.", "type": "string" }, "artworkType": { "description": "Artwork type used by the creative.This is a read-only field.", "type": "string", "enum": [ "ARTWORK_TYPE_FLASH", "ARTWORK_TYPE_HTML5", "ARTWORK_TYPE_MIXED", "ARTWORK_TYPE_IMAGE" ], "enumDescriptions": [ "The creative is a Flash creative.", "The creative is HTML5.", "The creative is HTML5 if available, Flash otherwise.", "The creative is Image." ] }, "videoReportingId": { "description": "Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field.", "type": "string" } }, "id": "CreativeCustomEvent", "description": "Creative Custom Event.", "type": "object" }, "Site": { "description": "Contains properties of a site.", "type": "object", "id": "Site", "properties": { "keyName": { "description": "Key name of this site. This is a read-only, auto-generated field.", "type": "string" }, "name": { "type": "string", "description": "Name of this site.This is a required field. Must be less than 128 characters long. If this site is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this site is a top-level site, and the name must be unique among top-level sites of the same account." }, "videoSettings": { "$ref": "SiteVideoSettings", "description": "Default video settings for new placements created under this site. This value will be used to populate the placements.videoSettings field, when no value is specified for the new placement." }, "idDimensionValue": { "description": "Dimension value for the ID of this site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "directorySiteIdDimensionValue": { "description": "Dimension value for the ID of the directory site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "siteSettings": { "description": "Site-wide settings.", "$ref": "SiteSettings" }, "id": { "type": "string", "format": "int64", "description": "ID of this site. This is a read-only, auto-generated field." }, "adServingPlatformId": { "type": "string", "description": "Optional. Ad serving platform ID to identify the ad serving platform used by the site. Measurement partners can use this field to add ad-server specific macros. If set, this value acts as the default during placement creation. Possible values are: * `1`, Adelphic * `2`, Adform * `3`, Adobe * `4`, Amobee * `5`, Basis (Centro) * `6`, Beeswax * `7`, Amazon * `8`, DV360 (DBM) * `9`, Innovid * `10`, MediaMath * `11`, Roku OneView DSP * `12`, TabMo Hawk * `13`, The Trade Desk * `14`, Xandr Invest DSP * `15`, Yahoo DSP * `16`, Zeta Global * `17`, Scaleout * `18`, Bidtellect * `19`, Unicorn * `20`, Teads * `21`, Quantcast * `22`, Cognitiv * `23`, AdTheorent * `24`, DeepIntent * `25`, Pulsepoint", "format": "int64" }, "approved": { "description": "Whether this site is approved.", "type": "boolean" }, "subaccountId": { "description": "Subaccount ID of this site. This is a read-only field that can be left blank.", "format": "int64", "type": "string" }, "directorySiteId": { "description": "Directory site associated with this site. This is a required field that is read-only after insertion.", "format": "int64", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#site\"." }, "accountId": { "description": "Account ID of this site. This is a read-only field that can be left blank.", "format": "int64", "type": "string" }, "siteContacts": { "description": "Site contacts.", "type": "array", "items": { "$ref": "SiteContact" } } } }, "MeasurementPartnerCampaignLink": { "id": "MeasurementPartnerCampaignLink", "properties": { "linkStatus": { "type": "string", "enum": [ "MEASUREMENT_PARTNER_UNLINKED", "MEASUREMENT_PARTNER_LINKED", "MEASUREMENT_PARTNER_LINK_PENDING", "MEASUREMENT_PARTNER_LINK_FAILURE", "MEASUREMENT_PARTNER_LINK_OPT_OUT", "MEASUREMENT_PARTNER_LINK_OPT_OUT_PENDING", "MEASUREMENT_PARTNER_LINK_WRAPPING_PENDING", "MEASUREMENT_PARTNER_MODE_CHANGE_PENDING", "MEASUREMENT_PARTNER_UNLINK_PENDING" ], "enumDescriptions": [ "Unlinked.", "Linked successfully", "Link pending for wrapping.", "Linking failure.", "Link opt-out by user.", "Link opt-out pending sync.", "Link wrap answer pending.", "Mode change pending.", "Partner unlink pending." ], "description": "." }, "measurementPartner": { "type": "string", "enum": [ "NONE", "INTEGRAL_AD_SCIENCE", "DOUBLE_VERIFY" ], "enumDescriptions": [ "", "", "" ], "description": "Measurement partner used for tag wrapping." }, "partnerCampaignId": { "type": "string", "description": "Partner campaign ID needed for establishing linking with Measurement partner." } }, "type": "object" }, "VideoSettings": { "type": "object", "properties": { "orientation": { "enumDescriptions": [ "", "", "" ], "type": "string", "enum": [ "ANY", "LANDSCAPE", "PORTRAIT" ], "description": "Orientation of a video placement. If this value is set, placement will return assets matching the specified orientation." }, "obaSettings": { "$ref": "ObaIcon", "description": "Settings for the OBA icon of video creatives served to this placement. If this object is provided, the creative-level OBA settings will be overridden." }, "obaEnabled": { "description": "Whether OBA icons are enabled for this placement.", "type": "boolean" }, "publisherSpecificationId": { "type": "string", "description": "Publisher specification ID of a video placement. Possible values are: * `1`, Hulu * `2`, NBC * `3`, CBS * `4`, CBS Desktop * `5`, Discovery * `6`, VEVO HD * `7`, VEVO Vertical * `8`, Fox * `9`, CW Network * `10`, Disney * `11`, IGN * `12`, NFL.com * `13`, Turner Broadcasting * `14`, Tubi on Fox * `15`, Hearst Corporation * `16`, Twitch Desktop * `17`, ABC * `18`, Univision * `19`, MLB.com * `20`, MLB.com Mobile * `21`, MLB.com OTT * `22`, Polsat * `23`, TVN * `24`, Mediaset * `25`, Antena 3 * `26`, Mediamond * `27`, Sky Italia * `28`, Tubi on CBS * `29`, Spotify * `30`, Paramount * `31`, Max", "format": "int64" }, "durationSeconds": { "description": "Duration of a video placement in seconds.", "format": "int32", "type": "integer" }, "skippableSettings": { "description": "Settings for the skippability of video creatives served to this placement. If this object is provided, the creative-level skippable settings will be overridden.", "$ref": "SkippableSetting" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#videoSettings\".", "type": "string" }, "companionSettings": { "description": "Settings for the companion creatives of video creatives served to this placement.", "$ref": "CompanionSetting" }, "transcodeSettings": { "description": "Settings for the transcodes of video creatives served to this placement. If this object is provided, the creative-level transcode settings will be overridden.", "$ref": "TranscodeSetting" } }, "description": "Video Settings", "id": "VideoSettings" }, "MetrosListResponse": { "description": "Metro List Response", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#metrosListResponse\".", "type": "string" }, "metros": { "items": { "$ref": "Metro" }, "description": "Metro collection.", "type": "array" } }, "id": "MetrosListResponse" }, "File": { "type": "object", "id": "File", "description": "Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is \"REPORT_AVAILABLE\".", "properties": { "dateRange": { "$ref": "DateRange", "description": "The date range for which the file has report data. The date range will always be the absolute date range for which the report is run." }, "urls": { "description": "The URLs where the completed report file can be downloaded.", "properties": { "apiUrl": { "description": "The URL for downloading the report data through the API.", "type": "string" }, "browserUrl": { "description": "The URL for downloading the report data through a browser.", "type": "string" } }, "type": "object" }, "id": { "format": "int64", "type": "string", "description": "The unique ID of this report file." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#file\".", "type": "string" }, "reportId": { "type": "string", "description": "The ID of the report this file was generated from.", "format": "int64" }, "fileName": { "description": "The filename of the file.", "type": "string" }, "status": { "description": "The status of the report file.", "type": "string", "enum": [ "PROCESSING", "REPORT_AVAILABLE", "FAILED", "CANCELLED", "QUEUED" ], "enumDescriptions": [ "", "", "", "", "" ] }, "format": { "description": "The output format of the report. Only available once the file is available.", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "CSV", "EXCEL" ] }, "etag": { "type": "string", "description": "Etag of this resource." }, "lastModifiedTime": { "type": "string", "description": "The timestamp in milliseconds since epoch when this file was last modified.", "format": "int64" } } }, "PlatformType": { "type": "object", "properties": { "id": { "format": "int64", "description": "ID of this platform type.", "type": "string" }, "name": { "type": "string", "description": "Name of this platform type." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#platformType\"." } }, "description": "Contains information about a platform type that can be targeted by ads.", "id": "PlatformType" }, "SizesListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#sizesListResponse\"." }, "sizes": { "items": { "$ref": "Size" }, "description": "Size collection.", "type": "array" } }, "type": "object", "id": "SizesListResponse", "description": "Size List Response" }, "SkippableSetting": { "id": "SkippableSetting", "type": "object", "description": "Skippable Settings", "properties": { "skipOffset": { "description": "Amount of time to play videos served to this placement before the skip button should appear. Applicable when skippable is true.", "$ref": "VideoOffset" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#skippableSetting\".", "type": "string" }, "skippable": { "type": "boolean", "description": "Whether the user can skip creatives served to this placement." }, "progressOffset": { "$ref": "VideoOffset", "description": "Amount of time to play videos served to this placement before counting a view. Applicable when skippable is true." } } }, "EventTag": { "id": "EventTag", "description": "Contains properties of an event tag.", "properties": { "enabledByDefault": { "description": "Whether this event tag should be automatically enabled for all of the advertiser's campaigns and ads.", "type": "boolean" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "status": { "description": "Status of this event tag. Must be ENABLED for this event tag to fire. This is a required field.", "type": "string", "enum": [ "ENABLED", "DISABLED" ], "enumDescriptions": [ "", "" ] }, "campaignId": { "format": "int64", "description": "Campaign ID of this event tag. This field or the advertiserId field is required on insertion.", "type": "string" }, "siteFilterType": { "type": "string", "enum": [ "ALLOWLIST", "BLOCKLIST" ], "description": "Site filter type for this event tag. If no type is specified then the event tag will be applied to all sites.", "enumDescriptions": [ "The event tag should only ever fire on specified sites.", "The event tag should fire on all sites EXCEPT the specified sites." ] }, "type": { "description": "Event tag type. Can be used to specify whether to use a third-party pixel, a third-party JavaScript URL, or a third-party click-through URL for either impression or click tracking. This is a required field.", "type": "string", "enum": [ "IMPRESSION_IMAGE_EVENT_TAG", "IMPRESSION_JAVASCRIPT_EVENT_TAG", "CLICK_THROUGH_EVENT_TAG" ], "enumDescriptions": [ "A third-party pixel for impression tracking.", "A third-party JavaScript URL for impression tracking.", "A third-party URL for click tracking that redirects to the landing page." ] }, "campaignIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the campaign. This is a read-only, auto-generated field." }, "id": { "description": "ID of this event tag. This is a read-only, auto-generated field.", "type": "string", "format": "int64" }, "name": { "type": "string", "description": "Name of this event tag. This is a required field and must be less than 256 characters long." }, "accountId": { "description": "Account ID of this event tag. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "excludeFromAdxRequests": { "type": "boolean", "description": "Whether to remove this event tag from ads that are trafficked through Display & Video 360 to Ad Exchange. This may be useful if the event tag uses a pixel that is unapproved for Ad Exchange bids on one or more networks, such as the Google Display Network." }, "siteIds": { "description": "Filter list of site IDs associated with this event tag. The siteFilterType determines whether this is a allowlist or blocklist filter.", "items": { "type": "string", "format": "int64" }, "type": "array" }, "advertiserId": { "type": "string", "format": "int64", "description": "Advertiser ID of this event tag. This field or the campaignId field is required on insertion." }, "urlEscapeLevels": { "type": "integer", "format": "int32", "description": "Number of times the landing page URL should be URL-escaped before being appended to the click-through event tag URL. Only applies to click-through event tags as specified by the event tag type." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#eventTag\"." }, "url": { "type": "string", "description": "Payload URL for this event tag. The URL on a click-through event tag should have a landing page URL appended to the end of it. This field is required on insertion." }, "sslCompliant": { "type": "boolean", "description": "Whether this tag is SSL-compliant or not. This is a read-only field." }, "subaccountId": { "format": "int64", "description": "Subaccount ID of this event tag. This is a read-only field that can be left blank.", "type": "string" } }, "type": "object" }, "CampaignSummary": { "description": "Represents a summarized campaign information associated with this invoice.", "type": "object", "id": "CampaignSummary", "properties": { "taxAmountMicros": { "description": "The tax amount for this campaign, in micros of the invoice's currency.", "type": "string", "format": "int64" }, "campaignId": { "format": "int64", "type": "string", "description": "Campaign ID." }, "totalAmountMicros": { "description": "The total amount of charges for this campaign, in micros of the invoice's currency.", "type": "string", "format": "int64" }, "preTaxAmountMicros": { "format": "int64", "type": "string", "description": "The pre-tax amount for this campaign, in micros of the invoice's currency." }, "billingInvoiceCode": { "type": "string", "description": "Campaign billing invoice code." } } }, "FieldFilter": { "properties": { "fieldId": { "format": "int32", "description": "Optional. The field ID on the left hand side of the expression.", "type": "integer" }, "valueType": { "type": "string", "enum": [ "RHS_VALUE_TYPE_UNKNOWN", "STRING", "REQUEST", "BOOL", "DEPENDENT" ], "enumDescriptions": [ "The right hand side of the expression is unknown. This value is unused.", "The right hand side of the expression is a string.", "The right hand side of the expression is a request value.", "The right hand side of the expression is a boolean.", "The right hand side of the expression is a dependent field value." ], "description": "Optional. Right hand side of the expression." }, "boolValue": { "description": "Optional. The boolean values, only applicable when rhs_value_type is BOOL.", "type": "boolean" }, "requestValue": { "description": "Optional. The request value, only applicable when rhs_value_type is REQUEST.", "$ref": "RequestValue" }, "stringValue": { "description": "Optional. The string value, only applicable when rhs_value_type is STRING.", "type": "string" }, "matchType": { "enumDescriptions": [ "The left hand side of the expression is unknown. This value is unused.", "The left hand side of the expression is equals or unrestricted. It is the default value.", "The left hand side of the expression is equals.", "The left hand side of the expression is unrestricted. Unrestricted is used to target fields with no restrictions. For example, country targeting fields hold a list of countries. If the list is empty, we consider the element value to have no restrictions.", "Left hand side of the expression is not equals. Not equals specifies which fields should not be targeted." ], "type": "string", "enum": [ "LHS_MATCH_TYPE_UNKNOWN", "EQUALS_OR_UNRESTRICTED", "EQUALS", "UNRESTRICTED", "NOT_EQUALS" ], "description": "Optional. Left hand side of the expression match type." }, "dependentFieldValue": { "description": "Optional. The dependent values, only applicable when rhs_value_type is DEPENDENT.", "$ref": "DependentFieldValue" } }, "id": "FieldFilter", "description": "Contains field filter information.", "type": "object" }, "MeasurementPartnerAdvertiserLink": { "type": "object", "properties": { "partnerAdvertiserId": { "description": "partner Advertiser Id.", "type": "string" }, "linkStatus": { "enumDescriptions": [ "Unlinked.", "Linked successfully", "Link pending for wrapping.", "Linking failure.", "Link opt-out by user.", "Link opt-out pending sync.", "Link wrap answer pending.", "Mode change pending.", "Partner unlink pending." ], "description": "Status of the partner link.", "type": "string", "enum": [ "MEASUREMENT_PARTNER_UNLINKED", "MEASUREMENT_PARTNER_LINKED", "MEASUREMENT_PARTNER_LINK_PENDING", "MEASUREMENT_PARTNER_LINK_FAILURE", "MEASUREMENT_PARTNER_LINK_OPT_OUT", "MEASUREMENT_PARTNER_LINK_OPT_OUT_PENDING", "MEASUREMENT_PARTNER_LINK_WRAPPING_PENDING", "MEASUREMENT_PARTNER_MODE_CHANGE_PENDING", "MEASUREMENT_PARTNER_UNLINK_PENDING" ] }, "measurementPartner": { "description": "Measurement partner used for tag wrapping.", "type": "string", "enum": [ "NONE", "INTEGRAL_AD_SCIENCE", "DOUBLE_VERIFY" ], "enumDescriptions": [ "", "", "" ] } }, "id": "MeasurementPartnerAdvertiserLink" }, "PricingSchedule": { "id": "PricingSchedule", "properties": { "floodlightActivityId": { "description": "Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to PRICING_TYPE_CPA.", "type": "string", "format": "int64" }, "pricingType": { "enumDescriptions": [ "", "", "", "", "", "" ], "description": "Placement pricing type. This field is required on insertion.", "type": "string", "enum": [ "PRICING_TYPE_CPM", "PRICING_TYPE_CPC", "PRICING_TYPE_CPA", "PRICING_TYPE_FLAT_RATE_IMPRESSIONS", "PRICING_TYPE_FLAT_RATE_CLICKS", "PRICING_TYPE_CPM_ACTIVEVIEW" ] }, "flighted": { "type": "boolean", "description": "Whether this placement is flighted. If true, pricing periods will be computed automatically." }, "startDate": { "type": "string", "format": "date" }, "pricingPeriods": { "description": "Pricing periods for this placement.", "type": "array", "items": { "$ref": "PricingSchedulePricingPeriod" } }, "endDate": { "format": "date", "type": "string" }, "capCostOption": { "description": "Placement cap cost option.", "enumDescriptions": [ "", "", "" ], "type": "string", "enum": [ "CAP_COST_NONE", "CAP_COST_MONTHLY", "CAP_COST_CUMULATIVE" ] }, "testingStartDate": { "type": "string", "format": "date" } }, "type": "object", "description": "Pricing Schedule" }, "ClickTag": { "description": "Creative Click Tag.", "type": "object", "properties": { "clickThroughUrl": { "description": "Parameter value for the specified click tag. This field contains a click-through url.", "$ref": "CreativeClickThroughUrl" }, "eventName": { "description": "Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "string" }, "name": { "description": "Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field.", "type": "string" } }, "id": "ClickTag" }, "DynamicTargetingKeysListResponse": { "description": "Dynamic Targeting Key List Response", "id": "DynamicTargetingKeysListResponse", "type": "object", "properties": { "dynamicTargetingKeys": { "items": { "$ref": "DynamicTargetingKey" }, "description": "Dynamic targeting key collection.", "type": "array" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#dynamicTargetingKeysListResponse\"." } } }, "AccountPermission": { "description": "AccountPermissions contains information about a particular account permission. Some features of Campaign Manager require an account permission to be present in the account.", "properties": { "name": { "type": "string", "description": "Name of this account permission." }, "level": { "type": "string", "enum": [ "USER", "ADMINISTRATOR" ], "description": "Administrative level required to enable this account permission.", "enumDescriptions": [ "", "" ] }, "id": { "format": "int64", "description": "ID of this account permission.", "type": "string" }, "accountProfiles": { "items": { "enumDescriptions": [ "Basic profile has fewer features and lower CPM.", "Standard profile as a higher CPM and all the features." ], "type": "string", "enum": [ "ACCOUNT_PROFILE_BASIC", "ACCOUNT_PROFILE_STANDARD" ] }, "type": "array", "description": "Account profiles associated with this account permission. Possible values are: - \"ACCOUNT_PROFILE_BASIC\" - \"ACCOUNT_PROFILE_STANDARD\" " }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountPermission\".", "type": "string" }, "permissionGroupId": { "type": "string", "description": "Permission group of this account permission.", "format": "int64" } }, "id": "AccountPermission", "type": "object" }, "Country": { "properties": { "sslEnabled": { "type": "boolean", "description": "Whether ad serving supports secure servers in this country." }, "dartId": { "type": "string", "description": "DART ID of this country. This is the ID used for targeting and generating reports.", "format": "int64" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#country\"." }, "tvDataProviders": { "readOnly": true, "type": "array", "items": { "enumDescriptions": [ "", "Allows populating multiple tvCampaignId filters and tvCampaignEndDate filter on the report.", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "INVALID_TV_DATA_PROVIDER", "INTAGE_JP", "IBOPE_AR", "IBOPE_BR", "IBOPE_CL", "IBOPE_CO", "TNS_VN", "COMSCORE_NATIONAL_US", "COMSCORE_CA", "SAMBA_AU" ] }, "description": "Output only. The TV data providers supported in this country." }, "name": { "description": "Name of this country.", "type": "string" }, "countryCode": { "type": "string", "description": "Country code." } }, "description": "Contains information about a country that can be targeted by ads.", "type": "object", "id": "Country" }, "CompanionClickThroughOverride": { "type": "object", "properties": { "creativeId": { "description": "ID of the creative for this companion click-through override.", "type": "string", "format": "int64" }, "clickThroughUrl": { "$ref": "ClickThroughUrl", "description": "Click-through URL of this companion click-through override." } }, "id": "CompanionClickThroughOverride", "description": "Companion Click-through override." }, "ThirdPartyAuthenticationToken": { "id": "ThirdPartyAuthenticationToken", "description": "Third Party Authentication Token", "type": "object", "properties": { "name": { "description": "Name of the third-party authentication token.", "type": "string" }, "value": { "description": "Value of the third-party authentication token. This is a read-only, auto-generated field.", "type": "string" } } }, "ConversionsBatchUpdateResponse": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionsBatchUpdateResponse\".", "type": "string" }, "hasFailures": { "description": "Indicates that some or all conversions failed to update.", "type": "boolean" }, "status": { "items": { "$ref": "ConversionStatus" }, "type": "array", "description": "The update status of each conversion. Statuses are returned in the same order that conversions are updated." } }, "id": "ConversionsBatchUpdateResponse", "description": "Update Conversions Response.", "type": "object" }, "TargetingTemplate": { "properties": { "id": { "description": "ID of this targeting template. This is a read-only, auto-generated field.", "format": "int64", "type": "string" }, "listTargetingExpression": { "$ref": "ListTargetingExpression", "description": "Remarketing list targeting criteria." }, "languageTargeting": { "description": "Language targeting criteria.", "$ref": "LanguageTargeting" }, "name": { "description": "Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.", "type": "string" }, "contextualKeywordTargeting": { "$ref": "ContextualKeywordTargeting", "description": "Optional. Contextual keyword targeting criteria." }, "keyValueTargetingExpression": { "$ref": "KeyValueTargetingExpression", "description": "Key-value targeting criteria." }, "accountId": { "description": "Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.", "type": "string", "format": "int64" }, "advertiserId": { "type": "string", "format": "int64", "description": "Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert." }, "technologyTargeting": { "description": "Technology platform targeting criteria.", "$ref": "TechnologyTargeting" }, "geoTargeting": { "$ref": "GeoTargeting", "description": "Geographical targeting criteria." }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "dayPartTargeting": { "description": "Time and day targeting criteria.", "$ref": "DayPartTargeting" }, "subaccountId": { "type": "string", "format": "int64", "description": "Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#targetingTemplate\"." } }, "type": "object", "id": "TargetingTemplate", "description": "Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads." }, "LanguagesListResponse": { "description": "Language List Response", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#languagesListResponse\".", "type": "string" }, "languages": { "type": "array", "items": { "$ref": "Language" }, "description": "Language collection." } }, "id": "LanguagesListResponse", "type": "object" }, "Activities": { "description": "Represents an activity group.", "id": "Activities", "type": "object", "properties": { "filters": { "items": { "$ref": "DimensionValue" }, "type": "array", "description": "List of activity filters. The dimension values need to be all either of type \"dfa:activity\" or \"dfa:activityGroup\"." }, "metricNames": { "type": "array", "items": { "type": "string" }, "description": "List of names of floodlight activity metrics." }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#activities." } } }, "Metro": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#metro\"." }, "dmaId": { "description": "DMA ID of this metro region. This is the ID used for targeting and generating reports, and is equivalent to metro_code.", "format": "int64", "type": "string" }, "dartId": { "format": "int64", "type": "string", "description": "DART ID of this metro region." }, "countryDartId": { "format": "int64", "type": "string", "description": "DART ID of the country to which this metro region belongs." }, "metroCode": { "type": "string", "description": "Metro code of this metro region. This is equivalent to dma_id." }, "countryCode": { "description": "Country code of the country to which this metro region belongs.", "type": "string" }, "name": { "type": "string", "description": "Name of this metro region." } }, "description": "Contains information about a metro region that can be targeted by ads.", "id": "Metro", "type": "object" }, "DeepLink": { "description": "Contains information about a landing page deep link.", "type": "object", "properties": { "appUrl": { "type": "string", "description": "The URL of the mobile app being linked to." }, "fallbackUrl": { "description": "The fallback URL. This URL will be served to users who do not have the mobile app installed.", "type": "string" }, "remarketingListIds": { "items": { "type": "string", "format": "int64" }, "type": "array", "description": "Ads served to users on these remarketing lists will use this deep link. Applicable when mobileApp.directory is APPLE_APP_STORE." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#deepLink\"." }, "mobileApp": { "description": "The mobile app targeted by this deep link.", "$ref": "MobileApp" } }, "id": "DeepLink" }, "CreativeRotation": { "description": "Creative Rotation.", "properties": { "weightCalculationStrategy": { "type": "string", "enum": [ "WEIGHT_STRATEGY_EQUAL", "WEIGHT_STRATEGY_CUSTOM", "WEIGHT_STRATEGY_HIGHEST_CTR", "WEIGHT_STRATEGY_OPTIMIZED" ], "enumDescriptions": [ "The creative weights should all be equal to 1. This is the default value for all ads with a rotation type of Random.", "The creative weights can be any user provided positive integer.", "The weights will be automatically calculated giving preference to the creative that has the highest CTR. The CTR for campaigns that are optimized for clicks = clicks/impressions. The CTR for campaigns that are optimized for view-through or click through is sum(activities + floodlight weight)/impressions.", "The creative weights will be automatically calculated using a formula that could not possibly be explained in these comments. The value will be within some predetermined range (probably 0 - 1,000,000)." ], "description": "Strategy for calculating weights. Used with CREATIVE_ROTATION_TYPE_RANDOM." }, "creativeOptimizationConfigurationId": { "description": "Creative optimization configuration that is used by this ad. It should refer to one of the existing optimization configurations in the ad's campaign. If it is unset or set to 0, then the campaign's default optimization configuration will be used for this ad.", "type": "string", "format": "int64" }, "type": { "type": "string", "enum": [ "CREATIVE_ROTATION_TYPE_SEQUENTIAL", "CREATIVE_ROTATION_TYPE_RANDOM" ], "description": "Type of creative rotation. Can be used to specify whether to use sequential or random rotation.", "enumDescriptions": [ "The weights of each creative in the rotation should be sequential starting at 1. The user may adjust the order.", "The weights are calculated according to the ad's CreativeRoationWeightStrategy." ] }, "creativeAssignments": { "description": "Creative assignments in this creative rotation.", "type": "array", "items": { "$ref": "CreativeAssignment" } } }, "id": "CreativeRotation", "type": "object" }, "CustomFloodlightVariable": { "id": "CustomFloodlightVariable", "properties": { "type": { "description": "The type of custom floodlight variable to supply a value for. These map to the \"u[1-100]=\" in the tags.", "type": "string", "enum": [ "U1", "U2", "U3", "U4", "U5", "U6", "U7", "U8", "U9", "U10", "U11", "U12", "U13", "U14", "U15", "U16", "U17", "U18", "U19", "U20", "U21", "U22", "U23", "U24", "U25", "U26", "U27", "U28", "U29", "U30", "U31", "U32", "U33", "U34", "U35", "U36", "U37", "U38", "U39", "U40", "U41", "U42", "U43", "U44", "U45", "U46", "U47", "U48", "U49", "U50", "U51", "U52", "U53", "U54", "U55", "U56", "U57", "U58", "U59", "U60", "U61", "U62", "U63", "U64", "U65", "U66", "U67", "U68", "U69", "U70", "U71", "U72", "U73", "U74", "U75", "U76", "U77", "U78", "U79", "U80", "U81", "U82", "U83", "U84", "U85", "U86", "U87", "U88", "U89", "U90", "U91", "U92", "U93", "U94", "U95", "U96", "U97", "U98", "U99", "U100" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ] }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#customFloodlightVariable\".", "type": "string" }, "value": { "type": "string", "description": "The value of the custom floodlight variable. The length of string must not exceed 100 characters." } }, "type": "object", "description": "A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list." }, "SiteTranscodeSetting": { "type": "object", "properties": { "enabledVideoFormats": { "description": "Allowlist of video formats to be served to this site template. Set this list to null or empty to serve all video formats.", "type": "array", "items": { "format": "int32", "type": "integer" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#siteTranscodeSetting\".", "type": "string" } }, "id": "SiteTranscodeSetting", "description": "Transcode Settings" }, "ConversionsBatchUpdateRequest": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionsBatchUpdateRequest\"." }, "conversions": { "type": "array", "items": { "$ref": "Conversion" }, "description": "The set of conversions to update." }, "encryptionInfo": { "description": "Describes how encryptedUserId is encrypted. This is a required field if encryptedUserId is used.", "$ref": "EncryptionInfo" } }, "id": "ConversionsBatchUpdateRequest", "description": "Update Conversions Request.", "type": "object" }, "DimensionValueList": { "properties": { "kind": { "description": "The kind of list this is, in this case dfareporting#dimensionValueList.", "type": "string" }, "etag": { "type": "string", "description": "The eTag of this response for caching purposes." }, "items": { "items": { "$ref": "DimensionValue" }, "description": "The dimension values returned in this response.", "type": "array" }, "nextPageToken": { "description": "Continuation token used to page through dimension values. To retrieve the next page of results, set the next request's \"pageToken\" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted.", "type": "string" } }, "id": "DimensionValueList", "type": "object", "description": "Represents the list of DimensionValue resources." }, "ClickThroughUrl": { "properties": { "landingPageId": { "format": "int64", "type": "string", "description": "ID of the landing page for the click-through URL. Applicable if the defaultLandingPage field is set to false." }, "customClickThroughUrl": { "description": "Custom click-through URL. Applicable if the defaultLandingPage field is set to false and the landingPageId field is left unset.", "type": "string" }, "defaultLandingPage": { "type": "boolean", "description": "Whether the campaign default landing page is used." }, "computedClickThroughUrl": { "description": "Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: - If defaultLandingPage is enabled then the campaign's default landing page URL is assigned to this field. - If defaultLandingPage is not enabled and a landingPageId is specified then that landing page's URL is assigned to this field. - If neither of the above cases apply, then the customClickThroughUrl is assigned to this field. ", "type": "string" } }, "description": "Click-through URL", "id": "ClickThroughUrl", "type": "object" }, "SiteSkippableSetting": { "properties": { "progressOffset": { "$ref": "VideoOffset", "description": "Amount of time to play videos served to this site template before counting a view. Applicable when skippable is true." }, "skipOffset": { "description": "Amount of time to play videos served to this site before the skip button should appear. Applicable when skippable is true.", "$ref": "VideoOffset" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#siteSkippableSetting\".", "type": "string" }, "skippable": { "description": "Whether the user can skip creatives served to this site. This will act as default for new placements created under this site.", "type": "boolean" } }, "id": "SiteSkippableSetting", "type": "object", "description": "Skippable Settings" }, "PlacementsGenerateTagsResponse": { "id": "PlacementsGenerateTagsResponse", "type": "object", "description": "Placement GenerateTags Response", "properties": { "placementTags": { "items": { "$ref": "PlacementTag" }, "type": "array", "description": "Set of generated tags for the specified placements." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementsGenerateTagsResponse\"." } } }, "IngestionErrorRecord": { "properties": { "errors": { "type": "array", "readOnly": true, "items": { "$ref": "FieldError" }, "description": "Output only. The list of field errors of the ingestion error record." }, "recordId": { "readOnly": true, "type": "string", "description": "Output only. The record ID of the ingestion error record." } }, "type": "object", "id": "IngestionErrorRecord", "description": "Contains the ingestion error record of the dynamic feed. limited to 100 records." }, "Report": { "properties": { "subAccountId": { "description": "The subaccount ID to which this report belongs if applicable.", "type": "string", "format": "int64" }, "fileName": { "type": "string", "description": "The filename used when generating report files for this report." }, "lastModifiedTime": { "format": "uint64", "description": "The timestamp (in milliseconds since epoch) of when this report was last modified.", "type": "string" }, "reachCriteria": { "description": "The report criteria for a report of type \"REACH\".", "properties": { "activities": { "$ref": "Activities", "description": "Activity group." }, "dateRange": { "description": "The date range this report should be run for.", "$ref": "DateRange" }, "dimensionFilters": { "items": { "$ref": "DimensionValue" }, "description": "The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.", "type": "array" }, "customRichMediaEvents": { "description": "Custom Rich Media Events group.", "$ref": "CustomRichMediaEvents" }, "reachByFrequencyMetricNames": { "type": "array", "items": { "type": "string" }, "description": "The list of names of Reach By Frequency metrics the report should include." }, "dimensions": { "items": { "$ref": "SortedDimension" }, "type": "array", "description": "The list of dimensions the report should include." }, "metricNames": { "items": { "type": "string" }, "description": "The list of names of metrics the report should include.", "type": "array" } }, "type": "object" }, "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#report." }, "accountId": { "format": "int64", "description": "The account ID to which this report belongs.", "type": "string" }, "delivery": { "properties": { "emailOwner": { "description": "Whether the report should be emailed to the report owner.", "type": "boolean" }, "recipients": { "items": { "$ref": "Recipient" }, "description": "The list of recipients to which to email the report.", "type": "array" }, "emailOwnerDeliveryType": { "description": "The type of delivery for the owner to receive, if enabled.", "type": "string", "enum": [ "LINK", "ATTACHMENT" ], "enumDescriptions": [ "", "" ] }, "message": { "type": "string", "description": "The message to be sent with each email." } }, "description": "The report's email delivery settings.", "type": "object" }, "ownerProfileId": { "description": "The user profile id of the owner of this report.", "format": "int64", "type": "string" }, "pathToConversionCriteria": { "properties": { "conversionDimensions": { "items": { "$ref": "SortedDimension" }, "type": "array", "description": "The list of conversion dimensions the report should include." }, "floodlightConfigId": { "description": "The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.", "$ref": "DimensionValue" }, "perInteractionDimensions": { "type": "array", "items": { "$ref": "SortedDimension" }, "description": "The list of per interaction dimensions the report should include." }, "metricNames": { "description": "The list of names of metrics the report should include.", "type": "array", "items": { "type": "string" } }, "dateRange": { "$ref": "DateRange", "description": "The date range this report should be run for." }, "customFloodlightVariables": { "items": { "$ref": "SortedDimension" }, "type": "array", "description": "The list of custom floodlight variables the report should include." }, "customRichMediaEvents": { "items": { "$ref": "DimensionValue" }, "type": "array", "description": "The list of custom rich media events to include." }, "activityFilters": { "description": "The list of 'dfa:activity' values to filter on.", "items": { "$ref": "DimensionValue" }, "type": "array" }, "reportProperties": { "description": "The properties of the report.", "properties": { "pivotOnInteractionPath": { "type": "boolean", "description": "Enable pivoting on interaction path." }, "maximumImpressionInteractions": { "description": "The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.", "type": "integer", "format": "int32" }, "maximumClickInteractions": { "format": "int32", "description": "The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report.", "type": "integer" }, "includeUnattributedIPConversions": { "type": "boolean", "description": "Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion." }, "impressionsLookbackWindow": { "format": "int32", "type": "integer", "description": "CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90." }, "includeAttributedIPConversions": { "type": "boolean", "description": "Deprecated: has no effect." }, "clicksLookbackWindow": { "format": "int32", "description": "CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90.", "type": "integer" }, "maximumInteractionGap": { "format": "int32", "type": "integer", "description": "The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90." }, "includeUnattributedCookieConversions": { "description": "Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.", "type": "boolean" } }, "type": "object" } }, "type": "object", "description": "The report criteria for a report of type \"PATH_TO_CONVERSION\"." }, "etag": { "description": "The eTag of this response for caching purposes.", "type": "string" }, "crossMediaReachCriteria": { "description": "Optional. The report criteria for a report of type \"CROSS_MEDIA_REACH\".", "type": "object", "properties": { "dimensions": { "type": "array", "items": { "$ref": "SortedDimension" }, "description": "Required. The list of dimensions the report should include." }, "metricNames": { "items": { "type": "string" }, "description": "Required. The list of names of metrics the report should include.", "type": "array" }, "dateRange": { "$ref": "DateRange", "description": "Required. The date range this report should be run for." }, "dimensionFilters": { "items": { "$ref": "DimensionValue" }, "description": "Required. The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed.", "type": "array" } } }, "criteria": { "description": "The report criteria for a report of type \"STANDARD\".", "properties": { "dimensionFilters": { "type": "array", "items": { "$ref": "DimensionValue" }, "description": "The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed." }, "activities": { "$ref": "Activities", "description": "Activity group." }, "customRichMediaEvents": { "description": "Custom Rich Media Events group.", "$ref": "CustomRichMediaEvents" }, "dimensions": { "description": "The list of standard dimensions the report should include.", "items": { "$ref": "SortedDimension" }, "type": "array" }, "metricNames": { "items": { "type": "string" }, "description": "The list of names of metrics the report should include.", "type": "array" }, "dateRange": { "description": "The date range for which this report should be run.", "$ref": "DateRange" } }, "type": "object" }, "name": { "type": "string", "description": "The name of the report." }, "schedule": { "type": "object", "description": "The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not \"TODAY\".", "properties": { "runsOnDayOfMonth": { "description": "Enum to define for \"MONTHLY\" scheduled reports whether reports should be repeated on the same day of the month as \"startDate\" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), \"DAY_OF_MONTH\" would run subsequent reports on the 2nd of every Month, and \"WEEK_OF_MONTH\" would run subsequent reports on the first Monday of the month.", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "DAY_OF_MONTH", "WEEK_OF_MONTH" ] }, "repeats": { "description": "The interval for which the report is repeated. Note: - \"DAILY\" also requires field \"every\" to be set. - \"WEEKLY\" also requires fields \"every\" and \"repeatsOnWeekDays\" to be set. - \"MONTHLY\" also requires fields \"every\" and \"runsOnDayOfMonth\" to be set. ", "type": "string" }, "repeatsOnWeekDays": { "description": "List of week days \"WEEKLY\" on which scheduled reports should run.", "items": { "enumDescriptions": [ "", "", "", "", "", "", "" ], "type": "string", "enum": [ "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" ] }, "type": "array" }, "expirationDate": { "format": "date", "type": "string" }, "timezone": { "description": "The timezone when the report will run.", "type": "string" }, "startDate": { "type": "string", "format": "date" }, "every": { "description": "Defines every how many days, weeks or months the report should be run. Needs to be set when \"repeats\" is either \"DAILY\", \"WEEKLY\" or \"MONTHLY\".", "format": "int32", "type": "integer" }, "active": { "description": "Whether the schedule is active or not. Must be set to either true or false.", "type": "boolean" } } }, "floodlightCriteria": { "description": "The report criteria for a report of type \"FLOODLIGHT\".", "type": "object", "properties": { "dimensionFilters": { "type": "array", "items": { "$ref": "DimensionValue" }, "description": "The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed." }, "dateRange": { "$ref": "DateRange", "description": "The date range this report should be run for." }, "floodlightConfigId": { "description": "The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'.", "$ref": "DimensionValue" }, "metricNames": { "description": "The list of names of metrics the report should include.", "type": "array", "items": { "type": "string" } }, "reportProperties": { "description": "The properties of the report.", "type": "object", "properties": { "includeAttributedIPConversions": { "type": "boolean", "description": "Include conversions that have no cookie, but do have an exposure path." }, "includeUnattributedIPConversions": { "description": "Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion.", "type": "boolean" }, "includeUnattributedCookieConversions": { "description": "Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window.", "type": "boolean" } } }, "customRichMediaEvents": { "type": "array", "items": { "$ref": "DimensionValue" }, "description": "The list of custom rich media events to include." }, "dimensions": { "items": { "$ref": "SortedDimension" }, "description": "The list of dimensions the report should include.", "type": "array" } } }, "type": { "description": "The type of the report.", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "STANDARD", "REACH", "PATH_TO_CONVERSION", "FLOODLIGHT", "CROSS_MEDIA_REACH" ] }, "format": { "type": "string", "enum": [ "CSV", "EXCEL" ], "enumDescriptions": [ "", "" ], "description": "The output format of the report. If not specified, default format is \"CSV\". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. \"CSV\" will then be the fallback format." }, "id": { "description": "The unique ID identifying this report resource.", "type": "string", "format": "int64" } }, "type": "object", "id": "Report", "description": "Represents a Report resource." }, "CustomRule": { "properties": { "name": { "type": "string", "description": "Optional. Name of this custom rule." }, "ruleBlocks": { "description": "Optional. A list of field filter, the custom rule will apply.", "type": "array", "items": { "$ref": "RuleBlock" } }, "priority": { "format": "int32", "description": "Optional. Priority of the custom rule.", "type": "integer" } }, "type": "object", "id": "CustomRule", "description": "Contains custom rule information." }, "AdvertiserGroupsListResponse": { "description": "Advertiser Group List Response", "type": "object", "id": "AdvertiserGroupsListResponse", "properties": { "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" }, "advertiserGroups": { "description": "Advertiser group collection.", "type": "array", "items": { "$ref": "AdvertiserGroup" } }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertiserGroupsListResponse\"." } } }, "DfpSettings": { "type": "object", "description": "Google Ad Manager Settings", "properties": { "dfpNetworkCode": { "description": "Ad Manager network code for this directory site.", "type": "string" }, "programmaticPlacementAccepted": { "type": "boolean", "description": "Whether this directory site accepts programmatic placements." }, "publisherPortalOnly": { "description": "Whether this directory site is available only via Publisher Portal.", "type": "boolean" }, "pubPaidPlacementAccepted": { "description": "Whether this directory site accepts publisher-paid tags.", "type": "boolean" }, "dfpNetworkName": { "type": "string", "description": "Ad Manager network name for this directory site." } }, "id": "DfpSettings" }, "ConversionsBatchInsertRequest": { "id": "ConversionsBatchInsertRequest", "properties": { "conversions": { "items": { "$ref": "Conversion" }, "description": "The set of conversions to insert.", "type": "array" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionsBatchInsertRequest\".", "type": "string" }, "encryptionInfo": { "description": "Describes how encryptedUserId or encryptedUserIdCandidates[] is encrypted. This is a required field if encryptedUserId or encryptedUserIdCandidates[] is used.", "$ref": "EncryptionInfo" } }, "description": "Insert Conversions Request.", "type": "object" }, "Size": { "description": "Represents the dimensions of ads, placements, creatives, or creative assets.", "id": "Size", "type": "object", "properties": { "id": { "type": "string", "format": "int64", "description": "ID of this size. This is a read-only, auto-generated field." }, "height": { "description": "Height of this size. Acceptable values are 0 to 32767, inclusive.", "type": "integer", "format": "int32" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#size\".", "type": "string" }, "width": { "type": "integer", "format": "int32", "description": "Width of this size. Acceptable values are 0 to 32767, inclusive." }, "iab": { "description": "IAB standard size. This is a read-only, auto-generated field.", "type": "boolean" } } }, "OperatingSystemsListResponse": { "type": "object", "description": "Operating System List Response", "id": "OperatingSystemsListResponse", "properties": { "operatingSystems": { "description": "Operating system collection.", "items": { "$ref": "OperatingSystem" }, "type": "array" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#operatingSystemsListResponse\"." } } }, "UserProfileList": { "type": "object", "description": "Represents the list of user profiles.", "id": "UserProfileList", "properties": { "items": { "type": "array", "description": "The user profiles returned in this response.", "items": { "$ref": "UserProfile" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userProfileList\".", "type": "string" }, "etag": { "type": "string", "description": "Etag of this resource." } } }, "DependentFieldValue": { "type": "object", "id": "DependentFieldValue", "properties": { "fieldId": { "type": "integer", "format": "int32", "description": "Optional. The field id of the dependent field." }, "dynamicFeedId": { "description": "Optional. The ID of the dynamic feed that value's field will match against.", "type": "string", "format": "int64" }, "elementId": { "type": "string", "description": "Optional. The ID of the element that value's field will match against.", "format": "int64" } }, "description": "Contains dependent field value information." }, "OptimizationActivity": { "properties": { "floodlightActivityIdDimensionValue": { "description": "Dimension value for the ID of the floodlight activity. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "floodlightActivityId": { "type": "string", "format": "int64", "description": "Floodlight activity ID of this optimization activity. This is a required field." }, "weight": { "description": "Weight associated with this optimization. The weight assigned will be understood in proportion to the weights assigned to the other optimization activities. Value must be greater than or equal to 1.", "format": "int32", "type": "integer" } }, "type": "object", "id": "OptimizationActivity", "description": "Creative optimization activity." }, "RemarketingList": { "id": "RemarketingList", "description": "Contains properties of a remarketing list. Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource can be used to manage remarketing lists that are owned by your advertisers. To see all remarketing lists that are visible to your advertisers, including those that are shared to your advertiser or account, use the TargetableRemarketingLists resource.", "type": "object", "properties": { "active": { "type": "boolean", "description": "Whether this remarketing list is active." }, "description": { "description": "Remarketing list description.", "type": "string" }, "id": { "type": "string", "description": "Remarketing list ID. This is a read-only, auto-generated field.", "format": "int64" }, "name": { "type": "string", "description": "Name of the remarketing list. This is a required field. Must be no greater than 128 characters long." }, "listSize": { "description": "Number of users currently in the list. This is a read-only field.", "format": "int64", "type": "string" }, "listPopulationRule": { "description": "Rule used to populate the remarketing list with users.", "$ref": "ListPopulationRule" }, "advertiserId": { "type": "string", "format": "int64", "description": "Dimension value for the advertiser ID that owns this remarketing list. This is a required field." }, "listSource": { "description": "Product from which this remarketing list was originated.", "enumDescriptions": [ "covers sources not supported in DCM other than those listed below", "ADX", "DFP", "XFP", "DoubleClick Campaign Manager", "Google Analytics Premium", "Youtube", "DoubleClick Bid Manager", "G+", "DoubleClick Audience Center", "Playstore" ], "type": "string", "enum": [ "REMARKETING_LIST_SOURCE_OTHER", "REMARKETING_LIST_SOURCE_ADX", "REMARKETING_LIST_SOURCE_DFP", "REMARKETING_LIST_SOURCE_XFP", "REMARKETING_LIST_SOURCE_DFA", "REMARKETING_LIST_SOURCE_GA", "REMARKETING_LIST_SOURCE_YOUTUBE", "REMARKETING_LIST_SOURCE_DBM", "REMARKETING_LIST_SOURCE_GPLUS", "REMARKETING_LIST_SOURCE_DMP", "REMARKETING_LIST_SOURCE_PLAY_STORE" ] }, "advertiserIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field." }, "lifeSpan": { "format": "int64", "description": "Number of days that a user should remain in the remarketing list without an impression. Acceptable values are 1 to 540, inclusive.", "type": "string" }, "subaccountId": { "description": "Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests.", "type": "string", "format": "int64" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#remarketingList\"." }, "accountId": { "type": "string", "format": "int64", "description": "Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in GET requests." } } }, "ClickThroughUrlSuffixProperties": { "type": "object", "properties": { "overrideInheritedSuffix": { "type": "boolean", "description": "Whether this entity should override the inherited click-through URL suffix with its own defined value." }, "clickThroughUrlSuffix": { "description": "Click-through URL suffix to apply to all ads in this entity's scope. Must be less than 128 characters long.", "type": "string" } }, "id": "ClickThroughUrlSuffixProperties", "description": "Click Through URL Suffix settings." }, "AdvertiserGroup": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertiserGroup\".", "type": "string" }, "name": { "type": "string", "description": "Name of this advertiser group. This is a required field and must be less than 256 characters long and unique among advertiser groups of the same account." }, "accountId": { "format": "int64", "type": "string", "description": "Account ID of this advertiser group. This is a read-only field that can be left blank." }, "id": { "format": "int64", "description": "ID of this advertiser group. This is a read-only, auto-generated field.", "type": "string" } }, "description": "Groups advertisers together so that reports can be generated for the entire group at once.", "type": "object", "id": "AdvertiserGroup" }, "ReachReportCompatibleFields": { "id": "ReachReportCompatibleFields", "properties": { "reachByFrequencyMetrics": { "description": "Metrics which are compatible to be selected in the \"reachByFrequencyMetricNames\" section of the report.", "items": { "$ref": "Metric" }, "type": "array" }, "metrics": { "type": "array", "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report.", "items": { "$ref": "Metric" } }, "dimensions": { "type": "array", "description": "Dimensions which are compatible to be selected in the \"dimensions\" section of the report.", "items": { "$ref": "Dimension" } }, "pivotedActivityMetrics": { "items": { "$ref": "Metric" }, "type": "array", "description": "Metrics which are compatible to be selected as activity metrics to pivot on in the \"activities\" section of the report." }, "dimensionFilters": { "items": { "$ref": "Dimension" }, "type": "array", "description": "Dimensions which are compatible to be selected in the \"dimensionFilters\" section of the report." }, "kind": { "description": "The kind of resource this is, in this case dfareporting#reachReportCompatibleFields.", "type": "string" } }, "description": "Represents fields that are compatible to be selected for a report of type \"REACH\".", "type": "object" }, "RichMediaExitOverride": { "description": "Rich Media Exit Override.", "type": "object", "id": "RichMediaExitOverride", "properties": { "enabled": { "type": "boolean", "description": "Whether to use the clickThroughUrl. If false, the creative-level exit will be used." }, "exitId": { "format": "int64", "type": "string", "description": "ID for the override to refer to a specific exit in the creative." }, "clickThroughUrl": { "description": "Click-through URL of this rich media exit override. Applicable if the enabled field is set to true.", "$ref": "ClickThroughUrl" } } }, "PostalCode": { "id": "PostalCode", "description": "Contains information about a postal code that can be targeted by ads.", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#postalCode\".", "type": "string" }, "countryCode": { "type": "string", "description": "Country code of the country to which this postal code belongs." }, "countryDartId": { "type": "string", "format": "int64", "description": "DART ID of the country to which this postal code belongs." }, "id": { "description": "ID of this postal code.", "type": "string" }, "code": { "type": "string", "description": "Postal code. This is equivalent to the id field." } } }, "CitiesListResponse": { "description": "City List Response", "type": "object", "id": "CitiesListResponse", "properties": { "cities": { "items": { "$ref": "City" }, "type": "array", "description": "City collection." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#citiesListResponse\"." } } }, "TechnologyTargeting": { "type": "object", "properties": { "browsers": { "description": "Browsers that this ad targets. For each browser either set browserVersionId or dartId along with the version numbers. If both are specified, only browserVersionId will be used. The other fields are populated automatically when the ad is inserted or updated.", "type": "array", "items": { "$ref": "Browser" } }, "operatingSystemVersions": { "type": "array", "items": { "$ref": "OperatingSystemVersion" }, "description": "Operating system versions that this ad targets. To target all versions, use operatingSystems. For each operating system version, only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system version, do not set targeting for the corresponding operating system in operatingSystems." }, "operatingSystems": { "items": { "$ref": "OperatingSystem" }, "description": "Operating systems that this ad targets. To target specific versions, use operatingSystemVersions. For each operating system only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting an operating system, do not set targeting for operating system versions for the same operating system.", "type": "array" }, "connectionTypes": { "description": "Connection types that this ad targets. For each connection type only id is required. The other fields are populated automatically when the ad is inserted or updated.", "type": "array", "items": { "$ref": "ConnectionType" } }, "platformTypes": { "type": "array", "items": { "$ref": "PlatformType" }, "description": "Platform types that this ad targets. For example, desktop, mobile, or tablet. For each platform type, only id is required, and the other fields are populated automatically when the ad is inserted or updated." }, "mobileCarriers": { "type": "array", "description": "Mobile carriers that this ad targets. For each mobile carrier only id is required, and the other fields are populated automatically when the ad is inserted or updated. If targeting a mobile carrier, do not set targeting for any zip codes.", "items": { "$ref": "MobileCarrier" } } }, "description": "Technology Targeting.", "id": "TechnologyTargeting" }, "CreativeGroup": { "id": "CreativeGroup", "description": "Contains properties of a creative group.", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeGroup\"." }, "id": { "format": "int64", "description": "ID of this creative group. This is a read-only, auto-generated field.", "type": "string" }, "accountId": { "description": "Account ID of this creative group. This is a read-only field that can be left blank.", "format": "int64", "type": "string" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "groupNumber": { "type": "integer", "description": "Subgroup of the creative group. Assign your creative groups to a subgroup in order to filter or manage them more easily. This field is required on insertion and is read-only after insertion. Acceptable values are 1 to 2, inclusive.", "format": "int32" }, "advertiserId": { "format": "int64", "description": "Advertiser ID of this creative group. This is a required field on insertion.", "type": "string" }, "subaccountId": { "type": "string", "format": "int64", "description": "Subaccount ID of this creative group. This is a read-only field that can be left blank." }, "name": { "type": "string", "description": "Name of this creative group. This is a required field and must be less than 256 characters long and unique among creative groups of the same advertiser." } }, "type": "object" }, "PostalCodesListResponse": { "type": "object", "description": "Postal Code List Response", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#postalCodesListResponse\".", "type": "string" }, "postalCodes": { "description": "Postal code collection.", "items": { "$ref": "PostalCode" }, "type": "array" } }, "id": "PostalCodesListResponse" }, "CreativeFieldsListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeFieldsListResponse\"." }, "creativeFields": { "description": "Creative field collection.", "items": { "$ref": "CreativeField" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "type": "object", "id": "CreativeFieldsListResponse", "description": "Creative Field List Response" }, "PlacementGroup": { "description": "Contains properties of a package or roadblock.", "type": "object", "properties": { "siteIdDimensionValue": { "description": "Dimension value for the ID of the site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "primaryPlacementId": { "description": "ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the primary field on all affected roadblock child placements.", "type": "string", "format": "int64" }, "advertiserId": { "description": "Advertiser ID of this placement group. This is a required field on insertion.", "format": "int64", "type": "string" }, "campaignIdDimensionValue": { "description": "Dimension value for the ID of the campaign. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "createInfo": { "$ref": "LastModifiedInfo", "description": "Information about the creation of this placement group. This is a read-only field." }, "lastModifiedInfo": { "description": "Information about the most recent modification of this placement group. This is a read-only field.", "$ref": "LastModifiedInfo" }, "campaignId": { "description": "Campaign ID of this placement group. This field is required on insertion.", "type": "string", "format": "int64" }, "externalId": { "description": "External ID for this placement.", "type": "string" }, "idDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of this placement group. This is a read-only, auto-generated field." }, "directorySiteId": { "description": "Directory site ID associated with this placement group. On insert, you must set either this field or the site_id field to specify the site associated with this placement group. This is a required field that is read-only after insertion.", "type": "string", "format": "int64" }, "comment": { "description": "Comments for this placement group.", "type": "string" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "contentCategoryId": { "format": "int64", "type": "string", "description": "ID of the content category assigned to this placement group." }, "name": { "type": "string", "description": "Name of this placement group. This is a required field and must be less than 256 characters long." }, "siteId": { "format": "int64", "type": "string", "description": "Site ID associated with this placement group. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement group. This is a required field that is read-only after insertion." }, "directorySiteIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the directory site. This is a read-only, auto-generated field." }, "placementGroupType": { "enumDescriptions": [ "A simple group of site-placements (tags). Basically acts as a single pricing point for a group of tags.", "A group of site-placements (tags) that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. This kind of group requires one of its assigned site-placements to be marked as primary for reporting purposes." ], "description": "Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion.", "type": "string", "enum": [ "PLACEMENT_PACKAGE", "PLACEMENT_ROADBLOCK" ] }, "placementStrategyId": { "type": "string", "description": "ID of the placement strategy assigned to this placement group.", "format": "int64" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementGroup\".", "type": "string" }, "childPlacementIds": { "type": "array", "items": { "format": "int64", "type": "string" }, "description": "IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field." }, "pricingSchedule": { "$ref": "PricingSchedule", "description": "Pricing schedule of this placement group. This field is required on insertion." }, "activeStatus": { "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "PLACEMENT_STATUS_UNKNOWN", "PLACEMENT_STATUS_ACTIVE", "PLACEMENT_STATUS_INACTIVE", "PLACEMENT_STATUS_ARCHIVED", "PLACEMENT_STATUS_PERMANENTLY_ARCHIVED" ], "description": "Whether this placement group is active, inactive, archived or permanently archived." }, "primaryPlacementIdDimensionValue": { "description": "Dimension value for the ID of the primary placement. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "subaccountId": { "format": "int64", "description": "Subaccount ID of this placement group. This is a read-only field that can be left blank.", "type": "string" }, "id": { "type": "string", "description": "ID of this placement group. This is a read-only, auto-generated field.", "format": "int64" }, "accountId": { "description": "Account ID of this placement group. This is a read-only field that can be left blank.", "format": "int64", "type": "string" } }, "id": "PlacementGroup" }, "PricingSchedulePricingPeriod": { "id": "PricingSchedulePricingPeriod", "description": "Pricing Period", "type": "object", "properties": { "rateOrCostNanos": { "format": "int64", "description": "Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are 0 to 1000000000000000000, inclusive.", "type": "string" }, "pricingComment": { "description": "Comments for this pricing period.", "type": "string" }, "startDate": { "format": "date", "type": "string" }, "units": { "format": "int64", "description": "Units of this pricing period. Acceptable values are 0 to 10000000000, inclusive.", "type": "string" }, "endDate": { "type": "string", "format": "date" } } }, "AccountPermissionGroupsListResponse": { "id": "AccountPermissionGroupsListResponse", "type": "object", "description": "Account Permission Group List Response", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountPermissionGroupGroupsListResponse\"." }, "accountPermissionGroups": { "items": { "$ref": "AccountPermissionGroup" }, "type": "array", "description": "Account permission group collection." } } }, "DirectorySitesListResponse": { "description": "Directory Site List Response", "type": "object", "id": "DirectorySitesListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#directorySitesListResponse\".", "type": "string" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "directorySites": { "type": "array", "description": "Directory site collection.", "items": { "$ref": "DirectorySite" } } } }, "CreativesListResponse": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativesListResponse\".", "type": "string" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "creatives": { "type": "array", "description": "Creative collection.", "items": { "$ref": "Creative" } } }, "id": "CreativesListResponse", "type": "object", "description": "Creative List Response" }, "ListPopulationTerm": { "id": "ListPopulationTerm", "description": "Remarketing List Population Rule Term.", "properties": { "negation": { "type": "boolean", "description": "Whether to negate the comparison result of this term during rule evaluation. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM." }, "variableFriendlyName": { "description": "Friendly name of this term's variable. This is a read-only, auto-generated field. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM.", "type": "string" }, "contains": { "description": "Will be true if the term should check if the user is in the list and false if the term should check if the user is not in the list. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM. False by default.", "type": "boolean" }, "value": { "type": "string", "description": "Literal to compare the variable to. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM." }, "operator": { "enumDescriptions": [ "", "", "", "", "", "", "" ], "description": "Comparison operator of this term. This field is only relevant when type is left unset or set to CUSTOM_VARIABLE_TERM or REFERRER_TERM.", "type": "string", "enum": [ "NUM_EQUALS", "NUM_LESS_THAN", "NUM_LESS_THAN_EQUAL", "NUM_GREATER_THAN", "NUM_GREATER_THAN_EQUAL", "STRING_EQUALS", "STRING_CONTAINS" ] }, "remarketingListId": { "description": "ID of the list in question. This field is only relevant when type is set to LIST_MEMBERSHIP_TERM.", "format": "int64", "type": "string" }, "type": { "enumDescriptions": [ "", "", "" ], "description": "List population term type determines the applicable fields in this object. If left unset or set to CUSTOM_VARIABLE_TERM, then variableName, variableFriendlyName, operator, value, and negation are applicable. If set to LIST_MEMBERSHIP_TERM then remarketingListId and contains are applicable. If set to REFERRER_TERM then operator, value, and negation are applicable.", "type": "string", "enum": [ "CUSTOM_VARIABLE_TERM", "LIST_MEMBERSHIP_TERM", "REFERRER_TERM" ] }, "variableName": { "type": "string", "description": "Name of the variable (U1, U2, etc.) being compared in this term. This field is only relevant when type is set to null, CUSTOM_VARIABLE_TERM or REFERRER_TERM." } }, "type": "object" }, "Campaign": { "id": "Campaign", "description": "Contains properties of a Campaign Manager campaign.", "type": "object", "properties": { "defaultLandingPageId": { "description": "The default landing page ID for this campaign.", "type": "string", "format": "int64" }, "clickThroughUrlSuffixProperties": { "$ref": "ClickThroughUrlSuffixProperties", "description": "Click-through URL suffix override properties for this campaign." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#campaign\".", "type": "string" }, "lastModifiedInfo": { "description": "Information about the most recent modification of this campaign. This is a read-only field.", "$ref": "LastModifiedInfo" }, "euPoliticalAdsDeclaration": { "enumDescriptions": [ "The campaign contains EU political ads.", "The campaign does not contain EU political ads." ], "description": "Optional. Whether the campaign has EU political ads. Campaign Manager 360 doesn't allow campaigns with EU political ads to serve in the EU. They can still serve in other regions.", "type": "string", "enum": [ "CONTAINS_EU_POLITICAL_ADS", "DOES_NOT_CONTAIN_EU_POLITICAL_ADS" ] }, "billingInvoiceCode": { "description": "Billing invoice code included in the Campaign Manager client billing invoices associated with the campaign.", "type": "string" }, "idDimensionValue": { "description": "Dimension value for the ID of this campaign. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "adBlockingConfiguration": { "description": "Ad blocking settings for this campaign.", "$ref": "AdBlockingConfiguration" }, "additionalCreativeOptimizationConfigurations": { "type": "array", "items": { "$ref": "CreativeOptimizationConfiguration" }, "description": "Additional creative optimization configurations for the campaign." }, "advertiserIdDimensionValue": { "description": "Dimension value for the advertiser ID of this campaign. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "startDate": { "type": "string", "format": "date" }, "creativeGroupIds": { "description": "List of creative group IDs that are assigned to the campaign.", "items": { "type": "string", "format": "int64" }, "type": "array" }, "advertiserId": { "type": "string", "format": "int64", "description": "Advertiser ID of this campaign. This is a required field." }, "eventTagOverrides": { "items": { "$ref": "EventTagOverride" }, "type": "array", "description": "Overrides that can be used to activate or deactivate advertiser event tags." }, "measurementPartnerLink": { "description": "Measurement partner campaign link for tag wrapping.", "$ref": "MeasurementPartnerCampaignLink" }, "advertiserGroupId": { "format": "int64", "type": "string", "description": "Advertiser group ID of the associated advertiser." }, "id": { "type": "string", "format": "int64", "description": "ID of this campaign. This is a read-only auto-generated field." }, "endDate": { "type": "string", "format": "date" }, "defaultClickThroughEventTagProperties": { "description": "Click-through event tag ID override properties for this campaign.", "$ref": "DefaultClickThroughEventTagProperties" }, "comment": { "type": "string", "description": "Arbitrary comments about this campaign. Must be less than 256 characters long." }, "externalId": { "description": "External ID for this campaign.", "type": "string" }, "creativeOptimizationConfiguration": { "description": "Creative optimization configuration for the campaign.", "$ref": "CreativeOptimizationConfiguration" }, "accountId": { "type": "string", "description": "Account ID of this campaign. This is a read-only field that can be left blank.", "format": "int64" }, "subaccountId": { "description": "Subaccount ID of this campaign. This is a read-only field that can be left blank.", "format": "int64", "type": "string" }, "audienceSegmentGroups": { "items": { "$ref": "AudienceSegmentGroup" }, "type": "array", "description": "Audience segment groups assigned to this campaign. Cannot have more than 300 segment groups." }, "createInfo": { "description": "Information about the creation of this campaign. This is a read-only field.", "$ref": "LastModifiedInfo" }, "archived": { "type": "boolean", "description": "Whether this campaign has been archived." }, "name": { "type": "string", "description": "Name of this campaign. This is a required field and must be less than 512 characters long and unique among campaigns of the same advertiser." } } }, "MeasurementPartnerWrappingData": { "type": "object", "description": "Placement tag wrapping", "id": "MeasurementPartnerWrappingData", "properties": { "measurementPartner": { "type": "string", "enum": [ "NONE", "INTEGRAL_AD_SCIENCE", "DOUBLE_VERIFY" ], "description": "Measurement partner used for wrapping the placement.", "enumDescriptions": [ "", "", "" ] }, "wrappedTag": { "type": "string", "description": "Tag provided by the measurement partner during wrapping." }, "linkStatus": { "description": "Placement wrapping status.", "enumDescriptions": [ "Unlinked.", "Linked successfully", "Link pending for wrapping.", "Linking failure.", "Link opt-out by user.", "Link opt-out pending sync.", "Link wrap answer pending.", "Mode change pending.", "Partner unlink pending." ], "type": "string", "enum": [ "MEASUREMENT_PARTNER_UNLINKED", "MEASUREMENT_PARTNER_LINKED", "MEASUREMENT_PARTNER_LINK_PENDING", "MEASUREMENT_PARTNER_LINK_FAILURE", "MEASUREMENT_PARTNER_LINK_OPT_OUT", "MEASUREMENT_PARTNER_LINK_OPT_OUT_PENDING", "MEASUREMENT_PARTNER_LINK_WRAPPING_PENDING", "MEASUREMENT_PARTNER_MODE_CHANGE_PENDING", "MEASUREMENT_PARTNER_UNLINK_PENDING" ] }, "tagWrappingMode": { "description": "Measurement mode for the wrapped placement.", "type": "string", "enum": [ "NONE", "BLOCKING", "MONITORING", "MONITORING_READ_ONLY", "VIDEO_PIXEL_MONITORING", "TRACKING", "VPAID_MONITORING", "VPAID_BLOCKING", "NON_VPAID_MONITORING", "VPAID_ONLY_MONITORING", "VPAID_ONLY_BLOCKING", "VPAID_ONLY_FILTERING", "VPAID_FILTERING", "NON_VPAID_FILTERING", "BLOCKING_FILTERING_VPAID", "BLOCKING_FILTERING_VPAID_ONLY" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ] } } }, "ReportDataResponse": { "type": "object", "description": "Represents a response to report data request.", "properties": { "rows": { "type": "array", "items": { "$ref": "ReportDataRow" }, "readOnly": true, "description": "Output only. The resulting set of matching data rows." }, "nextPageToken": { "readOnly": true, "description": "Output only. Token to retrieve the next page of rows, or empty if end of results.", "type": "string" }, "totalRow": { "description": "Output only. Singular aggregate total row for the entire query matching the criteria. Column headers apply in the exact same order as data rows. In the total_row: - All dimension columns contain an empty string (\"\"), as aggregation does not apply. - Non-summable metric columns (e.g. Reach metrics) contain an empty string (\"\"), as grand total aggregation cannot be mathematically/logically computed for them.", "$ref": "ReportDataRow", "readOnly": true }, "columnHeaders": { "readOnly": true, "items": { "$ref": "ColumnHeader" }, "description": "Output only. Ordered descriptors of the requested column fields.", "type": "array" } }, "id": "ReportDataResponse" }, "FloodlightConfigurationsListResponse": { "properties": { "floodlightConfigurations": { "type": "array", "items": { "$ref": "FloodlightConfiguration" }, "description": "Floodlight configuration collection." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightConfigurationsListResponse\".", "type": "string" } }, "id": "FloodlightConfigurationsListResponse", "type": "object", "description": "Floodlight Configuration List Response" }, "Browser": { "properties": { "browserVersionId": { "format": "int64", "type": "string", "description": "ID referring to this grouping of browser and version numbers. This is the ID used for targeting." }, "name": { "description": "Name of this browser.", "type": "string" }, "majorVersion": { "description": "Major version number (leftmost number) of this browser. For example, for Chrome 5.0.376.86 beta, this field should be set to 5. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.", "type": "string" }, "minorVersion": { "description": "Minor version number (number after first dot on left) of this browser. For example, for Chrome 5.0.375.86 beta, this field should be set to 0. An asterisk (*) may be used to target any version number, and a question mark (?) may be used to target cases where the version number cannot be identified. For example, Chrome *.* targets any version of Chrome: 1.2, 2.5, 3.5, and so on. Chrome 3.* targets Chrome 3.1, 3.5, but not 4.0. Firefox ?.? targets cases where the ad server knows the browser is Firefox but can't tell which version it is.", "type": "string" }, "dartId": { "description": "DART ID of this browser. This is the ID used when generating reports.", "type": "string", "format": "int64" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#browser\"." } }, "type": "object", "id": "Browser", "description": "Contains information about a browser that can be targeted by ads." }, "CreativeOptimizationConfiguration": { "description": "Creative optimization settings.", "properties": { "name": { "description": "Name of this creative optimization config. This is a required field and must be less than 129 characters long.", "type": "string" }, "optimizationModel": { "description": "Optimization model for this configuration.", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "CLICK", "POST_CLICK", "POST_IMPRESSION", "POST_CLICK_AND_IMPRESSION", "VIDEO_COMPLETION" ] }, "optimizationActivitys": { "description": "List of optimization activities associated with this configuration.", "type": "array", "items": { "$ref": "OptimizationActivity" } }, "id": { "description": "ID of this creative optimization config. This field is auto-generated when the campaign is inserted or updated. It can be null for existing campaigns.", "format": "int64", "type": "string" } }, "type": "object", "id": "CreativeOptimizationConfiguration" }, "FeedIngestionStatus": { "id": "FeedIngestionStatus", "type": "object", "description": "Contains the ingestion status of the dynamic feed. Feed ingestion is an asynchronous process. If the feed create request is successful, feed ingestion will be processed in the background, including validation, assets retrieval, and saving the data from the resource link. The processing time is dependent on the data size in the resource link. This read-only status field contains the current stage of that processing and its ingestion state.", "properties": { "ingestionErrorRecords": { "items": { "$ref": "IngestionErrorRecord" }, "description": "Output only. The ingestion error records of the feed.", "type": "array", "readOnly": true }, "ingestionStatus": { "description": "Output only. The ingestion status of the feed.", "readOnly": true, "$ref": "IngestionStatus" }, "state": { "enumDescriptions": [ "The feed processing state is unknown.", "The feed processing state is cancelled.", "The feed processing state is ingesting queued.", "The feed processing state is ingesting.", "The feed processing state is ingested successfully.", "The feed processing state is ingested with failure.", "The feed processing state is request to publish.", "The feed processing state is publishing.", "The feed processing state is published successfully.", "The feed processing state is published with failure." ], "readOnly": true, "type": "string", "enum": [ "FEED_PROCESSING_STATE_UNKNOWN", "CANCELLED", "INGESTING_QUEUED", "INGESTING", "INGESTED_SUCCESS", "INGESTED_FAILURE", "REQUEST_TO_PUBLISH", "PUBLISHING", "PUBLISHED_SUCCESS", "PUBLISHED_FAILURE" ], "description": "Output only. The processing state of the feed." } } }, "SiteContact": { "properties": { "contactType": { "description": "Site contact type.", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "SALES_PERSON", "TRAFFICKER" ] }, "id": { "type": "string", "format": "int64", "description": "ID of this site contact. This is a read-only, auto-generated field." }, "firstName": { "description": "First name of this site contact.", "type": "string" }, "address": { "description": "Address of this site contact.", "type": "string" }, "email": { "description": "Email address of this site contact. This is a required field.", "type": "string" }, "title": { "type": "string", "description": "Title or designation of this site contact." }, "phone": { "description": "Primary phone number of this site contact.", "type": "string" }, "lastName": { "type": "string", "description": "Last name of this site contact." } }, "type": "object", "id": "SiteContact", "description": "Site Contact" }, "PlacementsListResponse": { "type": "object", "id": "PlacementsListResponse", "description": "Placement List Response", "properties": { "placements": { "description": "Placement collection.", "items": { "$ref": "Placement" }, "type": "array" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementsListResponse\".", "type": "string" }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } } }, "CountriesListResponse": { "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#countriesListResponse\".", "type": "string" }, "countries": { "type": "array", "description": "Country collection.", "items": { "$ref": "Country" } } }, "description": "Country List Response", "id": "CountriesListResponse" }, "Invoice": { "properties": { "replacedInvoiceIds": { "items": { "type": "string" }, "type": "array", "description": "The originally issued invoice(s) that is being cancelled by this invoice, if applicable. May appear on invoice PDF as *Replaced invoice numbers*. Note: There may be multiple replaced invoices due to consolidation of multiple invoices into a single invoice." }, "dueDate": { "type": "string", "description": "The invoice due date." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#invoice\"." }, "correctedInvoiceId": { "type": "string", "description": "The originally issued invoice that is being adjusted by this invoice, if applicable. May appear on invoice PDF as *Reference invoice number*." }, "serviceEndDate": { "type": "string", "description": "The invoice service end date." }, "paymentsProfileId": { "description": "The ID of the payments profile the invoice belongs to. Appears on the invoice PDF as *Billing ID*.", "type": "string" }, "id": { "description": "ID of this invoice.", "type": "string" }, "totalTaxAmountMicros": { "format": "int64", "type": "string", "description": "The sum of all taxes in invoice, in micros of the invoice's currency." }, "invoiceType": { "enumDescriptions": [ "", "", "" ], "description": "The type of invoice document.", "type": "string", "enum": [ "INVOICE_TYPE_UNSPECIFIED", "INVOICE_TYPE_CREDIT", "INVOICE_TYPE_INVOICE" ] }, "paymentsAccountId": { "description": "The ID of the payments account the invoice belongs to. Appears on the invoice PDF as *Billing Account Number*.", "type": "string" }, "issueDate": { "description": "The date when the invoice was issued.", "type": "string" }, "totalAmountMicros": { "format": "int64", "description": "The invoice total amount, in micros of the invoice's currency.", "type": "string" }, "campaign_summaries": { "description": "The list of summarized campaign information associated with this invoice.", "type": "array", "items": { "$ref": "CampaignSummary" } }, "subtotalAmountMicros": { "type": "string", "format": "int64", "description": "The pre-tax subtotal amount, in micros of the invoice's currency." }, "purchaseOrderNumber": { "description": "Purchase order number associated with the invoice.", "type": "string" }, "serviceStartDate": { "description": "The invoice service start date.", "type": "string" }, "pdfUrl": { "type": "string", "description": "The URL to download a PDF copy of the invoice. Note that this URL is user specific and requires a valid OAuth 2.0 access token to access. The access token must be provided in an *Authorization: Bearer* HTTP header. The URL will only be usable for 7 days from when the api is called." }, "currencyCode": { "description": "Invoice currency code in ISO 4217 format.", "type": "string" } }, "description": "Contains information about a single invoice", "type": "object", "id": "Invoice" }, "RuleBlock": { "id": "RuleBlock", "properties": { "fieldFilter": { "type": "array", "description": "Optional. A list of non-auto field filters", "items": { "$ref": "FieldFilter" } } }, "description": "Contains a list of field filters that the given custom rule will apply.", "type": "object" }, "ContentSource": { "properties": { "contentSourceName": { "type": "string", "description": "Optional. The name of the content source. It is defaulted to content source file name if not provided." }, "resourceType": { "enumDescriptions": [ "The resource type is unspecified.", "The resource type is google spreadsheet.", "The resource type is remote file." ], "type": "string", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "RESOURCE_TYPE_GOOGLE_SPREADSHEET", "RESOURCE_TYPE_REMOTE_FILE" ], "description": "Required. The resource type of the content source." }, "resourceLink": { "description": "Required. The link to the file of the content source.", "type": "string" }, "metaData": { "$ref": "ContentSourceMetaData", "readOnly": true, "description": "Output only. Metadata of the content source. It contains the number of rows and the column names from resource link. This is a read-only field." }, "createInfo": { "$ref": "LastModifiedInfo", "readOnly": true, "description": "Output only. The creation timestamp of the content source. This is a read-only field." }, "lastModifiedInfo": { "$ref": "LastModifiedInfo", "description": "Output only. The last modified timestamp of the content source. This is a read-only field.", "readOnly": true } }, "id": "ContentSource", "description": "Contains the content source of the dynamic feed.", "type": "object" }, "DynamicProfileFeedSettings": { "description": "Contains dynamic profile specific settings for an associated dynamic feed.", "type": "object", "id": "DynamicProfileFeedSettings", "properties": { "quantity": { "type": "integer", "format": "int32", "description": "Optional. The number of this dynamic feed rows needed by the dynamic profile, default value is 1. Acceptable values are between 1 to 99, inclusive." }, "dynamicFeedId": { "description": "Optional. Dynamic feed ID associated with dynamic profile version.", "format": "int64", "type": "string" }, "dynamicRules": { "$ref": "DynamicRules", "description": "Optional. Dynamic rules for row selection for the given dynamic feed in the given dynamic profile." } } }, "AccountPermissionsListResponse": { "type": "object", "properties": { "accountPermissions": { "description": "Account permission collection.", "type": "array", "items": { "$ref": "AccountPermission" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountPermissionsListResponse\".", "type": "string" } }, "id": "AccountPermissionsListResponse", "description": "Account Permission List Response" }, "ReportDataQueryRequest": { "description": "The request body containing ad-hoc query parameters.", "type": "object", "id": "ReportDataQueryRequest", "properties": { "dateRange": { "$ref": "DateRange", "description": "Optional. The requested date range covering the report duration." }, "maxResults": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of result rows to return per page. The default value is 100. The maximum allowed value is 1000. Values above 1000 will be coerced (clamped) down to 1000. Negative values will be rejected." }, "dimensionFilters": { "description": "Optional. The list of dimension values on which report lines are filtered. Utilizes the existing legacy filter message `DimensionValue`.", "items": { "$ref": "DimensionValue" }, "type": "array" }, "metricNames": { "items": { "type": "string" }, "type": "array", "description": "Required. The list of metric names to include." }, "pageToken": { "type": "string", "description": "Optional. Continuation token for paginating results." }, "dimensionNames": { "description": "Optional. The list of dimension names to group by.", "type": "array", "items": { "type": "string" } }, "sortBys": { "type": "array", "description": "Optional. Sort options across either requested dimensions or metrics.", "items": { "$ref": "SortBy" } } } }, "UserRolePermission": { "id": "UserRolePermission", "properties": { "permissionGroupId": { "format": "int64", "description": "ID of the permission group that this user role permission belongs to.", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRolePermission\"." }, "availability": { "description": "Levels of availability for a user role permission.", "enumDescriptions": [ "Not available by default.", "Available by default to accounts only.", "Available by default to both accounts and subaccounts.", "Always available to accounts.", "Always available to both accounts and subaccounts.", "Available for user profile permissions only." ], "type": "string", "enum": [ "NOT_AVAILABLE_BY_DEFAULT", "ACCOUNT_BY_DEFAULT", "SUBACCOUNT_AND_ACCOUNT_BY_DEFAULT", "ACCOUNT_ALWAYS", "SUBACCOUNT_AND_ACCOUNT_ALWAYS", "USER_PROFILE_ONLY" ] }, "id": { "description": "ID of this user role permission.", "format": "int64", "type": "string" }, "name": { "description": "Name of this user role permission.", "type": "string" } }, "description": "Contains properties of a user role permission.", "type": "object" }, "UserRolePermissionsListResponse": { "id": "UserRolePermissionsListResponse", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRolePermissionsListResponse\"." }, "userRolePermissions": { "items": { "$ref": "UserRolePermission" }, "description": "User role permission collection.", "type": "array" } }, "description": "User Role Permission List Response", "type": "object" }, "OperatingSystemVersionsListResponse": { "id": "OperatingSystemVersionsListResponse", "description": "Operating System Version List Response", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#operatingSystemVersionsListResponse\".", "type": "string" }, "operatingSystemVersions": { "type": "array", "description": "Operating system version collection.", "items": { "$ref": "OperatingSystemVersion" } } } }, "Ad": { "properties": { "dayPartTargeting": { "description": "Time and day targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.", "$ref": "DayPartTargeting" }, "eventTagOverrides": { "description": "Event tag overrides for this ad.", "items": { "$ref": "EventTagOverride" }, "type": "array" }, "languageTargeting": { "description": "Language targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.", "$ref": "LanguageTargeting" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "deliverySchedule": { "description": "Delivery schedule information for this ad. Applicable when type is AD_SERVING_STANDARD_AD or AD_SERVING_TRACKING. This field along with subfields priority and impressionRatio are required on insertion when type is AD_SERVING_STANDARD_AD.", "$ref": "DeliverySchedule" }, "size": { "description": "Size of this ad. Applicable when type is AD_SERVING_DEFAULT_AD.", "$ref": "Size" }, "audienceSegmentId": { "type": "string", "format": "int64", "description": "Audience segment ID that is being targeted for this ad. Applicable when type is AD_SERVING_STANDARD_AD." }, "idDimensionValue": { "description": "Dimension value for the ID of this ad. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "type": { "description": "Type of ad. This is a required field on insertion. Note that default ads ( AD_SERVING_DEFAULT_AD) cannot be created directly (see Creative resource).", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "AD_SERVING_STANDARD_AD", "AD_SERVING_DEFAULT_AD", "AD_SERVING_CLICK_TRACKER", "AD_SERVING_TRACKING", "AD_SERVING_BRAND_SAFE_AD" ] }, "lastModifiedInfo": { "description": "Information about the most recent modification of this ad. This is a read-only field.", "$ref": "LastModifiedInfo" }, "creativeGroupAssignments": { "items": { "$ref": "CreativeGroupAssignment" }, "type": "array", "description": "Creative group assignments for this ad. Applicable when type is AD_SERVING_CLICK_TRACKER. Only one assignment per creative group number is allowed for a maximum of two assignments." }, "name": { "description": "Name of this ad. This is a required field and must be less than 256 characters long.", "type": "string" }, "targetingTemplateId": { "description": "Targeting template ID, used to apply preconfigured targeting information to this ad. This cannot be set while any of dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression, or technologyTargeting are set. Applicable when type is AD_SERVING_STANDARD_AD.", "format": "int64", "type": "string" }, "geoTargeting": { "description": "Geographical targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.", "$ref": "GeoTargeting" }, "remarketingListExpression": { "$ref": "ListTargetingExpression", "description": "Remarketing list targeting expression for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD." }, "compatibility": { "enumDescriptions": [ "", "", "Deprecated enum value. No longer supported.", "Deprecated enum value. No longer supported.", "", "" ], "type": "string", "enum": [ "DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO" ], "description": "Compatibility of this ad. Applicable when type is AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to either rendering on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are only used for existing default ads. New mobile placements must be assigned DISPLAY or DISPLAY_INTERSTITIAL and default ads created for those placements will be limited to those compatibility types. IN_STREAM_VIDEO refers to rendering in-stream video ads developed with the VAST standard." }, "id": { "format": "int64", "description": "ID of this ad. This is a read-only, auto-generated field.", "type": "string" }, "subaccountId": { "description": "Subaccount ID of this ad. This is a read-only field that can be left blank.", "format": "int64", "type": "string" }, "sslCompliant": { "type": "boolean", "description": "Whether this ad is ssl compliant. This is a read-only field that is auto-generated when the ad is inserted or updated." }, "campaignId": { "description": "Campaign ID of this ad. This is a required field on insertion.", "format": "int64", "type": "string" }, "createInfo": { "description": "Information about the creation of this ad. This is a read-only field.", "$ref": "LastModifiedInfo" }, "keyValueTargetingExpression": { "description": "Key-value targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.", "$ref": "KeyValueTargetingExpression" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#ad\".", "type": "string" }, "defaultClickThroughEventTagProperties": { "description": "Default click-through event tag properties for this ad.", "$ref": "DefaultClickThroughEventTagProperties" }, "clickThroughUrl": { "description": "Click-through URL for this ad. This is a required field on insertion. Applicable when type is AD_SERVING_CLICK_TRACKER.", "$ref": "ClickThroughUrl" }, "dynamicClickTracker": { "type": "boolean", "description": "Whether this ad is a dynamic click tracker. Applicable when type is AD_SERVING_CLICK_TRACKER. This is a required field on insert, and is read-only after insert." }, "creativeRotation": { "$ref": "CreativeRotation", "description": "Creative rotation for this ad. Applicable when type is AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD, or AD_SERVING_TRACKING. When type is AD_SERVING_DEFAULT_AD, this field should have exactly one creativeAssignment ." }, "archived": { "type": "boolean", "description": "Whether this ad is archived. When true, active must be false." }, "endTime": { "type": "string", "format": "date-time" }, "campaignIdDimensionValue": { "description": "Dimension value for the ID of the campaign. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "placementAssignments": { "description": "Placement assignments for this ad.", "items": { "$ref": "PlacementAssignment" }, "type": "array" }, "advertiserId": { "description": "Advertiser ID of this ad. This is a required field on insertion.", "format": "int64", "type": "string" }, "sslRequired": { "type": "boolean", "description": "Whether this ad requires ssl. This is a read-only field that is auto-generated when the ad is inserted or updated." }, "startTime": { "type": "string", "format": "date-time" }, "active": { "type": "boolean", "description": "Whether this ad is active. When true, archived must be false." }, "comments": { "type": "string", "description": "Comments for this ad." }, "accountId": { "format": "int64", "type": "string", "description": "Account ID of this ad. This is a read-only field that can be left blank." }, "clickThroughUrlSuffixProperties": { "description": "Click-through URL suffix properties for this ad. Applies to the URL in the ad or (if overriding ad properties) the URL in the creative.", "$ref": "ClickThroughUrlSuffixProperties" }, "contextualKeywordTargeting": { "description": "Optional. Contextual keyword targeting information for this ad.", "$ref": "ContextualKeywordTargeting" }, "technologyTargeting": { "description": "Technology platform targeting information for this ad. This field must be left blank if the ad is using a targeting template. Applicable when type is AD_SERVING_STANDARD_AD.", "$ref": "TechnologyTargeting" } }, "id": "Ad", "type": "object", "description": "Contains properties of a Campaign Manager ad." }, "ListTargetingExpression": { "description": "Remarketing List Targeting Expression.", "type": "object", "properties": { "expression": { "type": "string", "description": "Expression describing which lists are being targeted by the ad." } }, "id": "ListTargetingExpression" }, "PlacementTag": { "properties": { "placementId": { "description": "Placement ID", "type": "string", "format": "int64" }, "tagDatas": { "description": "Tags generated for this placement.", "items": { "$ref": "TagData" }, "type": "array" } }, "type": "object", "id": "PlacementTag", "description": "Placement Tag" }, "DefaultClickThroughEventTagProperties": { "id": "DefaultClickThroughEventTagProperties", "type": "object", "properties": { "defaultClickThroughEventTagId": { "description": "ID of the click-through event tag to apply to all ads in this entity's scope.", "type": "string", "format": "int64" }, "overrideInheritedEventTag": { "type": "boolean", "description": "Whether this entity should override the inherited default click-through event tag with its own defined value." } }, "description": "Properties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further." }, "FloodlightActivityPublisherDynamicTag": { "type": "object", "properties": { "siteIdDimensionValue": { "description": "Dimension value for the ID of the site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "dynamicTag": { "description": "Dynamic floodlight tag.", "$ref": "FloodlightActivityDynamicTag" }, "clickThrough": { "type": "boolean", "description": "Whether this tag is applicable only for click-throughs." }, "viewThrough": { "type": "boolean", "description": "Whether this tag is applicable only for view-throughs." }, "directorySiteId": { "description": "Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the siteId field. When this resource is retrieved, only the siteId field will be populated.", "type": "string", "format": "int64" }, "siteId": { "description": "Site ID of this dynamic tag.", "type": "string", "format": "int64" } }, "description": "Publisher Dynamic Tag", "id": "FloodlightActivityPublisherDynamicTag" }, "Recipient": { "type": "object", "description": "Represents a recipient.", "id": "Recipient", "properties": { "kind": { "type": "string", "description": "The kind of resource this is, in this case dfareporting#recipient." }, "email": { "type": "string", "description": "The email address of the recipient." }, "deliveryType": { "description": "The delivery type for the recipient.", "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "LINK", "ATTACHMENT" ] } } }, "PlacementGroupsListResponse": { "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placementGroupsListResponse\".", "type": "string" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "placementGroups": { "type": "array", "description": "Placement group collection.", "items": { "$ref": "PlacementGroup" } } }, "type": "object", "id": "PlacementGroupsListResponse", "description": "Placement Group List Response" }, "ObjectFilter": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#objectFilter\"." }, "objectIds": { "type": "array", "description": "Applicable when status is ASSIGNED. The user has access to objects with these object IDs.", "items": { "format": "int64", "type": "string" } }, "status": { "type": "string", "enum": [ "NONE", "ASSIGNED", "ALL" ], "description": "Status of the filter. NONE means the user has access to none of the objects. ALL means the user has access to all objects. ASSIGNED means the user has access to the objects with IDs in the objectIds list.", "enumDescriptions": [ "Profile has access to none of the objects.", "Profile has access to only specific objects.", "Profile has access to all objects." ] } }, "type": "object", "id": "ObjectFilter", "description": "Object Filter." }, "EncryptionInfo": { "properties": { "encryptionEntityType": { "type": "string", "enum": [ "ENCRYPTION_ENTITY_TYPE_UNKNOWN", "DCM_ACCOUNT", "DCM_ADVERTISER", "DBM_PARTNER", "DBM_ADVERTISER", "ADWORDS_CUSTOMER", "DFP_NETWORK_CODE" ], "description": "The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.", "enumDescriptions": [ "", "", "", "", "", "", "" ] }, "encryptionEntityId": { "description": "The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer.", "format": "int64", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#encryptionInfo\".", "type": "string" }, "encryptionSource": { "enumDescriptions": [ "", "", "" ], "description": "Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.", "type": "string", "enum": [ "ENCRYPTION_SCOPE_UNKNOWN", "AD_SERVING", "DATA_TRANSFER" ] } }, "description": "A description of how user IDs are encrypted.", "id": "EncryptionInfo", "type": "object" }, "VideoProcessingData": { "description": "Contains processing data for a video asset.", "type": "object", "properties": { "errorReason": { "description": "For a FAILED processing state, the error reason discovered.", "type": "string" }, "processingState": { "description": "Output only. The processing state of the studio creative asset.", "enumDescriptions": [ "The processing state is unknown.", "The asset is being processed.", "The asset was successfully processed.", "The asset failed to be processed." ], "type": "string", "enum": [ "UNKNOWN", "PROCESSING", "SUCCEEDED", "FAILED" ], "readOnly": true } }, "id": "VideoProcessingData" }, "DirectorySiteSettings": { "properties": { "dfpSettings": { "$ref": "DfpSettings", "description": "Directory site Ad Manager settings." }, "activeViewOptOut": { "description": "Whether this directory site has disabled active view creatives.", "type": "boolean" }, "instreamVideoPlacementAccepted": { "description": "Whether this site accepts in-stream video ads.", "type": "boolean" }, "interstitialPlacementAccepted": { "description": "Whether this site accepts interstitial ads.", "type": "boolean" } }, "type": "object", "id": "DirectorySiteSettings", "description": "Directory Site Settings" }, "UserRole": { "properties": { "subaccountId": { "type": "string", "description": "Subaccount ID of this user role. This is a read-only field that can be left blank.", "format": "int64" }, "defaultUserRole": { "description": "Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions.", "type": "boolean" }, "permissions": { "items": { "$ref": "UserRolePermission" }, "type": "array", "description": "List of permissions associated with this user role." }, "name": { "type": "string", "description": "Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account." }, "accountId": { "type": "string", "description": "Account ID of this user role. This is a read-only field that can be left blank.", "format": "int64" }, "parentUserRoleId": { "format": "int64", "type": "string", "description": "ID of the user role that this user role is based on or copied from. This is a required field." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRole\".", "type": "string" }, "id": { "description": "ID of this user role. This is a read-only, auto-generated field.", "format": "int64", "type": "string" } }, "id": "UserRole", "type": "object", "description": "Contains properties of auser role, which is used to manage user access." }, "OperatingSystemVersion": { "id": "OperatingSystemVersion", "description": "Contains information about a particular version of an operating system that can be targeted by ads.", "type": "object", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#operatingSystemVersion\"." }, "majorVersion": { "type": "string", "description": "Major version (leftmost number) of this operating system version." }, "minorVersion": { "type": "string", "description": "Minor version (number after the first dot) of this operating system version." }, "operatingSystem": { "description": "Operating system of this operating system version.", "$ref": "OperatingSystem" }, "name": { "description": "Name of this operating system version.", "type": "string" }, "id": { "type": "string", "format": "int64", "description": "ID of this operating system version." } } }, "ReportDataRow": { "type": "object", "id": "ReportDataRow", "description": "A row of report data.", "properties": { "values": { "items": { "type": "string" }, "type": "array", "readOnly": true, "description": "Output only. A single sequential list of all cell values matching column_headers indices exactly. - Metric cells that are suppressed due to Minimum Reporting Standard (MRS) privacy protection constraints return \"-\"." } } }, "SortBy": { "properties": { "name": { "type": "string", "description": "Required. The dimension or metric field name to sort on." }, "sortOrder": { "description": "Optional. The sort order of this column.", "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "enumDescriptions": [ "Ascending order.", "Descending order." ] } }, "type": "object", "description": "Specifies the sort configuration for a specific field in the report.", "id": "SortBy" }, "FloodlightActivitiesListResponse": { "id": "FloodlightActivitiesListResponse", "type": "object", "description": "Floodlight Activity List Response", "properties": { "floodlightActivities": { "type": "array", "description": "Floodlight activity collection.", "items": { "$ref": "FloodlightActivity" } }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightActivitiesListResponse\"." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } } }, "ContentSourceMetaData": { "id": "ContentSourceMetaData", "type": "object", "properties": { "charset": { "description": "Output only. The charset of the content source.", "readOnly": true, "type": "string" }, "separator": { "description": "Output only. The separator of the content source.", "type": "string", "readOnly": true }, "rowNumber": { "description": "Output only. The number of rows in the content source.", "readOnly": true, "format": "int32", "type": "integer" }, "fieldNames": { "description": "Output only. The list of column names in the content source.", "type": "array", "items": { "type": "string" }, "readOnly": true } }, "description": "Contains the meta data of the content source. This is a read-only field." }, "CreativeAssetMetadata": { "id": "CreativeAssetMetadata", "properties": { "timerCustomEvents": { "items": { "$ref": "CreativeCustomEvent" }, "description": "List of timer events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset.", "type": "array" }, "id": { "description": "Numeric ID of the asset. This is a read-only, auto-generated field.", "type": "string", "format": "int64" }, "assetIdentifier": { "$ref": "CreativeAssetId", "description": "ID of the creative asset. This is a required field." }, "richMedia": { "description": "True if the uploaded asset is a rich media asset. This is a read-only, auto-generated field.", "type": "boolean" }, "idDimensionValue": { "description": "Dimension value for the numeric ID of the asset. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "warnedValidationRules": { "description": "Rules validated during code generation that generated a warning. This is a read-only, auto-generated field. Possible values are: - \"ADMOB_REFERENCED\" - \"ASSET_FORMAT_UNSUPPORTED_DCM\" - \"ASSET_INVALID\" - \"CLICK_TAG_HARD_CODED\" - \"CLICK_TAG_INVALID\" - \"CLICK_TAG_IN_GWD\" - \"CLICK_TAG_MISSING\" - \"CLICK_TAG_MORE_THAN_ONE\" - \"CLICK_TAG_NON_TOP_LEVEL\" - \"COMPONENT_UNSUPPORTED_DCM\" - \"ENABLER_UNSUPPORTED_METHOD_DCM\" - \"EXTERNAL_FILE_REFERENCED\" - \"FILE_DETAIL_EMPTY\" - \"FILE_TYPE_INVALID\" - \"GWD_PROPERTIES_INVALID\" - \"HTML5_FEATURE_UNSUPPORTED\" - \"LINKED_FILE_NOT_FOUND\" - \"MAX_FLASH_VERSION_11\" - \"MRAID_REFERENCED\" - \"NOT_SSL_COMPLIANT\" - \"ORPHANED_ASSET\" - \"PRIMARY_HTML_MISSING\" - \"SVG_INVALID\" - \"ZIP_INVALID\" ", "items": { "type": "string", "enum": [ "CLICK_TAG_NON_TOP_LEVEL", "CLICK_TAG_MISSING", "CLICK_TAG_MORE_THAN_ONE", "CLICK_TAG_INVALID", "ORPHANED_ASSET", "PRIMARY_HTML_MISSING", "EXTERNAL_FILE_REFERENCED", "MRAID_REFERENCED", "ADMOB_REFERENCED", "FILE_TYPE_INVALID", "ZIP_INVALID", "LINKED_FILE_NOT_FOUND", "MAX_FLASH_VERSION_11", "NOT_SSL_COMPLIANT", "FILE_DETAIL_EMPTY", "ASSET_INVALID", "GWD_PROPERTIES_INVALID", "ENABLER_UNSUPPORTED_METHOD_DCM", "ASSET_FORMAT_UNSUPPORTED_DCM", "COMPONENT_UNSUPPORTED_DCM", "HTML5_FEATURE_UNSUPPORTED", "CLICK_TAG_IN_GWD", "CLICK_TAG_HARD_CODED", "SVG_INVALID", "CLICK_TAG_IN_RICH_MEDIA", "MISSING_ENABLER_REFERENCE" ], "enumDescriptions": [ "Click tag initialization detected but not at the top level of the primary html file.", "No click tag detected.", "More than one click tag detected.", "Click tag invalid (failed url validation).", "Orphaned asset not referenced.", "Primary html file missing.", "Reference to a third-party resource.", "Reference to INAPP MRAID feature.", "Reference to INAPP ADMOB feature.", "Invalid file type referenced.", "Invalid zip passed in", "A relative file was linked to that wasn't included in zip.", "Max flash version at 11.", "Whether the asset uses secure urls or not.", "File detail empty.", "Asset is not valid and could not be processed.", "GWD properties are invalid.", "Unsupported Enabler methods in DCM.", "Asset ad format is unsupported in DCM.", "Component is unsupported in DCM.", "Html5 feature is unsupported.", "Click tag defined in GWD asset. GWD-published creatives should use exit events instead of defining var clickTag. Defined var clickTags are a symptom of an unsupported workflow, and an error should be thrown.", "Whether the asset has hard coded click tag url(s).", "Whether an SVG block could not be parsed.", "Click tag defined in rich media asset. Rich media creatives should use exit events instead of defining var clickTag. Defined var clickTags are a symptom of an unsupported workflow, and an error should be thrown.", "Rich media primary asset is missing the Enabler reference." ] }, "type": "array" }, "exitCustomEvents": { "type": "array", "items": { "$ref": "CreativeCustomEvent" }, "description": "List of exit events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeAssetMetadata\"." }, "detectedFeatures": { "items": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "POST_MESSAGE always required due to html5 implementation.", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "CSS_FONT_FACE", "CSS_BACKGROUND_SIZE", "CSS_BORDER_IMAGE", "CSS_BORDER_RADIUS", "CSS_BOX_SHADOW", "CSS_FLEX_BOX", "CSS_HSLA", "CSS_MULTIPLE_BGS", "CSS_OPACITY", "CSS_RGBA", "CSS_TEXT_SHADOW", "CSS_ANIMATIONS", "CSS_COLUMNS", "CSS_GENERATED_CONTENT", "CSS_GRADIENTS", "CSS_REFLECTIONS", "CSS_TRANSFORMS", "CSS_TRANSFORMS3D", "CSS_TRANSITIONS", "APPLICATION_CACHE", "CANVAS", "CANVAS_TEXT", "DRAG_AND_DROP", "HASH_CHANGE", "HISTORY", "AUDIO", "VIDEO", "INDEXED_DB", "INPUT_ATTR_AUTOCOMPLETE", "INPUT_ATTR_AUTOFOCUS", "INPUT_ATTR_LIST", "INPUT_ATTR_PLACEHOLDER", "INPUT_ATTR_MAX", "INPUT_ATTR_MIN", "INPUT_ATTR_MULTIPLE", "INPUT_ATTR_PATTERN", "INPUT_ATTR_REQUIRED", "INPUT_ATTR_STEP", "INPUT_TYPE_SEARCH", "INPUT_TYPE_TEL", "INPUT_TYPE_URL", "INPUT_TYPE_EMAIL", "INPUT_TYPE_DATETIME", "INPUT_TYPE_DATE", "INPUT_TYPE_MONTH", "INPUT_TYPE_WEEK", "INPUT_TYPE_TIME", "INPUT_TYPE_DATETIME_LOCAL", "INPUT_TYPE_NUMBER", "INPUT_TYPE_RANGE", "INPUT_TYPE_COLOR", "LOCAL_STORAGE", "POST_MESSAGE", "SESSION_STORAGE", "WEB_SOCKETS", "WEB_SQL_DATABASE", "WEB_WORKERS", "GEO_LOCATION", "INLINE_SVG", "SMIL", "SVG_HREF", "SVG_CLIP_PATHS", "TOUCH", "WEBGL", "SVG_FILTERS", "SVG_FE_IMAGE" ] }, "type": "array", "description": "List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field." }, "clickTags": { "items": { "$ref": "ClickTag" }, "type": "array", "description": "List of detected click tags for assets. This is a read-only, auto-generated field. This field is empty for a rich media asset." }, "counterCustomEvents": { "items": { "$ref": "CreativeCustomEvent" }, "description": "List of counter events configured for the asset. This is a read-only, auto-generated field and only applicable to a rich media asset.", "type": "array" } }, "description": "CreativeAssets contains properties of a creative asset file which will be uploaded or has already been uploaded. Refer to the creative sample code for how to upload assets and insert a creative.", "type": "object" }, "ObaIcon": { "description": "Online Behavioral Advertiser icon.", "type": "object", "properties": { "program": { "type": "string", "description": "Identifies the industry initiative that the icon supports. For example, AdChoices." }, "iconClickThroughUrl": { "description": "URL to redirect to when an OBA icon is clicked.", "type": "string" }, "size": { "description": "OBA icon size.", "$ref": "Size" }, "iconClickTrackingUrl": { "description": "URL to track click when an OBA icon is clicked.", "type": "string" }, "yPosition": { "description": "OBA icon y coordinate position. Accepted values are top or bottom.", "type": "string" }, "resourceUrl": { "description": "OBA icon resource URL. Campaign Manager only supports image and JavaScript icons. Learn more", "type": "string" }, "iconViewTrackingUrl": { "type": "string", "description": "URL to track view when an OBA icon is clicked." }, "xPosition": { "type": "string", "description": "OBA icon x coordinate position. Accepted values are left or right." } }, "id": "ObaIcon" }, "PopupWindowProperties": { "properties": { "dimension": { "description": "Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID", "$ref": "Size" }, "offset": { "description": "Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES.", "$ref": "OffsetPosition" }, "showScrollBar": { "description": "Whether to display the browser scroll bar.", "type": "boolean" }, "showToolBar": { "description": "Whether to display the browser tool bar.", "type": "boolean" }, "showMenuBar": { "description": "Whether to display the browser menu bar.", "type": "boolean" }, "showAddressBar": { "type": "boolean", "description": "Whether to display the browser address bar." }, "title": { "description": "Title of popup window.", "type": "string" }, "showStatusBar": { "type": "boolean", "description": "Whether to display the browser status bar." }, "positionType": { "description": "Popup window position either centered or at specific coordinate.", "enumDescriptions": [ "window positioning at center.", "window positioning by upper left corner coordinates." ], "type": "string", "enum": [ "CENTER", "COORDINATES" ] } }, "type": "object", "description": "Popup Window Properties.", "id": "PopupWindowProperties" }, "AccountsListResponse": { "id": "AccountsListResponse", "properties": { "accounts": { "items": { "$ref": "Account" }, "description": "Account collection.", "type": "array" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#accountsListResponse\"." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "description": "Account List Response", "type": "object" }, "GeoTargeting": { "type": "object", "description": "Geographical Targeting.", "properties": { "postalCodes": { "type": "array", "items": { "$ref": "PostalCode" }, "description": "Postal codes to be targeted. For each postal code only id is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a postal code, do not target or exclude the country of the postal code." }, "excludeCountries": { "description": "Whether or not to exclude the countries in the countries field from targeting. If false, the countries field refers to countries which will be targeted by the ad.", "type": "boolean" }, "regions": { "items": { "$ref": "Region" }, "description": "Regions to be targeted. For each region only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a region, do not target or exclude the country of the region.", "type": "array" }, "metros": { "description": "Metros to be targeted. For each metro only dmaId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a metro, do not target or exclude the country of the metro.", "items": { "$ref": "Metro" }, "type": "array" }, "cities": { "items": { "$ref": "City" }, "description": "Cities to be targeted. For each city only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting a city, do not target or exclude the country of the city, and do not target the metro or region of the city.", "type": "array" }, "countries": { "type": "array", "description": "Countries to be targeted or excluded from targeting, depending on the setting of the excludeCountries field. For each country only dartId is required. The other fields are populated automatically when the ad is inserted or updated. If targeting or excluding a country, do not target regions, cities, metros, or postal codes in the same country.", "items": { "$ref": "Country" } } }, "id": "GeoTargeting" }, "MobileAppsListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#mobileAppsListResponse\"." }, "mobileApps": { "items": { "$ref": "MobileApp" }, "description": "Mobile apps collection.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "id": "MobileAppsListResponse", "description": "Mobile app List Response", "type": "object" }, "AdBlockingConfiguration": { "id": "AdBlockingConfiguration", "type": "object", "description": "Campaign ad blocking settings.", "properties": { "enabled": { "description": "Whether this campaign has enabled ad blocking. When true, ad blocking is enabled for placements in the campaign, but this may be overridden by site and placement settings. When false, ad blocking is disabled for all placements under the campaign, regardless of site and placement settings.", "type": "boolean" } } }, "ContentCategoriesListResponse": { "id": "ContentCategoriesListResponse", "type": "object", "properties": { "contentCategories": { "description": "Content category collection.", "type": "array", "items": { "$ref": "ContentCategory" } }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#contentCategoriesListResponse\"." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "description": "Content Category List Response" }, "Region": { "id": "Region", "description": "Contains information about a region that can be targeted by ads.", "type": "object", "properties": { "name": { "description": "Name of this region.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#region\".", "type": "string" }, "countryCode": { "type": "string", "description": "Country code of the country to which this region belongs." }, "dartId": { "description": "DART ID of this region.", "type": "string", "format": "int64" }, "regionCode": { "type": "string", "description": "Region code." }, "countryDartId": { "format": "int64", "description": "DART ID of the country to which this region belongs.", "type": "string" } } }, "SitesListResponse": { "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#sitesListResponse\".", "type": "string" }, "sites": { "items": { "$ref": "Site" }, "type": "array", "description": "Site collection." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "id": "SitesListResponse", "description": "Site List Response" }, "AdvertisersListResponse": { "properties": { "advertisers": { "type": "array", "items": { "$ref": "Advertiser" }, "description": "Advertiser collection." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertisersListResponse\"." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." } }, "type": "object", "description": "Advertiser List Response", "id": "AdvertisersListResponse" }, "ReportCompatibleFields": { "id": "ReportCompatibleFields", "properties": { "kind": { "description": "The kind of resource this is, in this case dfareporting#reportCompatibleFields.", "type": "string" }, "dimensionFilters": { "description": "Dimensions which are compatible to be selected in the \"dimensionFilters\" section of the report.", "items": { "$ref": "Dimension" }, "type": "array" }, "dimensions": { "items": { "$ref": "Dimension" }, "type": "array", "description": "Dimensions which are compatible to be selected in the \"dimensions\" section of the report." }, "metrics": { "type": "array", "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report.", "items": { "$ref": "Metric" } }, "pivotedActivityMetrics": { "description": "Metrics which are compatible to be selected as activity metrics to pivot on in the \"activities\" section of the report.", "items": { "$ref": "Metric" }, "type": "array" } }, "description": "Represents fields that are compatible to be selected for a report of type \"STANDARD\".", "type": "object" }, "LandingPage": { "type": "object", "id": "LandingPage", "properties": { "url": { "description": "URL of this landing page. This is a required field.", "type": "string" }, "name": { "description": "Name of this landing page. This is a required field. It must be less than 256 characters long.", "type": "string" }, "id": { "description": "ID of this landing page. This is a read-only, auto-generated field.", "format": "int64", "type": "string" }, "advertiserId": { "format": "int64", "description": "Advertiser ID of this landing page. This is a required field.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#landingPage\".", "type": "string" }, "deepLinks": { "items": { "$ref": "DeepLink" }, "description": "Links that will direct the user to a mobile app, if installed.", "type": "array" }, "archived": { "type": "boolean", "description": "Whether this landing page has been archived." } }, "description": "Contains information about where a user's browser is taken after the user clicks an ad." }, "FloodlightActivity": { "description": "Contains properties of a Floodlight activity.", "type": "object", "id": "FloodlightActivity", "properties": { "name": { "type": "string", "description": "Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes." }, "sslRequired": { "description": "Whether this floodlight activity must be SSL-compliant.", "type": "boolean" }, "floodlightConfigurationIdDimensionValue": { "description": "Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "countingMethod": { "description": "Counting method for conversions for this floodlight activity. This is a required field.", "enumDescriptions": [ "Count every conversion.", "Count the first conversion for each unique user during each 24-hour day, from midnight to midnight, Eastern Time.", "Count one conversion per user per session. Session length is set by the site where the Spotlight tag is deployed.", "Count all conversions, plus the total number of sales that take place and the total revenue for these transactions.", "Count each conversion, plus the total number of items sold and the total revenue for these sales." ], "type": "string", "enum": [ "STANDARD_COUNTING", "UNIQUE_COUNTING", "SESSION_COUNTING", "TRANSACTIONS_COUNTING", "ITEMS_SOLD_COUNTING" ] }, "floodlightActivityGroupName": { "type": "string", "description": "Name of the associated floodlight activity group. This is a read-only field." }, "expectedUrl": { "description": "URL where this tag will be deployed. If specified, must be less than 256 characters long.", "type": "string" }, "floodlightActivityGroupType": { "enumDescriptions": [ "", "" ], "description": "Type of the associated floodlight activity group. This is a read-only field.", "type": "string", "enum": [ "COUNTER", "SALE" ] }, "subaccountId": { "format": "int64", "description": "Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.", "type": "string" }, "sslCompliant": { "description": "Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.", "type": "boolean" }, "notes": { "description": "General notes or implementation instructions for the tag.", "type": "string" }, "cacheBustingType": { "description": "Code type used for cache busting in the generated tag. Applicable only when floodlightActivityGroupType is COUNTER and countingMethod is STANDARD_COUNTING or UNIQUE_COUNTING.", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "JAVASCRIPT", "ACTIVE_SERVER_PAGE", "JSP", "PHP", "COLD_FUSION" ] }, "advertiserIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field." }, "accountId": { "type": "string", "description": "Account ID of this floodlight activity. This is a read-only field that can be left blank.", "format": "int64" }, "floodlightConfigurationId": { "description": "Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.", "type": "string", "format": "int64" }, "floodlightActivityGroupTagString": { "type": "string", "description": "Tag string of the associated floodlight activity group. This is a read-only field." }, "id": { "type": "string", "format": "int64", "description": "ID of this floodlight activity. This is a read-only, auto-generated field." }, "tagString": { "type": "string", "description": "Value of the cat= parameter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being a-z0-9[ _ ]. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion." }, "floodlightTagType": { "description": "The type of Floodlight tag this activity will generate. This is a required field.", "type": "string", "enumDescriptions": [ "", "", "" ], "enum": [ "IFRAME", "IMAGE", "GLOBAL_SITE_TAG" ] }, "idDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field." }, "secure": { "description": "Whether this tag should use SSL.", "type": "boolean" }, "publisherTags": { "type": "array", "items": { "$ref": "FloodlightActivityPublisherDynamicTag" }, "description": "Publisher dynamic floodlight tags." }, "conversionCategory": { "type": "string", "enum": [ "CONVERSION_CATEGORY_DEFAULT", "CONVERSION_CATEGORY_PURCHASE", "CONVERSION_CATEGORY_SIGNUP", "CONVERSION_CATEGORY_PAGE_VIEW", "CONVERSION_CATEGORY_DOWNLOAD", "CONVERSION_CATEGORY_ADD_TO_CART", "CONVERSION_CATEGORY_BEGIN_CHECKOUT", "CONVERSION_CATEGORY_SUBSCRIBE_PAID", "CONVERSION_CATEGORY_SUBMIT_LEAD_FORM", "CONVERSION_CATEGORY_BOOK_APPOINTMENT", "CONVERSION_CATEGORY_REQUEST_QUOTE", "CONVERSION_CATEGORY_GET_DIRECTIONS", "CONVERSION_CATEGORY_OUTBOUND_CLICK", "CONVERSION_CATEGORY_CONTACT", "CONVERSION_CATEGORY_QUALIFIED_LEAD", "CONVERSION_CATEGORY_CONVERTED_LEAD", "CONVERSION_CATEGORY_IN_APP_AD_REVENUE" ], "enumDescriptions": [ "Unspecified category (called \"Other\" externally).", "Purchase, sales, or \"order placed\" event.", "Signup user action.", "User visiting a page.", "Software download action (as for an app). A conversion type that is created as a download type may not have its category changed.", ". The addition of items to a shopping cart or bag on an advertiser site.", "When someone enters the checkout flow on an advertiser site.", "The start of a paid subscription for a product or service.", "A submission of a form on an advertiser site indicating business interest.", "A booking of an appointment with an advertiser's business.", "A quote or price estimate request.", "A search for an advertiser's business location.", "A click to an advertiser's partner site, e.g. a referral.", "A call, SMS, email, chat or other type of contact to an advertiser.", "A lead conversion imported from an external source into Google Ads, that has been further qualified by the advertiser.", "A lead conversion imported from an external source into Google Ads, that has further completed a desired stage as defined by the lead gen advertiser.", "Conversion event that provides the revenue value of impressions that were shown in-app to users." ], "description": "Required. The conversion category of the activity." }, "status": { "type": "string", "enum": [ "ACTIVE", "ARCHIVED_AND_DISABLED", "ARCHIVED", "DISABLED_POLICY" ], "description": "The status of the activity. This can only be set to ACTIVE or ARCHIVED_AND_DISABLED. The ARCHIVED status is no longer supported and cannot be set for Floodlight activities. The DISABLED_POLICY status indicates that a Floodlight activity is violating Google policy. Contact your account manager for more information.", "enumDescriptions": [ "", "", "", "" ] }, "advertiserId": { "format": "int64", "type": "string", "description": "Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser." }, "defaultTags": { "type": "array", "description": "Dynamic floodlight tags.", "items": { "$ref": "FloodlightActivityDynamicTag" } }, "floodlightActivityGroupId": { "format": "int64", "description": "Floodlight activity group ID of this floodlight activity. This is a required field.", "type": "string" }, "tagFormat": { "enumDescriptions": [ "", "" ], "type": "string", "enum": [ "HTML", "XHTML" ], "description": "Tag format type for the floodlight activity. If left blank, the tag format will default to HTML." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightActivity\".", "type": "string" }, "userDefinedVariableTypes": { "type": "array", "items": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "U1", "U2", "U3", "U4", "U5", "U6", "U7", "U8", "U9", "U10", "U11", "U12", "U13", "U14", "U15", "U16", "U17", "U18", "U19", "U20", "U21", "U22", "U23", "U24", "U25", "U26", "U27", "U28", "U29", "U30", "U31", "U32", "U33", "U34", "U35", "U36", "U37", "U38", "U39", "U40", "U41", "U42", "U43", "U44", "U45", "U46", "U47", "U48", "U49", "U50", "U51", "U52", "U53", "U54", "U55", "U56", "U57", "U58", "U59", "U60", "U61", "U62", "U63", "U64", "U65", "U66", "U67", "U68", "U69", "U70", "U71", "U72", "U73", "U74", "U75", "U76", "U77", "U78", "U79", "U80", "U81", "U82", "U83", "U84", "U85", "U86", "U87", "U88", "U89", "U90", "U91", "U92", "U93", "U94", "U95", "U96", "U97", "U98", "U99", "U100" ] }, "description": "List of the user-defined variables used by this conversion tag. These map to the \"u[1-100]=\" in the tags. Each of these can have a user defined type. Acceptable values are U1 to U100, inclusive. " }, "attributionEnabled": { "type": "boolean", "description": "Whether the activity is enabled for attribution." } } }, "RemarketingListShare": { "type": "object", "description": "Contains properties of a remarketing list's sharing information. Sharing allows other accounts or advertisers to target to your remarketing lists. This resource can be used to manage remarketing list sharing to other accounts and advertisers.", "id": "RemarketingListShare", "properties": { "sharedAdvertiserIds": { "type": "array", "items": { "type": "string", "format": "int64" }, "description": "Advertisers that the remarketing list is shared with." }, "sharedAccountIds": { "description": "Accounts that the remarketing list is shared with.", "type": "array", "items": { "type": "string", "format": "int64" } }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#remarketingListShare\"." }, "remarketingListId": { "description": "Remarketing list ID. This is a read-only, auto-generated field.", "format": "int64", "type": "string" } } }, "FloodlightReportCompatibleFields": { "type": "object", "id": "FloodlightReportCompatibleFields", "properties": { "dimensionFilters": { "type": "array", "items": { "$ref": "Dimension" }, "description": "Dimensions which are compatible to be selected in the \"dimensionFilters\" section of the report." }, "kind": { "description": "The kind of resource this is, in this case dfareporting#floodlightReportCompatibleFields.", "type": "string" }, "dimensions": { "items": { "$ref": "Dimension" }, "description": "Dimensions which are compatible to be selected in the \"dimensions\" section of the report.", "type": "array" }, "metrics": { "type": "array", "description": "Metrics which are compatible to be selected in the \"metricNames\" section of the report.", "items": { "$ref": "Metric" } } }, "description": "Represents fields that are compatible to be selected for a report of type \"FlOODLIGHT\"." }, "LastModifiedInfo": { "id": "LastModifiedInfo", "properties": { "time": { "type": "string", "format": "int64", "description": "Timestamp of the last change in milliseconds since epoch." } }, "description": "Modification timestamp.", "type": "object" }, "DynamicProfileGenerateCodeResponse": { "type": "object", "properties": { "code": { "type": "string", "description": "Generated code for the dynamic profile. The code will need to be unescaped." } }, "id": "DynamicProfileGenerateCodeResponse", "description": "Response message for DfareportingDynamicProfiles.GenerateCode." }, "StudioCreativeAssetsResponse": { "type": "object", "description": "Response message for DfareportingStudioCreativeAssets.Insert.", "properties": { "assets": { "description": "The list of studio creative assets.", "items": { "$ref": "StudioCreativeAsset" }, "type": "array" } }, "id": "StudioCreativeAssetsResponse" }, "Creative": { "id": "Creative", "description": "Contains properties of a Creative.", "type": "object", "properties": { "artworkType": { "type": "string", "enum": [ "ARTWORK_TYPE_FLASH", "ARTWORK_TYPE_HTML5", "ARTWORK_TYPE_MIXED", "ARTWORK_TYPE_IMAGE" ], "enumDescriptions": [ "The creative is a Flash creative.", "The creative is HTML5.", "The creative is HTML5 if available, Flash otherwise.", "The creative is Image." ], "description": "Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID." }, "universalAdId": { "$ref": "UniversalAdId", "description": "A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID." }, "version": { "format": "int32", "description": "The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types.", "type": "integer" }, "backgroundColor": { "description": "The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE.", "type": "string" }, "authoringSource": { "type": "string", "enum": [ "CREATIVE_AUTHORING_SOURCE_DCM", "CREATIVE_AUTHORING_SOURCE_DBM", "CREATIVE_AUTHORING_SOURCE_STUDIO", "CREATIVE_AUTHORING_SOURCE_GWD", "CREATIVE_AUTHORING_SOURCE_ACS", "CREATIVE_AUTHORING_SOURCE_ADOBE", "CREATIVE_AUTHORING_SOURCE_TYPEFACE_AI", "CREATIVE_AUTHORING_SOURCE_REMBRAND", "CREATIVE_AUTHORING_SOURCE_TRACKTO_STUDIO", "CREATIVE_AUTHORING_SOURCE_BORNLOGIC", "CREATIVE_AUTHORING_SOURCE_BEGEN_AI" ], "enumDeprecated": [ false, false, false, false, true, false, false, false, false, false, false ], "description": "Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types.", "enumDescriptions": [ "DCM-UI or external API used to author the creative.", "DBM-UI used to author the creative.", "Studio-UI used to author the creative.", "Google Web Designer used to author the creative.", "ACS-UI used to author the creative.", "Creative authoring source is Adobe.", "Creative authoring source is Typeface.ai.", "Creative authoring source is Rembrand.", "Creative authoring source is Trackto.", "Creative authoring source is Bornlogic.", "Creative authoring source is BEGEN_AI." ] }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creative\"." }, "additionalSizes": { "type": "array", "items": { "$ref": "Size" }, "description": "Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE." }, "timerCustomEvents": { "description": "List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE.", "items": { "$ref": "CreativeCustomEvent" }, "type": "array" }, "requiredFlashVersion": { "format": "int32", "description": "The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "integer" }, "thirdPartyBackupImageImpressionsUrl": { "description": "Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA.", "type": "string" }, "allowScriptAccess": { "type": "boolean", "description": "Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE." }, "progressOffset": { "description": "Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO.", "$ref": "VideoOffset" }, "backupImageTargetWindow": { "$ref": "TargetWindow", "description": "Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE." }, "archived": { "description": "Whether the creative is archived. Applicable to all creative types.", "type": "boolean" }, "htmlCode": { "description": "HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA.", "type": "string" }, "size": { "description": "Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA.", "$ref": "Size" }, "authoringTool": { "type": "string", "enum": [ "NINJA", "SWIFFY" ], "enumDescriptions": [ "", "" ], "description": "Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER." }, "creativeFieldAssignments": { "items": { "$ref": "CreativeFieldAssignment" }, "type": "array", "description": "Creative field assignments for this creative. Applicable to all creative types." }, "companionCreatives": { "description": "List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false.", "type": "array", "items": { "format": "int64", "type": "string" } }, "skippable": { "description": "Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID.", "type": "boolean" }, "additionalAsset": { "description": "Optional. Additional asset for the creative. This field captures additional assets that are associated with the creative and used in the context of the social/native and YouTube platforms.", "$ref": "AdditionalAsset" }, "type": { "type": "string", "enum": [ "IMAGE", "DISPLAY_REDIRECT", "CUSTOM_DISPLAY", "INTERNAL_REDIRECT", "CUSTOM_DISPLAY_INTERSTITIAL", "INTERSTITIAL_INTERNAL_REDIRECT", "TRACKING_TEXT", "RICH_MEDIA_DISPLAY_BANNER", "RICH_MEDIA_INPAGE_FLOATING", "RICH_MEDIA_IM_EXPAND", "RICH_MEDIA_DISPLAY_EXPANDING", "RICH_MEDIA_DISPLAY_INTERSTITIAL", "RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL", "RICH_MEDIA_MOBILE_IN_APP", "FLASH_INPAGE", "INSTREAM_VIDEO", "VPAID_LINEAR_VIDEO", "VPAID_NON_LINEAR_VIDEO", "INSTREAM_VIDEO_REDIRECT", "RICH_MEDIA_PEEL_DOWN", "HTML5_BANNER", "DISPLAY", "DISPLAY_IMAGE_GALLERY", "BRAND_SAFE_DEFAULT_INSTREAM_VIDEO", "INSTREAM_AUDIO" ], "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "description": "Required. Type of this creative. Applicable to all creative types. *Note:* FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types." }, "fsCommand": { "description": "OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE.", "$ref": "FsCommand" }, "active": { "type": "boolean", "description": "Whether the creative is active. Applicable to all creative types." }, "studioAdvertiserId": { "description": "Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "type": "string", "format": "int64" }, "autoAdvanceImages": { "type": "boolean", "description": "Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY." }, "advertiserId": { "type": "string", "description": "Required. Advertiser ID of this creative. This is a required field. Applicable to all creative types.", "format": "int64" }, "totalFileSize": { "format": "int64", "description": "Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "type": "string" }, "accountId": { "format": "int64", "type": "string", "description": "Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types." }, "lastModifiedInfo": { "description": "Creative last modification information. This is a read-only field. Applicable to all creative types.", "$ref": "LastModifiedInfo" }, "syntheticContentAttestationStatus": { "description": "Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations. [Learn more about labeling requirements in AI regulations.](https://support.google.com/campaignmanager/answer/17232030)", "type": "string", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "IS_SYNTHETIC", "NOT_SYNTHETIC" ], "enumDescriptions": [ "No attestation has been provided.", "Attested as created or edited using AI.", "Attested as not created or edited using AI." ] }, "studioTraffickedCreativeId": { "format": "int64", "description": "Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "type": "string" }, "compatibility": { "items": { "enumDescriptions": [ "", "", "Deprecated enum value. No longer supported.", "Deprecated enum value. No longer supported.", "", "" ], "type": "string", "enum": [ "DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO" ] }, "description": "Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. Acceptable values are: - \"APP\" - \"APP_INTERSTITIAL\" - \"IN_STREAM_VIDEO\" - \"IN_STREAM_AUDIO\" - \"DISPLAY\" - \"DISPLAY_INTERSTITIAL\" ", "type": "array" }, "idDimensionValue": { "description": "Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types.", "$ref": "DimensionValue" }, "requiredFlashPluginVersion": { "description": "The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "type": "string" }, "adParameters": { "description": "Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID.", "type": "string" }, "renderingId": { "type": "string", "format": "int64", "description": "ID of current rendering version. This is a read-only field. Applicable to all creative types." }, "backupImageFeatures": { "description": "List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "array", "items": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "POST_MESSAGE always required due to html5 implementation.", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "CSS_FONT_FACE", "CSS_BACKGROUND_SIZE", "CSS_BORDER_IMAGE", "CSS_BORDER_RADIUS", "CSS_BOX_SHADOW", "CSS_FLEX_BOX", "CSS_HSLA", "CSS_MULTIPLE_BGS", "CSS_OPACITY", "CSS_RGBA", "CSS_TEXT_SHADOW", "CSS_ANIMATIONS", "CSS_COLUMNS", "CSS_GENERATED_CONTENT", "CSS_GRADIENTS", "CSS_REFLECTIONS", "CSS_TRANSFORMS", "CSS_TRANSFORMS3D", "CSS_TRANSITIONS", "APPLICATION_CACHE", "CANVAS", "CANVAS_TEXT", "DRAG_AND_DROP", "HASH_CHANGE", "HISTORY", "AUDIO", "VIDEO", "INDEXED_DB", "INPUT_ATTR_AUTOCOMPLETE", "INPUT_ATTR_AUTOFOCUS", "INPUT_ATTR_LIST", "INPUT_ATTR_PLACEHOLDER", "INPUT_ATTR_MAX", "INPUT_ATTR_MIN", "INPUT_ATTR_MULTIPLE", "INPUT_ATTR_PATTERN", "INPUT_ATTR_REQUIRED", "INPUT_ATTR_STEP", "INPUT_TYPE_SEARCH", "INPUT_TYPE_TEL", "INPUT_TYPE_URL", "INPUT_TYPE_EMAIL", "INPUT_TYPE_DATETIME", "INPUT_TYPE_DATE", "INPUT_TYPE_MONTH", "INPUT_TYPE_WEEK", "INPUT_TYPE_TIME", "INPUT_TYPE_DATETIME_LOCAL", "INPUT_TYPE_NUMBER", "INPUT_TYPE_RANGE", "INPUT_TYPE_COLOR", "LOCAL_STORAGE", "POST_MESSAGE", "SESSION_STORAGE", "WEB_SOCKETS", "WEB_SQL_DATABASE", "WEB_WORKERS", "GEO_LOCATION", "INLINE_SVG", "SMIL", "SVG_HREF", "SVG_CLIP_PATHS", "TOUCH", "WEBGL", "SVG_FILTERS", "SVG_FE_IMAGE" ] } }, "clickTags": { "description": "Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "array", "items": { "$ref": "ClickTag" } }, "mediaDuration": { "type": "number", "format": "float", "description": "Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID." }, "counterCustomEvents": { "description": "List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID.", "type": "array", "items": { "$ref": "CreativeCustomEvent" } }, "backupImageClickThroughUrl": { "$ref": "CreativeClickThroughUrl", "description": "Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE." }, "convertFlashToHtml5": { "description": "Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE.", "type": "boolean" }, "subaccountId": { "format": "int64", "type": "string", "description": "Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types." }, "sslCompliant": { "type": "boolean", "description": "Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types." }, "obaIcon": { "description": "Online behavioral advertising icon to be added to the creative. Applicable to the following creative types: all INSTREAM_VIDEO.", "$ref": "ObaIcon" }, "redirectUrl": { "description": "URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT", "type": "string" }, "mediaDescription": { "description": "Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID.", "type": "string" }, "thirdPartyRichMediaImpressionsUrl": { "description": "Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA.", "type": "string" }, "thirdPartyUrls": { "type": "array", "items": { "$ref": "ThirdPartyTrackingUrl" }, "description": "Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID." }, "customKeyValues": { "items": { "type": "string" }, "description": "Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "type": "array" }, "exitCustomEvents": { "items": { "$ref": "CreativeCustomEvent" }, "type": "array", "description": "List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE." }, "adTagKeys": { "type": "array", "items": { "type": "string" }, "description": "Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID." }, "id": { "format": "int64", "type": "string", "description": "ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types." }, "sslOverride": { "type": "boolean", "description": "Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types." }, "latestTraffickedCreativeId": { "format": "int64", "type": "string", "description": "Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID." }, "htmlCodeLocked": { "description": "Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER.", "type": "boolean" }, "name": { "type": "string", "description": "Required. Name of the creative. This must be less than 256 characters long. Applicable to all creative types." }, "backupImageReportingLabel": { "type": "string", "description": "Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE." }, "commercialId": { "description": "Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives.", "type": "string" }, "renderingIdDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types." }, "studioCreativeId": { "type": "string", "description": "Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID.", "format": "int64" }, "skipOffset": { "description": "Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO.", "$ref": "VideoOffset" }, "creativeAssets": { "items": { "$ref": "CreativeAsset" }, "description": "Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT", "type": "array" }, "overrideCss": { "type": "string", "description": "Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA." } } }, "ContentCategory": { "type": "object", "id": "ContentCategory", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#contentCategory\".", "type": "string" }, "id": { "type": "string", "description": "ID of this content category. This is a read-only, auto-generated field.", "format": "int64" }, "accountId": { "description": "Account ID of this content category. This is a read-only field that can be left blank.", "type": "string", "format": "int64" }, "name": { "type": "string", "description": "Name of this content category. This is a required field and must be less than 256 characters long and unique among content categories of the same account." } } }, "EventTagOverride": { "id": "EventTagOverride", "type": "object", "description": "Event tag override information.", "properties": { "id": { "format": "int64", "description": "ID of this event tag override. This is a read-only, auto-generated field.", "type": "string" }, "enabled": { "description": "Whether this override is enabled.", "type": "boolean" } } }, "UserIdentifier": { "type": "object", "description": "User identifying information. Exactly one type of identifier must be specified.", "properties": { "addressInfo": { "description": "Address information.", "$ref": "OfflineUserAddressInfo" }, "hashedPhoneNumber": { "type": "string", "description": "Hashed phone number using SHA-256 hash function after normalization (E164 standard)." }, "hashedEmail": { "description": "Hashed email address using SHA-256 hash function after normalization.", "type": "string" } }, "id": "UserIdentifier" }, "UserRolePermissionGroupsListResponse": { "description": "User Role Permission Group List Response", "type": "object", "id": "UserRolePermissionGroupsListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRolePermissionGroupsListResponse\".", "type": "string" }, "userRolePermissionGroups": { "type": "array", "items": { "$ref": "UserRolePermissionGroup" }, "description": "User role permission group collection." } } }, "ConnectionType": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#connectionType\"." }, "id": { "type": "string", "description": "ID of this connection type.", "format": "int64" }, "name": { "type": "string", "description": "Name of this connection type." } }, "description": "Contains information about an internet connection type that can be targeted by ads. Clients can use the connection type to target mobile vs. broadband users.", "type": "object", "id": "ConnectionType" }, "FeedSchedule": { "properties": { "repeatValue": { "format": "int64", "type": "string", "description": "Optional. The number of times the feed retransforms within one day. This is a required field if the schedule is enabled. Acceptable values are between 1 to 6, inclusive." }, "startHour": { "type": "string", "description": "Optional. The hour of the day to start the feed. It is applicable if the repeat value is equal to 1. Default value is 0." }, "timeZone": { "description": "Optional. The time zone to schedule the feed. It is applicable if the repeat value is equal to 1. Default value is \"America/Los_Angeles\".", "type": "string" }, "startMinute": { "description": "Optional. The minute of the hour to start the feed. It is applicable if the repeat value is equal to 1. Default value is 0.", "type": "string" }, "scheduleEnabled": { "type": "boolean", "description": "Optional. Whether the schedule is enabled." } }, "description": "Contains the schedule of the dynamic feed.", "type": "object", "id": "FeedSchedule" }, "RemarketingListsListResponse": { "type": "object", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#remarketingListsListResponse\"." }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "remarketingLists": { "items": { "$ref": "RemarketingList" }, "type": "array", "description": "Remarketing list collection." } }, "description": "Remarketing list response", "id": "RemarketingListsListResponse" }, "ContextualKeywordTargeting": { "id": "ContextualKeywordTargeting", "description": "Contextual Keyword Targeting.", "type": "object", "properties": { "keywords": { "type": "array", "description": "Contextual keywords that this ad targets", "items": { "$ref": "ContextualKeyword" } } } }, "BillingAssignmentsListResponse": { "id": "BillingAssignmentsListResponse", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#billingAssignmentsListResponse\"." }, "billingAssignments": { "type": "array", "description": "Billing assignments collection.", "items": { "$ref": "BillingAssignment" } } }, "description": "Billing assignment List Response", "type": "object" }, "ThirdPartyTrackingUrl": { "properties": { "url": { "type": "string", "description": "URL for the specified third-party URL type." }, "thirdPartyUrlType": { "type": "string", "enum": [ "IMPRESSION", "CLICK_TRACKING", "VIDEO_START", "VIDEO_FIRST_QUARTILE", "VIDEO_MIDPOINT", "VIDEO_THIRD_QUARTILE", "VIDEO_COMPLETE", "VIDEO_MUTE", "VIDEO_PAUSE", "VIDEO_REWIND", "VIDEO_FULLSCREEN", "VIDEO_STOP", "VIDEO_CUSTOM", "SURVEY", "RICH_MEDIA_IMPRESSION", "RICH_MEDIA_RM_IMPRESSION", "RICH_MEDIA_BACKUP_IMPRESSION", "VIDEO_SKIP", "VIDEO_PROGRESS" ], "description": "Third-party URL type for in-stream video and in-stream audio creatives.", "enumDescriptions": [ "Used to count impressions of the ad after video buffering is complete.", "Used to track user clicks on the video.", "Used to track the number of times a user starts a video.", "Used to track the number of times the video plays to 25% of its length.", "Used to track the number of times the video plays to 50% of its length.", "Used to track the number of times the video plays to 75% of its length.", "Used to track the number of times the video plays to the end.", "Used to track the number of times a user mutes the video.", "Used to track the number of times a user pauses the video.", "Used to track the number of times a user replays the video.", "Used to track the number of times a user expands the video to full-screen size.", "Used to track the number of times a user stops the video.", "Used to track the number of times a user performs a custom click, such as clicking on a video hot spot.", "Used for DFA6 compatibility, this is deprecating in favor of event tags.", "Used by Studio RichMediaCreative, maps to its thirdPartyImpressionsUrl", "Used by Studio RichMediaCreative, maps to its thirdPartyRichMediaImpressionsUrl", "Used by Studio RichMediaCreative, maps to its thirdPartyBackupImageImpressionsUrl", "Used to track the number of times the video was skipped.", "Used to track the number of times the video plays to an offset determined by the user." ] } }, "id": "ThirdPartyTrackingUrl", "description": "Third-party Tracking URL.", "type": "object" }, "FeedField": { "properties": { "name": { "description": "Required. The name of the field.", "type": "string" }, "required": { "type": "boolean", "description": "Optional. Whether the field is required and should not be empty in the feed. Could be set as true when the field type is any of the following: - GPA_SERVED_IMAGE_URL - GPA_SERVED_ASSET_URL - ASSET_LIBRARY_HANDLE - ASSET_LIBRARY_VIDEO_HANDLE - ASSET_LIBRARY_DIRECTORY_HANDLE " }, "defaultValue": { "description": "Optional. The default value of the field.", "type": "string" }, "type": { "type": "string", "enum": [ "TYPE_UNKNOWN", "STRING", "LONG", "GPA_SERVED_IMAGE_URL", "GPA_SERVED_ASSET_URL", "COUNTRY_CODE_ISO", "FLOAT", "CM360_KEYWORD", "CM360_SITE_ID", "BOOL", "EXIT_URL", "DATETIME", "CM360_CREATIVE_ID", "CM360_PLACEMENT_ID", "CM360_AD_ID", "CM360_ADVERTISER_ID", "CM360_CAMPAIGN_ID", "CITY", "REGION", "POSTAL_CODE", "METRO", "CUSTOM_VALUE", "REMARKETING_VALUE", "GEO_CANONICAL", "WEIGHT", "STRING_LIST", "CREATIVE_DIMENSION", "USERLIST_ID", "ASSET_LIBRARY_DIRECTORY_HANDLE", "ASSET_LIBRARY_VIDEO_HANDLE", "ASSET_LIBRARY_HANDLE", "THIRD_PARTY_SERVED_URL", "CM360_DYNAMIC_TARGETING_KEY", "DV360_LINE_ITEM_ID" ], "description": "Required. The type of the field.", "enumDescriptions": [ "The type is unspecified. This is an unused value.", "The field type is text.", "The field type is whole number.", "The field type is image url", "The field type is asset url.", "The field type is the ISO 3166-2 alpha-2 codes. It is two-letter country codes defined in ISO 3166-1 published by the International Organization for Standardization.", "The field type is decimal.", "The field type is custom CM360 ad tag parameter.", "The field type is CM360 site ID.", "The field type is boolean.", "The field type is exit url.", "The field type is datetime.", "The field type is CM360 creative ID.", "The field type is CM360 placement ID.", "The field type is CM360 ad ID.", "The field type is CM360 advertiser ID.", "The field type is CM360 campaign ID.", "The field type is cities.", "The field type is region.", "The field type is postal code.", "The field type is metro code.", "The field type is custom value.", "The field type is remarketing value.", "The field type is accurate geographic type.", "The field type is weight.", "The field type is a list of values.", "The field type is creative dimension.", "The field type is CM/DV360 Audience ID.", "The field type is AssetLibrary directory path.", "The field type is AssetLibrary video file path.", "The field type is AssetLibrary path.", "The field type is third party served url.", "The field type is CM dynamic targeting key.", "The field type is DV360 line item ID." ] }, "renderable": { "description": "Optional. Whether the field is able to display. Could be set as true when the field type is not in any of the following and the field is not filterable: - COUNTRY_CODE_ISO - CITY - REGION - POSTAL_CODE - METRO - GEO_CANONICAL - USERLIST_ID - CONTEXTUAL_KEYWORD - CM360_DYNAMIC_TARGETING_KEY - WEIGHT ", "type": "boolean" }, "id": { "description": "Required. The ID of the field. The ID is based on the column index starting from 0, and it should match the column index in the resource link.", "format": "int32", "type": "integer" }, "filterable": { "description": "Optional. Whether the field is filterable. Could be set as true when the field type is any of the following and is not renderable: - STRING - BOOL - COUNTRY_CODE_ISO - CM360_SITE_ID - CM360_KEYWORD - CM360_CREATIVE_ID - CM360_PLACEMENT_ID - CM360_AD_ID - CM360_ADVERTISER_ID - CM360_CAMPAIGN_ID - CITY - REGION - POSTAL_CODE - METRO - CUSTOM_VALUE - REMARKETING_VALUE - GEO_CANONICAL - STRING_LIST - CREATIVE_DIMENSION - USERLIST_ID - CM360_DYNAMIC_TARGETING_KEY - DV360_LINE_ITEM_ID ", "type": "boolean" } }, "description": "Each field of the element. This is a required field.", "type": "object", "id": "FeedField" }, "DimensionValueRequest": { "description": "Represents a DimensionValuesRequest.", "type": "object", "id": "DimensionValueRequest", "properties": { "kind": { "type": "string", "description": "The kind of request this is, in this case dfareporting#dimensionValueRequest ." }, "startDate": { "format": "date", "type": "string" }, "filters": { "type": "array", "description": "The list of filters by which to filter values. The filters are ANDed.", "items": { "$ref": "DimensionFilter" } }, "endDate": { "format": "date", "type": "string" }, "dimensionName": { "type": "string", "description": "The name of the dimension for which values should be requested." } } }, "MobileCarrier": { "id": "MobileCarrier", "description": "Contains information about a mobile carrier that can be targeted by ads.", "type": "object", "properties": { "id": { "type": "string", "format": "int64", "description": "ID of this mobile carrier." }, "countryCode": { "type": "string", "description": "Country code of the country to which this mobile carrier belongs." }, "name": { "type": "string", "description": "Name of this mobile carrier." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#mobileCarrier\"." }, "countryDartId": { "description": "DART ID of the country to which this mobile carrier belongs.", "type": "string", "format": "int64" } } }, "TargetableRemarketingListsListResponse": { "id": "TargetableRemarketingListsListResponse", "type": "object", "description": "Targetable remarketing list response", "properties": { "targetableRemarketingLists": { "description": "Targetable remarketing list collection.", "type": "array", "items": { "$ref": "TargetableRemarketingList" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#targetableRemarketingListsListResponse\".", "type": "string" }, "nextPageToken": { "description": "Pagination token to be used for the next list operation.", "type": "string" } } }, "LanguageTargeting": { "id": "LanguageTargeting", "properties": { "languages": { "type": "array", "description": "Languages that this ad targets. For each language only languageId is required. The other fields are populated automatically when the ad is inserted or updated.", "items": { "$ref": "Language" } } }, "description": "Language Targeting.", "type": "object" }, "TvCampaignDetail": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#tvCampaignSummary\"." }, "timepoints": { "description": "The timepoints of the TV campaign.", "type": "array", "items": { "$ref": "TvCampaignTimepoint" } }, "id": { "description": "ID of this TV campaign.", "type": "string" } }, "id": "TvCampaignDetail", "type": "object", "description": "TvCampaignDetail contains data from a TV campaign for specific start dates and date windows." }, "FloodlightActivitiesGenerateTagResponse": { "type": "object", "properties": { "globalSiteTagGlobalSnippet": { "type": "string", "description": "The global snippet section of a Google tag. The Google tag sets new cookies on your domain, which will store a unique identifier for a user or the ad click that brought the user to your site. Learn more." }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#floodlightActivitiesGenerateTagResponse\"." }, "floodlightActivityTag": { "type": "string", "description": "Generated tag for this Floodlight activity. For Google tags, this is the event snippet." } }, "id": "FloodlightActivitiesGenerateTagResponse", "description": "Floodlight Activity GenerateTag Response" }, "DateRange": { "id": "DateRange", "properties": { "endDate": { "type": "string", "format": "date" }, "startDate": { "type": "string", "format": "date" }, "relativeDateRange": { "description": "The date range relative to the date of when the report is run.", "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "TODAY", "YESTERDAY", "WEEK_TO_DATE", "MONTH_TO_DATE", "QUARTER_TO_DATE", "YEAR_TO_DATE", "PREVIOUS_WEEK", "PREVIOUS_MONTH", "PREVIOUS_QUARTER", "PREVIOUS_YEAR", "LAST_7_DAYS", "LAST_30_DAYS", "LAST_90_DAYS", "LAST_365_DAYS", "LAST_24_MONTHS", "LAST_14_DAYS", "LAST_60_DAYS" ] }, "kind": { "description": "The kind of resource this is, in this case dfareporting#dateRange.", "type": "string" } }, "type": "object", "description": "Represents a date range." }, "IngestionStatus": { "id": "IngestionStatus", "description": "Contains the ingestion status of the dynamic feed.", "type": "object", "properties": { "numRowsWithErrors": { "description": "Output only. The number of rows with errors in the feed.", "type": "string", "readOnly": true, "format": "int64" }, "numActiveRows": { "type": "string", "description": "Output only. The number of active rows in the feed.", "format": "int64", "readOnly": true }, "numWarningsTotal": { "format": "int64", "type": "string", "readOnly": true, "description": "Output only. The total number of warnings in the feed." }, "numRowsTotal": { "description": "Output only. The total number of rows in the feed.", "type": "string", "readOnly": true, "format": "int64" }, "numRowsProcessed": { "type": "string", "format": "int64", "description": "Output only. The number of rows processed in the feed.", "readOnly": true } } }, "CreativeFieldValue": { "id": "CreativeFieldValue", "type": "object", "description": "Contains properties of a creative field value.", "properties": { "value": { "type": "string", "description": "Value of this creative field value. It needs to be less than 256 characters in length and unique per creative field." }, "id": { "description": "ID of this creative field value. This is a read-only, auto-generated field.", "format": "int64", "type": "string" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#creativeFieldValue\"." } } }, "CampaignCreativeAssociationsListResponse": { "properties": { "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "campaignCreativeAssociations": { "items": { "$ref": "CampaignCreativeAssociation" }, "description": "Campaign creative association collection", "type": "array" }, "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#campaignCreativeAssociationsListResponse\"." } }, "description": "Campaign Creative Association List Response", "type": "object", "id": "CampaignCreativeAssociationsListResponse" }, "AudienceSegment": { "id": "AudienceSegment", "properties": { "allocation": { "format": "int32", "description": "Weight allocated to this segment. The weight assigned will be understood in proportion to the weights assigned to other segments in the same segment group. Acceptable values are 1 to 1000, inclusive.", "type": "integer" }, "name": { "description": "Name of this audience segment. This is a required field and must be less than 65 characters long.", "type": "string" }, "id": { "description": "ID of this audience segment. This is a read-only, auto-generated field.", "format": "int64", "type": "string" } }, "type": "object", "description": "Audience Segment." }, "UserRolesListResponse": { "type": "object", "description": "User Role List Response", "id": "UserRolesListResponse", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#userRolesListResponse\".", "type": "string" }, "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "userRoles": { "items": { "$ref": "UserRole" }, "type": "array", "description": "User role collection." } } }, "SiteCompanionSetting": { "description": "Companion Settings", "id": "SiteCompanionSetting", "type": "object", "properties": { "enabledSizes": { "type": "array", "items": { "$ref": "Size" }, "description": "Allowlist of companion sizes to be served via this site template. Set this list to null or empty to serve all companion sizes." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#siteCompanionSetting\".", "type": "string" }, "imageOnly": { "description": "Whether to serve only static images as companions.", "type": "boolean" }, "companionsDisabled": { "description": "Whether companions are disabled for this site template.", "type": "boolean" } } }, "ContextualKeyword": { "properties": { "keyword": { "description": "The keyword that can be targeted by ads.", "type": "string" } }, "description": "Contains information about a Contextual Keyword that can be targeted by ads.", "id": "ContextualKeyword", "type": "object" }, "ConversionError": { "id": "ConversionError", "type": "object", "description": "The error code and description for a conversion that failed to insert or update.", "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#conversionError\"." }, "message": { "description": "A description of the error.", "type": "string" }, "code": { "description": "The error code.", "type": "string", "enum": [ "INVALID_ARGUMENT", "INTERNAL", "PERMISSION_DENIED", "NOT_FOUND" ], "enumDescriptions": [ "", "", "", "" ] } } }, "FrequencyCap": { "type": "object", "description": "Frequency Cap.", "id": "FrequencyCap", "properties": { "impressions": { "format": "int64", "description": "Number of times an individual user can be served the ad within the specified duration. Acceptable values are 1 to 15, inclusive.", "type": "string" }, "duration": { "description": "Duration of time, in seconds, for this frequency cap. The maximum duration is 90 days. Acceptable values are 1 to 7776000, inclusive.", "format": "int64", "type": "string" } } }, "DimensionValue": { "type": "object", "properties": { "etag": { "type": "string", "description": "The eTag of this response for caching purposes." }, "dimensionName": { "type": "string", "description": "The name of the dimension." }, "value": { "description": "The value of the dimension.", "type": "string" }, "kind": { "description": "The kind of resource this is, in this case dfareporting#dimensionValue.", "type": "string" }, "matchType": { "description": "Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.", "type": "string", "enum": [ "EXACT", "BEGINS_WITH", "CONTAINS", "WILDCARD_EXPRESSION" ], "enumDescriptions": [ "", "", "", "" ] }, "id": { "description": "The ID associated with the value if available.", "type": "string" } }, "id": "DimensionValue", "description": "Represents a DimensionValue resource." }, "CreativeClickThroughUrl": { "properties": { "customClickThroughUrl": { "description": "Custom click-through URL. Applicable if the landingPageId field is left unset.", "type": "string" }, "computedClickThroughUrl": { "type": "string", "description": "Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: - If landingPageId is specified then that landing page's URL is assigned to this field. - Otherwise, the customClickThroughUrl is assigned to this field. " }, "landingPageId": { "description": "ID of the landing page for the click-through URL.", "type": "string", "format": "int64" } }, "type": "object", "id": "CreativeClickThroughUrl", "description": "Click-through URL" }, "AdvertiserLandingPagesListResponse": { "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "Pagination token to be used for the next list operation." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#advertiserLandingPagesListResponse\".", "type": "string" }, "landingPages": { "description": "Landing page collection", "type": "array", "items": { "$ref": "LandingPage" } } }, "description": "Landing Page List Response", "id": "AdvertiserLandingPagesListResponse" }, "BrowsersListResponse": { "properties": { "kind": { "type": "string", "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#browsersListResponse\"." }, "browsers": { "description": "Browser collection.", "items": { "$ref": "Browser" }, "type": "array" } }, "type": "object", "description": "Browser List Response", "id": "BrowsersListResponse" }, "StudioCreativeDimension": { "type": "object", "properties": { "width": { "description": "Width of the studio creative.", "format": "int32", "type": "integer" }, "height": { "format": "int32", "description": "Height of the studio creative.", "type": "integer" } }, "description": "Dimension information for a studio creative.", "id": "StudioCreativeDimension" }, "Placement": { "description": "Contains properties of a placement.", "properties": { "placementGroupId": { "type": "string", "description": "ID of this placement's group, if applicable.", "format": "int64" }, "placementGroupIdDimensionValue": { "description": "Dimension value for the ID of the placement group. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "vpaidAdapterChoice": { "enumDescriptions": [ "DEFAULT means Google chooses which adapter, if any, to serve.", "", "", "" ], "type": "string", "enum": [ "DEFAULT", "FLASH", "HTML5", "BOTH" ], "description": "VPAID adapter setting for this placement. Controls which VPAID format the measurement adapter will use for in-stream video creatives assigned to this placement. *Note:* Flash is no longer supported. This field now defaults to HTML5 when the following values are provided: FLASH, BOTH." }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"dfareporting#placement\".", "type": "string" }, "subaccountId": { "type": "string", "description": "Subaccount ID of this placement. This field can be left blank.", "format": "int64" }, "siteIdDimensionValue": { "description": "Dimension value for the ID of the site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "keyName": { "type": "string", "description": "Key name of this placement. This is a read-only, auto-generated field." }, "siteId": { "type": "string", "description": "Site ID associated with this placement. On insert, you must set either this field or the directorySiteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.", "format": "int64" }, "contentCategoryId": { "type": "string", "format": "int64", "description": "ID of the content category assigned to this placement." }, "paymentApproved": { "description": "Whether payment was approved for this placement. This is a read-only field relevant only to publisher-paid placements.", "type": "boolean" }, "youtubeSettings": { "description": "Optional. YouTube settings for the placement. The placement must be enabled for YouTube to use this field.", "$ref": "YoutubeSettings" }, "activeStatus": { "description": "Whether this placement is active, inactive, archived or permanently archived.", "enumDescriptions": [ "", "", "", "", "" ], "type": "string", "enum": [ "PLACEMENT_STATUS_UNKNOWN", "PLACEMENT_STATUS_ACTIVE", "PLACEMENT_STATUS_INACTIVE", "PLACEMENT_STATUS_ARCHIVED", "PLACEMENT_STATUS_PERMANENTLY_ARCHIVED" ] }, "adBlockingOptOut": { "type": "boolean", "description": "Whether this placement opts out of ad blocking. When true, ad blocking is disabled for this placement. When false, the campaign and site settings take effect." }, "additionalSizes": { "description": "Additional sizes associated with this placement. When inserting or updating a placement, only the size ID field is used.", "items": { "$ref": "Size" }, "type": "array" }, "advertiserIdDimensionValue": { "description": "Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "sslRequired": { "description": "Whether creatives assigned to this placement must be SSL-compliant.", "type": "boolean" }, "allowOnYoutube": { "description": "Optional. Whether the placement is enabled for YouTube integration.", "type": "boolean" }, "wrappingOptOut": { "description": "Whether this placement opts out of tag wrapping.", "type": "boolean" }, "paymentSource": { "enumDescriptions": [ "", "" ], "description": "Payment source for this placement. This is a required field that is read-only after insertion.", "type": "string", "enum": [ "PLACEMENT_AGENCY_PAID", "PLACEMENT_PUBLISHER_PAID" ] }, "adServingPlatformId": { "type": "string", "format": "int64", "description": "Optional. Ad serving platform ID to identify the ad serving platform used by the placement. Measurement partners can use this field to add ad-server specific macros. Possible values are: * `1`, Adelphic * `2`, Adform * `3`, Adobe * `4`, Amobee * `5`, Basis (Centro) * `6`, Beeswax * `7`, Amazon * `8`, DV360 (DBM) * `9`, Innovid * `10`, MediaMath * `11`, Roku OneView DSP * `12`, TabMo Hawk * `13`, The Trade Desk * `14`, Xandr Invest DSP * `15`, Yahoo DSP * `16`, Zeta Global * `17`, Scaleout * `18`, Bidtellect * `19`, Unicorn * `20`, Teads * `21`, Quantcast * `22`, Cognitiv * `23`, AdTheorent * `24`, DeepIntent * `25`, Pulsepoint" }, "directorySiteId": { "format": "int64", "description": "Directory site ID of this placement. On insert, you must set either this field or the siteId field to specify the site associated with this placement. This is a required field that is read-only after insertion.", "type": "string" }, "lookbackConfiguration": { "$ref": "LookbackConfiguration", "description": "Lookback window settings for this placement." }, "directorySiteIdDimensionValue": { "description": "Dimension value for the ID of the directory site. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "compatibility": { "type": "string", "enum": [ "DISPLAY", "DISPLAY_INTERSTITIAL", "APP", "APP_INTERSTITIAL", "IN_STREAM_VIDEO", "IN_STREAM_AUDIO" ], "description": "Placement compatibility. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering on desktop, on mobile devices or in mobile apps for regular or interstitial ads respectively. APP and APP_INTERSTITIAL are no longer allowed for new placement insertions. Instead, use DISPLAY or DISPLAY_INTERSTITIAL. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. This field is required on insertion.", "enumDescriptions": [ "", "", "Deprecated enum value. No longer supported.", "Deprecated enum value. No longer supported.", "", "" ] }, "externalId": { "type": "string", "description": "External ID for this placement." }, "comment": { "description": "Comments for this placement.", "type": "string" }, "campaignId": { "type": "string", "format": "int64", "description": "Campaign ID of this placement. This field is a required field on insertion." }, "status": { "description": "Third-party placement status.", "enumDescriptions": [ "Placement is not yet reviewed by publisher.", "Placement Ad Serving fee is accepted by publisher", "Placement Ad Serving fee is rejected by publisher", "Advertisers has accepted rejection of placement ad serving fee. This will suppress future notification on DDMM UI", "Advertisers has accepted acceptance of placement ad serving fee. This will suppress future notification on DDMM UI", "Advertisers is still working on placement not yet ready for Publisher review; default status for pub-paid placements" ], "type": "string", "enum": [ "PENDING_REVIEW", "PAYMENT_ACCEPTED", "PAYMENT_REJECTED", "ACKNOWLEDGE_REJECTION", "ACKNOWLEDGE_ACCEPTANCE", "DRAFT" ] }, "createInfo": { "$ref": "LastModifiedInfo", "description": "Information about the creation of this placement. This is a read-only field." }, "pricingSchedule": { "$ref": "PricingSchedule", "description": "Pricing schedule of this placement. This field is required on insertion, specifically subfields startDate, endDate and pricingType." }, "tagSetting": { "$ref": "TagSetting", "description": "Tag settings for this placement." }, "partnerWrappingData": { "$ref": "MeasurementPartnerWrappingData", "description": "Measurement partner provided settings for a wrapped placement." }, "videoActiveViewOptOut": { "description": "Whether Verification and ActiveView are disabled for in-stream video creatives for this placement. The same setting videoActiveViewOptOut exists on the site level -- the opt out occurs if either of these settings are true. These settings are distinct from DirectorySites.settings.activeViewOptOut or Sites.siteSettings.activeViewOptOut which only apply to display ads. However, Accounts.activeViewOptOut opts out both video traffic, as well as display ads, from Verification and ActiveView.", "type": "boolean" }, "advertiserId": { "format": "int64", "description": "Advertiser ID of this placement. This field can be left blank.", "type": "string" }, "size": { "description": "Size associated with this placement. When inserting or updating a placement, only the size ID field is used. This field is required on insertion.", "$ref": "Size" }, "tagFormats": { "description": "Tag formats to generate for this placement. This field is required on insertion. Acceptable values are: - \"PLACEMENT_TAG_STANDARD\" - \"PLACEMENT_TAG_IFRAME_JAVASCRIPT\" - \"PLACEMENT_TAG_IFRAME_ILAYER\" - \"PLACEMENT_TAG_INTERNAL_REDIRECT\" - \"PLACEMENT_TAG_JAVASCRIPT\" - \"PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT\" - \"PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT\" - \"PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT\" - \"PLACEMENT_TAG_CLICK_COMMANDS\" - \"PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH\" - \"PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3\" - \"PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4\" - \"PLACEMENT_TAG_TRACKING\" - \"PLACEMENT_TAG_TRACKING_IFRAME\" - \"PLACEMENT_TAG_TRACKING_JAVASCRIPT\" ", "items": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string", "enum": [ "PLACEMENT_TAG_STANDARD", "PLACEMENT_TAG_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_IFRAME_ILAYER", "PLACEMENT_TAG_INTERNAL_REDIRECT", "PLACEMENT_TAG_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT", "PLACEMENT_TAG_INTERSTITIAL_INTERNAL_REDIRECT", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT", "PLACEMENT_TAG_CLICK_COMMANDS", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH", "PLACEMENT_TAG_TRACKING", "PLACEMENT_TAG_TRACKING_IFRAME", "PLACEMENT_TAG_TRACKING_JAVASCRIPT", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_3", "PLACEMENT_TAG_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_IFRAME_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INTERSTITIAL_JAVASCRIPT_LEGACY", "PLACEMENT_TAG_INSTREAM_VIDEO_PREFETCH_VAST_4", "PLACEMENT_TAG_TRACKING_THIRD_PARTY_MEASUREMENT" ] }, "type": "array" }, "conversionDomainOverride": { "description": "Optional. Conversion domain overrides for a placement.", "$ref": "PlacementConversionDomainOverride" }, "primary": { "type": "boolean", "description": "Whether this placement is the primary placement of a roadblock (placement group). You cannot change this field from true to false. Setting this field to true will automatically set the primary field on the original primary placement of the roadblock to false, and it will automatically set the roadblock's primaryPlacementId field to the ID of this placement." }, "name": { "description": "Name of this placement.This is a required field and must be less than or equal to 512 characters long.", "type": "string" }, "placementStrategyId": { "format": "int64", "description": "ID of the placement strategy assigned to this placement.", "type": "string" }, "videoSettings": { "description": "A collection of settings which affect video creatives served through this placement. Applicable to placements with IN_STREAM_VIDEO compatibility.", "$ref": "VideoSettings" }, "campaignIdDimensionValue": { "description": "Dimension value for the ID of the campaign. This is a read-only, auto-generated field.", "$ref": "DimensionValue" }, "siteServed": { "type": "boolean", "description": "Optional. Whether the ads in the placement are served by another platform and CM is only used for tracking or they are served by CM. A false value indicates the ad is served by CM." }, "id": { "format": "int64", "description": "ID of this placement. This is a read-only, auto-generated field.", "type": "string" }, "idDimensionValue": { "$ref": "DimensionValue", "description": "Dimension value for the ID of this placement. This is a read-only, auto-generated field." }, "publisherUpdateInfo": { "$ref": "LastModifiedInfo", "description": "Information about the last publisher update. This is a read-only field." }, "accountId": { "type": "string", "description": "Account ID of this placement. This field can be left blank.", "format": "int64" }, "lastModifiedInfo": { "$ref": "LastModifiedInfo", "description": "Information about the most recent modification of this placement. This is a read-only field." } }, "id": "Placement", "type": "object" }, "KeyValueTargetingExpression": { "properties": { "expression": { "type": "string", "description": "Keyword expression being targeted by the ad." } }, "id": "KeyValueTargetingExpression", "type": "object", "description": "Key Value Targeting Expression." } }, "name": "dfareporting", "version": "v5" }