REST Resource: accounts.promotions

संसाधन: प्रमोशन

किसी प्रमोशन के बारे में जानकारी देता है. ज़्यादा जानकारी के लिए, नीचे दिए गए लेख पढ़ें.

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

प्रमोशन इनपुट डालने और उसे अपडेट करने के बाद, फ़ाइनल प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.

JSON के काेड में दिखाना 
{
  "name": string,
  "promotionId": string,
  "contentLanguage": string,
  "targetCountry": string,
  "redemptionChannel": [
    enum (RedemptionChannel)
  ],
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "promotionStatus": {
    object (PromotionStatus)
  },
  "versionNumber": string
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. प्रचार का नाम. फ़ॉर्मैट: accounts/{account}/promotions/{promotion}
promotionId

string

ज़रूरी है. प्रमोशन की खास पहचान करने के लिए, उपयोगकर्ता ने जो प्रमोशन आईडी दिया है. प्रमोशन को अस्वीकार होने से बचाने के लिए, ज़रूरी शर्तों का पालन करें.
contentLanguage

string

ज़रूरी है. प्रमोशन के लिए, दो अक्षरों वाला ISO 639-1 भाषा कोड.

प्रमोशन की सुविधा सिर्फ़ चुनिंदा भाषाओं के लिए उपलब्ध है.
targetCountry

string

ज़रूरी है. टारगेट किया गया वह देश जिसका इस्तेमाल यूनीक आइडेंटिफ़ायर के हिस्से के तौर पर किया जाता है. इसे देश/इलाके के CLDR कोड के तौर पर दिखाया जाता है.

प्रमोशन सिर्फ़ चुनिंदा देशों में उपलब्ध हैं, मुफ़्त में दिखाई जाने वाली लिस्टिंग और शॉपिंग विज्ञापन स्थानीय इन्वेंट्री विज्ञापन
redemptionChannel[]

enum (RedemptionChannel)

ज़रूरी है. प्रमोशन के लिए रिडेम्पशन चैनल. कम से कम एक चैनल का होना ज़रूरी है.
dataSource

string

सिर्फ़ आउटपुट के लिए. प्रमोशन का प्राइमरी डेटा सोर्स.
attributes

object (Attributes)

ज़रूरी नहीं. प्रमोशन एट्रिब्यूट की सूची.
customAttributes[]

object (CustomAttribute)

ज़रूरी नहीं. कस्टम (व्यापारी/कंपनी/कारोबारी की ओर से दिए गए) एट्रिब्यूट की सूची. इसका इस्तेमाल, डेटा स्पेसिफ़िकेशन के किसी भी एट्रिब्यूट को उसके सामान्य फ़ॉर्म (उदाहरण के लिए, { "name": "size type", "value": "regular" }) में सबमिट करने के लिए भी किया जा सकता है. यह उन एट्रिब्यूट को सबमिट करने के लिए काम आता है जिन्हें एपीआई साफ़ तौर पर एक्सपोज़ नहीं करता.
promotionStatus

object (PromotionStatus)

सिर्फ़ आउटपुट के लिए. प्रमोशन का स्टेटस, डेटा की पुष्टि से जुड़ी समस्याएं. इसका मतलब है कि प्रमोशन की जानकारी, अलग-अलग समय पर कैलकुलेट की गई है.
versionNumber

string (int64 format)

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

अगर यह सेट है, तो मौजूदा प्रमोशन के मौजूदा वर्शन नंबर से कम वर्शन नंबर होने पर, इंसर्शन को रोक दिया जाता है. मौजूदा versionNumber की मदद से, प्रॉडक्ट को फिर से जोड़ा जा सकता है. उदाहरण के लिए, 30 दिनों के बाद प्रमोशन को रीफ़्रेश करना.

अगर कार्रवाई को रोका जाता है, तो 'कार्रवाई रोक दी गई' अपवाद को थ्रो किया जाएगा.

RedemptionChannel

प्रमोशन का चैनल.

Enums
REDEMPTION_CHANNEL_UNSPECIFIED इससे पता चलता है कि चैनल के बारे में कोई जानकारी नहीं दी गई है.
IN_STORE इससे पता चलता है कि चैनल स्टोर में मौजूद है. यह वही चैनल है जिसका इस्तेमाल products के लिए किया गया था.local
ONLINE इससे पता चलता है कि चैनल ऑनलाइन है.

विशेषताएं

एट्रिब्यूट.

JSON के काेड में दिखाना 
{
  "productApplicability": enum (ProductApplicability),
  "offerType": enum (OfferType),
  "genericRedemptionCode": string,
  "longTitle": string,
  "couponValueType": enum (CouponValueType),
  "promotionDestinations": [
    enum (DestinationEnum)
  ],
  "itemIdInclusion": [
    string
  ],
  "brandInclusion": [
    string
  ],
  "itemGroupIdInclusion": [
    string
  ],
  "productTypeInclusion": [
    string
  ],
  "itemIdExclusion": [
    string
  ],
  "brandExclusion": [
    string
  ],
  "itemGroupIdExclusion": [
    string
  ],
  "productTypeExclusion": [
    string
  ],
  "minimumPurchaseAmount": {
    object (Price)
  },
  "minimumPurchaseQuantity": string,
  "limitQuantity": string,
  "limitValue": {
    object (Price)
  },
  "percentOff": string,
  "moneyOffAmount": {
    object (Price)
  },
  "getThisQuantityDiscounted": string,
  "freeGiftValue": {
    object (Price)
  },
  "freeGiftDescription": string,
  "freeGiftItemId": string,
  "promotionEffectiveTimePeriod": {
    object (Interval)
  },
  "promotionDisplayTimePeriod": {
    object (Interval)
  },
  "storeApplicability": enum (StoreApplicability),
  "storeCodesInclusion": [
    string
  ],
  "storeCodesExclusion": [
    string
  ],
  "promotionUrl": string
}
फ़ील्ड
productApplicability

enum (ProductApplicability)

ज़रूरी है. प्रमोशन सभी प्रॉडक्ट पर लागू होगा या सिर्फ़ कुछ खास प्रॉडक्ट पर.
offerType

enum (OfferType)

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

string

ज़रूरी नहीं. प्रमोशन के लिए जेनरिक रिडेंप्शन कोड. इसे offerType फ़ील्ड के साथ इस्तेमाल किया जाना चाहिए. साथ ही, यह ज़रूरी शर्तों को पूरा करना चाहिए.
longTitle

string

ज़रूरी है. प्रमोशन का लंबा टाइटल.
couponValueType

enum (CouponValueType)

ज़रूरी है. कूपन की वैल्यू किस तरह की है एट्रिब्यूट, जिससे यह पता चलता है कि किस तरह का प्रमोशन किया जा रहा है. चुनी गई कूपन की वैल्यू के टाइप के आधार पर, कुछ एट्रिब्यूट की वैल्यू देना ज़रूरी है.
promotionDestinations[]

enum (DestinationEnum)

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

ऐसा हो सकता है कि आपने इससे पहले, अपने प्रॉडक्ट के डेस्टिनेशन के तौर पर ये वैल्यू सबमिट की हों: Shopping Actions, Surfaces across Google, Local surfaces across Google. इन वैल्यू को दिखाने के लिए, FREE_LISTINGS, FREE_LOCAL_LISTINGS, LOCAL_INVENTORY_ADS का इस्तेमाल करें. ज़्यादा जानकारी के लिए, प्रमोशन दिखाने का डेस्टिनेशन देखें
itemIdInclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, आइटम आईडी के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
brandInclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, ब्रैंड के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
itemGroupIdInclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, सामान के ग्रुप के आईडी के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट [productApplicability] एट्रिब्यूट की वैल्यू को specific_products पर सेट किया गया हो.
productTypeInclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट टाइप के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
itemIdExclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, सामान के आईडी को बाहर रखने के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
brandExclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, शामिल नहीं किए गए ब्रैंड के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
itemGroupIdExclusion[]

string

ज़रूरी नहीं. सामान के ग्रुप का आईडी के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को specific_products पर सेट किया गया हो.
productTypeExclusion[]

string

ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट टाइप एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट productApplicability एट्रिब्यूट की वैल्यू को प्रमोशन के लिए योग्य प्रॉडक्ट specific_products पर सेट किया गया हो.
minimumPurchaseAmount

object (Price)

ज़रूरी नहीं. प्रमोशन के लिए कम से कम खरीदारी की रकम.
minimumPurchaseQuantity

string (int64 format)

ज़रूरी नहीं. प्रमोशन के लिए, खरीदारी के लिए ज़रूरी कम से कम संख्या.
limitQuantity

string (int64 format)

ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट की खरीदी जा सकने वाली ज़्यादा से ज़्यादा संख्या.
limitValue

object (Price)

ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट की ज़्यादा से ज़्यादा कीमत.
percentOff

string (int64 format)

ज़रूरी नहीं. प्रमोशन में दी जाने वाली छूट का प्रतिशत.
moneyOffAmount

object (Price)

ज़रूरी नहीं. प्रमोशन में ऑफ़र की गई छूट की रकम.
getThisQuantityDiscounted

string (int64 format)

ज़रूरी नहीं. प्रमोशन में छूट वाले आइटम की संख्या. एट्रिब्यूट तब सेट होता है, जब couponValueType, buy_m_get_n_money_off या buy_m_get_n_percent_off के बराबर हो.
freeGiftValue

object (Price)

ज़रूरी नहीं. प्रमोशन के लिए मुफ़्त उपहार की कीमत.
freeGiftDescription

string

ज़रूरी नहीं. प्रमोशन के लिए मुफ़्त उपहार का ब्यौरा.
freeGiftItemId

string

ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार का आइटम आईडी.
promotionEffectiveTimePeriod

object (Interval)

ज़रूरी है. TimePeriod प्रमोशन लागू होने की तारीखों की जानकारी. इस एट्रिब्यूट से पता चलता है कि इस समयावधि के दौरान, आपके ऑनलाइन स्टोर पर प्रमोशन की जांच की जा सकती है.
promotionDisplayTimePeriod

object (Interval)

ज़रूरी नहीं. TimePeriod प्रमोशन के दिखने की तारीखों की जानकारी. यह एट्रिब्यूट उस तारीख और समय सीमा को बताता है जब प्रमोशन Google.com और शॉपिंग विज्ञापनों पर लाइव होगा. अगर प्रमोशन के दिखने की समयावधि promotionDisplayTimePeriod एट्रिब्यूट की वैल्यू सबमिट नहीं की गई है, तो प्रमोशन लागू होने की समयावधि promotionEffectiveTimePeriod एट्रिब्यूट की वैल्यू से प्रमोशन के दिखने की तारीख और उसकी समयसीमा तय होगी.
storeApplicability

enum (StoreApplicability)

ज़रूरी नहीं. प्रमोशन सभी स्टोर पर लागू होगा या सिर्फ़ कुछ खास स्टोर पर. अगर स्टोर के लिए लागू होने की कोई जानकारी शामिल नहीं की जाती है, तो स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन में गड़बड़ी का मैसेज दिखता है. अगर storeApplicability को ALL_STORES पर सेट किया गया है और storeCodesInclusion या score_code_exclusion को किसी वैल्यू पर सेट किया गया है, तो INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.
storeCodesInclusion[]

string

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

उस स्टोर का स्टोर कोड (Business Profile में मौजूद स्टोर आईडी) जहां प्रॉडक्ट बेचा जाता है. ज़्यादा जानकारी के लिए, स्थानीय प्रॉडक्ट इन्वेंट्री डेटा स्पेसिफ़िकेशन देखें.
storeCodesExclusion[]

string

ज़रूरी नहीं. प्रोमोशन के लिए, किन स्टोर कोड को शामिल नहीं करना है. स्टोर फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब storeApplicability एट्रिब्यूट को specific_stores पर सेट किया गया हो.
promotionUrl

string

ज़रूरी नहीं. कारोबारी या कंपनी की साइट के उस पेज का यूआरएल जहां प्रमोशन दिखता है. अगर promotionUrl शामिल नहीं किया गया है, तो स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन में गड़बड़ी दिखती है. यूआरएल का इस्तेमाल यह पुष्टि करने के लिए किया जाता है कि प्रमोशन मान्य है या नहीं. साथ ही, इससे प्रमोशन को रिडीम करने की जानकारी मिलेगी.

ProductApplicability

प्रमोशन किस प्रॉडक्ट या प्रॉडक्ट की सूची पर लागू होता है.

Enums
PRODUCT_APPLICABILITY_UNSPECIFIED यह पता नहीं है कि प्रमोशन किन प्रॉडक्ट पर लागू होता है.
ALL_PRODUCTS यह सभी प्रॉडक्ट पर लागू होता है.
SPECIFIC_PRODUCTS यह सिर्फ़ एक प्रॉडक्ट या प्रॉडक्ट की सूची पर लागू होता है.

OfferType

प्रमोशन का ऑफ़र टाइप.

Enums
OFFER_TYPE_UNSPECIFIED ऑफ़र का टाइप अज्ञात है.
NO_CODE कोड के बिना मिलने वाला ऑफ़र टाइप.
GENERIC_CODE कोड वाला ऑफ़र टाइप. जब offerType = GENERIC_CODE हो, तो प्रमोशन के लिए जेनरिक रिडेंप्शन कोड देना ज़रूरी है.

CouponValueType

किसी प्रमोशन के लिए, कूपन की वैल्यू किस तरह की है.

Enums
COUPON_VALUE_TYPE_UNSPECIFIED इससे पता चलता है कि कूपन की वैल्यू किस तरह की है, इसकी जानकारी नहीं दी गई है.
MONEY_OFF 'कूपन की वैल्यू किस तरह की है' एट्रिब्यूट की वैल्यू, जो छूट वाले कूपन के लिए दी गई हो.
PERCENT_OFF 'कूपन की वैल्यू किस तरह की है' एट्रिब्यूट की वैल्यू, जो छूट के प्रतिशत के तौर पर दी गई हो.
BUY_M_GET_N_MONEY_OFF 'कूपन की वैल्यू किस तरह की है' एट्रिब्यूट की वैल्यू के तौर पर, 'M खरीदें, N रुपये की छूट पाएं' लिखें. minimumPurchaseQuantity और getThisQuantityDiscounted मौजूद होने चाहिए. moneyOffAmount भी मौजूद होना चाहिए.
BUY_M_GET_N_PERCENT_OFF M खरीदें, कूपन की वैल्यू किस तरह की है पर N प्रतिशत की छूट पाएं. minimumPurchaseQuantity और getThisQuantityDiscounted मौजूद होने चाहिए. percent_off_percentage भी मौजूद होना चाहिए.
BUY_M_GET_MONEY_OFF M खरीदें, इतने रुपये की छूट पाएं. minimumPurchaseQuantity और moneyOffAmount मौजूद होने चाहिए.
BUY_M_GET_PERCENT_OFF M खरीदें, इतने रुपये की छूट पाएं. minimumPurchaseQuantity और percent_off_percentage मौजूद होने चाहिए.
FREE_GIFT मुफ़्त उपहार का सिर्फ़ ब्यौरा.
FREE_GIFT_WITH_VALUE मुफ़्त उपहार की कीमत.
FREE_GIFT_WITH_ITEM_ID मुफ़्त उपहार का आइटम आईडी.
FREE_SHIPPING_STANDARD स्टैंडर्ड मुफ़्त शिपिंग कूपन की वैल्यू किस तरह की है. यह सुविधा सिर्फ़ ऑनलाइन प्रमोशन के लिए उपलब्ध है.
FREE_SHIPPING_OVERNIGHT एक दिन में डिलीवरी वाली मुफ़्त शिपिंग के कूपन की वैल्यू किस तरह की है. यह सिर्फ़ ऑनलाइन प्रमोशन के लिए उपलब्ध है.
FREE_SHIPPING_TWO_DAY दो दिन में मुफ़्त शिपिंग वाले कूपन की वैल्यू किस तरह की है. यह सुविधा सिर्फ़ ऑनलाइन प्रमोशन के लिए उपलब्ध है.

DestinationEnum

डेस्टिनेशन वैल्यू.

Enums
DESTINATION_ENUM_UNSPECIFIED इसकी जानकारी नहीं दी गई है.
SHOPPING_ADS शॉपिंग विज्ञापन.
DISPLAY_ADS डिसप्ले विज्ञापन.
LOCAL_INVENTORY_ADS लोकल इन्वेंट्री विज्ञापन.
FREE_LISTINGS मुफ़्त में दिखाई जाने वाली लिस्टिंग.
FREE_LOCAL_LISTINGS मुफ़्त में दिखाई जाने वाली स्थानीय प्रॉडक्ट लिस्टिंग.
YOUTUBE_SHOPPING YouTube Shopping.
YOUTUBE_SHOPPING_CHECKOUT YouTube Shopping पर चेकआउट करने की सुविधा.
YOUTUBE_AFFILIATE YouTube अफ़िलिएट.
FREE_VEHICLE_LISTINGS वाहन की मुफ़्त में दिखाई जाने वाली लिस्टिंग.
VEHICLE_ADS वाहन के विज्ञापन.
CLOUD_RETAIL Cloud retail.
LOCAL_CLOUD_RETAIL लोकल क्लाउड रीटेल.

StoreApplicability

स्टोर कोड या उन स्टोर कोड की सूची जिन पर प्रमोशन लागू होता है. सिर्फ़ स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन के लिए.

Enums
STORE_APPLICABILITY_UNSPECIFIED यह पता नहीं है कि प्रमोशन किन स्टोर कोड पर लागू होता है.
ALL_STORES प्रमोशन सभी स्टोर पर लागू होता है.
SPECIFIC_STORES प्रमोशन सिर्फ़ बताए गए स्टोर पर लागू होता है.

PromotionStatus

प्रमोशन की स्थिति.

JSON के काेड में दिखाना 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
फ़ील्ड
destinationStatuses[]

object (DestinationStatus)

सिर्फ़ आउटपुट के लिए. प्रमोशन के लिए चुने गए डेस्टिनेशन.
itemLevelIssues[]

object (ItemLevelIssue)

सिर्फ़ आउटपुट के लिए. प्रमोशन से जुड़ी समस्याओं की सूची.
creationDate

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. प्रमोशन बनाने की तारीख, ISO 8601 फ़ॉर्मैट में: तारीख, समय, और ऑफ़सेट. उदाहरण के लिए, 2020-01-02T09:00:00+01:00 या 2020-01-02T09:00:00Z
lastUpdateDate

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. ISO 8601 फ़ॉर्मैट में, प्रमोशन की स्थिति को पिछली बार अपडेट करने की तारीख: तारीख, समय, और ऑफ़सेट. उदाहरण के लिए, 2020-01-02T09:00:00+01:00 या 2020-01-02T09:00:00Z

DestinationStatus

चुने गए डेस्टिनेशन का स्टेटस.

JSON के काेड में दिखाना 
{
  "reportingContext": enum (ReportingContextEnum),
  "status": enum (State)
}
फ़ील्ड
reportingContext

enum (ReportingContextEnum)

सिर्फ़ आउटपुट के लिए. प्रमोशन डेस्टिनेशन का नाम.
status

enum (State)

सिर्फ़ आउटपुट के लिए. चुने गए डेस्टिनेशन का स्टेटस.

स्थिति

प्रमोशन की मौजूदा स्थिति.

Enums
STATE_UNSPECIFIED प्रमोशन की स्थिति की जानकारी नहीं है.
IN_REVIEW प्रमोशन की समीक्षा की जा रही है.
REJECTED प्रमोशन अस्वीकार कर दिया गया है.
LIVE प्रमोशन को मंज़ूरी मिल गई है और वह चालू है.
STOPPED मर्चेंट ने प्रमोशन को रोक दिया है.
EXPIRED प्रमोशन अब चालू नहीं है.
PENDING प्रमोशन बंद नहीं हुआ है और सभी समीक्षाओं को मंज़ूरी मिल गई है. हालांकि, प्रमोशन की तारीख आने वाली है.

ItemLevelIssue

प्रमोशन से जुड़ी समस्या.

JSON के काेड में दिखाना 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
फ़ील्ड
code

string

सिर्फ़ आउटपुट के लिए. समस्या का गड़बड़ी कोड.
severity

enum (Severity)

सिर्फ़ आउटपुट के लिए. इस समस्या से प्रमोशन दिखाने पर क्या असर पड़ता है.
resolution

string

सिर्फ़ आउटपुट के लिए. क्या व्यापारी/कंपनी इस समस्या को हल कर सकती है.
attribute

string

सिर्फ़ आउटपुट के लिए. अगर समस्या किसी एक एट्रिब्यूट की वजह से है, तो एट्रिब्यूट का नाम.
reportingContext

enum (ReportingContextEnum)

सिर्फ़ आउटपुट के लिए. वह डेस्टिनेशन जिस पर समस्या लागू होती है.
description

string

सिर्फ़ आउटपुट के लिए. समस्या के बारे में अंग्रेज़ी में कम शब्दों में जानकारी.
detail

string

सिर्फ़ आउटपुट के लिए. समस्या की पूरी जानकारी अंग्रेज़ी में.
documentation

string

सिर्फ़ आउटपुट के लिए. इस समस्या को हल करने में मदद करने के लिए, किसी वेब पेज का यूआरएल.
applicableCountries[]

string

सिर्फ़ आउटपुट के लिए. उन देशों के कोड (ISO 3166-1 alpha-2) की सूची जहां ऑफ़र पर समस्या लागू होती है.

गंभीरता

समस्या की गंभीरता.

Enums
SEVERITY_UNSPECIFIED इसकी जानकारी नहीं दी गई है.
NOT_IMPACTED यह गड़बड़ी एक चेतावनी है. इससे प्रमोशन पर सीधा असर नहीं पड़ता.
DEMOTED प्रमोशन की रैंकिंग कम हो जाती है और खोज के नतीजों में उसकी परफ़ॉर्मेंस पर असर पड़ सकता है
DISAPPROVED समस्या की वजह से प्रमोशन अस्वीकार कर दिया जाता है.

तरीके

get

 आपके Merchant Center खाते से प्रमोशन को वापस लाता है.

insert

 आपके Merchant Center खाते के लिए प्रमोशन डालता है.

list

 आपके Merchant Center खाते में मौजूद प्रमोशन की सूची दिखाता है.