Method: inventory.partners.merchants.status.list

أدرِج كل MerchantStatus للشريك الذي يستوفي شروط الفلتر.

طلب HTTP

GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوبة. الحساب الرئيسي الذي يملك هذه المجموعة من حالة التاجر تنسيق الملف: partners/{partner_id}/merchants

معلمات طلب البحث

المَعلمات
pageSize

integer

مطلوبة. تمثّل هذه السمة الحد الأقصى لعدد السلع المطلوب إرجاعها. وتجدر الإشارة إلى أن الخادم قد يقلل من حجم الصفحة.

pageToken

string

اختياريّ. القيمة NextPageToken التي يتم عرضها من استجابة ListMerchantStatusResponse السابقة، إن وجدت.

bookingInventoryStatusRestrict

enum (BookingInventoryStatus)

اختياريّ. قيود اختيارية لفلترة النتائج حسب حالة مستودع الحجز.

waitlistInventoryStatusRestrict

enum (WaitlistInventoryStatus)

اختياريّ. قيود اختيارية لفلترة النتائج حسب حالة المستودع في قائمة الانتظار.

geoMatchRestrict

enum (GeoMatchingStatus)

اختياريّ. قيد اختياري لفلترة النتائج حسب حالة المطابقة الجغرافية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الرد على القائمة MerchantStatus.

تمثيل JSON
{
  "merchantStatuses": [
    {
      object (MerchantStatus)
    }
  ],
  "nextPageToken": string
}
الحقول
merchantStatuses[]

object (MerchantStatus)

قائمة بحالات التاجر التي تستوفي شروط الفلتر.

nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج. لن يتم العثور على نتائج إضافية في القائمة إذا كانت فارغة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/mapsbooking

BookingInventoryStatus

حالة مستودع الحجوزات بالكامل

عمليات التعداد
BOOKING_INVENTORY_STATUS_UNSPECIFIED غير محدَّد.
NO_VALID_FUTURE_INVENTORY لا يمتلك التاجر مستودعًا للحجز في الأيام الـ 30 القادمة.
HAS_VALID_FUTURE_INVENTORY يتوفّر لدى التاجر مستودع للحجز في الأيام الـ 30 التالية.

WaitlistInventoryStatus

حالة مستودع قائمة الانتظار الشاملة

عمليات التعداد
WAITLIST_INVENTORY_STATUS_UNSPECIFIED غير محدَّد.
NO_VALID_WAITLIST_SERVICE لا تتوفّر لدى التاجر خدمة دعم قائمة الانتظار.
HAS_VALID_WAITLIST_SERVICE تتوفّر لدى التاجر قائمة انتظار تتيح تقديم خدمات الدعم.

GeoMatchingStatus

حالة المطابقة الجغرافية للتاجر

عمليات التعداد
GEO_MATCHING_STATUS_UNSPECIFIED غير محدَّد.
GEO_UNMATCHED لم تتم مطابقة الموقع الجغرافي للتاجر.
GEO_MATCHED تمّت مطابقة الموقع الجغرافي للتاجر.