REST Resource: inventorySources

संसाधन: InventorySource

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

जेएसओएन के काेड में दिखाना 
{
  "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)
    }
  ],
  "subSitePropertyId": string,
  "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

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

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

object (InventorySourceStatus)

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

enum (Exchange)

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

string (Timestamp format)

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

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

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

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

InventorySourceType

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

Enums
INVENTORY_SOURCE_TYPE_UNSPECIFIED इस वर्शन में इन्वेंट्री सोर्स के टाइप की जानकारी नहीं दी गई है या इसकी जानकारी नहीं है.
INVENTORY_SOURCE_TYPE_PRIVATE निजी इन्वेंट्री का सोर्स.
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE नीलामी का पैकेज.

InventorySourceProductType

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

Enums
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED इस वर्शन में प्रॉडक्ट टाइप की जानकारी नहीं दी गई है या इसकी जानकारी नहीं है. एपीआई की मदद से, इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव नहीं किया जा सकता.
PREFERRED_DEAL इन्वेंट्री सोर्स, Preferred Deal के ज़रिए इन्वेंट्री बेचता है.
PRIVATE_AUCTION इन्वेंट्री सोर्स, निजी नीलामी की मदद से इन्वेंट्री बेचता है.
PROGRAMMATIC_GUARANTEED इन्वेंट्री सोर्स, प्रोग्रामैटिक गारंटी के साथ इन्वेंट्री बेचता है.
TAG_GUARANTEED इन्वेंट्री सोर्स, Tag की गारंटी के साथ इन्वेंट्री बेचता है.
YOUTUBE_RESERVE इन्वेंट्री सोर्स, YouTube Reserve के ज़रिए इन्वेंट्री बेचता है.
INSTANT_RESERVE इन्वेंट्री सोर्स, Instant Reserve के ज़रिए इन्वेंट्री बेचता है. एपीआई की मदद से, इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव नहीं किया जा सकता.
GUARANTEED_PACKAGE इन्वेंट्री सोर्स, गारंटी वाले पैकेज के ज़रिए इन्वेंट्री बेचता है. एपीआई की मदद से, इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव नहीं किया जा सकता.
PROGRAMMATIC_TV इन्वेंट्री सोर्स, प्रोग्रामैटिक टीवी की मदद से इन्वेंट्री बेचता है. एपीआई की मदद से, इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव नहीं किया जा सकता.
AUCTION_PACKAGE इन्वेंट्री सोर्स, नीलामी पैकेज के ज़रिए इन्वेंट्री बेचता है. एपीआई की मदद से, इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव नहीं किया जा सकता.

InventorySourceCommitment

इन्वेंट्री सोर्स के लिए, तय किए गए शुल्क के कुछ टाइप.

Enums
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED इस वर्शन में प्रतिबद्धता मौजूद नहीं है या इसकी जानकारी नहीं है.
INVENTORY_SOURCE_COMMITMENT_GUARANTEED तय किया गया समय, डिलीवरी की गारंटी है.
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED वादे में डिलीवरी की गारंटी नहीं है.

InventorySourceDeliveryMethod

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

Enums
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED इस वर्शन में डिलीवरी का तरीका नहीं बताया गया है या इसकी जानकारी नहीं है.
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC डिलीवरी का तरीका, प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए होता है.
INVENTORY_SOURCE_DELIVERY_METHOD_TAG डिलीवरी का तरीका टैग है.

InventorySourceStatus

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

जेएसओएन के काेड में दिखाना 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}
फ़ील्ड
entityStatus

enum (EntityStatus)

इन्वेंट्री का सोर्स दिखाया जा सकता है या नहीं.

स्वीकार की जाने वाली वैल्यू ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED, और ENTITY_STATUS_PAUSED हैं. डिफ़ॉल्ट वैल्यू ENTITY_STATUS_ACTIVE है.
entityPauseReason

string

उपयोगकर्ता ने इस इन्वेंट्री सोर्स को रोकने की वजह बताई है.

नाम 100 से ज़्यादा वर्ण का नहीं होना चाहिए.

सिर्फ़ तब लागू होता है, जब entityStatus को ENTITY_STATUS_PAUSED पर सेट किया गया हो.
sellerStatus

