1. Centro de Ajuda
  2. Websites de Guesty
  3. Sites avançados para Guesty
  4. Conteúdo dinâmico: Coleções

Site avançado: Conteúdo dinâmico - Coleções do Airtable

O Airtable pode ser usado como uma coleção para gerar Páginas Dinâmicas. Para obter mais informações sobre coleções, consulte Definir uma coleção para Páginas Dinâmicas.

Importante:

A partir de 1º de fevereiro de 2024, as chaves de API serão completamente descontinuadas. Nesse momento, as coleções que ainda não migraram suas chaves de API para tokens de acesso pessoal poderão sofrer interrupções.

Limitações e especificações por tipo de coleção

As coleções do Airtable têm as seguintes limitações:

 

Airtable

Número de coleções por local

100

Campos (colunas)

100

Limite de caracteres para o nome da coleção

50

Limite de caracteres do nome do campo

50

URL do item da página

350 caracteres

Atualizar dados

Automaticamente a cada hora

Para criar uma coleção no Airtable:

  1. No painel esquerdo, clique em Conteúdo, clique em Coleções e, em seguida, clique em + Adicionar Coleção.
  2. Clique Airtable.
  3. Insira seu token do Airtable.
    • Token de acesso
  4. Insira suas credenciais da API do Airtable. 
    • Chave de API
      1. Clique Página da conta do Airtable (localizado na etapa 1 de Como conectar-se ao Airtable).
      2. Uma nova aba será aberta com a página da sua conta do Airtable (talvez seja necessário fazer login).
      3. Após fazer login, visite airtable.com/create/tokens (Caso não esteja conectado ao Airtable, você verá a página de erro 404).

      4. Na página de tokens de acesso pessoal, clique em Criar token.

      5. Insira um nome para o token.

      6. Na seção Escopos, clique em + Adicionar um escopo e selecione data.records:read (Ver os dados em registros).

      7. Na seção Acesso, clique em + Adicionar uma base e selecione a opção Todas as bases atuais e futuras em todos os espaços de trabalho atuais e futuros, localizada em Todos os espaços de trabalho.

      8. Selecione a data.records:read (Consulte os dados nos registros) opção.

      9. Na seção Acesso, clique em Adicionar uma base.

      10. Selecione a opção Todas as bases atuais e futuras em todos os espaços de trabalho atuais e futuros, localizada em Todos os Espaços de Trabalho.

      11. Clique Criar token.

      12. Clique no botão copiar localizado ao lado do token.

      13. Voltar para Site Guesty e cole o token no campo Token de acesso.

    • URL de exemplo
      1. Clique em Página da API do Airtable (localizado na etapa 2 de Como conectar-se ao Airtable).
      2. Uma nova aba será aberta no Airtable (talvez seja necessário fazer login).
      3. Na página de Referência da API, role para baixo e selecione a tabela desejada.
      4. No painel lateral, clique em Autenticação.
      5. Na aba curl, copie o link em EXEMPLO.
      6. Copie o link abaixo de EXEMPLO (localizado na aba Enrolar).
      7. Volte para Site Guesty e cole-o no campo URL de exemplo.
  5. Clique em Importar campos.
  6. Defina o tipo de dados correto para cada campo.
  7. Clique em Continuar.

Atualize a chave de API de uma coleção existente com um token de acesso pessoal.

Para atualizar a API de uma coleção existente com um Token de Acesso Pessoal:

  1. No painel esquerdo, clique em Conteúdo, clique em Coleções e, em seguida, na coleção desejada do Airtable.

  2. Clique em Configurações da coleção localizado na parte inferior.

  3. No campo Token de Acesso, substitua a Chave de API por um token de acesso pessoal.

    • Para criar um token de acesso pessoal:

      1. Clique em Página da conta do Airtable (localizado na etapa 1 de Como conectar-se ao Airtable).
      2. Uma nova aba será aberta com a página da sua conta do Airtable (talvez seja necessário fazer login).
      3. Após fazer login, visite airtable.com/create/tokens (Caso não esteja conectado ao Airtable, você verá a página de erro 404).

      4. Na página de tokens de acesso pessoal, clique em Criar token.

      5. Insira um nome no campo Nome. Na seção Escopos, clique em + Adicionar um escopo e selecione data.records:read (Ver os dados em registros).

      6. Na seção Acesso, clique em + Adicionar uma base e selecione a opção Todas as bases atuais e futuras em todos os espaços de trabalho atuais e futuros, localizada em Todos os espaços de trabalho.

      7. Clique Criar token.
      8. Clique no botão copiar localizado ao lado do token.
      9. Voltar para Site Guesty e cole o token no campo Token de acesso.

  4. Clique Atualizar dados.

  5. Clique Feito.

Campos suportados

Observação:

A Airtable fez alterações em seus Anexos de URL (como links e imagens) fazendo com que expirem após duas horas. Sites Guesty não é afetado por essa mudança, já que obtém dados do Airtable a cada hora.

