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:
- Faça o download do A biblioteca de cliente Java descompactou o arquivo para conseguir o arquivo "mapsbooking" .
-
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.
- Faça uma cópia da sua chave privada (arquivo JSON) no diretório src.
- Adicionar a biblioteca de cliente Java às dependências do projeto (inclua arquivos jar nos diretórios mapsbooking e libs-sources).
- 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:
-
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” }
- 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.
- 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.
- Os campos com valor zero não são mostrados na resposta.