REST Resource: 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

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

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

object (InventorySourceStatus)

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

enum (Exchange)

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण के लिए: "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 इन्वेंट्री का सोर्स, पसंदीदा डील के ज़रिए इन्वेंट्री बेचता है.
PRIVATE_AUCTION इन्वेंट्री का सोर्स, निजी नीलामी की मदद से इन्वेंट्री बेचता है.
PROGRAMMATIC_GUARANTEED इन्वेंट्री सोर्स, प्रोग्रामैटिक गारंटी के ज़रिए इन्वेंट्री बेचता है.
TAG_GUARANTEED इन्वेंट्री का सोर्स, टैग की गारंटी के साथ इन्वेंट्री बेचता है.
YOUTUBE_RESERVE इन्वेंट्री का स्रोत, YouTube Reserve के ज़रिए इन्वेंट्री बेचता है.
INSTANT_RESERVE इन्वेंट्री का स्रोत, Instant Reserve की मदद से इन्वेंट्री बेचता है. इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव, एपीआई की मदद से नहीं किया जा सकता.
GUARANTEED_PACKAGE इन्वेंट्री का सोर्स, गारंटी वाले पैकेज की मदद से इन्वेंट्री बेचता है. इस प्रॉडक्ट टाइप के इन्वेंट्री सोर्स में बदलाव, एपीआई की मदद से नहीं किया जा सकता.
PROGRAMMATIC_TV इन्वेंट्री का सोर्स, Programmtic 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

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

JSON के काेड में दिखाना 
{
  "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

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

JSON के काेड में दिखाना 
{
  "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 दर का टाइप तय नहीं है.

पैसे

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

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

string

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

string (int64 format)

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

integer

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

TimeRange

समयसीमा.

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

string (Timestamp format)

ज़रूरी है. समयसीमा की निचली सीमा, शामिल है.

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

string (Timestamp format)

ज़रूरी है. किसी समय सीमा की ऊपरी सीमा, शामिल की गई.

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

CreativeConfig

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

JSON के काेड में दिखाना 
{
  "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

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

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

object (Dimensions)

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

InventorySourceVideoCreativeConfig

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

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

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

InventorySourceAccessors

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

JSON के काेड में दिखाना 
{

  // 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

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

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

string (int64 format)

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

AdvertiserAccessors

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

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

string (int64 format)

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

तरीके

create

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

editInventorySourceReadWriteAccessors

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

get

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

list

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

patch

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