REST Resource: inventory.partners.merchants

منبع: بازرگان

اطلاعاتی درباره تاجری که در پلتفرم جمع‌آوری کننده است.

نمایندگی JSON
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  }
}
زمینه های
name

string

نام منبع تاجر، که دارای قالب partners/{partner_id}/merchants/{merchantId} است.

merchantName

string

merchantName، تلفن، آدرس اینترنتی و جغرافیایی برای پشتیبانی از موجودی شریک منطبق با تاجرانی که قبلاً در Google Maps حضور دارند استفاده می‌شود. این اطلاعات نمایش داده نخواهد شد.

نام تاجر.

telephone

string

شماره تلفن عمومی تاجر شامل کدهای کشور و منطقه آن، به عنوان مثال +14567891234.

url

string

آدرس وب سایت عمومی تاجر.

geo

object ( GeoCoordinates )

اطلاعات جغرافیایی تاجر، از جمله عرض جغرافیایی، طول جغرافیایی، و آدرس.

category

string

دسته بندی کسب و کار در پلت فرم جمع آوری کننده.

numBookings30d
(deprecated)

string ( int64 format)

این فیلد منسوخ شده است.

taxRateBasisPoints
(deprecated)

integer ( uint32 format)

نرخ مالیات تاجر بر حسب واحد پایه (یک صدم درصد). مثلاً اگر نرخ مالیات 7.5 درصد باشد، این فیلد باید 750 باشد.

اگر این قسمت تنظیم نشده باقی بماند یا روی 0 تنظیم شود، کل قیمتی که برای هر سرویس ارائه شده توسط این تاجر از کاربر دریافت می‌شود، دقیقاً قیمتی است که توسط Service.price مشخص شده است. فرض می شود که قیمت خدمات از مالیات های قابل اعمال معاف است یا از قبل شامل آن می شود. مالیات ها به عنوان یک خط جداگانه به کاربر نشان داده نمی شود.

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

این فیلد منسوخ شده است، لطفاً به جای آن از taxRate استفاده کنید.

taxRate

object ( TaxRate )

