REST Resource: advertisers.lineItems

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}

string

सिर्फ़ आउटपुट के लिए. लाइन आइटम के संसाधन का नाम.

string (int64 format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले उस व्यक्ति या कंपनी का यूनीक आईडी जिससे लाइन आइटम जुड़ा है.

string (int64 format)

सिर्फ़ आउटपुट के लिए. उस कैंपेन का यूनीक आईडी जिससे लाइन आइटम जुड़ा है.

string (int64 format)

ज़रूरी है. इम्यूटेबल. लाइन आइटम से जुड़े इंसर्शन ऑर्डर का यूनीक आईडी.

string (int64 format)

सिर्फ़ आउटपुट के लिए. लाइन आइटम का यूनीक आईडी. सिस्टम ने असाइन किया है.

string

ज़रूरी है. लाइन आइटम का डिसप्ले नेम.

यह UTF-8 कोड में बदला गया होना चाहिए और इसका साइज़ 240 बाइट से ज़्यादा नहीं होना चाहिए.

enum (LineItemType)

ज़रूरी है. इम्यूटेबल. लाइन आइटम का टाइप.

enum (EntityStatus)

ज़रूरी है. यह नीति कंट्रोल करती है कि लाइन आइटम, अपना बजट खर्च कर सकता है या नहीं और इन्वेंट्री पर बोली लगा सकता है या नहीं.

• lineItems.create तरीके में, सिर्फ़ ENTITY_STATUS_DRAFT की अनुमति है. किसी लाइन आइटम को चालू करने के लिए, lineItems.patch तरीके का इस्तेमाल करें. इसके बाद, लाइन आइटम बनाने के बाद, उसकी स्थिति को ENTITY_STATUS_ACTIVE में अपडेट करें.
• लाइन आइटम को किसी अन्य स्थिति से ENTITY_STATUS_DRAFT स्थिति में वापस नहीं बदला जा सकता.
• अगर लाइन आइटम का पैरंट इंसर्शन ऑर्डर चालू नहीं है, तो लाइन आइटम अपना बजट खर्च नहीं कर सकता, भले ही उसकी स्थिति ENTITY_STATUS_ACTIVE हो.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब लाइन आइटम को आखिरी बार अपडेट किया गया था. सिस्टम ने असाइन किया है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (PartnerCost)

लाइन आइटम से जुड़ा पार्टनर खर्च.

अगर lineItems.create तरीके में यह मौजूद नहीं है या इसकी वैल्यू नहीं दी गई है, तो बनाए गए नए लाइन आइटम पर, पार्टनर की कीमतें, पैरंट इंसर्शन ऑर्डर से लागू होंगी.

object (LineItemFlight)

ज़रूरी है. लाइन आइटम की फ़्लाइट के शुरू और खत्म होने का समय.

object (LineItemBudget)

ज़रूरी है. लाइन आइटम के लिए बजट का बंटवारा करने की सेटिंग.

object (Pacing)

ज़रूरी है. लाइन आइटम के लिए बजट खर्च करने की स्पीड की सेटिंग.

object (FrequencyCap)

ज़रूरी है. लाइन आइटम की इंप्रेशन फ़्रीक्वेंसी कैप सेटिंग.

अगर सीमित कैप असाइन करते हैं, तो इस सेटिंग ऑब्जेक्ट में maxImpressions फ़ील्ड का इस्तेमाल करना ज़रूरी है.

object (PartnerRevenueModel)

ज़रूरी है. लाइन आइटम के लिए, पार्टनर के रेवेन्यू के मॉडल की सेटिंग.

object (ConversionCountingConfig)

लाइन आइटम की कन्वर्ज़न ट्रैकिंग सेटिंग.

string (int64 format)

लाइन आइटम से जुड़े क्रिएटिव के आईडी.

object (BiddingStrategy)

ज़रूरी है. लाइन आइटम की बिडिंग की रणनीति.

object (IntegrationDetails)

लाइन आइटम के इंटिग्रेशन की जानकारी.

object (TargetingExpansionConfig)

लाइन आइटम की ऑप्टिमाइज़ की गई टारगेटिंग सेटिंग.

यह कॉन्फ़िगरेशन सिर्फ़ उन डिसप्ले, वीडियो या ऑडियो लाइन आइटम के लिए लागू है जो ऑटोमेटेड बिडिंग (बिड अपने-आप सेट होना) और पॉज़िटिव टारगेट की गई ऑडियंस की सूचियों का इस्तेमाल करते हैं.

enum (LineItemWarningMessage)

सिर्फ़ आउटपुट के लिए. लाइन आइटम से जनरेट होने वाले चेतावनी मैसेज. ये चेतावनियां लाइन आइटम को सेव होने से नहीं रोकतीं, लेकिन कुछ चेतावनियां लाइन आइटम को चलने से रोक सकती हैं.

object (MobileApp)

लाइन आइटम का प्रमोशन करने वाला मोबाइल ऐप्लिकेशन.

यह सिर्फ़ तब लागू होता है, जब lineItemType, LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL या LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL हो.

enum (ReservationType)

सिर्फ़ आउटपुट के लिए. लाइन आइटम का रिज़र्वेशन टाइप.

boolean

लाइन आइटम से अपने-आप टारगेट होने वाले नए एक्सचेंज को बाहर रखना है या नहीं. डिफ़ॉल्ट रूप से, यह फ़ील्ड गलत होता है.

object (YoutubeAndPartnersSettings)

सिर्फ़ आउटपुट के लिए. YouTube और पार्टनर लाइन आइटम के लिए खास सेटिंग.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}

