रीयल टाइम अपडेट

रीयल टाइम अपडेट की सुविधा की मदद से, Google के साथ अपने ऑफ़र की इन्वेंट्री को सिंक किया जा सकता है. आपके पास रीयल-टाइम में इंक्रीमेंटल अपडेट पुश करने का विकल्प होता है. हमारा सिस्टम, फ़ीड + आरटीयू से मिले बदलावों को कंपाइल करेगा, ताकि लोगों को सबसे नई जानकारी दिखाई जा सके.

एपीआई एंडपॉइंट

रीयल-टाइम अपडेट को पुश करने या मिटाने के लिए, इन REST API एंडपॉइंट का इस्तेमाल करें:

बैच पुश

सैंडबॉक्स: https://partnerdev-mapsbooking.googleapis.com/v1alpha/inventory/partners/{partner_id}/feeds/google.offer/record:batchPush
प्रोडक्शन: https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partner_id}/feeds/google.offer/record:batchPush

एक साथ कई आइटम मिटाना

सैंडबॉक्स: https://partnerdev-mapsbooking.googleapis.com/v1alpha/inventory/partners/{partner_id}/feeds/google.offer/record:batchDelete
प्रोडक्शन: https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partner_id}/feeds/google.offer/record:batchDelete

ऑफ़र के JSON ऑब्जेक्ट की परिभाषा के बारे में ज़्यादा जानने के लिए, Offer देखें. ऑफ़र की प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, ऑफ़र का रेफ़रंस पेज पर जाएं.

एपीआई से पुष्टि करने का तरीका

एपीआई से कनेक्ट करने के लिए, Mapsbooking API की मदद से पुष्टि करना लेख पढ़ें.

सीमाएं

रीयल-टाइम अपडेट एपीआई का इस्तेमाल करते समय, इन सीमाओं का ध्यान रखें:

सिर्फ़ protoRecord: एपीआई को सिर्फ़ protoRecord का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, न कि dataRecord का.
कोटा की सीमाएं: इन एपीआई के लिए, हर पार्टनर खाते से एक मिनट में 1,500 अनुरोध किए जा सकते हैं. अपसर्ट या मिटाने के लिए, हर अनुरोध में ज़्यादा से ज़्यादा 1,000 रिकॉर्ड भेजे जा सकते हैं.
इकाई मैपिंग से जुड़ी पाबंदियां: पार्टनर, हर ऑफ़र के लिए एक इकाई आईडी का अपडेट भेज सकते हैं. अगर आपको एक ही ऑफ़र को कई इकाई आईडी पर अपडेट करना है, तो पार्टनर को हर entityId के लिए एक रिकॉर्ड भेजना होगा. हर रिकॉर्ड के लिए entityId की वैल्यू हमेशा एक होनी चाहिए.
ऐड-ऑन ऑफ़र: इकाई मैपिंग से जुड़ी पाबंदी की वजह से, addOnOfferApplicableToAllEntities वाले ऐड-ऑन ऑफ़र, आरटीयू अपडेट के लिए काम नहीं करते. साथ ही, उन्हें इस तरीके से अपडेट नहीं किया जा सकता. उन्हें सिर्फ़ फ़ीड के ज़रिए अपडेट किया जा सकता है.

उदाहरण

ध्यान दें: इस उदाहरण के लिए, gcloud CLI की पुष्टि करने की सुविधा को सेट अप करना ज़रूरी है. यह काफ़ी मुश्किल है और सिर्फ़ टेस्टिंग के लिए मददगार होगा. अगर आपको इसका इस्तेमाल करना है, तो gcloud का दस्तावेज़ देखें. ये उदाहरण, एंडपॉइंट और पेलोड को फ़ॉर्मैट करने के तरीके के बारे में ज़्यादा जानकारी देने के लिए दिए गए हैं. हमारा सुझाव है कि अलग-अलग भाषाओं में पुष्टि करने के लिए कोड पाने के लिए, कोड के सैंपल देखें.

बैच अपडेट का उदाहरण

यहां curl के ज़रिए रीयल-टाइम अपडेट भेजने का एक उदाहरण दिया गया है:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token --impersonate-service-account=test@myproject.gserviceaccount.com --scopes=https://www.googleapis.com/auth/mapsbooking)" \
  -H "Content-Type: application/json" \
  -d '{
  "records": [
    {
      "generationTimestamp": {
        "seconds": 100
      },
      "protoRecord": {
        "@type": "type.googleapis.com/madden.ingestion.offer.Offer",
        "offerId": "1",
        "entityIds": [
          "1234567890"
        ],
        "addOnOfferApplicableToAllEntities": false,
        "offerSource": "OFFER_SOURCE_AGGREGATOR",
        "actionType": "ACTION_TYPE_FOOD_DELIVERY",
        "offerModes": [
          "OFFER_MODE_WALK_IN"
        ],
        "offerCategory": "OFFER_CATEGORY_BASE_OFFER",
        "tags": [
          "OFFER_TAG_NEW_YEAR_SPECIAL"
        ],
        "offerDetails": {
          "offerDisplayText": "FLAT 10% off",
          "offerSummaryText": "MONDAY TO FRIDAY",
          "discountPercent": 10
        },
        "offerRestrictions": {
          "combinableWithOtherOffers": true,
          "inclusions": [
            {
              "description": "complementary drink"
            },
            {
              "description": " starters"
            }
          ],
          "exclusions": [
            {
              "description": "taxes and Tips"
            }
          ]
        },
        "validityPeriods": [
          {
            "timeOfDay": {
              "timeWindows": [
                {
                  "openTime": {
                    "hours": 10
                  },
                  "closeTime": {
                    "hours": 20
                  }
                }
              ]
            },
            "validPeriod": {
              "validFromTime": {
                "seconds": 10
              }
            }
          }
        ],
        "offerUrl": "https://www.google.com/offer"
      }
    }
  ]
}' \
  https://partnerdev-mapsbooking.googleapis.com/v1alpha/inventory/partners/20000123/feeds/google.offer/record:batchPush

बैच मिटाने का उदाहरण

curl के ज़रिए किसी ऑफ़र को मिटाने का उदाहरण यहां दिया गया है:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token --impersonate-service-account=test@myproject.gserviceaccount.com --scopes=https://www.googleapis.com/auth/mapsbooking)" \
  -H "Content-Type: application/json" \
  -d '{
  "records": [
    {
      "deleteTime": {
        "seconds": 150
      },
      "protoRecord": {
        "@type": "type.googleapis.com/madden.ingestion.offer.Offer",
        "offerId": "1",
        "entityIds": [
          "1234567890"
        ]
      }
    }
  ]
}' \
  https://partnerdev-mapsbooking.googleapis.com/v1alpha/inventory/partners/20000123/feeds/google.offer/record:batchDelete