Cliente da API Java Booking

Você pode baixar nosso Cliente de API de atualização em tempo real do Java para ajudar na implementação as atualizações em tempo real.

Pré-requisitos:

Crie sua conta de serviço e faça o download da chave privada.

Primeiros passos:

  1. Faça o download do A biblioteca de cliente Java descompactou o arquivo para conseguir o arquivo "mapsbooking" .
  2. Crie um projeto Java no seu ambiente de desenvolvimento integrado e faça o download dos exemplos de código InventoryUpdate.java e BookingNotification.java deste repositório:

    git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
    

    e importá-las para o projeto Java no diretório src.

  3. Faça uma cópia da sua chave privada (arquivo JSON) no diretório src.
  4. Adicionar a biblioteca de cliente Java às dependências do projeto (inclua arquivos jar nos diretórios mapsbooking e libs-sources).
  5. Nos dois arquivos Java, siga as etapas a serem feitas para concluir as implementações.

Mais detalhes sobre a API REST podem ser encontradas aqui.

Solução de problemas:

  1. Ao tentar criar um novo comerciante/serviço com um merchantId ou serviceId, você receberá a seguinte mensagem de erro:

    409 Conflict
    {
      code : 409,
      errors :
        [{
            domain : global,
            message : Requested entity already exists,
            reason : alreadyExists,
            debugInfo : detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
        }],
      message : Requested entity already exists,
      status : ALREADY_EXISTS
    }
    
  2. Ao fazer uma chamada de substituição de disponibilidade por um merchantId ou serviceId, a chamada não vai gerar uma mensagem de erro. Isso ocorre porque as alterações nos horários disponíveis via RTUs dão suporte à execução fora de ordem portanto, não está associado a um merchantId ou serviceId. No entanto, os slots na solicitação não serão veiculados na produção devido ao URL inválido merchantId ou serviceId. Para tornar os slots veiculáveis, adicione o comerciante ou serviço ausente por RTUs ou feeds.
  3. Em todas as funções de atualização, o parâmetro "updateMask" deve estar no FieldMask para especificar os campos a serem atualizados. A API é necessária para alterar apenas os valores dos campos conforme especificado na máscara e deixar os outros intocados. Se você transmitir a string updateMask errada, a atualização não terá efeito. Se uma máscara de campo não estiver presente na atualização, a operação se aplica a todos os campos (como se uma máscara de campo de todos os campos tivesse foi especificado). Se quiser atualizar todos os campos, basta definir updateMask vazio.
  4. Os campos com valor zero não são mostrados na resposta.