A tabela a seguir descreve os campos do Airtable compatíveis, os campos correspondentes nos sites Guesty e exemplos.

Campo de sites Guesty Campo Airtable Exemplo

Texto

Texto rico

Bem-vindo(a) ao meu consultório odontológico.

Observação:

O uso do campo de texto formatado para links integrado do Airtable não é compatível. Por exemplo, para adicionar um link, use o HTML: <a> </a> marcação.

Texto

Texto longo

Observação:

Este campo aceita HTML e quebras de linha.

Texto

Texto simples

Bem-vindo(a) ao meu escritório.

Numérico

Número

10.000

Observação:

Deve conter apenas números e pontos (para decimais).

Booleano

Caixa de seleção

Observação:

Apenas para widgets personalizados.

Imagem

Anexo com uma imagem

Imagem adicionada através do Airtable.

Link

URL

https://goo.gl/maps/F81HPm4CBTQSTsJ5A

Vídeo

URL ou texto

https://www.youtube.com/watch?v=8EsYwAKxAFU

Telefone

Número de telefone ou mensagem de texto

123456789

E-mail

E-mail ou mensagem de texto

email@email.com

Localização

Texto

Endereço, CEP, região, cidade, país

846 Kerry Way, 90017, CA, Los Angeles, EUA

Horário comercial

Texto

SÁBADO, DOM: 08h00-20h00; QUI, SEX: 08h00-12h00;

Coleção interna que contém um campo de imagem.

Anexo com várias imagens

Imagens adicionadas através do Airtable.

Texto

Número

 

Texto

Moeda

Observação:

Exibe apenas o número, sem o símbolo de dólar.

Texto

Porcentagem

Observação:

Exibe com decimais e sem o sinal de porcentagem (%).

Texto

Avaliação

Observação:

Exibe o número.

Texto

Fórmula

Observação:

O resultado da fórmula pode ser uma string.

Texto

Número automático

 

Conta social

Valor

Deve ser formatado como nome: valor; nome: valor;

E-mail: my@gmail.com; WhatsApp: 123456; Facebook: Guesty Websites;

Observação:

Redes sociais suportadas: e-mail, WhatsApp, Facebook, Twitter, Instagram, YouTube, LinkedIn, Yelp, Pinterest, Google Meu Negócio, Waze, Vimeo, Snapchat, Reddit, TripAdvisor, Foursquare, RSS.

Data e hora

Texto

A estrutura padrão é AAAA-MM-DD HH:mm:SS, que é exibida como 2021-10-06 16:12:00. Para obter uma lista completa dos formatos de data e hora e como eles são exibidos, consulte a classe DateTimeFormatter.

Observação:

O site sempre será exibido no fuso horário UTC, independentemente da configuração do Airtable, mesmo que a opção "Usar o mesmo fuso horário para todos os colaboradores" esteja ativada (no Airtable).

Para evitar confusão de fuso horário entre o site e o Airtable, recomenda-se ativar a opção "Usar o mesmo fuso horário para todos os colaboradores" (localizada no Airtable) e selecionar o fuso horário GTM/UTC.

Este campo pode ser usado para ordenação ao utilizar os filtros ou a funcionalidade de classificação na janela pop-up Dados Conectados.

Seleção múltipla

Seleção múltipla

Após definir o campo como Seleção Múltipla, clique em Opções para adicionar opções. Cada linha da coleção pode ser atribuída a uma ou mais das opções que você criou.

Observação:

Este campo pode ser usado para filtrar a coleção exibida em widgets, como galeria de fotos, lista, acordeão e widgets personalizados que se conectam a coleções.

Observação:

Devido a limitações da API, os sites da Guesty não importarão campos que não possuam conteúdo nas 10 primeiras linhas.

Ordem da linha

Ao usar coleções do Airtable, a ordem das linhas é obtida aleatoriamente devido a uma limitação da API do site do Airtable. Ignoramos filtros ou ordenação no Airtable.

Para obter a ordem das linhas exatamente como existe no Airtable, incluindo filtros e classificação, adicione o nome da visualização do Airtable à URL de exemplo que você está usando para importar a coleção. Para obter mais informações, consulte o suporte do Airtable.

Para adicionar a visualização, após inserir o URL de exemplo, adicione '?view=View Name'. O nome da visualização diferencia maiúsculas e minúsculas e deve ser digitado exatamente como está escrito no Airtable.

Importante:

Excluir ou alterar o nome da visualização após importar a coleção interromperá a conexão.

Segue abaixo um exemplo da URL antes de adicionar o nome da visualização:

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main%20View

Segue abaixo um exemplo da URL após a adição do nome da visualização:

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main View

Para obter mais informações sobre como adicionar o nome da visualização ao URL, consulte este vídeo.

O próximo passo é criar ou converter uma Página Dinâmica para que você possa conectá-la à sua coleção recém-criada. Ou, você pode conectar as linhas da coleção a páginas normais. Para saber como, consulte Conectar Linhas da Coleção a Páginas Normais.

Relativo a:

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0