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)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": 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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

लाइन आइटम से जुड़ी पार्टनर की लागत.

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

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

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

object (FrequencyCap)

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

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

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

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

string (int64 format)

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

object (BiddingStrategy)

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

object (IntegrationDetails)

लाइन आइटम के इंटिग्रेशन की जानकारी.
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

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

object (YoutubeAndPartnersSettings)

ज़रूरी नहीं. YouTube और पार्टनर के लाइन आइटम के लिए खास सेटिंग.
demandGenSettings

object (DemandGenSettings)

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

यह सिर्फ़ मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम पर लागू होता है.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

क्या इस लाइन आइटम से, यूरोपियन यूनियन में दिखाए जाने वाले राजनैतिक विज्ञापन दिखाए जाएंगे.

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

नया लाइन आइटम बनाते समय, यह फ़ील्ड असाइन करना ज़रूरी है. ऐसा न करने पर, advertisers.lineItems.create का अनुरोध पूरा नहीं होगा.
optimizeFixedBidding

boolean

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

डिफ़ॉल्ट रूप से, DV360 आपकी तय बिड को ऑप्टिमाइज़ करता है. इसके लिए, वह उन इंप्रेशन के लिए बिड अपने-आप कम कर देता है जिनकी परफ़ॉर्मेंस अच्छी होने की संभावना कम होती है. यह ऑप्टिमाइज़ेशन डिफ़ॉल्ट रूप से चालू होता है. इसकी वैल्यू 'सही' होती है.

इस फ़ील्ड को false पर सेट करने पर, ऑप्टिमाइज़ेशन की यह सुविधा बंद हो जाती है. साथ ही, बिड को किसी भी वजह से कम नहीं किया जाएगा.

यह सेटिंग सिर्फ़ उन लाइन आइटम पर लागू होती है जिनमें FIXED_BID टाइप का biddingStrategy है.

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 ओटीटी इंसर्शन ऑर्डर में मौजूद ओटीटी विज्ञापन. यह टाइप सिर्फ़ उन लाइन आइटम पर लागू होता है जिनका इंसर्शन ऑर्डर insertionOrderType OVER_THE_TOP है.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

YouTube वीडियो विज्ञापन, जो कन्वर्ज़न को बढ़ावा देते हैं.

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

YouTube वीडियो विज्ञापन (ज़्यादा से ज़्यादा 15 सेकंड), जिन्हें स्किप नहीं किया जा सकता.

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

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

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

YouTube ऑडियो विज्ञापन.

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

YouTube वीडियो विज्ञापन, जो कम खर्च में ज़्यादा यूनीक उपयोगकर्ताओं तक पहुंचने के लिए ऑप्टिमाइज़ करते हैं. इनमें बंपर विज्ञापन, स्किप किए जा सकने वाले इन-स्ट्रीम विज्ञापन या दोनों तरह के विज्ञापन शामिल हो सकते हैं.

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

YouTube वीडियो विज्ञापनों के लिए डिफ़ॉल्ट सेटिंग.

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

कनेक्टेड टीवी पर दिखने वाले YouTube वीडियो विज्ञापन (ज़्यादा से ज़्यादा 15 सेकंड के), जिन्हें स्किप नहीं किया जा सकता.

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

कनेक्टेड टीवी पर दिखने वाले YouTube वीडियो विज्ञापन, जो कम खर्च में ज़्यादा यूनीक उपयोगकर्ताओं तक पहुंचने के लिए ऑप्टिमाइज़ किए जाते हैं. इसमें बंपर विज्ञापन, स्किप किए जा सकने वाले इन-स्ट्रीम विज्ञापन या दोनों तरह के विज्ञापन शामिल हो सकते हैं.

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

कनेक्टेड टीवी पर डिफ़ॉल्ट रूप से दिखने वाले YouTube वीडियो विज्ञापन. सिर्फ़ इन-स्ट्रीम विज्ञापन फ़ॉर्मैट शामिल करें.

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

