REST Resource: advertisers.lineItems

रिसॉर्स: LineItem

एक लाइन आइटम.

JSON के काेड में दिखाना
{
  "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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
फ़ील्ड
name

string

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

advertiserId

string (int64 format)

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

campaignId

string (int64 format)

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

insertionOrderId

string (int64 format)

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

lineItemId

string (int64 format)

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

displayName

string

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

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

lineItemType

enum (LineItemType)

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

entityStatus

enum (EntityStatus)

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

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

string (Timestamp format)

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

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

partnerCosts[]

object (PartnerCost)

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

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

flight

object (LineItemFlight)

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

budget

object (LineItemBudget)

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

pacing

object (Pacing)

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

frequencyCap

object (FrequencyCap)

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

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

partnerRevenueModel

object (PartnerRevenueModel)

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

conversionCounting

object (ConversionCountingConfig)

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

creativeIds[]

string (int64 format)

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

bidStrategy

object (BiddingStrategy)

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

integrationDetails

object (IntegrationDetails)

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

inventorySourceIds[]

string (int64 format)

लाइन आइटम को असाइन किए गए निजी इन्वेंट्री सोर्स के आईडी.

targetingExpansion

object (TargetingExpansionConfig)

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

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

warningMessages[]

enum (LineItemWarningMessage)

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

mobileApp

object (MobileApp)

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

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

reservationType

enum (ReservationType)

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

excludeNewExchanges

boolean

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

LineItemType

लाइन आइटम के संभावित टाइप.

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

Enums
LINE_ITEM_TYPE_UNSPECIFIED

इस वर्शन में, टाइप का मान नहीं दिया गया है या इसकी जानकारी नहीं है.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को, एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.

LINE_ITEM_TYPE_DISPLAY_DEFAULT इमेज, HTML5, नेटिव या रिच मीडिया विज्ञापन.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ऐसे डिसप्ले विज्ञापन जो ऐप्लिकेशन के इंस्टॉल को बढ़ावा देते हैं.
LINE_ITEM_TYPE_VIDEO_DEFAULT सीपीएम के आधार पर अलग-अलग तरह के एनवायरमेंट के हिसाब से बेचे जाने वाले वीडियो विज्ञापन.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ऐप्लिकेशन के इंस्टॉल बढ़ाने वाले वीडियो विज्ञापन.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

मोबाइल ऐप्लिकेशन इन्वेंट्री में दिखाए जाने वाले डिसप्ले विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को, एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.

LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

मोबाइल ऐप्लिकेशन इन्वेंट्री पर दिखाए जाने वाले वीडियो विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को, एपीआई का इस्तेमाल करके बनाया या अपडेट नहीं किया जा सकता.

LINE_ITEM_TYPE_AUDIO_DEFAULT अलग-अलग तरह के एनवायरमेंट में बेचे जाने वाले आरटीबी ऑडियो विज्ञापन.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP ओवर–द–टॉप (सीधे ग्राहक को) विज्ञापन, OTT इंसर्शन ऑर्डर में मौजूद हैं. यह टाइप, सिर्फ़ insertionOrderType OVER_THE_TOP के इंसर्शन ऑर्डर वाले लाइन आइटम पर लागू होता है.

LineItemFlight

वे सेटिंग जो किसी लाइन आइटम के चालू रहने की अवधि को कंट्रोल करती हैं.

JSON के काेड में दिखाना
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
फ़ील्ड
flightDateType

enum (LineItemFlightDateType)

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

dateRange

object (DateRange)

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

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

string (int64 format)

लाइन आइटम से जुड़े मैन्युअल ट्रिगर का आईडी.

  • flightDateType के LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER होने पर ज़रूरी है. इसे किसी और तरीके से सेट नहीं किया जाना चाहिए.
  • सेट किए जाने पर, लाइन आइटम की फ़्लाइट की तारीखें उसके पैरंट इंसर्शन ऑर्डर से इनहेरिट की जाती हैं.
  • चुने गए ट्रिगर को पैरंट इंसर्शन ऑर्डर की फ़्लाइट की तारीखों में चालू किए जाने पर, ऐक्टिव लाइन आइटम खर्च हो जाएंगे.

चेतावनी: मैन्युअल ट्रिगर का इस्तेमाल करने वाले लाइन आइटम अब Display &Video 360 के ज़रिए नहीं दिखाए जाएंगे वीडियो 360. यह फ़ील्ड 1 अगस्त, 2023 को बंद हो जाएगा. ज़्यादा जानकारी के लिए, सुविधा बंद करने का एलान पढ़ें.

LineItemFlightDateType

पंक्ति आइटम की फ्लाइट तारीखों के संभावित प्रकार.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED इस वर्शन में, टाइप का मान नहीं दिया गया है या इसकी जानकारी नहीं है.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED लाइन आइटम की फ़्लाइट की तारीखें, उसके पैरंट इंसर्शन ऑर्डर से ली जाती हैं.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM लाइन आइटम अपनी मनमुताबिक फ़्लाइट की तारीखों का इस्तेमाल करता है.
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

लाइन आइटम एक ट्रिगर का इस्तेमाल करता है.

चेतावनी: मैन्युअल ट्रिगर का इस्तेमाल करने वाले लाइन आइटम अब Display &Video 360 के ज़रिए नहीं दिखाए जाएंगे वीडियो 360. यह वैल्यू 1 अगस्त, 2023 को बंद हो जाएगी. ज़्यादा जानकारी के लिए, सुविधा बंद करने का एलान पढ़ें.

LineItemBudget

बजट बांटने के तरीके को कंट्रोल करने वाली सेटिंग.

JSON के काेड में दिखाना
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
फ़ील्ड
budgetAllocationType

enum (LineItemBudgetAllocationType)

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

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

budgetUnit

enum (BudgetUnit)

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

maxAmount

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, यह फ़ील्ड लागू नहीं है और सिस्टम इसे अनदेखा कर देगा.

LineItemBudgetAllocationType

बजट का बंटवारा करने के संभावित तरीके.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED इस वर्शन में, टाइप का मान नहीं दिया गया है या इसकी जानकारी नहीं है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC लाइन आइटम के लिए अपने-आप बजट असाइन होने की सुविधा चालू है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED लाइन आइटम के लिए, बजट की ज़्यादा से ज़्यादा तय रकम तय की जाती है.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED लाइन आइटम पर कोई बजट सीमा लागू नहीं होती.

PartnerRevenueModel

पार्टनर की आय का हिसाब लगाने का तरीका तय करने वाली सेटिंग.

JSON के काेड में दिखाना
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
फ़ील्ड
markupType

enum (PartnerRevenueModelMarkupType)

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

markupAmount

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).

