Criar feeds
Os feeds precisam ser enviados ao Google regularmente para que os dados sejam exibidos diretamente nele. Os feeds a seguir são necessários.
| Feed | Descrição | Frequência |
|---|---|---|
| Profissional | Contém dados que descrevem profissionais, incluindo links de terceiros para agendamento. Contraparte: FHIR Practice. [Obrigatório apenas para agendamento com profissionais específicos] | Uma vez a cada 24 horas |
| Recurso | Contém dados que descrevem instalações/locais de saúde, como centros de testes e clínicas, incluindo links de terceiros para agendamento com instalações. Contraparte: local FHIR | Uma vez a cada 24 horas |
| Tipo de agendamento | Contém uma lista de todos os tipos de agendamento, incluindo código e nome. Por exemplo, check-up, doença e novo paciente. Ela será usada como referência para restringir programações. Contraparte: tipo de horário FHIR | Uma vez a cada 24 horas |
| Disponibilidade | Lista os horários disponíveis para determinados profissionais, instalações, tipos de serviço e horários. Contraparte: slot de FHIR É necessário fornecer no mínimo 24 horas a partir do próximo horário disponível para cada combinação de profissional liberal, instalação e tipo de agendamento. | Uma vez a cada 15 a 60 minutos |
| Conversão | Compartilhe a taxa de conversão com o Google, incluindo métricas de acesso aos links e agendamentos. | Uma vez por semana |
O formato dos feeds é descrito com a sintaxe do buffer de protocolo 3, mas é possível consultar as amostras do feed para ver o formato JSON. Recomendamos que você faça upload dos feeds no formato JSON.
Tamanho, fragmentação e compactação de arquivos de feed
Veja os seguintes tutoriais sobre compactação e fragmentos:Para determinar o tamanho dos feeds, use as seguintes diretrizes (um feed pode ser constituído por vários arquivos chamados "fragmentos"):
- Fragmentação sugerida do feed:
- Feed do profissional: 1 fragmento
- Feed da instalação: 1 fragmento
- Feed do tipo de horário: 1 fragmento
- Feed de conversão: 1 fragmento
- Feed de disponibilidade : menos de 20 fragmentos
- Tamanho dos arquivos do feed e da fragmentação:
- O arquivo de fragmento precisa ter até 200 MB (após a compactação). Use vários fragmentos, se necessário.
- 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. Depois disso, navegue até a página feeds no portal do parceiro. Todos os feeds devem ser enviados para a conta Genérica.
Cada feed precisa ser enviado por meio do SFTP separadamente com um arquivo descritor do arquivo. 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.prof, healthappointments.facility, healthappointments.appointment_type e healthappointments.availability.
Acesse Como usar a caixa de depósito do feed genérico para mais informações. Há exemplos disponíveis na nossa página Amostras.
Confirmar se seus dados estão corretos
Faça login no Portal do Google Partners. Alterne para o ambiente Sandbox para encontrar as páginas a seguir 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 de sandbox, verifique se há erros 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 do sandbox, é possível começar o upload para o ambiente de produção. A integração não vai estar ativa no momento.
Depois que todos os dados do feed de produção forem enviados de maneira consistente e conectados ao sistema de produção, os feeds estarão prontos para revisão.
O Google avalia os feeds
Depois que você fizer o upload dos seus feeds, o Google os processará e avaliará a qualidade e a integridade deles.