REST Resource: inventory.partners.merchants

Tài nguyên: Người bán

Thông tin về một người bán có trên nền tảng của đơn vị tập hợp.

Biểu diễn dưới dạng 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)
    }
  ],
  "reservationLinkoutTemplate": [
    {
      object (LinkoutTemplate)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
Trường
name

string

Tên tài nguyên của người bán, có định dạng là partners/{partner_id}/merchants/{merchantId}.
merchantName

string

merchantName, telephone, url và geo được dùng để hỗ trợ việc so khớp khoảng không quảng cáo của đối tác với những người bán đã có trên Google Maps. Thông tin này sẽ không được hiển thị.

Tên của người bán.
telephone

string

Số điện thoại công khai của người bán, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234.
url

string

URL của trang web công khai của người bán.
geo

object (GeoCoordinates)

Thông tin địa lý của người bán, bao gồm vĩ độ, kinh độ và địa chỉ.
category

string

Danh mục của doanh nghiệp trong nền tảng của đơn vị tổng hợp.
numBookings30d
(deprecated)

string (int64 format)

Trường này không được dùng nữa.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

Thuế suất của người bán tính bằng điểm cơ bản (một phần trăm trăm). Ví dụ: Nếu thuế suất là 7, 5%, thì bạn nên đặt trường này thành 750.

Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ chính xác bằng giá mà bạn chỉ định theo Service.price. Giá dịch vụ được giả định là đã được miễn hoặc đã bao gồm các khoản thuế hiện hành. Người dùng sẽ không thấy thuế dưới dạng một mục riêng.

Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, thì tổng giá mà người dùng phải trả cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được tính theo mức thuế mà bạn cung cấp ở đây. Phần nhỏ nhất của đơn vị tiền tệ (ví dụ: phần nhỏ nhất của một xu) sẽ được làm tròn bằng cách làm tròn đến số chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục riêng.

Trường này không còn được dùng nữa, vui lòng sử dụng taxRate.
taxRate
(deprecated)

object (TaxRate)

Mức thuế của người bán. Nếu có, trường này sẽ ghi đè trường taxRateBasisPoints không dùng nữa. Một thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng thành 0. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
paymentRestrictions
(deprecated)

object (PaymentRestrictions)

Các hạn chế đối với phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định rằng không có quy tắc hạn chế nào nếu bạn không đặt trường này. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
paymentOption[]
(deprecated)

object (PaymentOption)

Các phương thức thanh toán mà người bán này chấp nhận. Các dịch vụ thuộc người bán này sẽ có thể tự giới hạn những phương thức thanh toán mà họ cho phép. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Cấu hình cho một công ty xử lý thanh toán bằng mã thông báo, nếu người bán có hỗ trợ công ty này.
tokenizationConfig
(deprecated)

object (TokenizationConfig)

Cấu hình cho một công ty xử lý thanh toán bằng mã thông báo, nếu người bán có hỗ trợ công ty này. Không dùng nữa vì chúng tôi không còn hỗ trợ các khoản thanh toán E2E.
terms

object (Terms)

Điều khoản và điều kiện cụ thể của người bán được hiển thị cho người dùng khi họ đặt dịch vụ thông qua tính năng Đặt chỗ bằng Google. Ngoài ra, Điều khoản và điều kiện của đối tác đơn vị tập hợp luôn được hiển thị cho người dùng và bạn không được cung cấp ở đây.
brandId

string

Một chuỗi mờ xác định thương hiệu dành cho người tiêu dùng sẽ sử dụng khi hiển thị thông tin phân bổ đối tác. Trường này cho phép những đối tác có nhiều thương hiệu dành cho người tiêu dùng cung cấp người bán cho tất cả thương hiệu trong cùng một nguồn cấp dữ liệu.

Thương hiệu bao gồm các tài sản dành cho người tiêu dùng như tên, biểu trưng, Điều khoản dịch vụ và Chính sách quyền riêng tư.

Nếu chỉ có một thương hiệu đối tác dành cho người tiêu dùng, thì bạn không cần phải đặt trường này và có thể bỏ qua.

Nếu đối tác...

Không có nhiều thương hiệu dành cho người tiêu dùng? --> Bỏ qua trường này

Đã định cấu hình Nhiều thương hiệu?

  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

Lưu ý quan trọng: hầu hết các đối tác đều không cần đặt trường này. Nếu muốn sử dụng trường này, đối tác phải liên hệ với chúng tôi trước để thiết lập các thương hiệu riêng biệt, bao gồm cả thương hiệu mặc định.
matchingHints

object (MerchantMatchingHints)

Gợi ý giúp Google so khớp người bán với một địa điểm trên Google Maps. Lưu ý: hầu hết các đối tác không cần đặt trường này, vì Google sẽ so khớp người bán với các địa điểm trên Google Maps bằng thông tin được cung cấp ở trên. (không bắt buộc)
serviceAttribute[]

object (ServiceAttribute)

Định nghĩa cho mọi thuộc tính dịch vụ được dùng để mô tả Dịch vụ cho Nhà bán hàng này. (không bắt buộc)
reservationLinkoutTemplate[]

object (LinkoutTemplate)

Không bắt buộc. Mẫu đường liên kết bên ngoài chỉ định cách Google tạo URL của đối tác để đặt bàn trên nền tảng của họ.

Xin lưu ý rằng hiện tại, hệ thống sẽ chỉ sử dụng mục đầu tiên nếu bạn cung cấp nhiều mục.

Mẫu URI hỗ trợ các trường sẽ được điền sẵn dựa trên lựa chọn đặt phòng của người dùng. Bạn cần có tất cả các trường bắt buộc để tạo thành công một URL để đặt chỗ trước: * (bắt buộc) partySize, int: Số người trong nhóm mà người dùng đang yêu cầu đặt phòng. * (bắt buộc) selected_date_time, ngày giờ theo tiêu chuẩn ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): Thời gian mà người dùng đang yêu cầu đặt chỗ. * (không bắt buộc) merchantId, chuỗi: Mã nhận dạng người bán mà người dùng đang yêu cầu đặt chỗ, không cần thiết nếu mẫu đã có mã nhận dạng người bán. * (không bắt buộc) roomId, string: Mã nhận dạng của phòng mà người dùng đang yêu cầu đặt chỗ.
waitlistAdvisement

object (Advisement)

Không bắt buộc. Lời khuyên chung của một người bán cụ thể dành cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Mỗi trường văn bản trong lời khuyên phải có độ dài tối đa là 100 byte.
economicOperator

object (EconomicOperator)

Không bắt buộc. Thông tin về Nhà khai thác kinh tế được liên kết với người bán cụ thể này là thông tin cần thiết để tuân thủ quy định. (không bắt buộc)

PaymentRestrictions

Các hạn chế đối với phương thức thanh toán mà người bán này chấp nhận.

Biểu diễn dưới dạng JSON 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Trường
creditCardRestrictions

object (CreditCardRestrictions)

Các hạn chế đối với thẻ tín dụng mà nhà bán hàng này chấp nhận. Chúng tôi giả định rằng tất cả thẻ tín dụng đều được chấp nhận nếu bạn không đặt trường này. Xin lưu ý rằng danh sách thẻ mà CreditCardType hỗ trợ sẽ tăng lên theo thời gian, nghĩa là việc để trống danh sách này sẽ khiến cấu hình phải chịu những thay đổi trong tương lai.

CreditCardRestrictions

Các loại thẻ tín dụng mà nhà bán hàng này chấp nhận.

Biểu diễn dưới dạng JSON 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Trường
creditCardType[]

enum (CreditCardType)

Danh sách thẻ tín dụng được hỗ trợ. Không hỗ trợ thẻ tín dụng nếu không có thẻ nào.

CreditCardType

Loại thẻ tín dụng.

Enum
CREDIT_CARD_TYPE_UNSPECIFIED Không dùng đến.
VISA Thẻ tín dụng Visa.
MASTERCARD Thẻ tín dụng Mastercard.
AMERICAN_EXPRESS Thẻ tín dụng American Express.
DISCOVER Thẻ tín dụng Discover.
JCB Thẻ tín dụng JCB.

PaymentOption

Một lựa chọn thanh toán mà bạn có thể dùng để thanh toán cho các dịch vụ do người bán cung cấp. Các phương thức thanh toán có thể được dùng chung giữa nhiều người bán (ví dụ: những người bán thuộc cùng một chuỗi).

Biểu diễn dưới dạng 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)
  }
}
Trường
paymentOptionId

