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

O nome do recurso do comerciante, no formato partners/{partner_id}/merchants/{merchantId}.

string

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.

string

Número de telefone público do comerciante, incluindo códigos de país e de área, por exemplo, +14567891234.

string

O URL do site público do comerciante.

object (GeoCoordinates)

Informações geográficas do comerciante, incluindo latitude, longitude e endereço.

string

Categoria do negócio na plataforma do agregador.

string (int64 format)

O uso desse campo está suspenso.

integer (uint32 format)

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.

object (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.

object (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.

object (PaymentOption)

Opções de pagamento disponíveis para esse comerciante. Os serviços dele poderão limitar cada opção de pagamento permitida.

object (PaymentProcessorConfig)

Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.

object (TokenizationConfig)

Configuração para um processador de pagamentos tokenizado, se o comerciante oferecer suporte a esse recurso.

object (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.

string

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?

  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

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.

object (MerchantMatchingHints)

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)

object (ServiceAttribute)

Definições de qualquer atributo de serviço usado para descrever os serviços deste comerciante. (opcional)

object (ActionLink)

Opcional. Um URL de ação com idioma associado, lista de países restritos, tipo e plataforma opcional que indica onde essa ação deve ser realizada,

object (Advisement)

Opcional. Recomendações gerais de um comerciante específico para um usuário que entra em uma lista de espera pelo Reservar com o Google. Os campos de texto individuais no aviso precisam ter no máximo 100 bytes.

object (EconomicOperator)

Opcional. Informações do operador econômico associadas a esse comerciante específico necessárias para compliance regulamentar. (opcional)

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

object (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.

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

enum (CreditCardType)

Uma lista de cartões de crédito aceitos. Nenhum cartão de crédito será aceito se o campo estiver vazio.

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

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.

string

Nome da opção de pagamento. Pode ser visível para o usuário.

string

Descrição da opção de pagamento, Pode ser visível para o usuário.

object (Price)

O preço da opção de pagamento.

object (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.

enum (PaymentOptionType)

Tipo dessa opção de pagamento. Uso único para atendimentos sem hora marcada, várias utilizações para pacotes e ilimitado para assinaturas.

string (int64 format)

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.

object (TimeRange)

Essa opção de pagamento pode ser usada para compras dentro desse intervalo.

object (TimeRange)

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.

string (Duration format)

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 "s". Exemplo: "3.5s".

enum (ActivationType)

Define como a data de início da validade é determinada para essa opção de pagamento.

object (UserPurchaseRestriction)

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.

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

boolean

Uma opção de pagamento que só pode ser comprada por usuários que nunca compraram do mesmo comerciante.

boolean

Uma opção de pagamento que só pode ser comprada por usuários que nunca compraram a mesma opção.

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

enum (Processor)

Define o parceiro do processador de pagamentos a que essa configuração se aplica.

string

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

string

Número da versão da API enviada ao processador de pagamentos junto com as solicitações de pagamento.

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

map (key: string, value: string)

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 "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

enum (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.

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

string

Opcionalmente, o URL dos Termos e Condições.

string

O texto a ser exibido para o usuário. Use localizedText abaixo para novas integrações.

object (Text)

O texto localizado que será exibido para o usuário.

{
  "placeId": string
}

string

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.

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

string

Identificador que identifica exclusivamente esse atributo de serviço entre outros para o mesmo comerciante, por exemplo, "account-type".

string

Nome desse atributo visível ao usuário, por exemplo, "Tipo de conta".

object (Value)

Todos os valores possíveis para este atributo de serviço.

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

string

Identificador que distingue exclusivamente esse valor para o mesmo atributo de serviço, por exemplo, "personal".

string

Um nome visível para o usuário, por exemplo, "Pessoal".

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

object (Text)

Mensagem personalizada que será exibida ao usuário ao fazer uma reserva pelo Reservar com o Google.

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

object (Text)

Obrigatório. Nome, endereço, número de telefone e endereço de e-mail do operador econômico, definido como o fabricante, representante autorizado, importador, distribuidor, provedor de serviços de fulfillment ou qualquer outra pessoa física ou jurídica sujeita a obrigações relacionadas à fabricação, disponibilização ou colocação em serviço de produtos. Representação de string em formato livre do economicOperator. Essas informações podem ser formatadas usando " " e "\n".