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)

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

आरएफ़सी 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 से पता चलता है कि फ़ील्ड सेट नहीं है. इसलिए, इसमें कोई ऑडियंस टारगेटिंग नहीं है. उदाहरण: "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)

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

आरएफ़सी 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

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

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

object (DailyVolume)

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

timeZoneId

string

IANA टाइम ज़ोन डेटाबेस का टाइम ज़ोन, जैसे कि "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

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