enum (LineItemFlightDateType)

ज़रूरी है. लाइन आइटम की फ़्लाइट की तारीखों का टाइप.

object (DateRange)

लाइन आइटम के फ़्लाइट शुरू और खत्म होने की तारीख. इनका समाधान, पैरंट विज्ञापन देने वाले के टाइम ज़ोन के हिसाब से किया जाता है.

• flightDateType के LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM होने पर ज़रूरी है. सिर्फ़ आउटपुट के लिए.
• नई फ़्लाइट बनाते समय, startDate और endDate, दोनों भविष्य में होने चाहिए.
• पहले की startDate वाली मौजूदा फ़्लाइट में, बदले जा सकने वाले endDate हैं, लेकिन startDate में बदलाव नहीं किया जा सकता.
• endDate, साल 2037 से पहले की startDate या उसके बाद की तारीख होनी चाहिए.

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum (LineItemBudgetAllocationType)

ज़रूरी है. असाइन किया गया बजट किस तरह का है.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC सिर्फ़ तब लागू होता है, जब पैरंट इंसर्शन ऑर्डर के लिए, अपने-आप बजट असाइन होने की सुविधा चालू हो.

enum (BudgetUnit)

सिर्फ़ आउटपुट के लिए. बजट की इकाई से पता चलता है कि बजट, मुद्रा पर आधारित है या इंप्रेशन पर आधारित है. यह वैल्यू, पैरंट इंसर्शन ऑर्डर से ली गई है.

string (int64 format)

लाइन आइटम के लिए खर्च की जाने वाली ज़्यादा से ज़्यादा बजट रकम. 0 से ज़्यादा होना चाहिए.

जब budgetAllocationType यह होता है:

• LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, इस फ़ील्ड में बदलाव नहीं किया जा सकता और इसे सिस्टम सेट करता है.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, अगर budgetUnit है:
  • BUDGET_UNIT_CURRENCY, यह फ़ील्ड विज्ञापन देने वाले की मुद्रा के माइक्रो में, खर्च करने के लिए बजट की ज़्यादा से ज़्यादा रकम दिखाता है. उदाहरण के लिए, 1500000 मुद्रा की 1.5 स्टैंडर्ड यूनिट को दिखाता है.
  • BUDGET_UNIT_IMPRESSIONS, यह फ़ील्ड दिखाए जाने के लिए इंप्रेशन की ज़्यादा से ज़्यादा संख्या दिखाता है.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, यह फ़ील्ड लागू नहीं है और सिस्टम इसे अनदेखा कर देगा.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum (PartnerRevenueModelMarkupType)

ज़रूरी है. पार्टनर के रेवेन्यू मॉडल का मार्कअप टाइप.