इस लाइन आइटम टाइप का मकसद, YouTube विज्ञापनों को किसी व्यक्ति को एक तय समयावधि में, टारगेट की गई संख्या के हिसाब से दिखाना है.

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

YouTube वीडियो विज्ञापन, जिनका मकसद अलग-अलग विज्ञापन फ़ॉर्मैट की मदद से ज़्यादा व्यू पाना है.

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

डिजिटल आउट-ऑफ़-होम इन्वेंट्री पर दिखाए जाने वाले डिसप्ले विज्ञापन.

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

डिजिटल आउट-ऑफ़-होम इन्वेंट्री पर दिखाए जाने वाले वीडियो विज्ञापन.

इस तरह के लाइन आइटम और उनकी टारगेटिंग को एपीआई का इस्तेमाल करके न तो बनाया जा सकता है और न ही अपडेट किया जा सकता है.
LINE_ITEM_TYPE_DEMAND_GEN मांग बढ़ाने में मदद करने वाले विज्ञापन.

LineItemFlight

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

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

enum (LineItemFlightDateType)

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

object (DateRange)

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

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

LineItemFlightDateType

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

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

LineItemBudget

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

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

enum (LineItemBudgetAllocationType)

ज़रूरी है. बजट के बंटवारे का टाइप.

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

मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम के लिए, इस फ़ील्ड को LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED पर सेट करना ज़रूरी है.
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)

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

मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम के लिए, इस फ़ील्ड को PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP पर सेट करना ज़रूरी है.
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)
    }
  ],
  "primaryAttributionModelId": string
}
फ़ील्ड
postViewCountPercentageMillis

string (int64 format)

गिनती किए जाने वाले पोस्ट-व्यू कन्वर्ज़न का प्रतिशत, मिलीसेकंड में (प्रतिशत का 1/1000). यह वैल्यू, 0 और 1,00,000 के बीच होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है.

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

object (TrackingFloodlightActivityConfig)

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

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

अगर लाइन आइटम को कस्टम बिडिंग एल्गोरिदम असाइन किया गया है, तो इस फ़ील्ड को अपडेट नहीं किया जा सकता. अगर आपने इस फ़ील्ड को सेट किया है और एक ही अनुरोध में कस्टम बिडिंग एल्गोरिदम असाइन किया है, तो Floodlight गतिविधियां, कस्टम बिडिंग एल्गोरिदम में इस्तेमाल की गई गतिविधियों से मैच होनी चाहिए.
primaryAttributionModelId

string (int64 format)

ज़रूरी नहीं. कन्वर्ज़न मेज़रमेंट के लिए इस्तेमाल किया जाने वाला एट्रिब्यूशन मॉडल. इस एट्रिब्यूशन मॉडल से यह तय होगा कि कन्वर्ज़न की गिनती कैसे की जाए. प्राइमरी मॉडल को Floodlight कॉन्फ़िगरेशन या ग्रुप के लिए सेट किया जा सकता है. ज़्यादा जानकारी के लिए यहां जाएं.

यह सिर्फ़ मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम पर लागू होता है.

TrackingFloodlightActivityConfig

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

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

string (int64 format)

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

integer

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

integer

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

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 इस लाइन आइटम के इंसर्ट करने के क्रम की खत्म होने की तारीख निकल चुकी है. लाइन आइटम नहीं चलेगा.

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 प्लैटफ़ॉर्म.

YoutubeAndPartnersSettings

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

JSON के काेड में दिखाना 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
फ़ील्ड
viewFrequencyCap

object (FrequencyCap)

लाइन आइटम के लिए, विज्ञापन दिखने की फ़्रीक्वेंसी कैप की सेटिंग.

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

object (ThirdPartyMeasurementConfigs)

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

object (YoutubeAndPartnersInventorySourceConfig)

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

enum (YoutubeAndPartnersContentCategory)

सिर्फ़ आउटपुट के लिए. YouTube और पार्टनर साइटों पर दिखने वाले विज्ञापनों के लिए कॉन्टेंट का टाइप.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

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

object (TargetFrequency)

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

string (int64 format)

