REST Resource: partners.inventorySources

संसाधन: InventorySource

कोई इन्वेंट्री सोर्स.

JSON के काेड में दिखाना
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
फ़ील्ड
name

string

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

inventorySourceId

string (int64 format)

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

displayName

string

इन्वेंट्री सोर्स का डिसप्ले नेम.

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

inventorySourceType

enum (InventorySourceType)

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

inventorySourceProductType

enum (InventorySourceProductType)

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

commitment

enum (InventorySourceCommitment)

इन्वेंट्री सोर्स में गारंटी वाली डिलीवरी है या बिना गारंटी वाली डिलीवरी.

deliveryMethod

enum (InventorySourceDeliveryMethod)

इन्वेंट्री सोर्स की डिलीवरी का तरीका.

  • बिना गारंटी वाली इन्वेंट्री के सोर्स के लिए, सिर्फ़ INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC वैल्यू स्वीकार की जाती है.
  • गारंटी वाली इन्वेंट्री के सोर्स के लिए, INVENTORY_SOURCE_DELIVERY_METHOD_TAG और INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC वैल्यू इस्तेमाल की जा सकती हैं.
dealId

string

Exchange स्पेस में मौजूद आईडी, जिससे इन्वेंट्री सोर्स की खास तौर पर पहचान की जाती है.

हर एक्सचेंज में, खरीदारों के लिए यह आईडी यूनीक होना चाहिए. हालांकि, यह ज़रूरी नहीं है कि अलग-अलग एक्सचेंज में भी यह आईडी यूनीक हो.

status

object (InventorySourceStatus)

इन्वेंट्री सोर्स की स्थिति की सेटिंग.

exchange

enum (Exchange)

वह एक्सचेंज जिससे इन्वेंट्री सोर्स जुड़ा है.

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

rateDetails

object (RateDetails)

ज़रूरी है. इन्वेंट्री सोर्स के रेट की जानकारी.

publisherName

string

इन्वेंट्री सोर्स के पब्लिशर/सेलर का नाम.

timeRange

object (TimeRange)

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

creativeConfigs[]

object (CreativeConfig)

इन्वेंट्री सोर्स के क्रिएटिव से जुड़ी ज़रूरी शर्तें.

नीलामी वाले पैकेज के लिए लागू नहीं है.

guaranteedOrderId

string

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

यह सिर्फ़ तब लागू होता है, जब commitment की वैल्यू INVENTORY_SOURCE_COMMITMENT_GUARANTEED हो.

readWriteAccessors

object (InventorySourceAccessors)

ऐसे पार्टनर या विज्ञापन देने वाले जिनके पास इन्वेंट्री सोर्स को पढ़ने/लिखने का ऐक्सेस है.

यह आउटपुट सिर्फ़ तब मिलता है, जब commitment की वैल्यू INVENTORY_SOURCE_COMMITMENT_GUARANTEED हो. इस मामले में, रीड/राइट ऐक्सेसर, पैरंट गारंटीड ऑर्डर से इनहेरिट किए जाते हैं.

commitment की वैल्यू INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED होने पर ज़रूरी है.

अगर commitment को INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED पर सेट किया गया है और इस फ़ील्ड में कोई पार्टनर सेट है, तो इस पार्टनर के तहत आने वाले सभी विज्ञापन देने वाले लोगों या कंपनियों को इन्वेंट्री सोर्स का रीड-ओनली ऐक्सेस अपने-आप मिल जाएगा. विज्ञापन देने वाले इन लोगों या कंपनियों को readAdvertiserIds में शामिल नहीं किया जाएगा.

readAdvertiserIds[]

string (int64 format)

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

readPartnerIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. उन पार्टनर के आईडी जिनके पास इन्वेंट्री सोर्स का रीड-ओनली ऐक्सेस है.

इस फ़ील्ड में मौजूद पार्टनर के सभी विज्ञापन देने वालों को, इन्वेंट्री सोर्स का रीड-ओनली ऐक्सेस मिलता है.

तरीके

get

इन्वेंट्री सोर्स की डील की जानकारी फ़ेच करता है.

list

इन्वेंट्री सोर्स की डील की सूची दिखाता है.