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

Es el nombre del recurso llamado comercio, que tiene el formato partners/{partner_id}/merchants/{merchantId}.

string

El campo merchant_name, el teléfono, la URL y la información geográfica permiten correlacionar el inventario del socio con comercios que ya se incluyen en Google Maps. Esta información no se mostrará.

Es el nombre del comercio.

string

Es el número de teléfono público del comercio, incluidos los códigos de país y área, p.ej., +14567891234.

string

Es la URL del sitio web público del comercio.

object (GeoCoordinates)

Es la información geográfica del comercio, incluidas la latitud, la longitud y la dirección.

string

Es la categoría de la empresa en la plataforma del agregador.

string (int64 format)

Este campo es obsoleto.

integer (uint32 format)

Es la tasa impositiva del comercio en puntos básicos (la centésima parte de un punto porcentual). Por ejemplo, si la tasa impositiva es del 7.5%, este campo se debe establecer en 750.

Si este campo no se define o se establece en 0, el precio total que se cobra a un usuario por cualquier servicio provisto por este comercio es el precio exacto especificado en Service.price. Se supone que el precio del servicio está exento de impuestos o que ya incluye los impuestos aplicables. Los impuestos no se mostrarán al usuario como una línea de pedido separada.

Si este campo se establece en un valor distinto de cero, el precio total que se le cobrará a un usuario por cualquier servicio provisto por este comercio incluirá el precio del servicio más el impuesto calculado con la tasa impositiva proporcionada aquí. Las fracciones de la unidad monetaria más pequeña (por ejemplo, fracciones de un centavo) se redondearán al número entero más cercano. Los impuestos se mostrarán al usuario como una línea de pedido separada.

Este campo es obsoleto; utiliza taxRate en su lugar.

object (TaxRate)

Es la tasa impositiva del comercio. Si está presente, este campo anula el campo taxRateBasisPoints obsoleto. Un mensaje vacío (es decir, taxRate { }) restablecerá la tasa impositiva aplicada a cero.

object (PaymentRestrictions)

Son las restricciones relacionadas con las formas de pago que acepta este comercio. Suponemos que no existen restricciones si no se establece este campo.

object (PaymentOption)

Son las opciones de pago disponibles para este comercio. Los servicios de este comercio podrán limitar individualmente las opciones de pago que permiten.

object (PaymentProcessorConfig)

Es la configuración de un procesador de pagos con tokens, si el comercio lo admite.

object (TokenizationConfig)

Es la configuración de un procesador de pagos con tokens, si el comercio lo admite.

object (Terms)

Son los Términos y Condiciones específicos del comercio que se muestran al usuario cuando se reserva un servicio a través de Reserva con Google. Además, los Términos y Condiciones del socio agregador siempre se muestran al usuario y no se deben proporcionar aquí.

string

Es una string opaca que identifica la marca orientada al consumidor que se debe utilizar al mostrar la atribución del socio. Este campo permite que los socios con varias marcas orientadas al consumidor proporcionen comercios para todas las marcas dentro del mismo feed.

Una marca consiste en propiedades orientadas al consumidor, como el nombre, el logotipo, las Condiciones del Servicio y la Política de Privacidad.

Si solo hay una marca de socio orientada al consumidor, este campo se puede omitir.

Posibles situaciones:

El socio no tiene varias marcas orientadas al consumidor: Omite este campo.

El socio tiene varias 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

Nota importante: La mayoría de los socios no necesitan establecer este campo. Si un socio desea utilizar este campo, primero debe comunicarse con nosotros para configurar marcas separadas, incluida la marca predeterminada.

object (MerchantMatchingHints)

Son las sugerencias para ayudar a Google a correlacionar un comercio con un lugar en Google Maps. Nota: La mayoría de los socios no necesitan configurar este campo, ya que Google utilizará la información proporcionada anteriormente para establecer una coincidencia entre los comercios y los lugares de Google Maps. (Opcional).

object (ServiceAttribute)

Son las definiciones de cualquier atributo de servicio utilizado para describir los servicios de este comercio. (opcional)

object (ActionLink)

Opcional. Una URL de acción con un idioma asociado, una lista de países restringidos, un tipo y una plataforma opcional que indique en qué plataforma se debe realizar esta acción.

object (Advisement)

Opcional. Son avisos generales de un comercio específico para un usuario que se une a una lista de espera a través de Reserva con Google. Los campos de texto individuales del aviso deben tener un máximo de 100 bytes de longitud.

object (EconomicOperator)

Opcional. Información del operador económico asociada a este comercio específico necesaria para el cumplimiento normativo (opcional)

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

object (CreditCardRestrictions)

Son las restricciones relacionadas con las tarjetas de crédito que acepta este comercio. Asumimos que se aceptan todas las tarjetas de crédito si no se establece este campo. Ten en cuenta que la lista de tarjetas compatibles con CreditCardType aumentará con el tiempo. Eso significa que, si este campo se deja vacío, la configuración queda sujeta a cambios futuros.

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

enum (CreditCardType)