ज़रूरी नहीं. प्रॉडक्ट फ़ीड उपलब्ध कराने के लिए इस्तेमाल किए गए Merchant Center खाते का आईडी.

यह Merchant Center खाता, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते से पहले से लिंक होना चाहिए.
relatedVideos[]

object (RelatedVideo)

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

string (int64 format)

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

object (VideoAdSequenceSettings)

ज़रूरी नहीं. VideoAdSequence से जुड़ी सेटिंग.
videoAdInventoryControl

object (VideoAdInventoryControl)

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

ThirdPartyMeasurementConfigs

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

JSON के काेड में दिखाना 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
फ़ील्ड
viewabilityVendorConfigs[]

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
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

तीसरे पक्ष के मेज़रमेंट वेंडर को कॉन्फ़िगर करने का तरीका कंट्रोल करने वाली सेटिंग.

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

enum (ThirdPartyVendor)

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

string

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

ThirdPartyVendor

तीसरे पक्ष के मेज़रमेंट की सुविधा देने वाले वेंडर.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED तीसरे पक्ष का वेंडर अज्ञात है.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY टेलीमेट्री.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN मूल दस्तावेज़ के तौर पर दिखाता है.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV ISpot TV.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

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

JSON के काेड में दिखाना 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
फ़ील्ड
includeYoutube

boolean

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

boolean

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

boolean

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

YoutubeAndPartnersContentCategory

YouTube और पार्टनर के कॉन्टेंट के लिए, ब्रैंड सुरक्षा की कैटगरी.

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED इस वर्शन में, कॉन्टेंट की कैटगरी के बारे में नहीं बताया गया है या उसकी जानकारी नहीं है.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD इस कैटगरी में कई तरह का कॉन्टेंट शामिल होता है, जो ज़्यादातर ब्रैंड के लिए सही होता है. कॉन्टेंट, विज्ञापन देने वालों के लिहाज़ से अच्छा कॉन्टेंट बनाने के लिए YouTube के दिशा-निर्देशों के मुताबिक हो.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED इस कैटगरी में, YouTube और वीडियो पार्टनर पर मौजूद ऐसा कॉन्टेंट शामिल होता है जो कमाई करने के मानकों को पूरा करता है.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED इस कैटगरी में, कम कॉन्टेंट शामिल होता है. यह कॉन्टेंट, सख्त शर्तों को पूरा करता है. खास तौर पर, आपत्तिजनक भाषा और सेक्शुअल ऐक्ट दिखाने वाले कॉन्टेंट से जुड़ी शर्तों को.

TargetFrequency

यह सेटिंग, किसी तय समयावधि में एक ही व्यक्ति को विज्ञापनों को दिखाए जाने की औसत संख्या को कंट्रोल करती है.

JSON के काेड में दिखाना 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
फ़ील्ड
targetCount

string (int64 format)

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

enum (TimeUnit)

समय की वह इकाई जिसमें विज्ञापन दिखाने की फ़्रीक्वेंसी लागू की जाएगी.

समय की यह इकाई लागू होती है:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

विज्ञापन दिखाने की फ़्रीक्वेंसी की अवधि के लिए timeUnit की संख्या.

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

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

RelatedVideo

यह मिलते-जुलते वीडियो की एंट्री को दिखाता है.

JSON के काेड में दिखाना 
{
  "videoId": string,
  "videoAssetId": string
}
फ़ील्ड
videoId

string

सिर्फ़ आउटपुट के लिए. मिलते-जुलते वीडियो का YouTube वीडियो आईडी.
videoAssetId

string (int64 format)

ज़रूरी है. YouTube वीडियो के लिए, AdAsset संसाधन का adAssetId.

VideoAdSequenceSettings

सिलसिलेवार वीडियो विज्ञापन से जुड़ी सेटिंग.

JSON के काेड में दिखाना 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
फ़ील्ड
minimumDuration

enum (VideoAdSequenceMinimumDuration)

वह कम से कम समयावधि जिसके बाद, उसी उपयोगकर्ता को यह क्रम फिर से दिखेगा.
steps[]

