رزروها جستجوی سرتاسر وضعیت تاجر از طریق API

موارد استفاده کنید

Google Maps Booking API دو روش را ارائه می‌کند که می‌توان از آنها برای بازیابی وضعیت تجار منفرد برای ادغام‌های مختلف یا فهرست آگهی‌های خدمات محلی استفاده کرد.

موارد استفاده برای Merchant Status API:

  • ابزارهای مدیریت ارتباط با مشتری موجود را تقویت کنید تا به مشتریان خود نشان دهید که چگونه موجودی آنها در Google ظاهر می شود.
  • یک داشبورد برای ردیابی وضعیت موجودی و وضعیت تطبیق تاجران خود بسازید.
  • به صورت برنامه‌ریزی وضعیت‌های منطبق و قابل رزرو تاجران خود را بازیابی کنید و هرگونه اطلاعات نادرست را برای بهبود کیفیت داده برطرف کنید.

وضعیت تاجر شامل چه مواردی است

MerchantStatus حاوی اطلاعات زیر است:

  • وضعیت موجودی تاجر: هم برای تاجران رزرو و/یا فهرست انتظار اعمال می‌شود.
  • وضعیت تطبیق تاجر: شامل جزئیات فهرست کسب و کار منطبق است
  • فقط برای تبلیغات سرویس‌های محلی Google ) ارائه‌دهنده خدمات تجاری منطبق: شامل شناسه مشتری و دسته‌های خدمات است.
  • نشانی‌های اینترنتی برای نشان دادن نحوه نمایش تاجر در Google.

وضعیت یک تاجر را جستجو کنید

با استفاده از inventory.partners.merchants.getStatus می توانید وضعیت یک تاجر را دریافت کنید:

GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}/status

در اینجا یک نمونه کد پایتون وجود دارد (نمونه‌هایی را به زبان‌های بیشتری در اینجا ببینید):

from google.auth.transport.requests import AuthorizedSession
from google.oauth2 import service_account

credentials = service_account.Credentials.from_service_account_file(
    './your_key.json')
scoped_credentials = credentials.with_scopes(
    ['https://www.googleapis.com/auth/mapsbooking'])
authed_session = AuthorizedSession(scoped_credentials)

response = authed_session.get('https://partnerdev-mapsbooking.googleapis.com' +
    '/v1alpha/inventory/partners/123456789/merchants/001/status')

یک نمونه پاسخ MerchantStatus به نظر می رسد:

  {
    "name": "partners/123456789/merchants/001/status",
    "merchantName": "Foo Bar Restaurant",
    "inputGeoInfo": {
      "unstructured_address": "123 Foo Bar Street, Mountain View"
    },
    "processingStatus": "COMPLETED",
    "bookingStatus": {
      "hasValidFutureInventory": true
    },
    "waitlistStatus": {
      "hasValidWaitlistService": true
    }
    "geoMatch": {
      "name": "Foo Bar Restaurant",
      "formattedAddress": "123 Foo Bar St, Mountain View, CA 94043",
      "placeId": "ChIAAAAAAAAABBBBBBBB"
    },
    "directUrls": [
      {
        "type": "BOOKING",
        "url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/dine/m/Nwaaaaa"
      },
      {
        "type": "WAITLIST",
        "url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/wait/c/iDbbbbb"
      }
    ]
  }

وضعیت تاجر را به صورت انبوه بازیابی کنید

با استفاده از inventory.partners.merchants.status.list ، می‌توانید وضعیت همه بازرگانان یا گروهی از بازرگانان را که شرایط موجودی/مطابق خاصی را برآورده می‌کنند، بازیابی کنید. به‌عنوان مثال، می‌توانید این تماس را برقرار کنید تا همه تاجران بی‌همتا با موجودی رزرو معتبر در آینده را دریافت کنید:

GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/status?pageSize=50&bookingInventoryStatusRestrict=HAS_VALID_FUTURE_INVENTORY&geoMatchRestrict=GEO_UNMATCHED

یک نمونه پاسخ به این شکل خواهد بود:

  {
    "merchantStatuses": [
      {
        "name": "partners/123456789/merchants/002/status",
        "merchantName": "Bar Foo Restaurant",
        "inputGeoInfo": {
          "unstructured_address": "234 Bar Foo Street, Mountain View"
        },
        "processingStatus": "COMPLETED",
        "bookingStatus": {
          "hasValidFutureInventory": true
        },
        "waitlistStatus": {},
      },
      ...
      {
        "name": "partners/123456789/merchants/080/status",
        "merchantName": "Baz Restaurant",
        "inputGeoInfo": {
          "unstructured_address": "345 Baz Street, Mountain View"
        },
        "processingStatus": "COMPLETED",
        "bookingStatus": {
          "hasValidFutureInventory": true
        },
        "waitlistStatus": {
          "hasValidWaitlistService": true
        },
      },
    ],
    "nextPageToken": "AAABBBB"
  }

این پاسخ حاوی 50 MerchantStatus است که شرایط فیلتر را برآورده می کند و توسط merchant_id سفارش داده شده است. پاسخ همچنین حاوی یک نشانه صفحه (اگر آخرین صفحه نیست) برای جستجو در صفحه بعدی است.

لطفاً توجه داشته باشید: شرایط فیلتر باید در تمام صفحات ثابت باشد.

بهترین شیوه ها

از آنجایی که وضعیت تاجر در اکثر مواقع به طور مکرر تغییر نمی کند، توصیه می شود نتایج بازیابی شده را در حافظه پنهان ذخیره کنید و به صورت دوره ای (مثلا هر چند ساعت یکبار) آنها را از طریق جستجوهای جدید بازیابی کنید. اگر تعداد درخواست‌ها در ثانیه بیش از حد زیاد باشد، ممکن است «مرکز اقدامات» درخواست‌های شما را کاهش دهد.