Trường hợp sử dụng
API Đặt chỗ trên Google Maps cung cấp hai phương thức có thể được sử dụng để truy xuất trạng thái của từng người bán cho các tiện ích tích hợp khác nhau hoặc Quảng cáo dịch vụ địa phương khoảng không quảng cáo.
Các trường hợp sử dụng API Trạng thái người bán:
- Nâng cao các công cụ quản lý quan hệ khách hàng hiện tại để chứng minh cách khoảng không quảng cáo của họ được hiển thị trên Google.
- Xây dựng trang tổng quan để theo dõi trạng thái khoảng không quảng cáo và trạng thái so khớp của người bán.
- Truy xuất theo phương thức lập trình trạng thái so khớp và có thể đặt trước của người bán và chỉnh sửa mọi thông tin không chính xác để cải thiện chất lượng dữ liệu.
Thông tin về trạng thái của người bán
Chiến lược phát hành đĩa đơn MerchantStatus chứa các thông tin sau:
- Trạng thái kho hàng của người bán: áp dụng cho cả người bán có yêu cầu đặt trước và/hoặc trong danh sách chờ.
- Trạng thái so khớp người bán: bao gồm thông tin chi tiết về trang thông tin doanh nghiệp trùng khớp
- Cho Chỉ Quảng cáo dịch vụ địa phương của Google) Nhà cung cấp dịch vụ người bán phù hợp: bao gồm mã khách hàng và danh mục dịch vụ.
- Những URL để minh hoạ cách người bán xuất hiện trên Google.
Tra cứu trạng thái của một người bán duy nhất
Bạn có thể xem trạng thái của một người bán bằng cách sử dụng inventory.partners.merchants.getStatus:
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}/status
Dưới đây là mã mẫu Python (xem ví dụ bằng các ngôn ngữ khác tại đây):
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')
Ví dụ Phản hồi MerchantStatus trông giống như sau:
{ "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" } ] }
Truy xuất trạng thái người bán hàng loạt
Bạn có thể truy xuất trạng thái của tất cả người bán hoặc nhóm người bán đáp ứng một số điều kiện so khớp/khoảng không quảng cáo nhất định, sử dụng inventory.partners.merchants.status.list. Ví dụ: bạn có thể tạo cuộc gọi này để tìm hiểu về tất cả những người bán không trùng khớp có lịch đặt chỗ hợp lệ trong tương lai khoảng không quảng cáo:
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/status?pageSize=50&bookingInventoryStatusRestrict=HAS_VALID_FUTURE_INVENTORY&geoMatchRestrict=GEO_UNMATCHED
Phản hồi mẫu sẽ có dạng như sau:
{ "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" }
Câu trả lời này sẽ chứa 50
MerchantStatus đáp ứng các điều kiện lọc và được sắp xếp theo
merchant_id. Phản hồi cũng chứa mã thông báo trang (nếu là
không phải trang cuối) để truy vấn trang tiếp theo.
Xin lưu ý: các điều kiện lọc phải nhất quán trên tất cả .
Các phương pháp hay nhất
Vì trạng thái người bán không thường xuyên thay đổi trong hầu hết thời gian, nên nên lưu các kết quả được truy xuất vào bộ nhớ đệm và định kỳ (ví dụ: mỗi vài kết quả giờ) truy xuất chúng qua các truy vấn mới. Actions Center có thể điều tiết nếu số lượng yêu cầu mỗi giây được cho là quá cao.