string

Mã nhận dạng này được dùng để xác định phương thức thanh toán này.

Mã nhận dạng này là mã nhận dạng chung cho toàn bộ đơn vị tổng hợp và việc sử dụng lại một giá trị cho nhiều người bán sẽ cho phép người dùng thanh toán bằng phương thức thanh toán tương ứng cho những người bán đó.

Khi sử dụng lại một mã nhận dạng cho nhiều người bán, việc cập nhật bất kỳ giá trị nào cho một lựa chọn thanh toán của một người bán cũng sẽ cập nhật mọi lựa chọn thanh toán khác có cùng mã nhận dạng của một người bán khác. Do đó, bạn nên sử dụng cùng một mã nhận dạng cho tất cả các lựa chọn thanh toán và luôn cập nhật các lựa chọn này thành các giá trị giống nhau để tránh mọi trường hợp hành vi không xác định.
name

string

Tên của phương thức thanh toán. Người dùng có thể thấy thông tin này.
description

string

Nội dung mô tả về lựa chọn thanh toán. Người dùng có thể thấy thông tin này.
price

object (Price)

Giá của phương thức thanh toán.
taxRate

object (TaxRate)

Thuế suất cho phương thức thanh toán này. Nếu có, trường này sẽ ghi đè trường taxRate có trong Người bán hoặc Dịch vụ. Một thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng thành 0.
paymentOptionType