enum (EntityStatus)

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

सिर्फ़ उन इन्वेंट्री सोर्स के लिए लागू होता है जिन्हें सीधे तौर पर पब्लिशर से सिंक किया गया है. ENTITY_STATUS_ACTIVE और ENTITY_STATUS_PAUSED वैल्यू स्वीकार की जाती हैं.
sellerPauseReason

string

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

सिर्फ़ उन इन्वेंट्री सोर्स के लिए लागू होता है जिन्हें सीधे तौर पर पब्लिशर से सिंक किया गया है. साथ ही, यह तब लागू होता है, जब sellerStatus को ENTITY_STATUS_PAUSED पर सेट किया गया हो.
configStatus

enum (InventorySourceConfigStatus)

सिर्फ़ आउटपुट के लिए. इन्वेंट्री सोर्स के कॉन्फ़िगरेशन की स्थिति.

यह ऑफ़र, सिर्फ़ गारंटी वाले इन्वेंट्री सोर्स के लिए लागू होता है. INVENTORY_SOURCE_CONFIG_STATUS_PENDING और INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED वैल्यू स्वीकार की जाती हैं.

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

InventorySourceConfigStatus

गारंटी वाले इन्वेंट्री सोर्स के लिए, कॉन्फ़िगरेशन की संभावित स्थिति.

Enums
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED इस वर्शन में, अनुमति की स्थिति की जानकारी नहीं है या इसकी जानकारी नहीं है.
INVENTORY_SOURCE_CONFIG_STATUS_PENDING गारंटी वाले इन्वेंट्री सोर्स की शुरुआती स्थिति. इस स्थिति में इन्वेंट्री सोर्स को कॉन्फ़िगर करना ज़रूरी है.
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED खरीदार के गारंटी वाले इन्वेंट्री सोर्स को कॉन्फ़िगर करने के बाद की स्थिति.

RateDetails

इन्वेंट्री सोर्स की दर से जुड़ी सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}
फ़ील्ड
inventorySourceRateType

enum (InventorySourceRateType)

दर का टाइप.

स्वीकार की जाने वाली वैल्यू INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR, और INVENTORY_SOURCE_RATE_TYPE_CPD हैं.
rate

object (Money)

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

string (int64 format)

ऐसे इन्वेंट्री सोर्स के लिए ज़रूरी है जिनकी गारंटी दी जाती है. ऐसे इंप्रेशन की संख्या जिनकी गारंटी विक्रेता से मिली है.
minimumSpend

object (Money)

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

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

InventorySourceRateType

इन्वेंट्री सोर्स के लिए संभावित दर के टाइप.

Enums
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED दर के टाइप की जानकारी नहीं दी गई है या इस वर्शन में उसकी जानकारी नहीं है.
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED दर का टाइप सीपीएम (तय) है.
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR दर का प्रकार सीपीएम (फ़्लोर) है.
INVENTORY_SOURCE_RATE_TYPE_CPD दर का टाइप, हर दिन की लागत है.
INVENTORY_SOURCE_RATE_TYPE_FLAT दर का टाइप, एक जैसा होता है.

धन

किसी रकम को उसके मुद्रा टाइप के साथ दिखाता है.

जेएसओएन के काेड में दिखाना 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
फ़ील्ड
currencyCode

string

तीन अक्षर वाला मुद्रा कोड, जिसके बारे में ISO 4217 में बताया गया है.
units

string (int64 format)

रकम की पूरी इकाइयां. उदाहरण के लिए, अगर currencyCode "USD" है, तो 1 यूनिट एक डॉलर होगी.
nanos

integer

मात्रा की नैनो (10^-9) यूनिट की संख्या. वैल्यू -9,99,99,999 से 9,99,99,999 के बीच होनी चाहिए. अगर units धनात्मक है, तो nanos का मान धनात्मक या शून्य होना चाहिए. अगर units शून्य है, तो nanos पॉज़िटिव, शून्य या नेगेटिव हो सकता है. अगर units ऋणात्मक है, तो nanos को ऋणात्मक या शून्य होना चाहिए. उदाहरण के लिए, $-1.75 को units=-1 और nanos=-7,50,000,000 के तौर पर दिखाया जाता है.

