- Recurso: comerciante
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- Processador
- TokenizationConfig
- BillingInformationFormat
- Termos
- MerchantMatchingHints
- ServiceAttribute
- Valor
- Orientação
- Métodos
Recurso: comerciante
Informações sobre um comerciante na plataforma do agregador.
Representação JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Campos | |
---|---|
name |
O nome do recurso do comerciante, que tem o formato |
merchantName |
O merchantName, telefone, URL e localização geográfica são usados para corresponder o inventário do parceiro aos comerciantes no Google Maps. Essas informações não serão exibidas. Nome do comerciante. |
telephone |
O número de telefone público do comerciante, incluindo os códigos de país e de área, por exemplo, +55 (14) 5678-91234 |
url |
O URL do site público do comerciante. |
geo |
Informações geográficas do comerciante, incluindo latitude, longitude e endereço. |
category |
A categoria do negócio na plataforma do agregador. |
numBookings30d |
O uso desse campo está suspenso. |
taxRateBasisPoints |
Taxa de tributo do comerciante em pontos base (um centésimo de um por cento). Por exemplo, se a alíquota for de 7,5%, o campo exibirá 750. Se esse campo não for definido ou mostrar o valor 0, o preço total cobrado do usuário por qualquer serviço do comerciante será aquele especificado em Service.price. Considera-se que esse valor está isento de impostos ou já inclui os tributos aplicáveis. Os impostos não serão exibidos para o usuário em outro item de linha. Se o campo for definido como qualquer valor diferente de zero, o preço total cobrado pelo comerciante incluirá o valor do serviço e o tributo calculado com base na alíquota informada. As frações da menor unidade monetária (por exemplo, frações de um centavo) serão arredondadas para o número par mais próximo. Os tributos aparecerão em outro item de linha. Este campo está obsoleto. Use taxRate. |
taxRate |
Taxa de tributo do comerciante. Se presente, esse campo substitui o campo taxRateBasisPoints obsoleto. Uma mensagem vazia (por exemplo, taxRate {}) redefinirá a taxa de tributo aplicada para zero. |
paymentRestrictions |
Restrições às formas de pagamento aceitas pelo comerciante. Supõe-se que não existam restrições se esse campo não estiver definido. |
paymentOption[] |
Opções de pagamento disponíveis para esse comerciante. Os serviços dele poderão limitar cada opção de pagamento permitida. |
paymentProcessorConfig |
Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso. |
tokenizationConfig |
Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso. |
terms |
Os Termos e Condições do comerciante, exibidos ao usuário quando um serviço é agendado pelo Reservar com o Google. Além desses, os Termos e Condições do parceiro agregador são sempre exibidos ao usuário e não podem ser disponibilizados aqui. |
brandId |
String opaca que identifica a marca voltada para o consumidor que será usada ao mostrar a atribuição de parceiro. Esse campo permite que parceiros com várias marcas desse tipo especifiquem comerciantes para todas elas no mesmo feed. Uma marca consiste em propriedades voltadas para o consumidor, como nome, logotipo, Termos de Serviço e Política de Privacidade. Se houver apenas uma marca de parceiro voltada para o consumidor, esse campo não precisará ser definido e poderá ser ignorado. Se o parceiro... não tiver várias marcas voltadas para o consumidor? --> Ignore esse campo tiver várias marcas configuradas?
Observação: a maioria dos parceiros não precisa definir esse campo. Se um parceiro quiser usá-lo, precisará entrar em contato conosco para configurar marcas separadas, incluindo a padrão. |
matchingHints |
Dicas para ajudar o Google a corresponder um comerciante a um lugar no Google Maps. Observação: a maioria dos parceiros não precisa definir esse campo, já que o Google fará a correspondência entre os comerciantes e os lugares no Google Maps usando as informações enviadas acima. (Opcional) |
serviceAttribute[] |
Definições de qualquer atributo de serviço usado para descrever os serviços deste comerciante. (opcional) |
actionLink[] |
Opcional. Um URL de ação com idioma associado, lista de países restritos, tipo e plataforma opcional que indica em qual plataforma essa ação deve ser realizada. |
waitlistAdvisement |
Opcional. Orientações gerais de um comerciante específico para um usuário que entrou em uma lista de espera pelo Reservar com o Google. Os campos de texto individuais no aviso devem ser limitados a 100 bytes. |
PaymentRestrictions
Restrições às formas de pagamento aceitas pelo comerciante.
Representação JSON |
---|
{
"creditCardRestrictions": {
object ( |
Campos | |
---|---|
creditCardRestrictions |
Restrições aos cartões de crédito aceitos pelo comerciante. Presumimos que todos os cartões de crédito sejam aceitos se esse campo não estiver definido. A lista de cartões aceitos por CreditCardType aumentará ao longo do tempo, o que significa que deixar esse campo vazio sujeitará o comerciante a alterações futuras. |
CreditCardRestrictions
Restrições aos tipos de cartão de crédito aceitos pelo comerciante.
Representação JSON |
---|
{
"creditCardType": [
enum ( |
Campos | |
---|---|
creditCardType[] |
Uma lista de cartões de crédito aceitos. Nenhum cartão de crédito será aceito se o campo estiver vazio. |
CreditCardType
Tipo de cartão de crédito.
Enumerações | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Não utilizado. |
VISA |
Cartão de crédito Visa. |
MASTERCARD |
Cartão de crédito Mastercard. |
AMERICAN_EXPRESS |
Cartão de crédito American Express. |
DISCOVER |
Cartão de crédito Discover. |
JCB |
Cartão de crédito JCB. |
PaymentOption
Opção que pode ser usada para pagar os serviços prestados por um comerciante. e pode ser compartilhada entre vários comerciantes (por exemplo, aqueles que fazem parte da mesma rede).
Representação JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Campos | |
---|---|
paymentOptionId |
Código usado para identificar a opção de pagamento. Esse código é global para todo o agregador. Se você reutilizar um valor em diversos comerciantes, um usuário poderá pagar com a opção correspondente em todos eles. Nesse caso, quando você atualiza o valor de uma opção de pagamento em um comerciante, todas as outras opções com o mesmo código em outros comerciantes também serão modificadas. Portanto, utilize valores idênticos em todas as opções de pagamento com o mesmo código para evitar comportamentos prejudiciais. |
name |
Nome da opção de pagamento. Pode ser visível para o usuário. |
description |
Descrição da opção de pagamento, Pode ser visível para o usuário. |
price |
O preço da opção de pagamento. |
taxRate |
Taxa de tributo dessa opção de pagamento. Se presente, esse campo substitui o taxRate presente no comerciante ou serviço. Uma mensagem vazia (por exemplo, taxRate {}) redefinirá a taxa de tributo aplicada para zero. |
paymentOptionType |
Tipo dessa opção de pagamento. Uso único para atendimentos sem hora marcada, várias utilizações para pacotes e ilimitado para assinaturas. |
sessionCount |
Em quantas sessões essa opção de pagamento pode ser usada. Válido apenas para várias sessões / pacotes, em que o valor deve ser > 1. |
purchaseInterval |
A opção de pagamento pode ser comprada dentro desse intervalo. |
validInterval |
A opção de pagamento pode ser usada no intervalo (por exemplo, preço especial para janeiro de 2017). Se presente, substitui validDuration e activationType. |
validDuration |
Duração da validade da opção de pagamento (por exemplo, assinatura de 30 dias). Duração em segundos com até nove dígitos fracionários, terminando em " |
activationType |
Define como a data de início da validade é determinada para essa opção de pagamento. |
userRestriction |
Restringe os usuários qualificados para comprar com essa opção de pagamento. Pode ser usado para restringir uma opção de pagamento promocional a um subconjunto de usuários. Se não estiver definido, todos os usuários estarão qualificados. |
PaymentOptionType
Tipo de opção de pagamento.
Enumerações | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Não utilizado. |
PAYMENT_OPTION_SINGLE_USE |
A opção de pagamento só pode ser usada uma vez. |
PAYMENT_OPTION_MULTI_USE |
A opção de pagamento poderá ser usada se a contagem de sessões for > 0. |
PAYMENT_OPTION_UNLIMITED |
A opção de pagamento pode ser usada em um período válido. A contagem de sessões não se aplica. |
ActivationType
Define como a data de início da validade é determinada.
Enumerações | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Não utilizado. |
ACTIVATION_ON_PURCHASE |
A validade começa no momento da compra. |
ACTIVATION_ON_FIRST_USE |
A validade começa quando a opção de pagamento é usada pela primeira vez. |
UserPurchaseRestriction
Restringe os usuários qualificados para comprar uma opção de pagamento.
Representação JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Campos | |
---|---|
newToMerchant |
Uma opção de pagamento que só pode ser comprada por usuários que nunca compraram do mesmo comerciante antes. |
newToPaymentOption |
Uma opção de pagamento que só pode ser comprada por usuários que nunca compraram a mesma opção de pagamento antes. |
PaymentProcessorConfig
Configuração para um processador de pagamentos definida por comerciante.
Representação JSON |
---|
{
"processor": enum ( |
Campos | |
---|---|
processor |
Define o parceiro do processador de pagamentos a que essa configuração se aplica. |
publicKey |
A chave usada para identificar esse comerciante com o processador de pagamentos. Para o Stripe, consulte: https://stripe.com/docs/dashboard#api-keys Para o Braintree, consulte: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
O número da versão da API enviado ao processador de pagamentos com as solicitações de pagamento. |
Processador
Define um parceiro específico de processador de pagamentos.
Enumerações | |
---|---|
PROCESSOR_UNSPECIFIED |
Não usado |
PROCESSOR_STRIPE |
Configuração para pagamentos com o Stripe. |
PROCESSOR_BRAINTREE |
Configuração para pagamentos com o Braintree. |
TokenizationConfig
Configuração de tokenização do processador de pagamentos, definida por comerciante.
Representação JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Campos | |
---|---|
tokenizationParameter |
Uma configuração de tokenização geralmente tem um tokenizationParameter, em que a chave é "gateway" e o valor é o nome do processador. Os demais parâmetros dependem do processador. Consulte a documentação do Google Pay para mais informações. Exemplo do 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" } Exemplo do Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } Exemplo do Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } Um objeto com uma lista de pares |
billingInformationFormat |
Inclua no token de pagamento as informações de faturamento do usuário idênticas ao que consta no Google Pay com a FOP (veja acima). Quando você deixa o campo vazio, o comportamento é o mesmo que especificar o campo MIN. |
BillingInformationFormat
Quanto do endereço de faturamento deve ser exigido do usuário e incluído no token. Os valores de enumeração correspondem aos parâmetros na API Google Pay (consulte https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Enumerações | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Não especificado. O padrão é MIN. |
MIN |
Nome, código do país e código postal (configuração padrão do Google Pay). |
FULL |
nome, endereço, localização, região, código do país e código postal. |
Termos
Um conjunto de regras e diretrizes exibidas ao usuário quando ele faz um agendamento pelo Reservar com o Google.
Representação JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
Campos | |
---|---|
url |
Opcionalmente, o URL dos Termos e Condições. |
text |
O texto a ser exibido para o usuário. Use localizedText abaixo para novas integrações. |
localizedText |
O texto localizado que será exibido ao usuário. |
MerchantMatchingHints
Dicas para ajudar o Google a corresponder um comerciante a um lugar no Google Maps.
Representação JSON |
---|
{ "placeId": string } |
Campos | |
---|---|
placeId |
O código de um lugar no banco de dados do Google Places e no Maps. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre os IDs de lugar. |
ServiceAttribute
Os atributos de serviço são categorias definidas pelo parceiro que descrevem os serviços de um comerciante. Por exemplo, um banco pode definir um atributo de serviço "Tipo de conta" com os valores "Pessoal" e "Empresa", enquanto um salão de beleza, com os valores "Corte de cabelo", "Coloração" e "Penteado".
Representação JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Campos | |
---|---|
attributeId |
Um identificador que identifica exclusivamente esse atributo de serviço entre outros para o mesmo comerciante, por exemplo, "tipo de conta". |
attributeName |
Um nome visível ao usuário para esse atributo, por exemplo, "Tipo de conta". |
value[] |
Todos os valores possíveis para este atributo de serviço. |
Valor
Representa um possível valor para um atributo de serviço específico.
Representação JSON |
---|
{ "valueId": string, "valueName": string } |
Campos | |
---|---|
valueId |
Um identificador que identifica exclusivamente esse valor, entre outros, para esse atributo de serviço. Por exemplo, "pessoal". |
valueName |
Um nome para o valor visível ao usuário, por exemplo, "Pessoal". |
Orientação
Sugestões que são exibidas ao usuário ao fazer uma reserva pelo Reservar com o Google.
Representação JSON |
---|
{
"text": {
object ( |
Campos | |
---|---|
text |
Mensagem personalizada a ser exibida para o usuário ao fazer uma reserva pelo Reservar com o Google. |
Métodos |
|
---|---|
|
Cria e retorna um novo Merchant gerenciado pelo agregador especificado. |
|
Exclui um Merchant existente gerenciado pelo agregador especificado. |
|
Extrai o MerchantStatus de um Merchant . |
|
Atualiza e retorna um Merchant gerenciado pelo agregador especificado. |