REST Resource: networks.lineItems

    Resource: LineItem

    A LineItem contains information about how specific ad creatives are intended to serve to your website or app along with pricing and other delivery details.

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "customFieldValues" 
 : 
 [ 
 { 
 object (  CustomFieldValue 
 
) 
 } 
 ] 
 , 
 "order" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "startTime" 
 : 
 string 
 , 
 "endTime" 
 : 
 string 
 , 
 "lineItemType" 
 : 
 enum (  LineItemType 
 
) 
 , 
 "rate" 
 : 
 { 
 object (  Money 
 
) 
 } 
 , 
 "budget" 
 : 
 { 
 object (  Money 
 
) 
 } 
 , 
 "goal" 
 : 
 { 
 object (  Goal 
 
) 
 } 
 }
    Fields
    name

    string

    Identifier. The resource name of the LineItem . Format: networks/{networkCode}/lineItems/{lineItemId}

    customFieldValues[]

    object ( CustomFieldValue )

    Optional. The values of the custom fields associated with this line item.
    order

    string

    Required. Immutable. The ID of the Order to which the LineItem belongs. Format: networks/{networkCode}/orders/{order}

    displayName

    string

    Required. The name of the line item. This attribute is required and has a maximum length of 255 characters.
    startTime

    string ( Timestamp format)

    Required. The date and time on which the LineItem is enabled to begin serving. This attribute is required and must be in the future.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    endTime

    string ( Timestamp format)

    Output only. The timestamp when the LineItem will stop serving. This attribute is read-only and includes auto extension days.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    lineItemType

    enum ( LineItemType )

    Required. Indicates the line item type of a LineItem. This attribute is required. The line item type determines the default priority of the line item. More information can be found at https://support.google.com/admanager/answer/177279 .
    rate

    object ( Money )

    Required. The amount of money to spend per impression or click.
    budget

    object ( Money )

    Output only. The amount of money allocated to the LineItem. This attribute is readonly and is populated by Google. The currency code is readonly.
    goal

    object ( Goal )

    Optional. The primary goal that this LineItem is associated with, which is used in its pacing and budgeting.

    Goal

    Defines the criteria a LineItem needs to satisfy to meet its delivery goal.

    JSON representation 
     { 
 "goalType" 
 : 
 enum (  GoalType 
 
) 
 , 
 "unitType" 
 : 
 enum (  UnitType 
 
) 
 , 
 "units" 
 : 
 string 
 }
    Fields
    goalType

    enum ( GoalType )

    The type of the goal for the LineItem. It defines the period over which the goal should be reached.
    unitType

    enum ( UnitType )

    The type of the goal unit for the LineItem.
    units

    string ( int64 format)

    If this is a primary goal, it represents the number or percentage of impressions or clicks that will be reserved. If the line item is of type LineItemTypeEnum.LineItemType.SPONSORSHIP , it represents the percentage of available impressions reserved. If the line item is of type LineItemTypeEnum.LineItemType.BULK or LineItemTypeEnum.LineItemType.PRICE_PRIORITY , it represents the number of remaining impressions reserved. If the line item is of type LineItemTypeEnum.LineItemType.NETWORK or LineItemTypeEnum.LineItemType.HOUSE , it represents the percentage of remaining impressions reserved.

    If this is an impression cap goal, it represents the number of impressions or conversions that the line item will stop serving at if reached. For valid line item types, see [LineItem.impressions_cap][].

    GoalType

    Specifies the type of the goal for a LineItem.

    Enums
    GOAL_TYPE_UNSPECIFIED
    Default value. This value is unused.
    NONE

    No goal is specified for the number of ads delivered. The line item type must be one of:

    LIFETIME

    There is a goal on the number of ads delivered for this line item during its entire lifetime. The line item type must be one of:

    UnitType

    Indicates the type of unit used for defining a reservation. The [LineItem.cost_type][] can differ from the UnitType - an ad can have an impression goal, but be billed by its click. Usually CostType and UnitType will refer to the same unit.

    Enums
    UNIT_TYPE_UNSPECIFIED
    Default value. This value is unused.
    IMPRESSIONS
    The number of impressions served by creatives associated with the line item.
    CLICKS

    The number of clicks reported by creatives associated with the line item. The line item type must be one of:

    CLICK_THROUGH_CPA_CONVERSIONS
    The number of click-through Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the [LineItem.cost_type][] must be [CostTypeEnum.CostType.CPA][].
    VIEW_THROUGH_CPA_CONVERSIONS
    The number of view-through Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the [LineItem.cost_type][] must be [CostTypeEnum.CostType.CPA}.
    TOTAL_CPA_CONVERSIONS
    The number of total Cost-Per-Action (CPA) conversions from creatives associated with the line item. This is only supported as secondary goal and the [LineItem.cost_type} must be [CostTypeEnum.CostType.CPA}.
    VIEWABLE_IMPRESSIONS
    The number of viewable impressions reported by creatives associated with the line item. The LineItem.line_item_type must be LineItemTypeEnum.LineItemType.STANDARD .
    IN_TARGET_IMPRESSIONS
    The number of in-target impressions reported by third party measurements. The LineItem.line_item_type must be LineItemTypeEnum.LineItemType.STANDARD .
    COMPLETED_VIEWS
    The number of completed views reported by creatives associated with the line item. A completed view is defined as having watched the entirety of the in-stream video ad and is only supported for standard reservation video line items. The LineItem.line_item_type must be LineItemTypeEnum.LineItemType.STANDARD .

    Methods

    get

    		API to retrieve a LineItem object.

    list

    		API to retrieve a list of LineItem objects.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: