Referência do Feed de Hotel

Nota

Esta versão beta do Hotel Price Ads está disponível apenas para participantes selecionados. Para obter informações sobre como participar no programa de versão beta, contacte o seu gestor de conta ou inscreva-se aqui.

Se você criar anúncios de preço de hotel no Bing, você deve usar um feed de hotel para fornecer informações do Bing sobre os hotéis que você anuncia. Tem de definir e importar o feed do hotel antes de enviar Mensagens de Transação do Bing.

Para obter informações sobre como criar um feed de hotel, consulte Criar um Feed de Hotel.

Nota

Os elementos têm de ser especificados pela ordem definida pelo Hotel XSD (e conforme listado neste tópico).


Listagens

Define o elemento de nível superior de um feed de hotel.

Elemento Descrição Crianças
listagens O elemento de nível superior num feed de hotel. Tipo de Listagem

Tipo de Listagem

Define uma lista de hotéis no feed.

Elemento Descrição Crianças
idioma Obrigatório.
O tipo de dados é cadeia.

O idioma em que os dados do hotel estão escritos no feed. Especifique o idioma com o código de idioma ISO 639 de duas letras. Por exemplo, utilize en para inglês.

Nenhum
listagem Define uma listagem de hotel. Inclua um listing elemento para cada hotel no feed. Tipo de Listagem

Tipo de Listagem

Define um hotel.

Elemento Descrição Crianças
ID Obrigatório.
O tipo de dados é cadeia.

Um ID opaco definido pelo utilizador que identifica exclusivamente o hotel no feed.

Quando criar a mensagem de transação, utilize este ID no Property elemento da mensagem de transação para identificar o hotel.
Nenhum
nome Obrigatório.
O tipo de dados é cadeia.

O nome do hotel. O nome pode conter um máximo de 200 carateres.
Nenhum
endereço Obrigatório.
O tipo de dados é cadeia ou Tipo de Componente.

A rua do hotel.

Notas:
  • Pode especificar o endereço utilizando texto de forma livre no corpo do address elemento ou utilizando component elementos subordinados para especificar os componentes do endereço (consulte Tipo de Componente).
  • Recomendamos que utilize component elementos para especificar os componentes do endereço.
  • Se utilizar texto de forma livre, separe cada componente do endereço com uma vírgula. Por exemplo, 1234 Billings Way, Redmond, WA, 98030.
Tipo de Componente
país/região Obrigatório.
O tipo de dados é cadeia.

O país onde se encontra o hotel. Especifique o país com o código de país ISO 3116 de duas letras. Por exemplo, utilize E.U.A. para Estados Unidos.
Nenhum
latitude Obrigatório.
O tipo de dados é decimal.

A latitude das coordenadas geográficas do hotel.

Notas:
  • A latitude e a longitude só são necessárias se não especificar phone. É preferível que especifique o telefone e as coordenadas geográficas.
  • A latitude tem de estar entre -90,0 e 90,0.
  • Utilize a API de Localização ou outra ferramenta de Geocodificação para gerar as coordenadas.
Nenhum
longitude Obrigatório.
O tipo de dados é decimal.

A longitude das coordenadas geográficas do hotel.

Notas:
  • A latitude e a longitude só são necessárias se não especificar phone. É preferível que especifique o telefone e as coordenadas geográficas.
  • A longitude tem de estar entre -180,0 e 180,0.
  • Utilize a API de Localização ou outra ferramenta de Geocodificação para gerar as coordenadas.
Nenhum
telemóvel Obrigatório.
O tipo de dados é cadeia.

Uma lista de números de telefone que os clientes utilizam para contactar o hotel.

Atributos:
  • type — Necessário. O tipo de número de telefone especificado. Seguem-se os valores possíveis.
    • main — Necessário. O número de telefone de voz principal do hotel.
    • tollfree — Opcional. O número de telefone de voz gratuito do hotel.
    • fax — Opcional. O número de telefone do fax do hotel.
    • tdd — Opcional. O dispositivo de telecomunicações do hotel para o número de telefone surdo.
    • mobile — Opcional. O número de telefone do hotel.
Notas:
  • Só é necessário um número de telefone se não especificar latitude e longitude. É preferível que especifique o telefone e as coordenadas geográficas.
  • Forneça números de telefone exclusivos para a listagem.
  • Utilize travessões, espaços ou parênteses no número de telefone para facilitar a leitura. Por exemplo, utilize "610-222-3333" ou "(610) 222-3333" em vez de "6102223333".
  • Especifique apenas um número de telefone em cada phone elemento. Não especifique múltiplos números, como 650-123-2222/33.
  • O número de telefone pode conter uma extensão de até 7 dígitos. Preceda as extensões com uma das seguintes abreviaturas: "ext", "extn" e "x". Por exemplo, "408-555-1111x12345" ou "408-555-1111 x12345".
  • O número de telefone pode não incluir carateres alfabéticos.
  • Cada listagem deve especificar um de cada tipo de número de telefone: "main", "mobile", "tollfree", "fax" ou "tdd", se aplicável.
  • Se o número de telefone incluir o código do país/região, preceda-o com um "+". Por exemplo, "+65 6722-2323" para um número em Singapura onde o código do país é 65 ou "+001 (408) 555-1111" para um número na Estados Unidos em que o código do país é 001.
Nenhum
categoria Opcional.
O tipo de dados é cadeia.

Uma categoria que identifica o tipo de hotel. O formato esperado é vacation_rental ou hotel , seguido do caráter pipe e de um valor personalizado. Por exemplo, vacation_rental | "valor personalizado" ou hotel | "valor personalizado"

Para obter uma lista de valores personalizados, veja Categorias de propriedades de alojamento.
Nenhum
conteúdo Opcional.
O tipo de dados é Tipo de Conteúdo.

Fornece informações adicionais sobre o hotel, como uma descrição, críticas e comodidades.
Tipo de Conteúdo

Tipo de Componente

Define um componente de um endereço de rua.

Elemento Descrição Crianças
componente Opcional.
O tipo de dados é cadeia.

Especifique um component elemento para cada componente do endereço.

Atributos:
  • name — Necessário. O nome do componente de endereço. Seguem-se os valores possíveis.
    • addr1 — Necessário. A morada do hotel.
    • addr2 — Opcional. Segunda linha de endereços de rua.
    • addr3 — Opcional. Linha de endereço da terceira rua.
    • cidade — Necessário. O nome da cidade onde se encontra o hotel.
    • province — Necessário. O nome do estado, região ou província onde se encontra o hotel.
    • postal_code — Necessário. O código postal do endereço.
Nenhum

Tipo de Conteúdo

Define informações adicionais sobre o hotel. (Estes elementos podem aparecer por qualquer ordem.)

Elemento Descrição Crianças
texto Opcional.
O tipo de dados é Tipo de descrição.

Uma descrição do hotel.

Atributos:
  • type — Necessário. Defina como descrição.
Tipo de descrição
rever Opcional.
O tipo de dados é Tipo de revisão.

Uma avaliação de hotel. Pode especificar um ou mais <elementos de revisão> .

Atributos:
  • type — Necessário. Defina para um dos seguintes tipos:
    • editorial — A revisão é escrita por um bloguista ou outra autoridade profissional.
    • user — A revisão é escrita por um utilizador.
Tipo de revisão
atributos Opcional.
O tipo de dados é Tipo de atributo.

A lista de comodidades do hotel. Especifique um <elemento subordinado attr> para cada amenidade que pretende incluir.
Tipo de atributo
imagem Opcional.
O tipo de dados é Tipo de imagem.

Uma imagem do hotel. Pode especificar um ou mais <elementos de imagem> . A melhor proporção da imagem é 4:3.

