Contains an object value. This object is experimental! <code>ObjectValue</code> is an experimental, innovative, and rapidly changing new feature for Ad Manager. Unfortunately, being on the bleeding edge means that we may make backwards-incompatible changes to <code>ObjectValue</code>. We will inform the community when this feature is no longer experimental. The action used for resuming {@link AdRule} objects. Represents the actions that can be performed on {@link AdRule} objects. Lists all errors associated with ad rule start and end dates. An {@link AdRule} contains data that the ad server will use to generate a playlist of video ads. The unique ID of the {@link AdRule}. This value is readonly and is assigned by Google. The unique name of the {@link AdRule}. This attribute is required to create an ad rule and has a maximum length of 255 characters. The priority of the {@link AdRule}. This attribute is required and can range from 1 to 1000, with 1 being the highest possible priority. Changing an ad rule's priority can affect the priorities of other ad rules. For example, increasing an ad rule's priority from 5 to 1 will shift the ad rules that were previously in priority positions 1 through 4 down one. The targeting criteria of the {@link AdRule}. This attribute is required. This {@link AdRule} object's start date and time. This attribute is required and must be a date in the future for new ad rules. Specifies whether to start using the {@link AdRule} right away, in an hour, etc. This attribute is optional and defaults to {@link StartDateTimeType#USE_START_DATE_TIME}. This {@link AdRule} object's end date and time. This attribute is required unless {@code unlimitedEndDateTime} is set to {@code true}. If specified, it must be after the {@code startDateTime}. Specifies whether the {@link AdRule} has an end time. This attribute is optional and defaults to false. The {@link AdRuleStatus} of the ad rule. This attribute is read-only and defaults to {@link AdRuleStatus#INACTIVE}. The {@link FrequencyCapBehavior} of the {@link AdRule}. This attribute is optional and defaults to {@link FrequencyCapBehavior#DEFER}. This {@link AdRule} object's frequency cap for the maximum impressions per stream. This attribute is optional and defaults to 0. This {@link AdRule} object's frequency cap for the maximum impressions per pod. This attribute is optional and defaults to 0. This {@link AdRule} object's pre-roll slot. This attribute is required. This {@link AdRule} object's mid-roll slot. This attribute is required. This {@link AdRule} object's post-roll slot. This attribute is required. Errors ad rule break template objects. Errors related to ad rule frequency caps An ad rule slot with no podding. It is defined by a {@link BaseAdRuleSlot#maxVideoAdDuration}. Ad rule slot with optimized podding. Optimized pods are defined by a {@link BaseAdRuleSlot#maxPodDuration} and a {@link BaseAdRuleSlot#maxAdsInPod}, and the ad server chooses the best ads for the alloted duration. Captures a page of {@link AdRule} objects. The size of the total result set to which this page belongs. The absolute index in the total result set on which this page begins. The collection of ad rules contained within this page. Errors associated with ad rule priorities. Simple object representing an ad slot within an {@link AdRule}. Ad rule slots contain information about the types/number of ads to display, as well as additional information on how the ad server will generate playlists. The {@link AdRuleSlotBehavior} for video ads for this slot. This attribute is optional and defaults to {@link AdRuleSlotBehavior#DEFER}. Indicates whether video ads are allowed for this slot, or if the decision is deferred to a lower-priority ad rule. The maximum duration in milliseconds of video ads within this slot. This attribute is optional and defaults to 0. The frequency type for video ads in this ad rule slot. This attribute is required for mid-rolls, but if this is not a mid-roll, the value is set to {@link MidrollFrequencyType#NONE}. The mid-roll frequency of this ad rule slot for video ads. This attribute is required for mid-rolls, but if {@link MidrollFrequencyType} is set to {@link MidrollFrequencyType#NONE}, this value should be ignored. For example, if this slot has a frequency type of {@link MidrollFrequencyType#EVERY_N_SECONDS} and {@code #videoMidrollFrequency} = "60", this would mean " play a mid-roll every 60 seconds." The {@link AdRuleSlotBumper} for this slot. This attribute is optional and defaults to {@link AdRuleSlotBumper#NONE}. The maximum duration of bumper ads within this slot. This attribute is optional and defaults to 0. The maximum pod duration in milliseconds for this slot. This attribute is optional and defaults to 0. The maximum number of ads allowed in a pod in this slot. This attribute is optional and defaults to 0. ID of a {@link BreakTemplate} that defines what kinds of ads show at which positions within this slot. This field is optional and only supported on {@link OptimizedPoddingAdRuleSlot} entities. Errors related to ad rule slots. An ad rule slot with standard podding. A standard pod is a series of video ads played back to back. Standard pods are defined by a {@link BaseAdRuleSlot#maxAdsInPod} and a {@link BaseAdRuleSlot#maxVideoAdDuration}. Lists all errors associated with ad rule targeting. A {@link AdSpot} is a targetable entity used in the creation of {@link AdRule} objects. A ad spot contains a variable number of ads and has constraints (ad duration, reservation type, etc) on the ads that can appear in it. The unique ID of the {@link AdSpot}. This value is readonly and is assigned by Google. Name of the {@link AdSpot}. The name is case insenstive and can be referenced in ad tags. This value is required if {@code customSpot} is true, and cannot be set otherwise. You can use alphanumeric characters and symbols other than the following: ", ', =, !, +, #, *, ~, ;, ^, (, ), <, >, [, ], the white space character. Descriptive name for the {@link AdSpot}.This value is optional if {@code customSpot} is true, and cannot be set otherwise. Whether this ad spot is a custom spot. This field is optional and defaults to false. Custom spots can be reused and targeted in the targeting picker. Whether this ad spot is a flexible spot. This field is optional and defaults to false. Flexible spots are allowed to have no max number of ads. The maximum total duration for this {@link AdSpot}. This field is optional, defaults to 0, and supports precision to the nearest second. The maximum number of ads allowed in the {@link AdSpot}. This field is optional and defaults to O. A {@code maxNumberOfAds} of 0 means that there is no maximum for the number of ads in the ad spot. No max ads is only supported for ad spots that have {@code flexible} set to true. The {@link SubpodTargetingType} determines how this ad spot can be targeted. This field is required. Whether backfill is blocked in this ad spot. This field is optional and defaults to false. The set of line item types that may appear in the ad spot. This field is optional and defaults to an empty set, which means that all types are allowed. Note, backfill reservation types are controlled via the {@code backfillBlocked} field. Whether inventory sharing is blocked in this ad spot. This field is optional and defaults to false. Captures a page of {@link AdSpot} objects. The size of the total result set to which this page belongs. The absolute index in the total result set on which this page begins. The collection of ad spot contained within this page. Represents targeted or excluded ad units. Included or excluded ad unit id. Whether or not all descendants are included (or excluded) as part of including (or excluding) this ad unit. By default, the value is {@code true} which means targeting this ad unit will target all of its descendants. The API error base class that provides details about an error that occurred while processing a service request. The OGNL field path is provided for parsers to identify the request data element that may have caused the error. The OGNL field path to identify cause of error. A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}. The data that caused the error. A simple string representation of the error and reason. Exception class for holding a list of service errors. List of errors. Provides {@link LineItem} objects the ability to target or exclude technologies. The bandwidth groups being targeted by the {@link LineItem}. The browsers being targeted by the {@link LineItem}. The languages of browsers being targeted by the {@link LineItem}. The device capabilities being targeted by the {@link LineItem}. The device categories being targeted by the {@link LineItem}. The device manufacturers being targeted by the {@link LineItem}. The mobile carriers being targeted by the {@link LineItem}. The mobile devices being targeted by the {@link LineItem}. The mobile device submodels being targeted by the {@link LineItem}. The operating systems being targeted by the {@link LineItem}. The operating system versions being targeted by the {@link LineItem}. Errors related to the usage of API versions. Base class for exceptions. Error message. An error for an exception that occurred when authenticating. Represents a group of bandwidths that are logically organized by some well known generic names such as 'Cable' or 'DSL'. Represents bandwidth groups that are being targeted or excluded by the {@link LineItem}. Indicates whether bandwidth groups should be targeted or excluded. This attribute is optional and defaults to {@code true}. The bandwidth groups that are being targeted or excluded by the {@link LineItem}. Contains a boolean value. The boolean value. A {@link BreakTemplate} defines what kinds of ads show at which positions within a pod. Break templates are made up of {@link AdSpot} objects. A break template must have a single ad spot that has {@code AdSpot#flexible} set to true. The unique ID of the {@link BreakTemplate}. This value is readonly and is assigned by Google. Whether this is custom template. Custom templates get created outside of the ad rule workflow and can be referenced in ad tags. Only custom templates can have names and display names. Name of the {@link BreakTemplate}. The name is case insenstive and can be referenced in ad tags. This value is required if {@code customTemplate} is true, and cannot be set otherwise. You can use alphanumeric characters and symbols other than the following: ", ', =, !, +, #, *, ~, ;, ^, (, ), <, >, [, ], the white space character. Descriptive name for the {@link BreakTemplateDto}. This value is optional if {@code customTemplate} is true, and cannot be set otherwise. The list of the {@link BreakTemplateMember} objects in the order in which they should appear in the ad pod. Each {@link BreakTemplateMember} has a reference to a {@link AdSpot}, which defines what kinds of ads can appear at that position, as well as other metadata that defines how each ad spot should be filled. A building block of a pod template. The ID of the {@link AdSpot} that has the settings about what kinds of ads can appear in this position of the {@link BreakTemplate}. The behavior for how the {@link AdSpot} should be filled in the context of the {@link BreakTemplate}. Captures a page of {@link BreakTemplate} objects. The size of the total result set to which this page belongs. The absolute index in the total result set on which this page begins. The collection of break templates contained within this page. Represents an internet browser. Browser major version. Browser minor version. Represents a Browser's language. Represents browser languages that are being targeted or excluded by the {@link LineItem}. Indicates whether browsers languages should be targeted or excluded. This attribute is optional and defaults to {@code true}. Browser languages that are being targeted or excluded by the {@link LineItem}. Represents browsers that are being targeted or excluded by the {@link LineItem}. Indicates whether browsers should be targeted or excluded. This attribute is optional and defaults to {@code true}. Browsers that are being targeted or excluded by the {@link LineItem}. The {@code BuyerUserListTargeting} associated with a programmatic {@link LineItem} or {@link ProposalLineItem} object. Whether the programmatic {@code LineItem} or {@code ProposalLineItem} object has buyer user list targeting. Error for the size of the collection being too large A place for common errors that can be used across services. Used to target {@link LineItem}s to specific videos on a publisher's site. The IDs of content being targeted by the {@code LineItem}. The IDs of content being excluded by the {@code LineItem}. A list of video content bundles, represented by {@link ContentBundle} IDs, that are being targeted by the {@code LineItem}. A list of video content bundles, represented by {@link ContentBundle} IDs, that are being excluded by the {@code LineItem}. A {@link CustomCriteria} object is used to perform custom criteria targeting on custom targeting keys of type {@link CustomTargetingKey.Type#PREDEFINED} or {@link CustomTargetingKey.Type#FREEFORM}. The {@link CustomTargetingKey#id} of the {@link CustomTargetingKey} object that was created using {@link CustomTargetingService}. This attribute is required. The ids of {@link CustomTargetingValue} objects to target the custom targeting key with id {@link CustomCriteria#keyId}. This attribute is required. The comparison operator. This attribute is required. A {@link CustomCriteriaSet} comprises of a set of {@link CustomCriteriaNode} objects combined by the {@link CustomCriteriaSet.LogicalOperator#logicalOperator}. The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}. The logical operator to be applied to {@link CustomCriteriaSet#children}. This attribute is required. This attribute is required. The custom criteria. This attribute is required. A {@code CmsMetadataCriteria} object is used to target {@code CmsMetadataValue} objects. The comparison operator. This attribute is required. The ids of {@link CmsMetadataValue} objects used to target CMS metadata. This attribute is required. Lists all errors related to {@link CustomTargetingKey} and {@link CustomTargetingValue} objects. A {@link CustomCriteriaLeaf} object represents a generic leaf of {@link CustomCriteria} tree structure. A {@link CustomCriteriaNode} is a node in the custom targeting tree. A custom criteria node can either be a {@link CustomCriteriaSet} (a non-leaf node) or a {@link CustomCriteria} (a leaf node). The custom criteria targeting tree is subject to the rules defined on {@link Targeting#customTargeting}. An {@link AudienceSegmentCriteria} object is used to target {@link AudienceSegment} objects. The comparison operator. This attribute is required. The ids of {@link AudienceSegment} objects used to target audience segments. This attribute is required. Represents a date. Year (e.g., 2009) Month (1..12) Day (1..31) Represents a date combined with the time of day. Represents a range of dates (combined with time of day) that has an upper and/or lower bound. The start date time of this range. This field is optional and if it is not set then there is no lower bound on the date time range. If this field is not set then {@code endDateTime} must be specified. The end date time of this range. This field is optional and if it is not set then there is no upper bound on the date time range. If this field is not set then {@code startDateTime} must be specified. The date time ranges that the line item is eligible to serve. Contains a date-time value. The {@code DateTime} value. Contains a date value. The {@code Date} value. {@code DayPart} represents a time-period within a day of the week which is targeted by a {@link LineItem}. Day of the week the target applies to. This field is required. Represents the start time of the targeted period (inclusive). Represents the end time of the targeted period (exclusive). Modify the delivery times of line items for particular days of the week. By default, line items are served at all days and times. Specifies days of the week and times at which a {@code LineItem} will be delivered. If targeting all days and times, this value will be ignored. Specifies the time zone to be used for delivering {@link LineItem} objects. This attribute is optional and defaults to {@link DeliveryTimeZone#BROWSER}. Setting this has no effect if targeting all days and times. The action used for pausing {@link AdRule} objects. The action used for deleting {@link AdRule} objects. Represents a capability of a physical device. Represents device capabilities that are being targeted or excluded by the {@link LineItem}. Device capabilities that are being targeted by the {@link LineItem}. Device capabilities that are being excluded by the {@link LineItem}. Represents the category of a device. Represents device categories that are being targeted or excluded by the {@link LineItem}. Device categories that are being targeted by the {@link LineItem}. Device categories that are being excluded by the {@link LineItem}. Represents a mobile device's manufacturer. Represents device manufacturer that are being targeted or excluded by the {@link LineItem}. Indicates whether device manufacturers should be targeted or excluded. This attribute is optional and defaults to {@code true}. Device manufacturers that are being targeted or excluded by the {@link LineItem}. Errors related to feature management. If you attempt using a feature that is not available to the current network you'll receive a FeatureError with the missing feature as the trigger. A segment of a field path. Each dot in a field path defines a new segment. The name of a field in lower camelcase. (e.g. "biddingStrategy") For list fields, this is a 0-indexed position in the list. Null for non-list fields. Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same. The following rules apply for geographical targeting: <ul> <li>You cannot target and exclude the same location. <li>You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago. <li>You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations. <li>You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California. </ul> The geographical locations being targeted by the {@link LineItem}. The geographical locations being excluded by the {@link LineItem}. Lists all errors associated with geographical targeting for a {@link LineItem}. The error reason represented by an enum. Indicates that a server-side error has occured. {@code InternalApiError}s are generally not the result of an invalid request or message sent by the client. The error reason represented by an enum. Represents a collection of targeted and excluded inventory sizes. This is currently only available on {@link YieldGroup} and {@link TrafficDataRequest}. Whether the inventory sizes should be targeted or excluded. A list of {@link TargetedSizeDto}s. A collection of targeted and excluded ad units and placements. A list of targeted {@link AdUnitTargeting}. A list of excluded {@link AdUnitTargeting}. A list of targeted {@link Placement} ids. Lists all inventory errors caused by associating a line item with a targeting expression. The error reason represented by an enum. The representation of an inventory Url that is used in targeting. A collection of targeted inventory urls. A {@link Location} represents a geographical entity that can be targeted. If a location type is not available because of the API version you are using, the location will be represented as just the base class, otherwise it will be sub-classed correctly. Uniquely identifies each {@code Location}. The location type for this geographical entity (ex. "COUNTRY", "CITY", "STATE", "COUNTY", etc.) The nearest location parent's ID for this geographical entity. The localized name of the geographical entity. Provides line items the ability to target or exclude users' mobile applications. The {@link MobileApplication#applicationId IDs} that are being targeted or excluded by the {@link LineItem}. Indicates whether mobile apps should be targeted or excluded. This attribute is optional and defaults to {@code true}. Represents a mobile carrier. Carrier targeting is only available to Ad Manager mobile publishers. For a list of current mobile carriers, you can use {@link PublisherQueryLanguageService#mobile_carrier}. Represents mobile carriers that are being targeted or excluded by the {@link LineItem}. Indicates whether mobile carriers should be targeted or excluded. This attribute is optional and defaults to {@code true}. Mobile carriers that are being targeted or excluded by the {@link LineItem}. Represents a Mobile Device. Manufacturer Id. Represents a mobile device submodel. The mobile device id. The device manufacturer id. Represents mobile devices that are being targeted or excluded by the {@link LineItem}. Mobile device submodels that are being targeted by the {@link LineItem}. Mobile device submodels that are being excluded by the {@link LineItem}. Represents mobile devices that are being targeted or excluded by the {@link LineItem}. Mobile devices that are being targeted by the {@link LineItem}. Mobile devices that are being excluded by the {@link LineItem}. Caused by supplying a null value for an attribute that cannot be null. The error reason represented by an enum. Contains a numeric value. The numeric value represented as a string. Represents an Operating System, such as Linux, Mac OS or Windows. Represents operating systems that are being targeted or excluded by the {@link LineItem}. Indicates whether operating systems should be targeted or excluded. This attribute is optional and defaults to {@code true}. Operating systems that are being targeted or excluded by the {@link LineItem}. Represents a specific version of an operating system. The operating system major version. The operating system minor version. The operating system micro version. Represents operating system versions that are being targeted or excluded by the {@link LineItem}. Operating system versions that are being targeted by the {@link LineItem}. Operating system versions that are being excluded by the {@link LineItem}. Lists errors related to parsing. The error reason represented by an enum. Errors related to incorrect permission. Errors related to podding fields in ad rule slots. An error that occurs while executing a PQL query contained in a {@link Statement} object. The error reason represented by an enum. An error that occurs while parsing a PQL query contained in a {@link Statement} object. The error reason represented by an enum. Describes a client-side error on which a user is attempting to perform an action to which they have no quota remaining. Provides line items the ability to target the platform that requests and renders the ad. The following rules apply for {@link RequestPlatformTargeting} <ul> <li>{@link RequestPlatformTargeting} must be specified for {@link ProposalLineItem}s. <li>{@link RequestPlatformTargeting} must be specified for video line items. Empty values for {@link RequestPlatformTargeting#targetedRequestPlatforms} mean that all request platforms will be targeted. <li>{@link RequestPlatformTargeting} is read-only and assigned by Google for non-video line items. <li>{@link RequestPlatformTargeting} is read-only and assigned by Google for line items generated from proposal line items. </ul> A list of all errors to be used for validating sizes of collections. Errors due to missing required field. The error reason represented by an enum. A list of all errors to be used in conjunction with required number validators. Errors related to the server. Contains a set of {@link Value Values}. May not contain duplicates. The values. They must all be the same type of {@code Value} and not contain duplicates. Represents the dimensions of an {@link AdUnit}, {@link LineItem} or {@link Creative}. For interstitial size (out-of-page), native, ignored and fluid size, {@link Size} must be 1x1. The width of the {@link AdUnit}, {@link LineItem} or {@link Creative}. The height of the {@link AdUnit}, {@link LineItem} or {@link Creative}. Whether this size represents an aspect ratio. Represents the SOAP request header used by API requests. The network code to use in the context of a request. The name of client library application. Represents the SOAP request header used by API responses. Captures the {@code WHERE}, {@code ORDER BY} and {@code LIMIT} clauses of a PQL query. Statements are typically used to retrieve objects of a predefined domain type, which makes SELECT clause unnecessary. An example query text might be {@code "WHERE status = 'ACTIVE' ORDER BY id LIMIT 30"}. Statements support bind variables. These are substitutes for literals and can be thought of as input parameters to a PQL query. An example of such a query might be {@code "WHERE id = :idValue"}. Statements also support use of the LIKE keyword. This provides wildcard string matching. An example of such a query might be {@code "WHERE name LIKE '%searchString%'"}. The value for the variable idValue must then be set with an object of type {@link Value}, e.g., {@link NumberValue}, {@link TextValue} or {@link BooleanValue}. Holds the query in PQL syntax. The syntax is: <code>[WHERE <condition> {[AND | OR] <condition> ...}]</code> <code>[ORDER BY <property> [ASC | DESC]]</code> <code>[LIMIT {[<offset>,] <count>} | {<count> OFFSET <offset>}]</code> <code><condition></code>      <code>:= <property> {< | <= | > | >= | = | != } <value></code> <code><condition></code>      <code>:= <property> {< | <= | > | >= | = | != } <bind variable></code> <code><condition> := <property> IN <list></code> <code><condition> := <property> IS NULL</code> <code><condition> := <property> LIKE <wildcard%match></code> <code><bind variable> := :<name></code> Holds keys and values for bind variables and their values. The key is the name of the bind variable. The value is the literal value of the variable. In the example {@code "WHERE status = :bindStatus ORDER BY id LIMIT 30"}, the bind variable, represented by {@code :bindStatus} is named {@code bindStatus}, which would also be the parameter map key. The bind variable's value would be represented by a parameter map value of type {@link TextValue}. The final result, for example, would be an entry of {@code "bindStatus" => StringParam("ACTIVE")}. An error that occurs while parsing {@link Statement} objects. The error reason represented by an enum. A list of error code for reporting invalid content of input strings. Errors for Strings which do not meet given length constraints. This represents an entry in a map with a key of type String and value of type Value. A size that is targeted on a request. Contains targeting criteria for {@link LineItem} objects. See {@link LineItem#targeting}. Specifies what geographical locations are targeted by the {@link LineItem}. This attribute is optional. Specifies what inventory is targeted by the {@link LineItem}. This attribute is required. The line item must target at least one ad unit or placement. Specifies the days of the week and times that are targeted by the {@link LineItem}. This attribute is optional. Specifies the dates and time ranges that are targeted by the {@link LineItem}. This attribute is optional. Specifies the browsing technologies that are targeted by the {@link LineItem}. This attribute is optional. Specifies the collection of custom criteria that is targeted by the {@link LineItem}. Once the {@link LineItem} is updated or modified with custom targeting, the server may return a normalized, but equivalent representation of the custom targeting expression. {@code customTargeting} will have up to three levels of expressions including itself. The top level {@code CustomCriteriaSet} i.e. the {@code customTargeting} object can only contain a {@link CustomCriteriaSet.LogicalOperator#OR} of all its children. The second level of {@code CustomCriteriaSet} objects can only contain {@link CustomCriteriaSet.LogicalOperator#AND} of all their children. If a {@link CustomCriteria} is placed on this level, the server will wrap it in a {@link CustomCriteriaSet}. The third level can only comprise of {@link CustomCriteria} objects. The resulting custom targeting tree would be of the form: <img src="https://chart.apis.google.com/chart?cht=gv&chl=digraph{customTargeting_LogicalOperator_OR-%3ECustomCriteriaSet_LogicalOperator_AND_1-%3ECustomCriteria_1;CustomCriteriaSet_LogicalOperator_AND_1-%3Eellipsis1;customTargeting_LogicalOperator_OR-%3Eellipsis2;ellipsis1[label=%22...%22,shape=none,fontsize=32];ellipsis2[label=%22...%22,shape=none,fontsize=32]}&chs=450x200"/> Specifies the domains or subdomains that are targeted or excluded by the {@link LineItem}. Users visiting from an IP address associated with those domains will be targeted or excluded. This attribute is optional. Specifies the video categories and individual videos targeted by the {@link LineItem}. Specifies targeting against video position types. Specifies targeting against mobile applications. Specifies whether buyer user lists are targeted on a programmatic {@link LineItem} or {@link ProposalLineItem}. This attribute is readonly and is populated by Google. Specifies the URLs that are targeted by the entity. This is currently only supported by {@link YieldGroup}. Specifies the request platforms that are targeted by the {@link LineItem}. This attribute is required for video line items and for {@link ProposalLineItem}. This value is modifiable for video line items, but read-only for non-video line items. This value is read-only for video line items generated from proposal line items. Specifies the sizes that are targeted by the entity. This is currently only supported on {@link YieldGroup} and {@link TrafficDataRequest}. Represents a technology entity that can be targeted. The unique ID of the {@code Technology}. This value is required for all forms of {@code TechnologyTargeting}. The name of the technology being targeting. This value is read-only and is assigned by Google. Contains a string value. The string value. Represents a specific time in a day. Hour in 24 hour time (0..24). This field must be between 0 and 24, inclusive. This field is required. Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required. An error for a field which must satisfy a uniqueness constraint The {@link BaseAdRuleSlot} subtype returned if the actual type is not exposed by the requested API version. Represents the result of performing an action on objects. The number of objects that were changed as a result of performing the action. Provides line items the ability to target or exclude users visiting their websites from a list of domains or subdomains. The domains or subdomains that are being targeted or excluded by the {@link LineItem}. This attribute is required and the maximum length of each domain is 67 characters. Indicates whether domains should be targeted or excluded. This attribute is optional and defaults to {@code true}. {@code Value} represents a value. Represents a targetable position within a video. A video ad can be targeted to a position (pre-roll, all mid-rolls, or post-roll), or to a specific mid-roll index. The type of video position (pre-roll, mid-roll, or post-roll). The index of the mid-roll to target. Only valid if the {@link positionType} is {@link VideoPositionType#MIDROLL}, otherwise this field will be ignored. Represents positions within and around a video where ads can be targeted to. Example positions could be {@code pre-roll} (before the video plays), {@code post-roll} (after a video has completed playback) and {@code mid-roll} (during video playback). Empty video position targeting means that all video positions are allowed. If a bumper line item has empty video position targeting it will be updated to target all bumper positions. The {@link VideoTargetingPosition} objects being targeted by the video {@link LineItem}. Represents a targetable position within a pod within a video stream. A video ad can be targeted to any position in the pod (first, second, third ... last). If there is only 1 ad in a pod, either first or last will target that position. The specific index of the pod. The index is defined as: <ul><li>1 = first</li> <li>2 = second</li> <li>3 = third</li> <li>....</li> <li>100 = last</li></ul> 100 will always be the last position. For example, for a pod with 5 positions, 100 would target position 5. Multiple targets against the index 100 can exist. Positions over 100 are not supported. Represents the options for targetable positions within a video. The video position to target. This attribute is required. The video bumper type to target. To target a video position or a pod position, this value must be null. To target a bumper position this value must be populated and the line item must have a bumper type. To target a custom ad spot, this value must be null. The video position within a pod to target. To target a video position or a bumper position, this value must be null. To target a position within a pod this value must be populated. To target a custom ad spot, this value must be null. A custom spot {@link AdSpot} to target. To target a video position, a bumper type or a video position within a pod this value must be null. Describes reasons for {@code AdRuleDateError}s. Cannot create a new ad rule with a start date in the past. Cannot update an existing ad rule that has already completely passed with a new end date that is still in the past. End date must be after the start date. {@code DateTime}s after 1 January 2037 are not supported. The value returned if the actual value is not exposed by the requested API version. Describes reason for {@code AdRuleError}s. The name contains unsupported or reserved characters. The break template must have exactly one flexible ad spot. The value returned if the actual value is not exposed by the requested API version. Describes reason for {@code AdRuleFrequencyCapError}s. The ad rule specifies that frequency caps should be turned on, but then none of the frequency caps have actually been set. The ad rule specifies that frequency caps should not be turned on, but then some frequency caps were actually set. The value returned if the actual value is not exposed by the requested API version. Reasons for an {@code AdRulePriorityError}. Ad rules must have unique priorities. One or more priorities are missing. The value returned if the actual value is not exposed by the requested API version. The types of behaviors for ads within a {@link BaseAdRuleSlot ad rule slot}. This ad rule always includes this slot's ads. This ad rule never includes this slot's ads. Defer to lower priority rules. This ad rule doesn't specify guidelines for this slot's ads. The value returned if the actual value is not exposed by the requested API version. Types of bumper ads on an ad rule slot. Do not show a bumper ad. Show a bumper ad before the slot's other ads. Show a bumper ad after the slot's other ads. Show a bumper before and after the slot's other ads. The value returned if the actual value is not exposed by the requested API version. Describes reason for {@code AdRuleSlotError}s. Has a different status than the ad rule to which it belongs. Min video ad duration is greater than max video ad duration. Video mid-roll frequency type other than NONE for pre-roll or post-roll. Invalid format for video mid-roll frequency when expecting a CSV list of numbers. Valid formats are the following:<ul> <li>empty <li> comma-separated list of numbers (time milliseconds or cue points) <li>a single number (every n milliseconds or cue points, or one specific time / cue point) </ul> Invalid format for video mid-roll frequency when expecting a single number only, e.g., every n seconds or every n cue points. Min overlay ad duration is greater than max overlay ad duration. Overlay mid-roll frequency type other than NONE for pre-roll or post-roll. Invalid format for overlay mid-roll frequency for list of numbers. See valid formats above. Invalid format for overlay mid-roll frequency for a single number. Non-positive bumper duration when expecting a positive number. At most one mid-roll can be set to disallow ads. The value returned if the actual value is not exposed by the requested API version. Represents the status of ad rules and ad rule slots. Created and ready to be served. Is user-visible. Paused, user-visible. The value returned if the actual value is not exposed by the requested API version. Describes reasons for {@code AdRuleTargetingError ad rule targeting errors}. Cannot target video positions. As part of COPPA requirements, custom targeting for session ad rules requires exact custom value matching. The value returned if the actual value is not exposed by the requested API version. Indicates that the operation is not allowed in the version the request was made in. The value returned if the actual value is not exposed by the requested API version. The SOAP message contains a request header with an ambiguous definition of the authentication header fields. This means either the {@code authToken} and {@code oAuthToken} fields were both null or both were specified. Exactly one value should be specified with each request. The login provided is invalid. Tried to authenticate with provided information, but failed. The OAuth provided is invalid. The specified service to use was not recognized. The SOAP message is missing a request header with an {@code authToken} and optional {@code networkCode}. The HTTP request is missing a request header with an {@code authToken} The request is missing an {@code authToken} The network does not have API access enabled. The user is not associated with any network. No network for the given {@code networkCode} was found. The user has access to more than one network, but did not provide a {@code networkCode}. An error happened on the server side during connection to authentication service. The user tried to create a test network using an account that already is associated with a network. The account is blocked and under investigation by the collections team. Please contact Google for more information. The value returned if the actual value is not exposed by the requested API version. The value returned if the actual value is not exposed by the requested API version. Describes reasons for common errors Indicates that an attempt was made to retrieve an entity that does not exist. Indicates that an attempt was made to create an entity that already exists. Indicates that a value is not applicable for given use case. Indicates that two elements in the collection were identical. Indicates that an attempt was made to change an immutable field. Indicates that the requested operation is not supported. Indicates that another request attempted to update the same data in the same network at about the same time. Please wait and try the request again. The value returned if the actual value is not exposed by the requested API version. Specifies the available comparison operators. Specifies the available logical operators. Specifies the available comparison operators. The reasons for the target error. Requested {@link CustomTargetingKey} is not found. Number of {@link CustomTargetingKey} objects created exceeds the limit allowed for the network. {@link CustomTargetingKey} with the same {@link CustomTargetingKey#name} already exists. {@link CustomTargetingKey#name} is empty. {@link CustomTargetingKey#name} is too long. {@link CustomTargetingKey#name} contains unsupported or reserved characters. {@link CustomTargetingKey#name} matches one of the reserved custom targeting key names. {@link CustomTargetingKey#displayName} is too long. Key is not active. Requested {@link CustomTargetingValue} is not found. The {@code WHERE} clause in the {@link Statement#query} must always contain {@link CustomTargetingValue#customTargetingKeyId} as one of its columns in a way that it is AND'ed with the rest of the query. The number of {@link CustomTargetingValue} objects associated with a {@link CustomTargetingKey} exceeds the network limit. This is only applicable for keys of type {@code CustomTargetingKey.Type#PREDEFINED}. {@link CustomTargetingValue} with the same {@link CustomTargetingValue#name} already exists. {@link CustomTargetingValue#name} is empty. {@link CustomTargetingValue#name} is too long. {@link CustomTargetingValue#name} contains unsupported or reserved characters. {@link CustomTargetingValue#displayName} is too long. Only Ad Manager 360 networks can have {@link CustomTargetingValue#matchType} other than {@link CustomTargetingValue.MatchType#EXACT}. You can only create {@link CustomTargetingValue} objects with match type {@link CustomTargetingValue.MatchType#EXACT} when associating with {@link CustomTargetingKey} objects of type {@link CustomTargetingKey.Type#PREDEFINED} {@link CustomTargetingValue} object cannot have match type of {@link CustomTargetingValue.MatchType#SUFFIX} when adding a {@link CustomTargetingValue} to a line item. {@link CustomTargetingValue} object cannot have match type of {@link CustomTargetingValue.MatchType#CONTAINS} when adding a {@link CustomTargetingValue} to targeting expression of a line item. Value is not active. The {@link CustomTargetingKey} does not have any {@link CustomTargetingValue} associated with it. The {@link CustomTargetingKey} has a {@link CustomTargetingValue} specified for which the value is not a valid child. {@link CustomCriteriaSet.LogicalOperator#OR} operation cannot be applied to values with different keys. Targeting expression is invalid. This can happen if the sequence of operators is wrong, or a node contains invalid number of children. The key has been deleted. {@link CustomCriteria} cannot have deleted keys. The value has been deleted. {@link CustomCriteria} cannot have deleted values. The key is set as the video browse-by key, which cannot be used for custom targeting. Only active custom-criteria keys are supported in content metadata mapping. Only active custom-criteria values are supported in content metadata mapping. Cannot delete a custom criteria key that is targeted by an active partner assignment. Cannot delete a custom criteria value that is targeted by an active partner assignment. {@link AudienceSegment} object cannot be targeted. Third party {@link AudienceSegment} cannot be targeted. Inactive {@link AudienceSegment} object cannot be targeted. Targeted {@link AudienceSegment} object is not valid. Mapped metadata key-values are deprecated and cannot be targeted. Targeted {@link AudienceSegment} objects have not been approved. The value returned if the actual value is not exposed by the requested API version. Specifies the available comparison operators. Days of the week. The day of week named Monday. The day of week named Tuesday. The day of week named Wednesday. The day of week named Thursday. The day of week named Friday. The day of week named Saturday. The day of week named Sunday. Represents the time zone to be used for {@link DayPartTargeting}. Use the time zone of the publisher. Use the time zone of the browser. A feature is being used that is not enabled on the current network. The value returned if the actual value is not exposed by the requested API version. Types of behavior for frequency caps within ad rules. Turn on at least one of the frequency caps. Turn off all frequency caps. Defer frequency cap decisions to the next ad rule in priority order. The value returned if the actual value is not exposed by the requested API version. The reasons for the target error. A location that is targeted cannot also be excluded. Excluded locations cannot have any of their children targeted. Postal codes cannot be excluded. Indicates that location targeting is not allowed. The value returned if the actual value is not exposed by the requested API version. The single reason for the internal API error. API encountered an unexpected internal error. A temporary error occurred during the request. Please retry. The cause of the error is not known or only defined in newer versions. The API is currently unavailable for a planned downtime. Mutate succeeded but server was unable to build response. Client should not retry mutate. The reasons for the target error. At least one placement or inventory unit is required The same inventory unit or placement cannot be targeted and excluded at the same time A child inventory unit cannot be targeted if its ancestor inventory unit is also targeted. A child inventory unit cannot be targeted if its ancestor inventory unit is excluded. A child inventory unit cannot be excluded if its ancestor inventory unit is also excluded. An explicitly targeted inventory unit cannot be targeted. An explicitly targeted inventory unit cannot be excluded. A landing page-only ad unit cannot be targeted. A landing page-only ad unit cannot be targeted if it doesn't have any children. Audience segments shared from YouTube can only be targeted with inventory shared from YouTube for cross selling. The value returned if the actual value is not exposed by the requested API version. {@code LineItemType} indicates the priority of a {@link LineItem}, determined by the way in which impressions are reserved to be served for it. The type of {@link LineItem} for which a percentage of all the impressions that are being sold are reserved. The type of {@link LineItem} for which a fixed quantity of impressions or clicks are reserved. The type of {@link LineItem} most commonly used to fill a site's unsold inventory if not contractually obligated to deliver a requested number of impressions. Users specify the daily percentage of unsold impressions or clicks when creating this line item. The type of {@link LineItem} for which a fixed quantity of impressions or clicks will be delivered at a priority lower than the {@link LineItemType#STANDARD} type. The type of {@link LineItem} most commonly used to fill a site's unsold inventory if not contractually obligated to deliver a requested number of impressions. Users specify the fixed quantity of unsold impressions or clicks when creating this line item. The type of {@link LineItem} typically used for ads that promote products and services chosen by the publisher. These usually do not generate revenue and have the lowest delivery priority. Represents a legacy {@link LineItem} that has been migrated from the DFP system. Such line items cannot be created any more. Also, these line items cannot be activated or resumed. The type of {@link LineItem} used for ads that track ads being served externally of Ad Manager, for example an email newsletter. The click through would reference this ad, and the click would be tracked via this ad. A {@link LineItem} using dynamic allocation backed by AdSense. A {@link LineItem} using dynamic allocation backed by the Google Ad Exchange. Represents a non-monetizable video {@link LineItem} that targets one or more bumper positions, which are short house video messages used by publishers to separate content from ad breaks. A {@link LineItem} using dynamic allocation backed by AdMob. The type of {@link LineItem} for which there are no impressions reserved, and will serve for a second price bid. All {@link LineItem}s of type {@link LineItemType#PREFERRED_DEAL} should be created via a {@link ProposalLineItem} with a matching type. When creating a {@link LineItem} of type {@link LineItemType#PREFERRED_DEAL}, the {@link ProposalLineItem#estimatedMinimumImpressions} field is required. The value returned if the actual value is not exposed by the requested API version. Frequency types for mid-roll {@link BaseAdRuleSlot ad rule slots}. The ad rule slot is not a mid-roll and hence {@code MidrollFrequency} should be ignored. {@code MidrollFrequency} is a time interval and mentioned as a single numeric value in seconds. For example, "100" would mean "play a mid-roll every 100 seconds". {@code MidrollFrequency} is a comma-delimited list of points in time (in seconds) when an ad should play. For example, "100,300" would mean "play an ad at 100 seconds and 300 seconds". {@code MidrollFrequency} is a cue point interval and is a single integer value, such as "5", which means "play a mid-roll every 5th cue point". Same as {@link #FIXED_TIME}, except the values represent the ordinal cue points ("1,3,5", for example). The value returned if the actual value is not exposed by the requested API version. Minutes in an hour. Currently, only 0, 15, 30, and 45 are supported. This field is required. Zero minutes past hour. Fifteen minutes past hour. Thirty minutes past hour. Forty-five minutes past hour. The reasons for the target error. Assuming that a method will not have more than 3 arguments, if it does, return NULL The value returned if the actual value is not exposed by the requested API version. The reasons for the target error. Indicates an error in parsing an attribute. The value returned if the actual value is not exposed by the requested API version. Describes reasons for permission errors. User does not have the required permission for the request. The value returned if the actual value is not exposed by the requested API version. Describes reason for {@code PoddingError}s. Invalid podding type NONE, but has podding fields filled in. Podding types are defined in {@link com.google.ads.publisher.domain.entity.adrule.export.PoddingType}. Invalid podding type STANDARD, but doesn't specify the max ads in pod and max ad duration podding fields. Invalid podding type OPTIMIZED, but doesn't specify pod duration. Invalid optimized pod that does not specify a valid max ads in pod, which must either be a positive number or -1 to signify that there is no maximum. Min pod ad duration is greater than max pod ad duration. The reasons for the target error. Indicates that there was an error executing the PQL. The value returned if the actual value is not exposed by the requested API version. The reasons for the target error. Indicates that there was a PQL syntax error. The value returned if the actual value is not exposed by the requested API version. The number of requests made per second is too high and has exceeded the allowable limit. The recommended approach to handle this error is to wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. Another way to mitigate this error is to limit requests to 8 per second for Ad Manager 360 accounts, or 2 per second for Ad Manager accounts. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. The value returned if the actual value is not exposed by the requested API version. This user has exceeded the allowed number of new report requests per hour (this includes both reports run via the UI and reports run via {@link ReportService#runReportJob}). The recommended approach to handle this error is to wait about 10 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. Another way to mitigate this error is to limit the number of new report requests to 250 per hour per user. Once again, this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. Represents the platform which requests and renders the ad. The value returned if the actual value is not exposed by the requested API version. Represents a request made from a web browser. This includes both desktop and mobile web. Represents a request made from a mobile application. This includes mobile app interstitial and rewarded video requests. Represents a request made from a video player that is playing publisher content. This includes video players embedded in web pages and mobile applications, and connected TV screens. A required collection is missing. Collection size is too large. Collection size is too small. The value returned if the actual value is not exposed by the requested API version. The reasons for the target error. Missing required field. Describes reasons for a number to be invalid. The value returned if the actual value is not exposed by the requested API version. Describes reasons for server errors Indicates that an unexpected error occured. Indicates that the server is currently experiencing a high load. Please wait and try your request again. The value returned if the actual value is not exposed by the requested API version. Specifies the start type to use for an entity with a start date time field. For example, a {@link LineItem} or {@link LineItemCreativeAssociation}. Use the value in {@link #startDateTime}. The entity will start serving immediately. {@link #startDateTime} in the request is ignored and will be set to the current time. Additionally, {@link #startDateTimeType} will be set to {@link StartDateTimeType#USE_START_DATE_TIME}. The entity will start serving one hour from now. {@link #startDateTime} in the request is ignored and will be set to one hour from the current time. Additionally, {@link #startDateTimeType} will be set to {@link StartDateTimeType#USE_START_DATE_TIME}. The value returned if the actual value is not exposed by the requested API version. A bind variable has not been bound to a value. The value returned if the actual value is not exposed by the requested API version. The reasons for the target error. The input string value contains disallowed characters. The input string value is invalid for the associated field. The value returned if the actual value is not exposed by the requested API version. The different options for how ad spots are filled. Only some allocations of ads to subpods produce a valid final pod. If this ad spot is empty, the overall pod is invalid. The ad spot is always "satisfied", whether empty or nonempty. The value returned if the actual value is not exposed by the requested API version. Defines the targeting behavior of an ad spot. Line items not targeting this ad spot explicitly may serve in it. Only line items targeting this ad spots explicitly may serve in it If house ads are an allowed reservation type, they may serve in the ad spot regardless of whether they explicitly target it. Ads of other reservation types (whose type is allowed in the ad spot), may serve in the ad spot only if explicitly targeted. The value returned if the actual value is not exposed by the requested API version. Represents the options for targetable bumper positions, surrounding an ad pod, within a video stream. This includes before and after the supported ad pod positions, {@link VideoPositionType#PREROLL}, {@link VideoPositionType#MIDROLL}, and {@link VideoPositionType#POSTROLL}. Represents the bumper position before the ad pod. Represents the bumper position after the ad pod. Represents a targetable position within a video. The value returned if the actual value is not exposed by the requested API version. This position targets all of the above video positions. The position defined as showing before the video starts playing. The position defined as showing within the middle of the playing video. The position defined as showing after the video is completed. Creates new {@link AdRule} objects. A fault element of type ApiException. Creates new {@link AdSpot} objects. Creates new {@link breakTemplate} objects. Gets an {@link AdRulePage} of {@link AdRule} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering: <table> <tr> <th scope="col">PQL Property</th> <th scope="col">Object Property</th> </tr> <tr> <td>{@code id}</td> <td>{@link AdRule#id} ({@link AdRule#adRuleId} beginning in v201702)</td> </tr> <tr> <td>{@code name}</td> <td>{@link AdRule#name}</td> </tr> <tr> <td>{@code priority}</td> <td>{@link AdRule#priority}</td> </tr> <tr> <td>{@code status}</td> <td>{@link AdRule#status}</td> </table> Gets a {@link AdSpotPage} of {@link AdSpot} objects that satisfy the given {@link Statement#query}. Gets a {@link BreakTemplatePage} of {@link BreakTemplate} objects that satisfy the given {@link Statement#query}. Performs actions on {@link AdRule} objects that match the given {@link Statement#query}. Updates the specified {@link AdRule} objects. Updates the specified {@link AdSpot} objects. Updates the specified {@link breakTemplate} objects. Provides methods for creating, updating and retrieving {@link AdRule} objects. Ad rules contain data that the ad server uses to generate a playlist of video ads. Creates new {@link AdRule} objects. Creates new {@link AdSpot} objects. Creates new {@link breakTemplate} objects. Gets an {@link AdRulePage} of {@link AdRule} objects that satisfy the given {@link Statement#query}. The following fields are supported for filtering: <table> <tr> <th scope="col">PQL Property</th> <th scope="col">Object Property</th> </tr> <tr> <td>{@code id}</td> <td>{@link AdRule#id} ({@link AdRule#adRuleId} beginning in v201702)</td> </tr> <tr> <td>{@code name}</td> <td>{@link AdRule#name}</td> </tr> <tr> <td>{@code priority}</td> <td>{@link AdRule#priority}</td> </tr> <tr> <td>{@code status}</td> <td>{@link AdRule#status}</td> </table> Gets a {@link AdSpotPage} of {@link AdSpot} objects that satisfy the given {@link Statement#query}. Gets a {@link BreakTemplatePage} of {@link BreakTemplate} objects that satisfy the given {@link Statement#query}. Performs actions on {@link AdRule} objects that match the given {@link Statement#query}. Updates the specified {@link AdRule} objects. Updates the specified {@link AdSpot} objects. Updates the specified {@link breakTemplate} objects.