TimeRange

कोई समयसीमा.

जेएसओएन के काेड में दिखाना 
{
  "startTime": string,
  "endTime": string
}
फ़ील्ड
startTime

string (Timestamp format)

ज़रूरी है. इसमें किसी समयसीमा की निचली सीमा भी शामिल होती है.

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

string (Timestamp format)

ज़रूरी है. किसी समयसीमा की ऊपरी सीमा, जिसमें ये दोनों शामिल हैं.

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

CreativeConfig

इन्वेंट्री सोर्स के लिए क्रिएटिव की शर्तों का कॉन्फ़िगरेशन.

जेएसओएन के काेड में दिखाना 
{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}
फ़ील्ड
creativeType

enum (CreativeType)

इन्वेंट्री सोर्स को असाइन किया जा सकने वाला क्रिएटिव टाइप. सिर्फ़ ये टाइप काम करते हैं:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

यूनियन फ़ील्ड creative_config_scheme. यह तब लागू होता है, जब creative_type इनमें से कोई एक हो:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

इन्वेंट्री सोर्स को असाइन किए जा सकने वाले क्रिएटिव का कॉन्फ़िगरेशन. creative_config_scheme इनमें से सिर्फ़ एक हो सकता है:
displayCreativeConfig

object (InventorySourceDisplayCreativeConfig)

डिसप्ले क्रिएटिव का कॉन्फ़िगरेशन. creativeType के CREATIVE_TYPE_STANDARD होने पर ही लागू होगा.
videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

वीडियो क्रिएटिव के लिए कॉन्फ़िगरेशन. creativeType के CREATIVE_TYPE_VIDEO होने पर ही लागू होगा.

InventorySourceDisplayCreativeConfig

डिसप्ले क्रिएटिव का कॉन्फ़िगरेशन.

जेएसओएन के काेड में दिखाना 
{
  "creativeSize": {
    object (Dimensions)
  }
}
फ़ील्ड
creativeSize

object (Dimensions)

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

InventorySourceVideoCreativeConfig

वीडियो क्रिएटिव के लिए कॉन्फ़िगरेशन.

जेएसओएन के काेड में दिखाना 
{
  "duration": string
}
फ़ील्ड
duration

string (Duration format)

वीडियो क्रिएटिव के लिए अवधि की ज़रूरी शर्तें, जिन्हें इन्वेंट्री सोर्स में असाइन किया जा सकता है.

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

InventorySourceAccessors

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

जेएसओएन के काेड में दिखाना 
{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}
फ़ील्ड
यूनियन फ़ील्ड accessors. वह पार्टनर या विज्ञापन देने वाले जिनके पास इन्वेंट्री सोर्स का ऐक्सेस है. accessors इनमें से सिर्फ़ एक हो सकता है:
partner

object (PartnerAccessor)

वह पार्टनर जिसके पास इन्वेंट्री सोर्स का ऐक्सेस है.
advertisers

object (AdvertiserAccessors)

विज्ञापन देने वाले ऐसे लोग जिनके पास इन्वेंट्री सोर्स का ऐक्सेस है. विज्ञापन देने वाले सभी लोगों या कंपनियों का एक ही पार्टनर से जुड़ा होना ज़रूरी है.

PartnerAccessor

वह पार्टनर जिसके पास इन्वेंट्री सोर्स का ऐक्सेस है.

जेएसओएन के काेड में दिखाना 
{
  "partnerId": string
}
फ़ील्ड
partnerId

string (int64 format)

पार्टनर का आईडी.

AdvertiserAccessors

विज्ञापन देने वाले ऐसे लोग जिनके पास इन्वेंट्री सोर्स का ऐक्सेस है.

जेएसओएन के काेड में दिखाना 
{
  "advertiserIds": [
    string
  ]
}
फ़ील्ड
advertiserIds[]

string (int64 format)

विज्ञापन देने वालों के आईडी.

तरीके

create

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

editInventorySourceReadWriteAccessors

 इन्वेंट्री सोर्स के रीड/राइट ऐक्सेसर में बदलाव करता है.

get

 इन्वेंट्री सोर्स दिखाता है.

list

 यह इन्वेंट्री के उन सोर्स की सूची बनाता है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकते हैं.

patch

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