string (int64 format)

ज़रूरी है. पार्टनर के रेवेन्यू मॉडल की मार्कअप रकम. वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए.

• जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM पर सेट किया जाता है, तो यह फ़ील्ड विज्ञापन देने वाले की मुद्रा के माइक्रो में सीपीएम मार्कअप दिखाता है. उदाहरण के लिए, 1500000 मुद्रा की 1.5 स्टैंडर्ड यूनिट को दिखाता है.
• जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP पर सेट किया जाता है, तो यह फ़ील्ड मिलीसेकंड में मीडिया लागत का प्रतिशत मार्कअप दिखाता है. उदाहरण के लिए, 100 का मतलब 0.1% है (दशमलव 0.001).
• जब markupType को PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP पर सेट किया जाता है, तो यह फ़ील्ड कुल मीडिया लागत का प्रतिशत मार्कअप मिलीसेकंड में दिखाता है. उदाहरण के लिए, 100 का मतलब 0.1% है (दशमलव 0.001).

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

मिलीसेकंड में (प्रतिशत का 1/1,000) में, देखे जाने के बाद के कन्वर्ज़न का प्रतिशत. यह 0 और 100,000 के बीच होना चाहिए.

उदाहरण के लिए, क्लिक के बाद होने वाले कन्वर्ज़न का 50% ट्रैक करने के लिए, 50,000 की वैल्यू सेट करें.

object (TrackingFloodlightActivityConfig)

Floodlight गतिविधि कॉन्फ़िगरेशन का इस्तेमाल, कन्वर्ज़न ट्रैक करने के लिए किया जाता है.

कन्वर्ज़न की गिनती की जाने वाली संख्या, इस फ़ील्ड में दिए गए सभी Floodlight ऐक्टिविटी आईडी से गिने गए कन्वर्ज़न का कुल योग होती है.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

ज़रूरी है. Floodlight गतिविधि का आईडी.

integer

ज़रूरी है. किसी विज्ञापन पर क्लिक होने के बाद के दिनों की वह संख्या जिसमें कन्वर्ज़न की गिनती की जा सकती है. 0 और 90 के बीच होना चाहिए.

integer

ज़रूरी है. किसी विज्ञापन को देखे जाने के बाद दिनों की वह संख्या जिसमें कन्वर्ज़न की गिनती की जा सकती है. 0 और 90 के बीच होना चाहिए.

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

ज़रूरी है. प्लैटफ़ॉर्म स्टोर से मिला ऐप्लिकेशन का आईडी.

Android ऐप्लिकेशन की पहचान, Android के Play Store में इस्तेमाल किए जाने वाले बंडल आईडी से की जाती है, जैसे कि com.google.android.gm.

iOS ऐप्लिकेशन की पहचान, Apple के App Store में इस्तेमाल होने वाले नौ अंकों के ऐप्लिकेशन आईडी से की जाती है, जैसे कि 422689480.

enum (Platform)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन प्लैटफ़ॉर्म.

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन का नाम.

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन पब्लिशर.

