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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "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 इन्वेंट्री सोर्स, Tag Guaranteed की मदद से इन्वेंट्री बेचता है.
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

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

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "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

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