Atributos:
  • type — Necessário. Defina para um dos seguintes tipos:
    • ad — A imagem é um anúncio.
    • menu — A imagem mostra o menu do restaurante do hotel.
    • foto — A imagem é do hotel.
  • URL — Necessário. O URL para a imagem.
  • largura — Opcional. A largura da imagem, em píxeis. Deve ser superior a 720 píxeis.
  • altura — Opcional. A altura da imagem, em píxeis. Deve ser superior a 720 píxeis.
Tipo de imagem
bairros Opcional.
O tipo de dados é Tipo de bairro.

Uma lista de bairros onde o hotel está localizado.
Tipo de bairro
brandCode Opcional.
O tipo de dados é cadeia.

O código da marca associado ao logótipo. Isto é utilizado quando tem vários logótipos para as propriedades que está a anunciar.
Nenhum

Tipo de Descrição

Define uma descrição do hotel.

Elemento Descrição Crianças
ligação Opcional.
O tipo de dados é cadeia.

Um URL para uma descrição online do hotel.
Nenhum
título Opcional.
O tipo de dados é cadeia.

Um título a utilizar para a descrição.
Nenhum
corpo Obrigatório.
O tipo de dados é cadeia.

Uma descrição do hotel.
Nenhum

Tipo de Imagem

Define uma imagem do hotel.

Elemento Descrição Crianças
data Obrigatório.

A data em que a imagem foi tirada.

Atributos:
  • month — Necessário. O mês em que a imagem foi tirada. Os valores válidos são de 1 (janeiro) a 12 (dezembro)
  • day — Necessário. No dia do mês em que a imagem foi tirada.
  • year — Necessário. O ano de quatro dígitos em que a imagem foi tirada.
Nenhum
ligação Opcional.
O tipo de dados é cadeia.

Um URL para a página Web do hotel que contém a imagem.
Nenhum
título Opcional.
O tipo de dados é cadeia.

Um título a utilizar para a imagem.
Nenhum
autor Opcional.
O tipo de dados é cadeia.

O nome da pessoa que tirou a imagem.
Nenhum

Tipo de Bairro

Define um bairro onde o hotel está localizado.

Elemento Descrição Crianças
bairro Opcional.
O tipo de dados é cadeia.

O nome do bairro onde o hotel está localizado.
Nenhum

Tipo de Revisão

Define uma revisão de hotel.

Elemento Descrição Crianças
autor Opcional.
O tipo de dados é cadeia.

O nome da pessoa que escreveu a crítica.
Nenhum
corpo Opcional.
O tipo de dados é cadeia.

O texto da crítica. O texto não deve incluir HTML, mas se incluir, tem de ser escapado.
Nenhum
data Opcional.

A data em que a revisão foi escrita. Especifique a data apenas se o tipo da revisão for utilizador.

Atributos:
  • month — Necessário. O mês em que a crítica foi escrita. Os valores válidos são de 1 (janeiro) a 12 (dezembro).
  • day — Necessário. No dia do mês em que a revisão foi escrita.
  • year — Necessário. O ano de quatro dígitos em que a revisão foi escrita.
Nenhum
ligação Opcional.
O tipo de dados é cadeia.

Um URL para a revisão online.
Nenhum
classificação Opcional.
O tipo de dados é cadeia.

A classificação que o revisor deu ao hotel. A classificação é uma cadeia decimal no intervalo de 0,0 a 10,0.
Nenhum
título Opcional.
O tipo de dados é cadeia.

O título da crítica. Especifique o título apenas se o tipo da crítica for editorial.
Nenhum

Tipo de Atributo

Define uma amenidade de hotel.

Elemento Descrição Crianças
web site Opcional.
O tipo de dados é cadeia.

O URL para o site do hotel.
Nenhum
attr Opcional.
O tipo de dados é cadeia.

Uma amenidade de hotel.

