Criar feeds
Os feeds precisam ser enviados ao Google regularmente para que os dados sejam mostrados diretamente na plataforma. Os feeds a seguir são necessários.
| Feed | Descrição | Frequência |
|---|---|---|
| Profissional de saúde | Contém dados que descrevem profissionais, incluindo links de terceiros para agendamento com profissionais. (Contraparte: profissional de FHIR). . [Obrigatório apenas para agendamentos com profissionais específicos] | Uma vez a cada 24 horas |
| Instalações | Contém dados que descrevem as instalações/locais de assistência médica, como clínicas e testes de laboratório, incluindo links de terceiros para agendamentos nas instalações. (versão: local FHIR) | Uma vez a cada 24 horas |
| Tipo de agendamento | Contém uma lista de todos os tipos de agendamento, incluindo ID e nome. Por exemplo, check-up, doença e um novo paciente. Ele será usado como referência para restringir as programações. (versão: tipo de agendamento FHIR) | Uma vez a cada 24 horas |
| Disponibilidade | Lista os horários disponíveis para determinados profissionais, instalações, tipos de serviço e tipos de agendamento. (contraparte: horário FHIR) É necessário fornecer no mínimo 24 horas de cobertura a partir do próximo horário disponível para cada combinação de profissional, instalação e tipo de agendamento. | Uma vez a cada 15 a 60 minutos |
| Conversão | Compartilhar a taxa de conversão com o Google, incluindo métricas para acessar os links e concluir agendamentos de horários. | Uma vez por semana |
O formato dos feeds é descrito com a sintaxe do buffer de protocolo 3, mas você pode consultar os exemplos de feed para ver o formato JSON. Recomendamos que você faça o upload dos feeds no formato JSON.
Tamanho, fragmentação e compactação do arquivo de feed
Consulte os seguintes tutoriais sobre compactação e fragmentos:Para determinar o tamanho dos feeds, siga as diretrizes a seguir. Um feed pode ser constituído por vários arquivos chamados de "fragmentos":
- Fragmentação de feed sugerida:
- Feed do profissional: 1 fragmento
- Feed da instalação: 1 fragmento
- Feed de tipo de agendamento: 1 fragmento
- Feed de conversão: 1 fragmento
- Feed de disponibilidade : menos de 20 fragmentos
- Tamanho dos arquivos de feed e fragmentação:
- O arquivo de fragmento precisa ter até 200 MB (após a compactação). Use vários fragmentos, se necessário.
- Os registros individuais enviados em um fragmento não precisam ser enviados no mesmo fragmento em feeds futuros.
- Para melhorar o desempenho, divida os dados uniformemente entre os fragmentos, para tornar todos os arquivos de fragmento semelhantes em tamanho.
- Se necessário, use o gzip para compactar os feeds JSON de texto simples. No entanto, faça isso para cada fragmento de feed individual.
Fazer upload dos feeds para sua caixa de depósito SFTP
Para começar a fazer upload de feeds, primeiro conclua as instruções de configuração. Em seguida, acesse a página Feeds no portal de parceiros. Todos os feeds precisam ser enviados para a conta Genérica.
Cada feed precisa ser enviado separadamente pelo SFTP com um arquivo descritor do conjunto de arquivos.
O nome do arquivo de um descritor do conjunto de arquivos precisa ser <feed_name>-<
generation_timestamp>.filesetdesc.json, em que <feed_name> pode ser
healthappointments.practitioner, healthappointments.facility,
healthappointments.appointment_type e healthappointments.availability.
Acesse Como usar a caixa de depósito de feed genérica para mais informações. Veja exemplos na nossa página Amostras.
Confirmar se seus dados estão corretos
Faça login no Portal do Google Partners. Alterne para o ambiente do Sandbox para encontrar as seguintes páginas na seção Painéis.
- Feeds
- Mostra as estatísticas de resumo do feed e aponta erros durante o upload do feed.
Para confirmar se os dados estão corretos após o upload inicial para o ambiente do sandbox, verifique se há erros de feed na página Feeds.
Fazer upload dos seus feeds na produção
Depois de fazer o upload consistente de feeds completos e sem erros para o ambiente de sandbox, você pode começar a fazer o upload para o ambiente de produção. Nesse momento, sua integração não estará ativa.
Quando todos os dados do feed de produção estiverem sendo enviados de maneira consistente e conectados ao seu sistema de produção, os feeds estarão prontos para revisão.
O Google avalia os feeds
Depois de fazer o upload dos seus feeds, o Google processa e avalia a qualidade e a integridade dos feeds.