enum (PaymentOptionType)

Loại phương thức thanh toán này. Sử dụng một lần cho các buổi tập luyện không cần đặt lịch trước, sử dụng nhiều lần cho các gói và không giới hạn cho các gói thành viên.
sessionCount

string (int64 format)

Số phiên mà bạn có thể sử dụng phương thức thanh toán này. Chỉ có hiệu lực đối với gói / nhiều phiên, trong đó giá trị phải lớn hơn 1.
purchaseInterval

object (TimeRange)

Bạn có thể mua lựa chọn thanh toán trong khoảng thời gian này.
validInterval

object (TimeRange)

Bạn có thể sử dụng lựa chọn thanh toán này trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, tham số này sẽ ghi đè validDuration và activationType.
validDuration

string (Duration format)

Thời hạn hiệu lực của lựa chọn thanh toán (ví dụ: gói thành viên 30 ngày).

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
activationType

enum (ActivationType)

Xác định cách xác định ngày bắt đầu hiệu lực của phương thức thanh toán này.
userRestriction

object (UserPurchaseRestriction)

Hạn chế những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để hạn chế một phương thức thanh toán khuyến mãi cho một nhóm nhỏ người dùng. Nếu bạn không đặt chính sách này, tất cả người dùng đều đủ điều kiện.

PaymentOptionType

Một loại lựa chọn thanh toán.

Enum
PAYMENT_OPTION_TYPE_UNSPECIFIED Không dùng đến.
PAYMENT_OPTION_SINGLE_USE Bạn chỉ có thể sử dụng phương thức thanh toán một lần.
PAYMENT_OPTION_MULTI_USE Bạn có thể sử dụng phương thức thanh toán nếu số phiên của phương thức đó > 0.
PAYMENT_OPTION_UNLIMITED Bạn có thể sử dụng phương thức thanh toán trong phạm vi thời gian hợp lệ – số phiên không áp dụng.

