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)
    }
  ],
  "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 इन्वेंट्री सोर्स, 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,999,999 से 9,99,999,999 के बीच होनी चाहिए. अगर units धनात्मक है, तो nanos का मान धनात्मक या शून्य होना चाहिए. अगर units शून्य है, तो nanos पॉज़िटिव, शून्य या नेगेटिव हो सकता है. अगर units ऋणात्मक है, तो nanos को ऋणात्मक या शून्य होना चाहिए. उदाहरण के लिए, $-1.75 को units=-1 और nanos=-7,50,00,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

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