REST Resource: inventory.partners.merchants

{
  "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)
  }
}

string

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

string

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

نام تاجر.

string

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

string

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

object ( GeoCoordinates )

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

string

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

string ( int64 format)

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

integer ( uint32 format)

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

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

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

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

object ( TaxRate )

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

object ( PaymentRestrictions )

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

object ( PaymentOption )

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

object ( PaymentProcessorConfig )

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

object ( TokenizationConfig )

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

object ( Terms )

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

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

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

object ( MerchantMatchingHints )

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

object ( ServiceAttribute )

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

object ( ActionLink )

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

object ( Advisement )

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

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object ( CreditCardRestrictions )

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

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum ( CreditCardType )

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

{
  "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)
  }
}

string

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

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

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

string

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

string

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

object ( Price )

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

object ( TaxRate )

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

enum ( PaymentOptionType )

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

string ( int64 format)

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

object ( TimeRange )

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

object ( TimeRange )

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

string ( Duration format)

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

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

enum ( ActivationType )

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

object ( UserPurchaseRestriction )

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

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

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

boolean

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

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum ( Processor )

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

string

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

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

string

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

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

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" } .

enum ( BillingInformationFormat )

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

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

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

string

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

object ( Text )

متن محلی برای نمایش به کاربر.

{
  "placeId": string
}

string

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

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

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

string

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

object ( Value )

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

{
  "valueId": string,
  "valueName": string
}

string

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

string

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

{
  "text": {
    object (Text)
  }
}

object ( Text )

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