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)
    }
  ],
  "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)

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

आरएफ़सी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

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