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)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

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

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 xuất hiện.

Tên người bán.

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.

string

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

object (GeoCoordinates)

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

string

Danh mục của doanh nghiệp trên nền tảng của công cụ tổng hợp.

string (int64 format)

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

integer (uint32 format)

Thuế suất của người bán tính theo điểm cơ sở (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ẽ là giá chính xác do Service.price chỉ định. 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 một giá trị 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 khoản thuế được đánh giá bằng mức thuế được cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phần thập phân 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.

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 còn được dùng nữa. Thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng về 0.

object (PaymentRestrictions)

Các quy định 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.

object (PaymentOption)

Các phương thức thanh toán có sẵn cho người bán này. Các dịch vụ thuộc người bán này sẽ có thể giới hạn riêng các phương thức thanh toán mà họ cho phép.

object (PaymentProcessorConfig)

Cấu hình cho 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 đó.

object (TokenizationConfig)

Cấu hình cho 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 đó.

object (Terms)

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

string

Một chuỗi mờ xác định thương hiệu dành cho người tiêu dùng để sử dụng khi hiển thị mô hình phân bổ đối tác. Trường này cho phép các đối tác có nhiều thương hiệu mà người tiêu dùng nhìn thấy 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 tiếp xúc với người tiêu dùng, thì bạn không cần đặt trường này và có thể bỏ qua trường này.

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

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

Có nhiều thương hiệu được định cấu hình không?

  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 không cần đặt trường này. Nếu muốn sử dụng trường này, trước tiên, đối tác phải liên hệ với chúng tôi để định cấu hình các thương hiệu riêng biệt, bao gồm cả thương hiệu mặc định.

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)

object (ServiceAttribute)

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

object (ActionLink)

Không bắt buộc. URL hành động có ngôn ngữ liên kết, danh sách quốc gia bị hạn chế, loại và nền tảng không bắt buộc cho biết hành động này sẽ được thực hiện trên nền tảng nào,

object (Advisement)

Không bắt buộc. Thông báo chung của một người bán cụ thể 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 thông báo phải có độ dài giới hạn là 100 byte.

object (EconomicOperator)

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

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

object (CreditCardRestrictions)

Các quy định hạn chế đối với thẻ tín dụng mà người bán này chấp nhận. Chúng tôi giả định 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ẻ được CreditCardType hỗ trợ sẽ tăng lên theo thời gian, nghĩa là việc để trống mục này sẽ khiến cấu hình phải thay đổi trong tương lai.

{
  "creditCardType": [
    enum (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 thẻ này trống.

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

Mã 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à chung cho toàn bộ trình tổng hợp và việc sử dụng lại một giá trị trên 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 trên 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 phương thức thanh toán của một người bán cũng sẽ cập nhật mọi phương thức thanh toán khác có cùng mã nhận dạng của một người bán khác. Do đó, tốt nhất là bạn nên sử dụng cùng một mã nhận dạng cho tất cả các phương thức thanh toán và luôn cập nhật các giá trị giống hệt nhau để tránh mọi khả năng xảy ra hành vi vi phạm.

string

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

string

Nội dung mô tả về phương thức thanh toán. Người dùng có thể nhìn thấy thông tin này.

object (Price)

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

object (TaxRate)

Mức thuế 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ụ. Thông báo trống (tức là taxRate { }) sẽ đặt lại tỷ lệ thuế đã áp dụng về 0.

enum (PaymentOptionType)

Loại của phương thức thanh toán này. Một lần sử dụng cho gói ghé thăm, nhiều lần sử dụng cho gói và không giới hạn cho gói thành viên.

string (int64 format)

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

object (TimeRange)

Bạn có thể mua phương thức thanh toán này trong khoảng thời gian này.

object (TimeRange)

Bạn có thể sử dụng phương thức thanh toán này trong khoảng thời gian này (ví dụ: giá ưu đãi cho tháng 1 năm 2017). Nếu có, giá trị này sẽ ghi đè validDuration và activationType.

string (Duration format)

Thời hạn hiệu lực của phương thức 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".

enum (ActivationType)

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

object (UserPurchaseRestriction)

Hạn chế những người dùng đủ điều kiện mua bằng 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 số ít người dùng. Nếu bạn không đặt giá trị này, tất cả người dùng đều đủ điều kiện.

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

boolean

Một phương thức thanh toán chỉ dành cho những người dùng chưa từng mua hàng của cùng một người bán.

boolean

Một phương thức thanh toán chỉ dành cho những người dùng chưa từng mua phương thức thanh toán đó.

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

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.

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

string

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

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

map (key: string, value: string)

Cấu hình mã thông báo thường sẽ có một tokenizationParameter có khoá là "cổng" và giá trị là tên của trình 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" }.

enum (BillingInformationFormat)

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

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

string

URL đến Điều khoản và điều kiện (không bắt buộc).

string

Văn bản sẽ hiển thị cho người dùng. Sử dụng localizedText bên dưới cho các tiện ích tích hợp mới.

object (Text)

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

{
  "placeId": string
}

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.

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

string

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

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

object (Value)

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

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

string

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

string

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

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

object (Text)

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

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

object (Text)

Bắt buộc. Tên, địa chỉ, số điện thoại và địa chỉ email của người vận hành 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 đặt hàng hoặc bất kỳ pháp nhân hoặc cá nhân nào khác chịu các nghĩa vụ liên quan đến việc sản xuất, cung cấp hoặc đưa sản phẩm vào sử dụng. Biểu thị chuỗi dạng tự do của economicOperator. Bạn có thể định dạng thông tin này bằng cách sử dụng " " và "\n".