PartnerRevenueModelMarkupType

पार्टनर के रेवेन्यू मॉडल के संभावित मार्कअप टाइप.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED इस वर्शन में, टाइप का मान नहीं दिया गया है या इसकी जानकारी नहीं है.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM तय सीपीएम के आधार पर पार्टनर की आय का हिसाब लगाएं.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

पार्टनर की आय का हिसाब, मीडिया लागत के सरचार्ज के आधार पर लगाया जाता है.

PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP पार्टनर की कुल मीडिया लागत के सरचार्ज के आधार पर पार्टनर की आय का हिसाब लगाएं. इसमें पार्टनर की सभी लागतें और डेटा की लागत शामिल हैं.

ConversionCountingConfig

कन्वर्ज़न की गिनती करने के तरीके को कंट्रोल करने वाली सेटिंग.

सभी पोस्ट-क्लिक कन्वर्ज़न की गिनती की जाएगी. व्यू के बाद होने वाले कन्वर्ज़न की गिनती के लिए, प्रतिशत वैल्यू सेट की जा सकती है.

JSON के काेड में दिखाना
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
फ़ील्ड
postViewCountPercentageMillis

string (int64 format)

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

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

floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

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

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

TrackingFloodlightActivityConfig

ऐसी सेटिंग जो किसी एक Floodlight गतिविधि कॉन्फ़िगरेशन के व्यवहार को कंट्रोल करती हैं.

JSON के काेड में दिखाना
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
फ़ील्ड
floodlightActivityId

string (int64 format)

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

postClickLookbackWindowDays

integer

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

postViewLookbackWindowDays

integer

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

TargetingExpansionConfig

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

JSON के काेड में दिखाना
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
फ़ील्ड
targetingExpansionLevel

enum (TargetingExpansionLevel)

ज़रूरी है. ऑप्टिमाइज़ की गई टारगेटिंग चालू है या नहीं.

इस फ़ील्ड में ये वैल्यू इस्तेमाल की जा सकती हैं:

  • NO_EXPANSION: ऑप्टिमाइज़ की गई टारगेटिंग की सुविधा बंद है
  • LEAST_EXPANSION: ऑप्टिमाइज़ की गई टारगेटिंग की सुविधा चालू है