ActivationType

Xác định cách xác định ngày bắt đầu hiệu lực.

Enum
ACTIVATION_TYPE_UNSPECIFIED Không dùng đến.
ACTIVATION_ON_PURCHASE Thời gian hiệu lực bắt đầu từ thời điểm mua.
ACTIVATION_ON_FIRST_USE Thời gian hiệu lực bắt đầu khi bạn sử dụng phương thức thanh toán lần đầu tiên.

UserPurchaseRestriction

Hạn chế những người dùng đủ điều kiện mua một phương thức thanh toán.

Biểu diễn dưới dạng JSON 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Trường
newToMerchant

boolean

Một lựa chọn thanh toán chỉ dành cho người dùng chưa từng mua hàng của cùng một người bán.
newToPaymentOption

boolean

Một lựa chọn thanh toán mà chỉ những người dùng chưa từng mua lựa chọn thanh toán đó mới có thể mua.

PaymentProcessorConfig

Cấu hình cho một công ty xử lý thanh toán, được thiết lập theo từng người bán.

Biểu diễn dưới dạng JSON 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Trường
processor

enum (Processor)

Xác định đối tác công ty xử lý thanh toán mà cấu hình này áp dụng.
publicKey

string

Khoá dùng để xác định người bán này với công ty xử lý thanh toán.

Đối với Stripe, hãy tham khảo: https://stripe.com/docs/dashboard#api-keys Đối với Braintree, hãy tham khảo: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

Số phiên bản API được gửi đến đơn vị xử lý thanh toán cùng với các yêu cầu thanh toán.

Bộ xử lý

Xác định một đối tác cụ thể là công ty xử lý thanh toán.

Enum
PROCESSOR_UNSPECIFIED Không Sử Dụng
PROCESSOR_STRIPE Một cấu hình cho các khoản thanh toán qua Stripe.
PROCESSOR_BRAINTREE Cấu hình cho các khoản thanh toán bằng Braintree.

TokenizationConfig

Một cấu hình để mã hoá bằng mã thông báo của công ty xử lý thanh toán, được thiết lập theo từng người bán.

Biểu diễn dưới dạng JSON 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Trường
tokenizationParameter

map (key: string, value: string)

Cấu hình mã hoá thường sẽ có một tokenizationParameter có khoá là "gateway" và giá trị là tên của đơn vị xử lý.

Các tham số còn lại phụ thuộc vào bộ xử lý. Hãy xem tài liệu của Google Pay để biết thêm thông tin.

Ví dụ về Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Ví dụ về Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Ví dụ về Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

enum (BillingInformationFormat)

Đưa thông tin thanh toán của người dùng vào mã thông báo thanh toán khi họ nhập thông tin này vào Google Pay bằng FOP (xem ở trên). Việc để trống trường này tương đương với việc chỉ định MIN.

BillingInformationFormat

