REST Resource: exchanges.inventorySources

संसाधन: InventorySource

DV360 इन्वेंट्री सोर्स का एक्ज़ीक्यूशन मॉडल.

JSON के काेड में दिखाना
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. ऑर्डर के लिए संसाधन का रिलेटिव नाम. सर्वर से जनरेट किया गया. उदाहरण: "exchanges/1234/inventorySources/5678".

buyerStatus

enum (BuyerStatus)

सिर्फ़ आउटपुट के लिए. खरीदार की स्थिति.

sellerStatus

enum (SellerStatus)

सेलर का स्टेटस.

transactionType

enum (TransactionType)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट के लेन-देन का टाइप.

pricingType

enum (PricingType)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट के लिए कीमत का टाइप.

rateDetails

object (RateDetails)

सिर्फ़ आउटपुट के लिए. किराये की जानकारी.

startTime

string (Timestamp format)

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

यह आरएफ़सी 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".

endTime

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

exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

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

audienceMatchRate

number

सिर्फ़ आउटपुट के लिए. ऑडियंस टारगेटिंग के साथ प्रोग्रामैटिक गारंटीड डील के लिए, ऑडियंस मैच रेट का अनुमान लगाया गया. इसका इस्तेमाल एक्सचेंज यह तय करने के लिए करता है कि कितने अतिरिक्त अनुरोध भेजे जाने चाहिए. यह 0 और 1 के बीच का दशमलव है. इसके व्युत्क्रम का इस्तेमाल, इंप्रेशन के लिए मल्टीप्लायर के तौर पर किया जाना चाहिए. शून्य का मतलब है कि फ़ील्ड को सेट नहीं किया गया है. इसलिए, इसमें ऑडियंस टारगेटिंग नहीं है. उदाहरण: "0.125". इससे पता चलता है कि 12.5% अनुरोध, ऑडियंस टारगेटिंग से मेल खाते हैं. साथ ही, भेजे गए अनुरोधों की संख्या, बातचीत के दौरान तय किए गए इंप्रेशन की संख्या से आठ गुना होनी चाहिए.

makegoodRequested

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि खरीदार से मेकगुड का अनुरोध किया गया है या नहीं.

makegoodRequestedReason

string

सिर्फ़ आउटपुट के लिए. खरीदार ने विज्ञापन की गड़बड़ी ठीक करने के अनुरोध की वजह बताई है.

percentFrequencyCapExcludedTraffic

string (int64 format)

प्रोग्रामैटिक गारंटी वाली डील के लिए, फ़्रीक्वेंसी कैपिंग से बाहर रखे गए ट्रैफ़िक का प्रतिशत. यह 0 से 100 के बीच का पूर्णांक होता है. वैल्यू 0 (यह डिफ़ॉल्ट वैल्यू भी है) का मतलब है कि कोई भी बाहर नहीं है. इसलिए, सभी ट्रैफ़िक पर फ़्रीक्वेंसी कैप लागू हो सकता है. 100 का मतलब है कि सभी बाहर हैं. इसलिए, किसी भी ट्रैफ़िक पर फ़्रीक्वेंसी कैप लागू नहीं होगा. 0 से 100 के बीच की वैल्यू से, कुछ हद तक बाहर रखा जाएगा. उदाहरण के लिए, वैल्यू 20 होने पर, 20% ट्रैफ़िक को फ़्रीक्वेंसी कैपिंग से बाहर रखा जाएगा.

dv360WseatId[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. ऐसे wseats जिन्हें फ़िलहाल इन्वेंट्री सोर्स का ऐक्सेस दिया गया है.

lastModifiedTime

string (Timestamp format)

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

यह आरएफ़सी 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".

creativeApprovalConfig

object (CreativeApprovalConfig)

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

BuyerStatus

खरीदार की स्थिति.

Enums
BUYER_STATUS_UNSPECIFIED खरीदार की स्थिति की जानकारी नहीं दी गई है. इनपुट की वैल्यू मान्य नहीं है.
BUYER_STATUS_ACTIVE खरीदार का स्टेटस ऐक्टिव है. लाइन आइटम असाइन किया गया है और मान्य क्रिएटिव असाइन किया गया है.
BUYER_STATUS_PENDING खरीदार की स्थिति की पुष्टि होना बाकी है. इस स्टेटस का मतलब है कि डील चालू नहीं है और खरीदार को कुछ कार्रवाइयां करनी होंगी.
BUYER_STATUS_PAUSED खरीदार ने इस लाइन आइटम को रोका है.

SellerStatus

सेलर का स्टेटस.

Enums
SELLER_STATUS_UNSPECIFIED सेलर की स्थिति की जानकारी नहीं है. यह एक अनचाही स्थिति है. इससे पता चलता है कि बातचीत की स्थिति के बारे में जानकारी नहीं है. इनपुट की वैल्यू मान्य नहीं है.
SELLER_STATUS_ACTIVE सेलर की स्थिति 'चालू है' के तौर पर सेट है. इन्वेंट्री सोर्स, एक्सचेंज पर ऐक्टिव है.
SELLER_STATUS_PAUSED सेलर का स्टेटस रोका गया.

InventorySourceVolumeForecast

किसी इन्वेंट्री सोर्स के लिए, हर दिन के अनुरोधों की संख्या का अनुमान. पुष्टि करने के ये नियम लागू होते हैं: - हफ़्ते के हर दिन के लिए एंट्री देनी होगी - वॉल्यूम, शून्य या इससे ज़्यादा होना चाहिए - timeZoneId ज़रूरी है और यह मान्य होना चाहिए

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

object (DailyVolume)

हर दिन के वॉल्यूम का अनुमान.

timeZoneId

string

आईएएनए टाइम ज़ोन डेटाबेस का टाइम ज़ोन, जैसे कि "America/New_York". इसका इस्तेमाल रोज़ाना के वॉल्यूम के लिए किया जाता है.

DailyVolume

किसी दिन के लिए, इन्वेंट्री सोर्स के लिए अनुरोधों की संख्या.

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

enum (DayOfWeek)

हफ़्ते का वह दिन जिस पर अनुरोधों की संख्या लागू होती है.

volume

string (int64 format)

हफ़्ते के किसी दिन के लिए, अनुरोधों की अनुमानित संख्या.

DayOfWeek

यह हफ़्ते के किसी दिन को दिखाता है.

Enums
DAY_OF_WEEK_UNSPECIFIED हफ़्ते का दिन तय नहीं किया गया है.
MONDAY सोमवार
TUESDAY मंगलवार
WEDNESDAY बुधवार
THURSDAY गुरुवार
FRIDAY शुक्रवार
SATURDAY शनिवार
SUNDAY रविवार

CreativeApprovalConfig

क्रिएटिव को मंज़ूरी देने के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
फ़ील्ड
requiresExchangeApproval

boolean

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

publisherConfigs[]

object (PublisherConfig)

ज़रूरी नहीं. पब्लिशर के लिए कॉन्फ़िगरेशन.

PublisherConfig

पब्लिशर के लिए कॉन्फ़िगरेशन (publisher_config). अगर publisher_config सेट है, तो क्रिएटिव को पब्लिशर लेवल पर प्री-इंजस्ट अप्रूवल की ज़रूरत होती है.

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

string

ज़रूरी है. पब्लिशर आईडी.

publisherDisplayName

string

ज़रूरी है. पब्लिशर का नाम.

तरीके

get

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

list

इन्वेंट्री सोर्स की सूची बनाता है.

patch

इन्वेंट्री सोर्स को अपडेट करता है.