अगर इस फ़ील्ड को किसी दूसरी वैल्यू पर सेट किया जाता है, तो यह अपने-आप LEAST_EXPANSION पर सेट हो जाएगा.

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

excludeFirstPartyAudience
(deprecated)

boolean

टारगेटिंग का दायरा बढ़ाने की सुविधा में, पहले-पक्ष की ऑडियंस का इस्तेमाल रोकना है या नहीं.

ऑप्टिमाइज़ की गई टारगेटिंग के लॉन्च होने की वजह से, इस फ़ील्ड को बंद कर दिया गया था.

यह फ़ील्ड false पर सेट किया जाएगा. अगर बंद होने पर इस फ़ील्ड को true पर सेट किया जाता है, तो इस लाइन आइटम को असाइन किए गए पहले पक्ष की सभी पॉज़िटिव ऑडियंस टारगेटिंग को, पहले पक्ष की इसी ऑडियंस के नेगेटिव टारगेटिंग से बदल दिया जाएगा. इससे यह पक्का किया जा सकेगा कि इन ऑडियंस को बाहर रखा जाए.

TargetingExpansionLevel

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

Enums
TARGETING_EXPANSION_LEVEL_UNSPECIFIED इस वर्शन में, ऑप्टिमाइज़ की गई टारगेटिंग सेटिंग तय नहीं की गई है या इसकी जानकारी नहीं है.
NO_EXPANSION ऑप्टिमाइज़ की गई टारगेटिंग की सुविधा बंद है.
LEAST_EXPANSION ऑप्टिमाइज़ की गई टारगेटिंग की सुविधा चालू है.
SOME_EXPANSION

अगर इसका इस्तेमाल किया जाता है, तो यह अपने-आप LEAST_EXPANSION पर सेट हो जाएगा.

BALANCED_EXPANSION

अगर इसका इस्तेमाल किया जाता है, तो यह अपने-आप LEAST_EXPANSION पर सेट हो जाएगा.

MORE_EXPANSION

अगर इसका इस्तेमाल किया जाता है, तो यह अपने-आप LEAST_EXPANSION पर सेट हो जाएगा.

MOST_EXPANSION

अगर इसका इस्तेमाल किया जाता है, तो यह अपने-आप LEAST_EXPANSION पर सेट हो जाएगा.

LineItemWarningMessage