Bạn yêu cầu người dùng cung cấp bao nhiêu thông tin về Địa chỉ thanh toán và đưa vào mã thông báo. Các giá trị enum tương ứng với các tham số trong Google Pay API (xem https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Enum
BILLING_INFORMATION_FORMAT_UNSPECIFIED Chưa chỉ định. Giá trị mặc định là MIN.
MIN tên, mã quốc gia và mã bưu chính (chế độ cài đặt mặc định của Google Pay).
FULL tên, địa chỉ đường phố, thành phố, vùng, mã quốc gia và mã bưu chính.

Điều khoản

Một bộ quy tắc và nguyên tắc được hiển thị cho người dùng để đặt chỗ thông qua tính năng Đặt chỗ bằng Google.

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Trường
url

string

Bạn có thể cung cấp URL cho Điều khoản và điều kiện (không bắt buộc).
text

string

Văn bản sẽ hiển thị cho người người dùng. Hãy sử dụng localizedText bên dưới cho các hoạt động tích hợp mới.
localizedText

object (Text)

Văn bản đã bản địa hoá sẽ hiển thị cho người dùng.

MerchantMatchingHints

Gợi ý được dùng để giúp Google so khớp người bán với một địa điểm trên Google Maps.

Biểu diễn dưới dạng JSON 
{
  "placeId": string
}
Trường
placeId

string

Mã địa điểm của một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem https://developers.google.com/places/web-service/place-id để biết thêm về mã địa điểm.

ServiceAttribute

Thuộc tính dịch vụ là những danh mục do đối tác xác định, mô tả các dịch vụ của người bán. Ví dụ: một ngân hàng có thể xác định thuộc tính dịch vụ "Loại tài khoản" với các giá trị có thể là "Cá nhân" và "Doanh nghiệp", trong khi một tiệm làm tóc có thể xác định thuộc tính dịch vụ "Loại dịch vụ" với các giá trị có thể là "Cắt tóc", "Nhuộm tóc" và "Tạo kiểu tóc".

Biểu diễn dưới dạng JSON 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Trường
attributeId

string

Giá trị nhận dạng xác định duy nhất thuộc tính dịch vụ này trong số những thuộc tính khác của cùng một người bán, ví dụ: "account-type".
attributeName

string

Tên hiển thị cho người dùng của thuộc tính này, ví dụ: "Loại tài khoản".
value[]

object (Value)

Tất cả các giá trị có thể có cho thuộc tính dịch vụ này.

Giá trị

Đại diện cho một giá trị có thể có của một thuộc tính dịch vụ cụ thể.

Biểu diễn dưới dạng JSON 
{
  "valueId": string,
  "valueName": string
}
Trường
valueId

string

Giá trị nhận dạng giúp xác định riêng giá trị này trong số những giá trị khác cho thuộc tính dịch vụ này, ví dụ: "cá nhân".
valueName

string

Tên mà người dùng nhìn thấy cho giá trị, ví dụ: "Cá nhân".

LinkoutTemplate

Một mẫu chỉ định cách Google nên tạo URL cho trang web của đối tác.

Biểu diễn dưới dạng JSON 
{
  "uriTemplate": string
}
Trường
uriTemplate

string

Mẫu uri phải tuân theo RFC 6570, xem https://datatracker.ietf.org/doc/html/rfc6570. Hỗ trợ mẫu Cấp 1 và tất cả mẫu hỗn hợp Cấp 4. ví dụ: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

Lời khuyên

Những lời khuyên được hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google.

Biểu diễn dưới dạng JSON 
{
  "text": {
    object (Text)
  }
}
Trường
text

object (Text)

Thông báo tuỳ chỉnh sẽ hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google.

EconomicOperator

Thông tin về Nhà khai thác kinh tế cho Nhà tổng hợp.

Biểu diễn dưới dạng JSON 
{
  "text": {
    object (Text)
  }
}
Trường
text

object (Text)

Bắt buộc. Tên, địa chỉ, số điện thoại và địa chỉ email của chủ thể kinh tế, được xác định là nhà sản xuất, người đại diện được uỷ quyền, nhà nhập khẩu, nhà phân phối, nhà cung cấp dịch vụ thực hiện đơn hàng hoặc bất kỳ thể nhân hoặc pháp nhân nào khác phải chịu nghĩa vụ liên quan đến việc sản xuất sản phẩm, cung cấp sản phẩm hoặc đưa sản phẩm vào sử dụng. Biểu thị chuỗi dạng tự do của economicOperator. Thông tin này có thể được định dạng bằng " " và "\n".

Phương thức

create

 Tạo một Merchant mới do trình tổng hợp đã chỉ định quản lý và trả về Merchant đó.

delete

 Xoá một Merchant hiện có do trình tổng hợp được chỉ định quản lý.

getStatus

 Nhận MerchantStatus của Merchant.

patch

 Cập nhật Merchant hiện có do trình tổng hợp đã chỉ định quản lý và trả về Merchant đó.