Indica una lista de las tarjetas de crédito admitidas. Si este campo está vacío, no se admite ninguna tarjeta de crédito.

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

Este ID se utiliza para identificar esta opción de pago.

Este ID es global, por lo que se aplica a todo el agregador. Esto implica que, si se reutiliza en varios comercios, un mismo usuario podrá pagar con la opción de pago correspondiente en todos esos comercios.

Cuando se reutiliza un ID en varios comercios y se actualiza cualquier valor de una opción de pago en uno de ellos, también se actualizarán todas las demás opciones de pago con el mismo ID en los otros comercios. Por lo tanto, se recomienda que todas las opciones de pago que compartan el mismo ID siempre se actualicen a valores idénticos para evitar cualquier posibilidad de comportamientos no esperados.

string

Es el nombre de la opción de pago. Puede ser visible para el usuario.

string

Es una descripción de la opción de pago. Puede ser visible para el usuario.

object (Price)

Es el precio de la opción de pago.

object (TaxRate)

Es la tasa impositiva para esta opción de pago. Si está presente, este campo anula el campo taxRate presente en Comercio o Servicio. Un mensaje vacío (es decir, taxRate { }) restablecerá la tasa impositiva aplicada a cero.

enum (PaymentOptionType)

Indica el tipo de esta opción de pago. Uso único para las compras ocasionales, usos múltiples para los paquetes y uso ilimitado para las membresías.

string (int64 format)

Indica la cantidad de sesiones para las que se puede usar esta opción de pago. Válido solo para sesiones múltiples y paquetes, donde el valor debe ser superior a 1.

object (TimeRange)

La opción de pago se puede comprar dentro de este intervalo.

object (TimeRange)

La opción de pago se puede utilizar dentro de este intervalo (p. ej., precio especial para enero de 2017). Si está presente, anula los campos validDuration y activationType.

string (Duration format)

Es la duración de la validez de la opción de pago (p. ej., una membresía de 30 días).

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

enum (ActivationType)

Define cómo se determina la fecha de inicio para la validez de esta opción de pago.

object (UserPurchaseRestriction)

Restringe los usuarios aptos para hacer compras utilizando esta opción de pago. Se puede usar para restringir una opción de pago promocional a un subconjunto de usuarios. Si no se establece, todos los usuarios son aptos.

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

boolean

Es una opción de pago que solo pueden utilizar los usuarios que nunca antes realizaron una compra en ese mismo comercio.

boolean

Es una opción de pago que solo pueden utilizar los usuarios que nunca antes usaron esa misma opción de pago.

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

enum (Processor)

Define el socio del procesador de pagos al que se aplica esta configuración.

string

Es la clave utilizada para identificar a este comercio con el procesador de pagos.

Para obtener información sobre Stripe, consulta https://stripe.com/docs/dashboard#api-keys. Para obtener información sobre Braintree, consulta https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

Es el número de versión de la API que se envía al procesador de pagos junto con las solicitudes de pago.

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

map (key: string, value: string)

Una configuración de asignación de token suele tener un campo tokenizationParameter cuya clave es "gateway" y cuyo valor es el nombre del procesador.

El resto de los parámetros dependen del procesador. Consulta la documentación de Google Pay para obtener más información.

Ejemplo de 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" }

Ejemplo de Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Ejemplo de Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

enum (BillingInformationFormat)

En el token de pago, incluye los datos de facturación del usuario, tal como figura en Google Pay con su FDP (consulta la información anterior). Si dejas el campo vacío, equivale a especificar MIN.

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

string

Es un campo opcional que incluye la URL de los Términos y Condiciones.

string

Es el texto que se mostrará al usuario. Usa el campo localizedText de abajo para nuevas integraciones.

object (Text)

Es el texto localizado que se mostrará al usuario.

{
  "placeId": string
}

string

Es el ID de un lugar en la base de datos de Google Places y en Google Maps. Consulta https://developers.google.com/places/web-service/place-id para obtener más información sobre los IDs de lugar.

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

string

Es un identificador que distingue de forma exclusiva este atributo de servicio entre otros del mismo comercio, p.ej., "account-type".

string

Es el nombre de este atributo que se muestra al usuario, p.ej., "Tipo de cuenta".

object (Value)

Son todos los valores posibles para este atributo de servicio.

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

string

Es un identificador que distingue de forma exclusiva este valor entre otros de este atributo de servicio, p.ej., "personal".

string

Es el nombre del valor que se muestra al usuario, p.ej., "Personal".

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

object (Text)

Es el mensaje personalizado que se mostrará al usuario cuando realice una reserva a través de Reserva con Google.

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

object (Text)

Obligatorio. Nombre, dirección, número de teléfono y dirección de correo electrónico del operador económico, definido como el fabricante, el representante autorizado, el importador, el distribuidor, el proveedor de servicios de cumplimiento o cualquier otra persona física o jurídica sujeta a obligaciones relacionadas con la fabricación de productos, su puesta a disposición o su puesta en servicio Representación de cadena de formato libre de economicOperator. Esta información puede tener formato con " " y "\n".