object (VideoAdSequenceStep)

क्रम में शामिल चरण.

VideoAdSequenceMinimumDuration

एक ही उपयोगकर्ता को VideoAdSequence फिर से दिखने से पहले, कम से कम इंटरवल के लिए enum.

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED नहीं बताया गया है या जानकारी नहीं है.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK सात दिन.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 दिन.

VideoAdSequenceStep

VideoAdSequence में किसी एक चरण की जानकारी.

JSON के काेड में दिखाना 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
फ़ील्ड
stepId

string (int64 format)

स्टेप का आईडी.
adGroupId

string (int64 format)

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

string (int64 format)

पिछले चरण का आईडी. पहले चरण से पहले कोई चरण नहीं होता.
interactionType

enum (InteractionType)

पिछले चरण पर किया गया इंटरैक्शन, जो दर्शक को इस चरण पर ले जाएगा. पहले चरण में, interactionType नहीं होता.

InteractionType

किसी चरण पर इंटरैक्शन के टाइप.

Enums
INTERACTION_TYPE_UNSPECIFIED जानकारी नहीं है या पता नहीं है
INTERACTION_TYPE_PAID_VIEW पेड व्यू.
INTERACTION_TYPE_SKIP दर्शक ने स्किप कर दिया.
INTERACTION_TYPE_IMPRESSION विज्ञापन इंप्रेशन (देखा गया).
INTERACTION_TYPE_ENGAGED_IMPRESSION ऐसा विज्ञापन इंप्रेशन जिसे दर्शक ने तुरंत स्किप नहीं किया, लेकिन वह बिलिंग के लायक इवेंट तक भी नहीं पहुंचा.

VideoAdInventoryControl

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

JSON के काेड में दिखाना 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
फ़ील्ड
allowInStream

boolean

ज़रूरी नहीं. क्या विज्ञापनों को इन-स्ट्रीम फ़ॉर्मैट में दिखाया जा सकता है.
allowInFeed

boolean

ज़रूरी नहीं. विज्ञापनों को फ़ीड में विज्ञापन फ़ॉर्मैट में दिखाया जा सकता है या नहीं.
allowShorts

boolean

ज़रूरी नहीं. क्या विज्ञापनों को Shorts फ़ॉर्मैट में दिखाया जा सकता है.
allowNonSkippableInStream

boolean

ज़रूरी नहीं. इससे पता चलता है कि विज्ञापनों को स्किप न किए जा सकने वाले इन-स्ट्रीम फ़ॉर्मैट में दिखाया जा सकता है या नहीं.

DemandGenSettings

मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम की सेटिंग.

JSON के काेड में दिखाना 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
फ़ील्ड
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ज़रूरी नहीं. मांग बढ़ाने में मदद करने वाले कैंपेन लाइन आइटम के लिए, तीसरे पक्ष की मेज़रमेंट सेटिंग.
linkedMerchantId

string (int64 format)

ज़रूरी नहीं. प्रॉडक्ट फ़ीड उपलब्ध कराने के लिए इस्तेमाल किए गए Merchant Center खाते का आईडी.

यह Merchant Center खाता, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते से पहले से लिंक होना चाहिए.
geoLanguageTargetingEnabled

boolean

ज़रूरी नहीं. इम्यूटेबल. क्या जगह और भाषा के हिसाब से टारगेटिंग को लाइन आइटम लेवल पर सेट किया जा सकता है. अन्यथा, प्रासंगिक टारगेटिंग के टाइप को सीधे विज्ञापन ग्रुप को असाइन करना होगा.

तरीके

bulkEditAssignedTargetingOptions

 एक से ज़्यादा लाइन आइटम में, टारगेटिंग के विकल्पों में एक साथ बदलाव करना.

bulkListAssignedTargetingOptions

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

bulkUpdate

 एक से ज़्यादा लाइन आइटम अपडेट करता है.

create

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

delete

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

duplicate

 किसी लाइन आइटम का डुप्लीकेट बनाता है.

get

 लाइन आइटम की जानकारी फ़ेच करता है.

list

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

patch

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