Atributos:
  • name — Necessário. Defina para um dos seguintes valores:
    • air_conditioned — Indica se todos os quartos de hóspedes têm ar condicionado. Defina o valor do elemento como Sim ou Não conforme adequado.
    • all_inclusive_available — Indica se a tarifa do quarto inclui comida e bebidas. Defina o valor do elemento como Sim ou Não conforme adequado.
    • child_friendly — Indica se o hotel inclui funcionalidades especiais para famílias que viajam com crianças, como taxas reduzidas de quartos, área de jogos ou clube infantil. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_affiliated_golf_course — Indica se o hotel tem um campo de golfe no local ou nas proximidades para os hóspedes desfrutarem. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_airport_shuttle — Indica se o hotel oferece um vaivém de aeroporto gratuitamente ou uma taxa. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_bar_or_lounge — Indica se o hotel tem um bar ou sala de estar que serve bebidas alcoólicas. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_beach_access — Indica se o hotel tem acesso à praia sem ter de atravessar uma estrada. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_business_center — Indica se o hotel inclui um centro empresarial onde os hóspedes podem utilizar um computador e impressora gratuitamente ou uma taxa. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_fitness_center — O hotel tem um centro de fitness no local. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_free_breakfast — Indica se o hotel fornece um pequeno-almoço gratuito a todos os hóspedes todos os dias. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_hot_tub — Indica se o hotel tem uma banheira de hidromassagem no local ou alguns ou todos os quartos de hóspedes incluem um conjunto de hidromassagem ou banheira de tubagem de tubagem. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_laundry_service — Indica se o hotel oferece serviço de lavandaria onde o hotel lava a roupa do hóspede. Uma instalação no local, auto-servido e operada por moedas não conta. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_restaurant — Indica se o hotel tem um restaurante no local para os hóspedes. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_room_service — Indica se o hotel oferece serviço de quarto onde a comida é preparada no local e entregue no quarto do hóspede. Defina o valor do elemento como Sim ou Não conforme adequado.
    • has_spa — Indica se o hotel tem um spa no local que fornece serviços como massagem, facial ou sauna. Defina o valor do elemento como Sim ou Não conforme adequado.
    • kitchen_availability — Indica se os quartos de hóspedes incluem cozinhas com frigorífico e fogão. Defina o valor do elemento como Disponível em todas as salas, Disponível em algumas salas ou Não disponível.
    • num_reviews — O número de vezes que o hotel foi revisto. Defina o valor do elemento como o número de críticas.
    • number_of_rooms — o número de unidades associadas à listagem. Defina o valor do elemento como o número de críticas.
    • parking_type — Indica se o estacionamento está disponível e se é gratuito. Defina o valor do elemento como Sem pagamento obrigatório, Pago ou Não disponível.
    • pets_allowed — Indica se o hotel permite que os hóspedes tragam animais de estimação. Defina o valor do elemento como Sim ou Não.
    • smoke_free_property — Indica se o hotel permite fumar. Defina o valor do elemento como Sim ou Não.
    • star_rating — a classificação de star do hotel. Os valores possíveis são de 1 a 5.
    • swimming_pool_type — Indica se o hotel tem uma piscina para os hóspedes. Defina o valor do elemento como Interior, Exterior, Interior e exterior ou Não disponível.
    • wheelchair_accessible — Indica se o hotel está acessível para cadeiras de rodas. Defina o valor do elemento como Sim ou Não.
    • wifi_type — Indica se o hotel oferece serviço Wi-Fi. Defina o valor do elemento como Sem pagamento obrigatório, Pago ou Não disponível.
    • custom_0 — Parâmetro personalizado para informações adicionais não aplicáveis a outros atributos
    • custom_1 — Parâmetro personalizado para informações adicionais não aplicáveis a outros atributos
    • custom_2 — Parâmetro personalizado para informações adicionais não aplicáveis a outros atributos
    • custom_3 — Parâmetro personalizado para informações adicionais não aplicáveis a outros atributos
    • custom_4 — Parâmetro personalizado para informações adicionais não aplicáveis a outros atributos
Nenhum