এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

রিয়েল টাইম আপডেট

রিয়েল-টাইম আপডেট আপনাকে আপনার অফার ইনভেন্টরি গুগলের সাথে সিঙ্ক করে রাখতে সাহায্য করে। আপনি প্রায় রিয়েল-টাইমে পর্যায়ক্রমিক আপডেট পাঠাতে পারেন। আমাদের সিস্টেম ফিড এবং আরটিইউ (RTU) থেকে পরিবর্তনগুলো সংকলন করে ব্যবহারকারীদের কাছে সবচেয়ে সাম্প্রতিক তথ্য প্রদর্শন করবে।

এপিআই এন্ডপয়েন্ট

রিয়েল-টাইম আপডেট পুশ বা ডিলিট করতে, নিম্নলিখিত 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 অবজেক্টের সংজ্ঞা সম্পর্কে আরও তথ্যের জন্য, অফার দেখুন। অফারের প্রোপার্টিগুলো সম্পর্কে আরও বিস্তারিত জানতে, অফার রেফারেন্স পেজটি দেখুন।

এপিআই-তে কীভাবে প্রমাণীকরণ করবেন

এপিআই-এর সাথে সংযোগ করতে, "ম্যাপসবুকিং এপিআই দিয়ে প্রমাণীকরণ" দেখুন।

সীমাবদ্ধতা

রিয়েল-টাইম আপডেট এপিআই ব্যবহার করার সময় নিম্নলিখিত সীমাবদ্ধতাগুলো মনে রাখবেন:

শুধুমাত্র protoRecord : API-টি শুধুমাত্র protoRecord ( dataRecord নয়) ব্যবহার করার জন্য কনফিগার করা হয়েছে।
কোটা সীমা : এই API-গুলির জন্য প্রতি পার্টনার অ্যাকাউন্টে প্রতি মিনিটে ১৫০০টি অনুরোধের একটি কোটা রয়েছে। প্রতিটি অনুরোধে আপসার্ট বা ডিলিট করার জন্য সর্বোচ্চ ১০০০টি রেকর্ড পাঠানো যায়।
এনটিটি ম্যাপিং সীমাবদ্ধতা : প্রতিটি অফারের জন্য, পার্টনাররা ১টি এনটিটি আইডির জন্য আপডেট পাঠাতে পারবেন। যদি আপনি একাধিক এনটিটি আইডিতে একই অফার আপডেট করতে চান, তবে পার্টনারকে অবশ্যই প্রতিটি entityId জন্য ১টি করে রেকর্ড পাঠাতে হবে। প্রতিটি রেকর্ডের জন্য entityId আইডি অবশ্যই একক হতে হবে।
অ্যাড-অন অফার : এনটিটি ম্যাপিং সীমাবদ্ধতার কারণে, addOnOfferApplicableToAllEntities হিসেবে চিহ্নিত অ্যাড-অন অফারগুলো RTU আপডেটের জন্য সমর্থিত নয় এবং এই পদ্ধতিতে আপডেট করা যায় না (শুধুমাত্র ফিডের মাধ্যমে)।

উদাহরণ

দ্রষ্টব্য: এই উদাহরণটির জন্য কিছু gcloud CLI অথেনটিকেশন সেটআপ প্রয়োজন। এটি বেশ জটিল এবং শুধুমাত্র পরীক্ষার জন্য সহায়ক হবে। আপনি যদি তবুও এটি ব্যবহার করতে চান, তবে gcloud ডকুমেন্টেশন দেখুন। এই উদাহরণগুলি মূলত এন্ডপয়েন্ট এবং পেলোড কীভাবে ফরম্যাট করা উচিত তার একটি উদাহরণ হিসাবে দেওয়া হয়েছে। বিভিন্ন ভাষায় অথেনটিকেশন কোডের জন্য আমরা কোড স্যাম্পলগুলি দেখার পরামর্শ দিই।

Batch Updates Example

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