{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object (FrequencyCap)

लाइन आइटम की व्यू फ़्रीक्वेंसी कैप सेटिंग.

अगर सीमित कैप असाइन करते हैं, तो इस सेटिंग ऑब्जेक्ट में maxViews फ़ील्ड का इस्तेमाल करना ज़रूरी है.

object (ThirdPartyMeasurementConfigs)

ज़रूरी नहीं. लाइन आइटम के लिए, तीसरे पक्ष के मेज़रमेंट कॉन्फ़िगरेशन.

object (YoutubeAndPartnersInventorySourceConfig)

वे सेटिंग जिनसे यह कंट्रोल किया जाता है कि लाइन आइटम, YouTube और पार्टनर की किन इन्वेंट्री को टारगेट करेगा.

enum (YoutubeAndPartnersContentCategory)

किस तरह के वीडियो पर YouTube और पार्टनर विज्ञापन दिखाए जाएंगे.

enum (YoutubeAndPartnersContentCategory)

सिर्फ़ आउटपुट के लिए. कॉन्टेंट की वह कैटगरी जो लाइन आइटम दिखाते समय लागू होती है. जब कॉन्टेंट कैटगरी को लाइन आइटम और विज्ञापन देने वाले व्यक्ति या कंपनी, दोनों के लिए सेट किया जाता है, तो लाइन आइटम को दिखाते समय सबसे ज़्यादा पाबंदी वाली कैटगरी लागू होगी.

object (TargetFrequency)

इस लाइन आइटम के विज्ञापनों को एक खास समय के दौरान एक ही व्यक्ति को जितनी बार दिखाना है उसकी औसत संख्या.

string (int64 format)

उस व्यापारी/कंपनी का आईडी जिसे प्रॉडक्ट फ़ीड के लाइन आइटम से लिंक किया गया है.

string

मोबाइल डिवाइसों पर YouTube ऐप्लिकेशन में विज्ञापन चलने के दौरान, वीडियो के आईडी मुख्य वीडियो विज्ञापन के नीचे दिखते हैं.

string (int64 format)

लीड जनरेट करने के लिए फ़ॉर्म का आईडी.

object (VideoAdSequenceSettings)

VideoAdSequence से जुड़ी सेटिंग.

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. विज्ञापन दिखने से जुड़े आंकड़ों को मेज़र करने वाले तीसरे पक्ष के वेंडर.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

• THIRD_PARTY_VENDOR_MOAT
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_TELEMETRY
• THIRD_PARTY_VENDOR_MEETRICS

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. ब्रैंड की सुरक्षा का आकलन करने वाले तीसरे पक्ष के वेंडर.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. तीसरे पक्ष के वेंडर, पहुंच का आकलन करते हैं.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object (ThirdPartyVendorConfig)

ज़रूरी नहीं. ब्रैंड पर असर को मेज़र करने वाले तीसरे पक्ष के वेंडर.

तीसरे पक्ष के ये वेंडर लागू होते हैं:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum (ThirdPartyVendor)

तीसरे पक्ष का मेज़रमेंट वेंडर.

string

वह आईडी जिसका इस्तेमाल तीसरे पक्ष का वेंडर, लाइन आइटम की पहचान करने के लिए करता है.

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

ज़रूरी नहीं. YouTube पर इन्वेंट्री को टारगेट करना है या नहीं. इसमें सर्च, चैनल, और वीडियो, दोनों शामिल हैं.

boolean

ज़रूरी नहीं. Google TV पर उपलब्ध वीडियो ऐप्लिकेशन की इन्वेंट्री को टारगेट करना है या नहीं.

boolean

क्या आपको अपनी इन्वेंट्री को ऐसी पार्टनर साइटों और ऐप्लिकेशन पर टारगेट करना है जो YouTube जैसे ब्रैंड सुरक्षा मानकों का पालन करते हैं.

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string (int64 format)

timeUnit और timeUnitCount की तय की गई समयावधि में, एक ही व्यक्ति को औसतन कितनी बार विज्ञापन दिखाए जाएंगे.

enum (TimeUnit)

समय की वह इकाई जिसमें टारगेट फ़्रीक्वेंसी लागू की जाएगी.

नीचे दी गई समय इकाई लागू है:

• TIME_UNIT_WEEKS

integer

कितने timeUnit के लिए, विज्ञापन दिखाने की फ़्रीक्वेंसी चालू रहेगी.

timeUnit की वैल्यू के आधार पर, ये पाबंदियां लागू होती हैं:

• TIME_UNIT_WEEKS - 1 होना चाहिए

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum (VideoAdSequenceMinimumDuration)

किसी उपयोगकर्ता को यह क्रम दोबारा देखने से पहले, तय किया गया कम से कम समय.

object (VideoAdSequenceStep)

वे चरण जिनमें क्रम शामिल होता है.

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string (int64 format)

चरण का आईडी.

string (int64 format)

चरण से जुड़े विज्ञापन ग्रुप का आईडी.

string (int64 format)

पिछले चरण का आईडी. पहले चरण में पिछला चरण नहीं जोड़ा गया है.

enum (InteractionType)

पिछले चरण पर हुआ इंटरैक्शन जो दर्शक को इस चरण पर ले जाएगा. पहले चरण में InteractiveType नहीं है.