نرخ مالیات تاجر. اگر این فیلد وجود داشته باشد، قسمت منسوخ taxRateBasisPoints را لغو می کند. یک پیام خالی (یعنی taxRate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.

paymentRestrictions

object ( PaymentRestrictions )

محدودیت‌هایی برای روش‌های پرداختی که این تاجر می‌پذیرد. اگر این فیلد تنظیم نشده باشد، فرض می کنیم که هیچ محدودیتی وجود ندارد.

paymentOption[]

object ( PaymentOption )

گزینه های پرداخت برای این تاجر موجود است. خدمات تحت این تاجر می توانند به صورت جداگانه گزینه های پرداختی را که اجازه می دهند محدود کنند.

paymentProcessorConfig
(deprecated)

object ( PaymentProcessorConfig )

پیکربندی برای پردازشگر پرداخت توکن شده، در صورتی که تاجر از آن پشتیبانی کند.

tokenizationConfig

object ( TokenizationConfig )

پیکربندی برای پردازشگر پرداخت توکن شده، در صورتی که تاجر از آن پشتیبانی کند.

terms

object ( Terms )

شرایط و ضوابط تاجر خاص که هنگام رزرو سرویس از طریق رزرو با Google به کاربر نمایش داده می شود. علاوه بر این موارد، شرایط و ضوابط شریک جمع آوری همیشه به کاربر نمایش داده می شود و نباید در اینجا ارائه شود.

brandId

string

رشته‌ای غیر شفاف که نشان‌دهنده برند مصرف‌کننده برای استفاده در هنگام نمایش اسناد شریک است. این فیلد به شرکای دارای چندین مارک مصرف‌کننده اجازه می‌دهد تا تجار را برای همه مارک‌ها در یک خوراک ارائه کنند.

یک نام تجاری شامل ویژگی‌هایی مانند نام، لوگو، شرایط خدمات و خط‌مشی رازداری است که با مصرف‌کننده مواجه است.

اگر فقط یک برند شریک مصرف کننده وجود داشته باشد، این زمینه نیازی به تنظیم ندارد و می توان آن را نادیده گرفت.

اگر شریک ...

آیا برندهای متعددی برای مصرف کننده ندارید؟ --> این فیلد را نادیده بگیرید

آیا چندین برند پیکربندی شده است؟

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

توجه دقیق: اکثر شرکا نیازی به تنظیم این فیلد ندارند. اگر شریکی بخواهد از این فیلد استفاده کند، باید ابتدا با ما تماس بگیرد تا مارک‌های جداگانه، از جمله نام تجاری پیش‌فرض را پیکربندی کنیم.

matchingHints

object ( MerchantMatchingHints )

نکاتی برای کمک به Google برای مطابقت دادن یک تاجر با مکانی در Google Maps. توجه: اکثر شرکا نیازی به تنظیم این فیلد ندارند، زیرا Google با استفاده از اطلاعات ارائه شده در بالا، بازرگانان را با مکان‌های Google Maps مطابقت می‌دهد. (اختیاری)

serviceAttribute[]

object ( ServiceAttribute )

تعاریف هر ویژگی خدماتی که برای توصیف خدمات این تاجر استفاده می شود. (اختیاری)

waitlistAdvisement

object ( Advisement )

اختیاری. توصیه‌های کلی از یک تاجر خاص برای کاربری که از طریق رزرو با Google به فهرست انتظار ملحق می‌شود. طول فیلدهای متنی در توصیه باید به 100 بایت محدود شود.

محدودیت های پرداخت

محدودیت‌هایی برای روش‌های پرداختی که این تاجر می‌پذیرد.

نمایندگی JSON
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
زمینه های
creditCardRestrictions

object ( CreditCardRestrictions )

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

محدودیت های کارت اعتباری

محدودیت‌هایی برای انواع کارت اعتباری که این تاجر می‌پذیرد.

نمایندگی JSON
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
زمینه های
creditCardType[]

enum ( CreditCardType )

لیستی از کارت های اعتباری پشتیبانی شده در صورت خالی بودن کارت اعتباری پشتیبانی نمی شود.

نوع کارت اعتباری

یک نوع کارت اعتباری

Enums
CREDIT_CARD_TYPE_UNSPECIFIED استفاده نشده
VISA کارت اعتباری ویزا
MASTERCARD کارت اعتباری مستر کارت
AMERICAN_EXPRESS کارت اعتباری امریکن اکسپرس
DISCOVER کارت اعتباری Discover
JCB کارت اعتباری JCB

گزینه پرداخت

یک گزینه پرداخت، که می تواند برای پرداخت هزینه خدمات ارائه شده توسط یک تاجر استفاده شود. گزینه های پرداخت را می توان در بین چندین تاجر به اشتراک گذاشت (مثلاً تاجرانی که متعلق به یک زنجیره هستند).

نمایندگی JSON
{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
زمینه های
paymentOptionId

string

این شناسه برای شناسایی این گزینه پرداخت استفاده می شود.

این شناسه برای کل تجمیع کننده جهانی است و استفاده مجدد از یک مقدار در چندین تاجر به کاربر امکان می دهد با گزینه پرداخت مربوطه در آن تاجران پرداخت کند.

هنگام استفاده مجدد از یک شناسه برای چندین تاجر، به‌روزرسانی هر مقدار برای گزینه پرداخت تحت یک تاجر، هر گزینه پرداخت دیگری را با همان شناسه، تحت یک تاجر دیگر نیز به‌روزرسانی می‌کند. به این ترتیب، بهترین روش این است که همه گزینه‌های پرداخت یک شناسه مشترک داشته باشند، همیشه به مقادیر یکسان به‌روزرسانی شوند تا از هرگونه احتمال رفتار ضعیف‌تر جلوگیری شود.

name

string

نام گزینه پرداخت. این می تواند کاربر قابل مشاهده باشد.

description

string

توضیح گزینه پرداخت این می تواند کاربر قابل مشاهده باشد.

price

object ( Price )

قیمت گزینه پرداخت.

taxRate

object ( TaxRate )

نرخ مالیات برای این گزینه پرداخت. اگر این فیلد وجود داشته باشد، فیلد نرخ مالیات موجود در تاجر یا سرویس را لغو می کند. یک پیام خالی (یعنی taxRate { }) نرخ مالیات اعمال شده را به صفر بازنشانی می کند.

paymentOptionType

enum ( PaymentOptionType )

نوع این گزینه پرداخت. یکبار مصرف برای بارگیری، چند منظوره برای بسته ها و نامحدود برای عضویت.

sessionCount

string ( int64 format)

این گزینه پرداخت برای چند جلسه قابل استفاده است. فقط برای چند جلسه / بسته معتبر است، جایی که مقدار باید > 1 باشد.

purchaseInterval

object ( TimeRange )

گزینه پرداخت را می توان در این فاصله خریداری کرد.

validInterval

object ( TimeRange )

گزینه پرداخت را می توان در این بازه زمانی استفاده کرد (به عنوان مثال قیمت ویژه ژانویه 2017). در صورت وجود، اعتبار ValidDuration و activationType را لغو می کند.

validDuration

string ( Duration format)

مدت اعتبار گزینه پرداخت (به عنوان مثال عضویت 30 روزه).

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

activationType

enum ( ActivationType )

نحوه تعیین تاریخ شروع اعتبار برای این گزینه پرداخت را مشخص می کند.

userRestriction

object ( UserPurchaseRestriction )

کاربران واجد شرایط خرید این گزینه پرداخت را محدود می کند. می توان از آن برای محدود کردن گزینه پرداخت تبلیغاتی به زیرمجموعه ای از کاربران استفاده کرد. اگر تنظیم نشود، همه کاربران واجد شرایط هستند.

نوع گزینه پرداخت

یک نوع گزینه پرداخت

Enums
PAYMENT_OPTION_TYPE_UNSPECIFIED استفاده نشده
PAYMENT_OPTION_SINGLE_USE گزینه پرداخت فقط یک بار قابل استفاده است.
PAYMENT_OPTION_MULTI_USE اگر تعداد جلسات آن > 0 باشد، می توان از گزینه پرداخت استفاده کرد.
PAYMENT_OPTION_UNLIMITED گزینه پرداخت را می توان در محدوده زمانی معتبر آن استفاده کرد - تعداد جلسات غیرقابل اجرا است.

نوع فعال سازی

نحوه تعیین تاریخ شروع اعتبار را مشخص می کند.

Enums
ACTIVATION_TYPE_UNSPECIFIED استفاده نشده
ACTIVATION_ON_PURCHASE اعتبار از زمان خرید شروع می شود.
ACTIVATION_ON_FIRST_USE اعتبار زمانی شروع می شود که گزینه پرداخت برای اولین بار استفاده شود.

UserPurchaseRestriction

کاربران واجد شرایط خرید گزینه پرداخت را محدود می کند.

نمایندگی JSON
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
زمینه های
newToMerchant

boolean

یک گزینه پرداخت که فقط توسط کاربرانی قابل خرید است که قبلاً هرگز از یک تاجر خرید نکرده‌اند.

newToPaymentOption

boolean

یک گزینه پرداخت که فقط توسط کاربرانی قابل خرید است که قبلاً گزینه پرداخت مشابهی را خریداری نکرده اند.

PaymentProcessorConfig

پیکربندی برای پردازشگر پرداخت، تنظیم بر اساس هر فروشنده.

نمایندگی JSON
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
زمینه های
processor

enum ( Processor )

شریک پردازشگر پرداخت را که این پیکربندی برای آن اعمال می شود، تعریف می کند.

publicKey

string

کلید مورد استفاده برای شناسایی این تاجر با پردازشگر پرداخت.

برای Stripe، به: https://stripe.com/docs/dashboard#api-keys برای Braintree، مراجعه کنید: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

شماره نسخه API به همراه درخواست‌های پرداخت به پردازشگر پرداخت ارسال می‌شود.

پردازنده

یک شریک پردازشگر پرداخت خاص را تعریف می کند.

Enums
PROCESSOR_UNSPECIFIED استفاده نشده
PROCESSOR_STRIPE پیکربندی برای پرداخت با Stripe.
PROCESSOR_BRAINTREE پیکربندی برای پرداخت با Braintree.

TokenizationConfig

پیکربندی برای توکن سازی پردازشگر پرداخت که بر اساس هر بازرگان تنظیم شده است.

نمایندگی JSON
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
زمینه های
tokenizationParameter

map (key: string, value: string)

یک پیکربندی توکن‌سازی معمولاً دارای یک پارامتر رمزگذاری است که کلید آن «دروازه» و مقدار آن نام پردازنده است.

بقیه پارامترها به پردازنده بستگی دارد. برای اطلاعات بیشتر به اسناد Google Pay مراجعه کنید.

نمونه Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" مقدار: "2.30.0" } توکنیزاسیونP key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" مقدار: "production_xxx_yyy" }

مثال خطی: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

مثال Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

billingInformationFormat

enum ( BillingInformationFormat )

اطلاعات صورت‌حساب کاربر را که با FOP در Google Pay وارد شده است، در رمز پرداخت قرار دهید (به بالا مراجعه کنید). خالی گذاشتن فیلد معادل تعیین MIN است.

BillingInformationFormat

چه مقدار از آدرس صورت‌حساب را از کاربر می‌خواهد و در توکن لحاظ می‌کند. مقادیر enum مربوط به پارامترهای موجود در Google Pay API هستند (به https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters مراجعه کنید) .

Enums
BILLING_INFORMATION_FORMAT_UNSPECIFIED مشخص نشده است. پیش‌فرض MIN است.
MIN نام، کد کشور و کد پستی (تنظیم پیش‌فرض Google Pay).
FULL نام، آدرس خیابان، محل، منطقه، کد کشور و کد پستی.

مقررات

مجموعه ای از قوانین و دستورالعمل هایی که به منظور رزرو از طریق رزرو با Google به کاربر نمایش داده می شود.

نمایندگی JSON
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
زمینه های
url

string

به صورت اختیاری، URL به شرایط و ضوابط.

text

string

متنی که باید به کاربر نمایش داده شود. برای ادغام های جدید از localizedText زیر استفاده کنید.

localizedText

object ( Text )

متن بومی سازی شده برای نمایش به کاربر.

MerchantMatchingHints

نکات مورد استفاده برای کمک به Google برای مطابقت دادن یک تاجر با مکانی در Google Maps.

نمایندگی JSON
{
  "placeId": string
}
زمینه های
placeId

string

شناسه مکان برای مکانی در پایگاه داده Google Places و در Google Maps. برای اطلاعات بیشتر درباره شناسه‌های مکان، به https://developers.google.com/places/web-service/place-id مراجعه کنید.

ServiceAttribute

ویژگی‌های سرویس دسته‌های تعریف شده توسط شریک هستند که خدمات یک تاجر را توصیف می‌کنند. به عنوان مثال، یک بانک ممکن است ویژگی خدمات "نوع حساب" را با مقادیر ممکن "شخصی" و "تجاری" تعریف کند، در حالی که یک آرایشگاه ممکن است ویژگی خدمات "نوع خدمات" را با مقادیر احتمالی "Haircut"، "Color" تعریف کند. ، و "سبک".

نمایندگی JSON
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
زمینه های
attributeId

string

شناسه‌ای که به‌طور منحصربه‌فرد این ویژگی خدمات را در میان سایر ویژگی‌های یک تاجر شناسایی می‌کند، مثلاً «نوع حساب».

attributeName

string

یک نام قابل مشاهده برای کاربر برای این ویژگی، به عنوان مثال "نوع حساب".

value[]

object ( Value )

تمام مقادیر ممکن برای این ویژگی سرویس.

ارزش

یک مقدار ممکن برای یک ویژگی سرویس خاص را نشان می دهد.

نمایندگی JSON
{
  "valueId": string,
  "valueName": string
}
زمینه های
valueId

string

شناسه‌ای که به‌طور منحصربه‌فرد این مقدار را در میان سایر ویژگی‌های این سرویس شناسایی می‌کند، مثلاً «شخصی».

valueName

string

یک نام قابل مشاهده برای مقدار، به عنوان مثال "شخصی".

نصیحت

توصیه هایی که هنگام رزرو از طریق Reserve with Google به کاربر نمایش داده می شود.

نمایندگی JSON
{
  "text": {
    object (Text)
  }
}
زمینه های
text

object ( Text )

پیام سفارشی برای نمایش به کاربر هنگام رزرو از طریق رزرو با Google.

مواد و روش ها

create

 یک Merchant جدید ایجاد می کند که توسط جمع کننده مشخص شده مدیریت می شود و آن را برمی گرداند.

delete

 یک Merchant موجود که توسط جمع‌آوری‌کننده مشخص شده مدیریت می‌شود را حذف می‌کند.

getStatus

 MerchantStatus یک Merchant را دریافت کنید.

patch

 یک Merchant موجود تحت مدیریت جمع‌آوری‌کننده مشخص شده را به‌روزرسانی می‌کند و آن را برمی‌گرداند.