लाइन आइटम से जनरेट होने वाले चेतावनी मैसेज. इस तरह की चेतावनियां, किसी लाइन आइटम को सेव होने से नहीं रोकती हैं. हालांकि, वे किसी लाइन आइटम को चलने से रोक सकती हैं.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED तय नहीं या इसकी जानकारी नहीं है.
INVALID_FLIGHT_DATES इस लाइन आइटम में फ़्लाइट की तारीखें गलत हैं. लाइन आइटम नहीं चलेगा.
EXPIRED इस लाइन आइटम के खत्म होने की तारीख बीत चुकी है.
PENDING_FLIGHT आगे जाकर यह लाइन आइटम काम करने लगेगा.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED पार्टनर के चालू किए हुए सभी एक्सचेंज की नेगेटिव टारगेटिंग की गई है. लाइन आइटम नहीं चलेगा.
INVALID_INVENTORY_SOURCE कोई चालू इन्वेंट्री स्रोत, टारगेट नहीं किए जा रहे हैं. लाइन आइटम नहीं चलेगा.
APP_INVENTORY_INVALID_SITE_TARGETING इस लाइन आइटम की 'ऐप्लिकेशन और यूआरएल टारगेटिंग' में कोई मोबाइल ऐप्लिकेशन शामिल नहीं है. इस लाइन आइटम के टाइप के लिए आपको अपने चैनल, साइट की सूची या ऐप्लिकेशन टारगेटिंग में मोबाइल ऐप्लिकेशन शामिल करने होंगे. लाइन आइटम नहीं चलेगा.
APP_INVENTORY_INVALID_AUDIENCE_LISTS यह लाइन आइटम किसी मोबाइल उपयोगकर्ता को टारगेट नहीं कर रहा. इस लाइन आइटम के टाइप के लिए ज़रूरी है कि आप मोबाइल उपयोगकर्ताओं वाली उपयोगकर्ता सूची को टारगेट करें. लाइन आइटम नहीं चलेगा.
NO_VALID_CREATIVE इस लाइन आइटम में कोई मान्य क्रिएटिव मौजूद नहीं है. लाइन आइटम नहीं चलेगा.
PARENT_INSERTION_ORDER_PAUSED इस लाइन आइटम के लिए इंसर्ट करने का क्रम रोका गया है. लाइन आइटम नहीं चलेगा.
PARENT_INSERTION_ORDER_EXPIRED इस लाइन आइटम के इंसर्शन ऑर्डर की खत्म होने की तारीख बीत चुकी है. लाइन आइटम नहीं चलेगा.
NO_POSITIVE_AUDIENCE_LIST_TARGETED यह लाइन आइटम किसी दर्शक सूची को टारगेट नहीं करता. इससे आपका बजट बहुत जल्दी खत्म हो जाएगा.
APP_INSTALL_NO_CONVERSION_PIXEL इस ऐप्लिकेशन इंस्टॉल लाइन आइटम के लिए कन्वर्ज़न पिक्सल सेट नहीं है.
TARGETING_REVOKED_OR_CLOSED_USER_LIST यह लाइन आइटम एक या उससे ज़्यादा ऐसी उपयोगकर्ता सूचियों को टारगेट करता है जो अब उपलब्ध नहीं हैं. आने वाले समय में, इसकी वजह से लाइन आइटम नहीं दिखेगा. इसलिए, अपनी टारगेटिंग से इन सूचियों को हटाएं.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY ऐप्लिकेशन इंस्टॉल के इस लाइन आइटम के लिए कोई सबसे अच्छी बोली लगाने की रणनीति मौजूद नहीं है.
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS इस लाइन आइटम से टारगेट की जाने वाली डील क्रिएटिव के ऐसे आकार स्वीकार करती हैं जो इस्तेमाल नहीं किए जाते. इसका असर उस लाइन आइटम की डिलीवरी और प्रदर्शन पर पड़ता है.
NO_CREATIVE_FOR_TARGETED_DEALS इस लाइन आइटम में टारगेट की गई डील के लिए कोई क्रिएटिव शामिल नहीं है.
TARGETING_DEPRECATED_GEO_TARGET यह लाइन आइटम ऐसे भौगोलिक टारगेट को टारगेट करता है जो अब सेवा में नहीं है.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

यह लाइन आइटम, excludeFirstPartyAudience सेटिंग का इस्तेमाल करता है. यह सेटिंग अब काम नहीं करती. इसे 25 मार्च, 2023 के बाद बंद करने के लिए शेड्यूल किया गया है.

excludeFirstPartyAudience फ़ील्ड बंद होने का ध्यान रखने के लिए, 25 मार्च, 2023 से पहले, ऑडियंस टारगेटिंग का इस्तेमाल करके पहले पक्ष की ऑडियंस को सीधे बाहर रखने के लिए, अपने एपीआई इंटिग्रेशन को अपडेट करें.

MobileApp

मोबाइल ऐप्लिकेशन इंस्टॉल लाइन आइटम के ज़रिए प्रमोट किया गया मोबाइल ऐप्लिकेशन.

JSON के काेड में दिखाना
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
फ़ील्ड
appId

string

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

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

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

platform

enum (Platform)

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

displayName

string

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

publisher

string

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

प्लैटफ़ॉर्म

संभावित मोबाइल ऐप्लिकेशन प्लैटफ़ॉर्म.

Enums
PLATFORM_UNSPECIFIED प्लेटफ़ॉर्म नहीं दिया गया है.
IOS iOS प्लैटफ़ॉर्म.
ANDROID Android प्लैटफ़ॉर्म.

तरीके

bulkEditLineItemAssignedTargetingOptions

एक लाइन आइटम में मौजूद टारगेटिंग के विकल्पों में, एक साथ कई बदलाव करने की सुविधा.

bulkListLineItemAssignedTargetingOptions

टारगेटिंग के अलग-अलग टाइप में, किसी लाइन आइटम के असाइन किए गए टारगेटिंग विकल्प की सूची बनाता है.

create

एक नया लाइन आइटम बनाता है.

delete

एक लाइन आइटम को मिटाता है.

generateDefault

इंसर्शन ऑर्डर और ENTITY_STATUS_DRAFT entity_status से इनहेरिट की गई सेटिंग (इसमें टारगेटिंग भी शामिल है) के साथ एक नया लाइन आइटम बनाता है.

get

इससे एक लाइन आइटम मिलता है.

list

यह विज्ञापन देने वाले में लाइन आइटम की सूची बनाता है.

patch

इससे मौजूदा लाइन आइटम को अपडेट किया जाता है.