Use esta referência para ver os campos compatíveis e os respectivos exemplos relacionados aos pontos de extremidade POST /{catalog_id}/batch
e POST [/{catalog_id}/items_batch
.
/{catalog_id}/batch
Os campos descritos aqui são compatíveis com os métodos CREATE
e UPDATE
.
Ao atualizar itens, forneça uma string vazia como valor para cancelar a definição de um campo opcional. Definir o valor como null
não removerá a definição do campo.
Campo | Descrição |
---|---|
tipo: matriz<string> | Opcional. URLs para até 9 a 10 imagens diferentes. |
tipo: lista<KeyValue:string,string> | Opcional. Atributos adicionais para distinguir o produto no grupo de variantes.
|
tipo: string | Obrigatório. Identifica o status de disponibilidade:
|
tipo: string | Opcional. Grupo de pessoas com a mesma idade ou idade semelhante. Valores aceitos: |
tipo: object<> | Opcional. Links que direcionam a apps para celular. |
tipo: string | Opcional, mas recomendado para anúncios de catálogo Advantage+ (pode contribuir para melhorar o desempenho do anúncio). Opcional para Compras no Instagram e Lojas de Páginas, mas obrigatório para habilitar a finalização da compra local nesses canais (somente nos EUA). Obrigatório para Marketplace (somente nos EUA). Categoria de produto do Google (GPC, pelas iniciais em inglês) referente ao item. Use o caminho de taxonomia da categoria ou o número de identificação correspondente listado aqui. Se você usar a finalização da compra no Facebook e no Instagram (somente nos EUA), a GPC de um item afetará os impostos e a política de devolução do produto. Para saber mais, consulte Como adicionar uma categoria de produto do Google ou do Facebook para itens do catálogo. Exemplo: |
tipo: string | Opcional. Tamanho máximo: 100. Cor do item. |
tipo: string | Obrigatório. Condição do item: |
tipo: string | Obrigatório. Moeda para o valor especificado. A API de Marketing aceita as mesmas moedas compatíveis com as contas de anúncios. Use os padrões ISO 4217 para definir a moeda. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. Forneça uma string vazia para cancelar a definição. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. Forneça uma string vazia para cancelar a definição. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. Forneça uma string vazia para cancelar a definição. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. Forneça uma string vazia para cancelar a definição. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. Forneça uma string vazia para cancelar a definição. |
tipo: string | Obrigatório. Tamanho máximo: 5.000. Descrição curta do item. |
tipo: string | Opcional. Gênero para definir tamanhos. Valores possíveis: |
tipo: string | Opcional. Tamanho máximo: 70. O número global de item comercial pode incluir |
tipo: string | Obrigatório. Link para a imagem do item usada no anúncio. Forneça imagens de tamanho adequado. Para imagem única, anúncios de catálogo Advantage+
Caso sejam usadas proporções diferentes, o Facebook cortará a imagem para aproximá-la da proporção mínima ou máxima, dependendo da taxa de proporção original. Para imagem de carrossel, anúncios de catálogo Advantage+: o requisito mínimo de resolução é de 500 pixels x 500 pixels, e o Facebook cortará a imagem a uma proporção de 1:1. Recomendação: evite mudar a |
tipo: número | Opcional. Número inteiro que pode ser usado pelos anunciantes para armazenar informações sobre o nível de estoque. |
tipo: string | Não aplicável para anúncios de catálogo Advantage+. Opcional para comércio. Indica se um item será usado no lançamento do produto. Valores compatíveis:
|
tipo: string | Obrigatório. Tamanho máximo: 100. Título do item. |
tipo: string | Opcional. Tamanho máximo: 100. Padrão ou estampa de um item. |
tipo: número inteiro | Obrigatório. O preço multiplicado por 100, para todas as moedas. Exemplo: 490, quando usado com USD, significa US$ 4,90. Já 49000, quando usado com JPY, significa ¥ 490,00. |
tipo: string | Opcional. Tamanho máximo: 750. Categoria do item definida pelo varejista. Exemplo em valores separados por tabulação: Casa e jardim > Cozinha e sala de jantar > Eletrodomésticos > Geladeiras. Exemplo em XML: product_type > Casa e jardim > Cozinha e sala de jantar > Eletrodomésticos > Geladeiras > product_type. |
tipo: string | Opcional. Aceita strings. Pode ser usado pelo anunciante para agrupar produtos. |
tipo: número inteiro | Opcional. Preço com desconto se o artigo estiver em promoção. É o preço promocional multiplicado por 100, para todas as moedas. Exemplo: 490, quando usado com USD, significa US$ 4,90. Já 49000, quando usado com JPY, significa ¥ 490,00. |
tipo: string | Opcional. Data e hora de término da oferta. Exemplo: |
tipo: string | Opcional. Data e hora de início da oferta.
|
tipo: matriz<object> | Opcional. Informação de envio. |
tipo: string | Opcional. Tamanho do item. Exemplo: |
tipo: string | Obrigatório. Link para o site do comerciante no qual é possível comprar o item. |
tipo: string | Opcional. O ID do fornecedor/vendedor que comercializa o item. |
/{catalog_id}/batch
{ "access_token": "<ACCESS_TOKEN>", "requests": [ { "method": "DELETE", "retailer_id": "retailer-1" }, { "method": "CREATE", "retailer_id": "retailer-2", "data": { "availability": "in stock", "brand": "Nike", "category": "t-shirts", "description": "product description", "image_url": "http://www.images.example.com/t-shirts/1.png", "name": "product name", "price": 1000, "currency": "USD", "shipping": [ { "country": "US", "region": "CA", "service": "service", "price_value": "10", "price_currency": "USD" } ], "condition": "new", "url":"http://www.images.example.com/t-shirts/1.png", "retailer_product_group_id": "product-group-1" }, "applinks": { "android": [{ "app_name": "Electronic Example Android", "package": "com.electronic", "url": "example-android://electronic" }], "ios": [{ "app_name": "Electronic Example iOS", "app_store_id": 2222, "url": "example-ios://electronic" }] }, }, { "method": "UPDATE", "retailer_id": "retailer-3", "data": { "availability": "out of stock", } } ] }
/{catalog_id}/batch
Um ou mais identificadores serão retornados.
"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch
/{catalog_id}/items_batch
Para catálogos de comércio: use esta API se você precisar atualizar as informações de produto com uma frequência maior do que uma vez por hora (caso contrário, use a API de Feed). Você pode atualizar vários itens em uma única solicitação HTTP.
Estes campos de produto são compatíveis com os métodos CREATE
e UPDATE
nas versões 3.3 e 3.2:
Campo | Descrição |
---|---|
tipo: matriz<string> | Opcional. Link para até 9 a 10 imagens diferentes. |
tipo: lista<KeyValue:string,string> | Opcional. Atributos adicionais para distinguir o produto no grupo de variantes. Exemplo: |
tipo: string | Opcional. Grupo de pessoas com a mesma idade ou idade semelhante. Valores aceitos: |
tipo: objeto<string> | Opcional. Links que direcionam a apps para celular. Exemplo: "applink" : { "ios_url": "example-ios://electronic", "ios_app_store_id": "42", "ios_app_name": "Electronic Example iOS", "iphone_url": "example-iphone://electronic", "iphone_app_store_id": "43", "iphone_app_name": "Electronic Example iPhone", "ipad_url": "example-ipad://electronic", "ipad_app_store_id": "44", "ipad_app_name": "Electronic Example iPad", "android_url": "example-android://electronic", "android_package": "com.electronic", "android_class": "com.electronic.Example", "android_app_name": "Electronic Example Android", "windows_phone_url": "example-windows://electronic", "windows_phone_app_id": "64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name": "Electronic Example Windows", } |
tipo: string | Obrigatório. Identifica o status de disponibilidade:
|
tipo: string | Opcional. Tamanho máximo: 100. Cor do item. |
tipo: string | Obrigatório. Condição do produto: |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. |
tipo: string | Opcional. Tamanho máximo: 100. Informações adicionais sobre o item. |
tipo: string | Obrigatório. Tamanho máximo: 5.000. Texto curto que descreve o produto. |
tipo: matriz<string> | Opcional. Lista de recursos a serem desabilitados. Valores possíveis: |
tipo: string | Opcional. Gênero para definir tamanhos. Valores possíveis: |
tipo: string | Opcional. Tamanho máximo: 250. Valores predefinidos (ID da categoria ou string) da taxonomia de produtos do Google. Exemplo: Vestuário e acessórios > Roupas > Vestidos ou 2271. |
tipo: string | Opcional. Tamanho máximo: 70. O número global de item comercial (GTIN, pelas inicias em inglês) pode incluir |
tipo: string | Obrigatório. ID do varejista. |
Tipo: matriz <object> | As URLs e tags para imagens a serem usadas em anúncios ou lojas. Aceita até 20 imagens diferentes. As tags são opcionais. Se forem usadas, precisarão descrever o que há na imagem. Exemplo: "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ] |
tipo: string | Não será obrigatório se Recomendamos usar Link para a imagem do item usada no anúncio. Forneça imagens de tamanho adequado. Para imagem única, anúncios de catálogo Advantage+:
Para imagem de carrossel, anúncios de catálogo Advantage+: o requisito mínimo de resolução é de 500 pixels x 500 pixels, e o Facebook cortará a imagem a uma proporção de 1:1. |
Tipo: matriz <object> | As URLs e tags para vídeos a serem usadas em anúncios ou lojas. Aceita até 30 mil vídeos no nível do catálogo. As tags são opcionais. Se forem usadas, precisarão descrever o que há no vídeo. O tamanho máximo de arquivo de vídeo é 200 MB. Formatos compatíveis: .3g2, .3gp, .3gpp, .asf, .avi, .dat, .divx, .dv, .f4v, .flv, .gif, .m2ts, .m4v, .mkv, .mod, .mov, .mp4, .mpe, .mpeg, .mpeg4, .mpg, .mts, .nsv, .ogm, .ogv, .qt, .tod, .ts, .vob e .wmv. Exemplo: "video": [ { "url":"http://example.com/video_1.mp4", "tag": ['Swimming pool','Gym'], } ] OBSERVAÇÃO: para excluir o vídeo 1 se o produto tiver vídeos 1 e 2, remova o vídeo 1 da matriz: [ { "method": "UPDATE", "data": { "video": [ { "url": "https://google.com/video_2.mp4", "tag": ["video_2"] } ] } } ] Para excluir todos os vídeos, envie uma matriz vazia: [ { "method": "UPDATE", "data": { "video": [] } } ] |
tipo: objeto | Opcional. Número inteiro que pode ser usado pelos anunciantes para armazenar informações sobre o nível de estoque. |
tipo: string | Opcional. O ID fornecido pelo anunciante para um grupo de produtos (não é o FBID). Aceita strings. Pode ser usado por anunciantes para agrupar objetos diferentes (itens, veículos, hotéis, voos, entre outros). |
tipo: string | Obrigatório. Link para o site do comerciante no qual é possível comprar o item. |
tipo: string | Opcional. ID único do fabricante do produto. |
tipo: string | Opcional. Tamanho máximo: 100. O padrão ou a estampa do produto. |
tipo: string | Obrigatório. Preço do item. Formate o preço como o custo seguido pelo código de moeda de três dígitos baseado nos padrões ISO, com um espaço entre o custo e a moeda. Exemplo: |
tipo: matriz<string> | Tamanho máximo da matriz: 5.000. Tamanho máximo da tag única: 110 caracteres. Matriz de tags técnicas que podem ser aplicadas a um produto com a finalidade de criar conjuntos de produtos. O conteúdo desse campo não fica visível para os consumidores. Isso significa que a atualização das tags não disparará uma análise de integridade. Use apenas letras minúsculas. Não é permitido incluir espaços em branco à esquerda e à direita. Exemplo: |
tipo: string | Opcional, mas obrigatório para usar o recurso de sobreposição em anúncios de catálogo Advantage+. Preço com desconto se o artigo estiver em promoção. Formate o preço como o custo seguido pelo código de moeda de três dígitos baseado nos padrões ISO, com um espaço entre o custo e a moeda. Exemplo: |
tipo: string | Opcional. Data e hora de início e fim da promoção, separadas por uma barra. Escreva as datas de início e fim como AAAA-MM-DD. Adicione um "T" após cada data e depois inclua a hora. Escreva a hora em um formato de 24 horas (0h00 a 23h59).
|
tipo: string | Opcional. Blob com preços diferentes para cada país e região. Regiões diferentes são separadas por vírgulas. O formato deve ser
|
tipo: string | Opcional. Tamanho do item. Exemplo: |
tipo: string | Obrigatório. Tamanho máximo: 100. Título do item. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
Saiba mais sobre os campos de produto na Referência da API.
PRODUCT_ITEM
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "PRODUCT_ITEM", "requests": [ { "method": "DELETE", "data": { "id": "retailer-1" } }, { "method": "CREATE", "data": { "id": "retailer-2", "applink" : { "ios_url":"example-ios://electronic", "ios_app_store_id":"42", "ios_app_name":"Electronic Example iOS", "iphone_url":"example-iphone://electronic", "iphone_app_store_id":"43", "iphone_app_name":"Electronic Example iPhone", "ipad_url":"example-ipad://electronic", "ipad_app_store_id":"44", "ipad_app_name":"Electronic Example iPad", "android_url":"example-android://electronic", "android_package":"com.electronic", "android_class":"com.electronic.Example", "android_app_name":"Electronic Example Android", "windows_phone_url":"example-windows://electronic", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Electronic Example Windows", }, "availability": "in stock", "brand": "Nike", "google_product_category": "t-shirts", "description": "product description", "image_link": "http://www.images.example.com/t-shirts/1.png", "title": "product name", "price": "10.00 USD", "shipping": [ { "shipping_country": "US", "shipping_region": "CA", "shipping_service": "service", "shipping_price_value": "10", "shipping_price_currency": "USD" } ], "condition": "new", "link":"http://www.images.example.com/t-shirts/1.png", "item_group_id": "product-group-1" } }, { "method": "UPDATE", "data": { "availability": "out of stock", "id": "retailer-3", } } ] }
PRODUCT_ITEM
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Para saber mais, consulte Como carregar itens para um catálogo com um feed de dados no Gerenciador de Comércio.
Os campos de produto compatíveis com os métodos CREATE
e UPDATE
para o tipo HOTEL
, na versão 3.2:
Campo | Descrição |
---|---|
tipo: objeto<string> | Obrigatório. O endereço do hotel. |
tipo: | Opcional. Links que direcionam a apps para celular. |
tipo: string | Obrigatório. O preço-base do pernoite no quarto de hotel. Adicione o tipo de moeda ao preço. Formate o preço como o custo seguido pelo código de moeda baseado nos padrões ISO, com um espaço entre o custo e a moeda. Exemplo: |
tipo: string | Opcional. Marca da rede de hotéis. |
tipo: string | Obrigatório. Máximo de caracteres: 5.000. Descrição curta do hotel. |
tipo: matriz<object> | Opcional. Classificação dada pelos hóspedes do hotel. |
tipo: string | Obrigatório. ID único do hotel. |
tipo: matriz<object> | Obrigatório. As URLs e tags para imagens a serem usadas nos anúncios. Aceita até 20 imagens múltiplas. O uso das tags é opcional. Se forem usadas, precisarão descrever o que há na imagem. Exemplo: |
tipo: string | Obrigatório. A localização de latitude do hotel. |
tipo: string | Obrigatório. A localização de longitude do hotel. |
tipo: string | Opcional. Programa de fidelidade usado para o hotel. |
tipo: string | Opcional. Indicador de lucratividade do hotel, com valor entre |
tipo: string | Obrigatório. O nome do hotel. |
tipo: matriz<string> | Opcional. Um ou mais bairros do hotel. Exemplo: |
tipo: string | Opcional. Número de telefone com código de país. |
tipo: string | Opcional. Preço promocional do pernoite no hotel. Use esse campo para divulgar descontos na tarifa regular do hotel. Obrigatório: adicione o tipo de moeda ao preço. Formate o preço como o custo seguido pelo código de moeda baseado nos padrões ISO, com um espaço entre o custo e a moeda. Exemplo: |
tipo: string | Opcional. A classificação com estrelas do hotel. O número deve estar entre |
tipo: string | Obrigatório. Link para o site externo no qual é possível reservar um quarto de hotel. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
HOTEL
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "HOTEL", "requests": [ { "method": "DELETE", "data": { "hotel_id": "hotel-1" } }, { "method": "CREATE", "data": { "hotel_id": "1234", "brand": "Premium_brand", "description": "A very nice hotel", "name": "The best hotel", "base_price": "100.00 USD", "longitude":"42.10", "latitude":"42.10", "address": { "addr1":"100 Main Street", "city":"North Pole", "region":"ABC", "country":"US", "postal_code":"11111" }, "guest_rating" : [ { "rating_system":"tripAdvisor", "score":"7.8", "number_of_reviewers":"300", "max_score":"10", }, { "rating_system":"Yelp", "score":"5.1", "number_of_reviewers":"123", "max_score":"10", }, ], "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ], "applink" : { "ios_url":"example-ios://electronic", "ios_app_store_id":"42", "ios_app_name":"Electronic Example iOS", "iphone_url":"example-iphone://electronic", "iphone_app_store_id":"43", "iphone_app_name":"Electronic Example iPhone", "ipad_url":"example-ipad://electronic", "ipad_app_store_id":"44", "ipad_app_name":"Electronic Example iPad", "android_url":"example-android://electronic", "android_package":"com.electronic", "android_class":"com.electronic.Example", "android_app_name":"Electronic Example Android", "windows_phone_url":"example-windows://electronic", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Electronic Example Windows", }, "loyalty_program":"Premium_program", "margin_level": "8", "phone":"+61 2-96027455", "star_rating":"4", "url":"http://www.images.example.com/t-shirts/1.png" } }, { "method": "UPDATE", "data": { "base_price": "90.00 USD", "hotel_id": "hotel-3", } } ] }
HOTEL
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Estes campos de produto são compatíveis com os métodos CREATE
e UPDATE
para o tipo HOTEL_ROOM
na versão 3.2.
Campo | Descrição |
---|---|
tipo: string | Obrigatório. O preço-base para 1 noite. Para moeda, siga os códigos ISO 4217. Exemplo: |
tipo: string | Obrigatório. Tamanho máximo: 5.000. Texto curto que descreve o quarto. |
tipo: string | Obrigatório. ID único para o varejista do hotel. |
tipo: string | Obrigatório. ID único do hotel. |
tipo: matriz<object> | Obrigatório. Imagens do quarto. |
tipo: string | Obrigatório. Tamanho máximo: 100. Nome do quarto. |
tipo: string | Obrigatório. Link para o site do anunciante no qual é possível reservar a estadia. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
HOTEL_ROOM
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "HOTEL_ROOM", "requests": [ { "method": "DELETE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-1", } }, { "method": "CREATE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-2", "description": "product description", "name": "product name", "base_price": "100 USD", "url": "http://www.example.com/t-shirts/1.html", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ] }, { "method": "UPDATE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-3", "base_price": "120 USD", } } ] }
HOTEL_ROOM
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Estes campos de produto são compatíveis com os métodos CREATE
e UPDATE
para tipo o FLIGHT
na versão 3.2.
Campo | Descrição |
---|---|
tipo: string | Opcional. Máximo de caracteres: 5.000. Descrição do voo. |
tipo: string | Obrigatório. Aeroporto de destino do voo. Deve ser escrito como um código IATA.
|
tipo: string | Opcional. Nome da cidade de destino do voo. |
tipo: matriz<object> | Obrigatório. As URLs e tags para imagens a serem usadas nos anúncios. Aceita até 20 imagens múltiplas. O uso de tags é opcional. Se forem usadas, precisarão descrever o que há na imagem.
|
tipo: string | Obrigatório. Aeroporto de origem do voo. Deve ser escrito como um código IATA. Exemplo: |
tipo: string | Opcional. Nome da cidade de origem do voo. |
tipo: string | Opcional. O custo e a moeda do voo. O preço é um número seguido pelo código de moeda. Use os padrões ISO 4217. Use "." como o decimal para o preço. |
tipo: string | Opcional. Link para o site no qual é possível reservar o voo. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
FLIGHT
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "FLIGHT", "requests": [ { "method": "DELETE", "data": { "origin_airport": "BOS", "destination_airport": "JFK", } }, { "method": "CREATE", "data": { "origin_airport": "BOS", "destination_airport": "SFO", "description": "Best Flight to SFO", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['City'], }, { "url":"http://example.com/some.image_2.jpg", "tag": ['Food'], } ], "price":"100.00 USD", } }, { "method": "UPDATE", "data": {
FLIGHT
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Estes campos de produto são compatíveis com os métodos CREATE
e UPDATE
para o tipo DESTINATION
na versão 3.2.
Campo | Descrição |
---|---|
tipo: objeto<string> | Opcional. Links que direcionam a apps para celular. |
tipo: objeto<string> | Obrigatório. O endereço do hotel. |
tipo: string | Opcional. Máximo de caracteres: 5.000. Um parágrafo curto que descreve o destino. |
tipo: string | Obrigatório. Máximo de caracteres: 100. ID único do destino. |
tipo: matriz<object> | Obrigatório. As URLs e tags para imagens a serem usadas nos anúncios. Aceita até 20 imagens múltiplas. O uso de tags é opcional. Se forem usadas, elas precisarão descrever o que há na imagem. Exemplo: |
tipo: string | Obrigatório. Localização de latitude do destino. |
tipo: string | Obrigatório. Localização de longitude do destino. |
tipo: string | Obrigatório. Nome do destino. |
tipo: matriz<string> | Opcional. Número máximo de bairros permitidos: 20. Um ou mais bairros do destino. Exemplo: |
tipo: string | Opcional. Custo médio mais baixo e moeda do destino. Formate o preço como um número seguido pelo código de moeda. Use os padrões ISO 4217. Use "." como o decimal para o preço. |
tipo: string | Opcional. Alteração no preço. Pode ser usado para criar conjuntos de produtos e no criativo do anúncio.
Exemplo: "O preço médio em Nova York caiu X" ou "O preço médio em Nova York caiu". |
tipo: matriz<string> | Obrigatório. Número máximo de tipos de destino: 20. Tipos de destino. Um destino pode ter vários tipos. Exemplo: |
tipo: string | Obrigatório. Link para o site no qual é possível reservar o destino. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
DESTINATION
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "DESTINATION", "requests": [ { "method": "DELETE", "data": { "destination_id": "destination-1" } }, { "method": "CREATE", "data": { "destination_id": "123456789", "description": "My destination is the best.", "name": "The best destination", "price": "199.00 USD", "price_change": "-20", "longitude":"-122.4424", "latitude":"37.7712", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['City','Package'], }, { "url":"http://example.com/some.image_2.jpg", "tag": ['Tour','Landmark'], } ], "address": { "addr1":"1 Market Street", "city":"San Francisco", "region":"California", "country":"United States", "postal_code":"94117" }, "applink" : { "ios_url":"example-ios://travelapp", "ios_app_store_id":"42", "ios_app_name":"Travel App iOS", "iphone_url":"example-iphone://travelapp", "iphone_app_store_id":"43", "iphone_app_name":"Travel App iPhone", "ipad_url":"example-ipad://travelapp", "ipad_app_store_id":"44", "ipad_app_name":"Travel App iPad", "android_url":"example-android://travelapp", "android_package":"com.travelapp", "android_class":"com.travelapp.Example", "android_app_name":"Travel App Android", "windows_phone_url":"example-windows://travelapp", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Travel App Windows", }, "type":["city","culture"], "neighborhood":["Mission","SoMa"], "url":"http://www.thebestdestination.com" } }, { "method": "UPDATE", "data": { "price": "159.99", "destination_id": "destination-3", } } ] }
DESTINATION
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Estes campos de produto são compatíveis com os métodos CREATE
e UPDATE
para o tipo HOME_LISTING
nas versões 3.3 e 3.2.
Campo | Descrição |
---|---|
tipo: objeto<string> | Opcional. Links que direcionam a apps para celular. |
tipo: objeto<string> | Obrigatório. Endereço do classificado de imóvel. |
tipo: string | Obrigatório. Disponibilidade atual do classificado de imóvel. Valores aceitos: |
tipo: matriz<object> | Opcional. Configurações de preço. |
tipo: string | Opcional. Máximo de caracteres: 5.000. Um parágrafo curto que descreve o classificado de imóvel. |
tipo: matriz<object> | Obrigatório. As URLs e tags para imagens a serem usadas nos anúncios. Aceita até 20 imagens múltiplas. O uso de tags é opcional. Se forem usadas, elas precisarão descrever o que há na imagem. Exemplo: |
tipo: string | Opcional. Localização de latitude do classificado de imóvel. |
tipo: string | Opcional. Localização de longitude do classificado de imóvel. |
tipo: string | Opcional. Tipo de classificado de imóvel. Valores aceitos: |
tipo: string | Obrigatório. Nome do classificado de imóvel. |
tipo: matriz<object> | Opcional. Bairro do classificado de imóvel. Número máximo de bairros permitidos: 20. |
tipo: string | Opcional. Número de banheiros. |
tipo: string | Opcional. Número de dormitórios. |
tipo: string | Opcional. Número de unidades disponíveis. Use apenas para apartamentos ou condomínios disponíveis para aluguel/locação. |
tipo: string | Obrigatório. Preço e moeda do classificado de imóvel. O preço é um número seguido pelo código de moeda. Use os padrões ISO 4217. Use "." como o decimal para o preço. |
tipo: string | Opcional. Alteração no preço. Pode ser usado para criar conjuntos de produtos e no criativo do anúncio.
Exemplo: "O preço médio em Nova York caiu X" ou "O preço médio em Nova York caiu". |
tipo: string | Opcional. Tipo de propriedade. Valores aceitos: |
tipo: string | Obrigatório. Link para o site no qual é possível visualizar o classificado de imóvel. |
tipo: string | Opcional. Ano de construção do imóvel. |
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
HOME_LISTING
{ "access_token": "<ACCESS_TOKEN>", "item_type": "HOME_LISTING", "requests": [ { "method": "DELETE", "data": { "home_listing_id": "home-listing-1" } }, { "method": "CREATE", "data": { "home_listing_id": "12345678", "availability": "for_sale", "description": "An amazing listing", "name": "1 Hacker Way, Menlo Park, CA 94025", "price": "110000 USD", "longitude":"1.11414", "latitude":"-1.835003", "address": { "addr1":"1 Hacker Way", "city":"Menlo Park", "region":"California", "country":"United States", "postal_code":"94025" }, "neighborhood":["Menlo Oaks"], "image": [ { "url":"http://img10.naventcdn.com/avisos/18/00/52/30/31/52/1200x1200/63590918.jpg", }, ], "listing_type": "for_sale_by_agent", "num_baths":"6", "num_beds":"5", "num_units":"1", "property_type":"house", "year_built":"2007", "available_dates_price_config" : [ { "start_date":"2020-11-15", "end_date":"2020-12-15", "rate":"10000", "currency":"USD", "interval":"nightly", }, { "start_date":"2020-11-15", "end_date":"2020-12-15", "rate":"50000", "currency":"USD", "interval":"weekly", }, ], "applink" : { "ios_url":"example-ios://travelapp", "ios_app_store_id":"42", "ios_app_name":"Travel App iOS", "android_url":"example-android://travelapp", "android_package":"com.travelapp", "android_class":"com.travelapp.Example", "android_app_name":"Travel App Android", }, "url":"http://www.example.com/link_to_listing" } }, { "method": "UPDATE", "data": { "price": "100000 USD", "home_listing_id": "home-listing-3", } } ] }
HOME_LISTING
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Para campos compatíveis com os métodos CREATE
e UPDATE
para o tipo VEHICLE
, consulte Anúncios de automóveis – Criar um catálogo.
Os campos aceitos estão disponíveis para veículo e concessionária.
O método UPDATE
também pode ser usado para criar itens que ainda não existem.
VEHICLE
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "VEHICLE", "requests": [ { "method": "DELETE", "data": { "vehicle_id": "vehicle-1" } }, { "method": "CREATE", "data": { "vehicle_id": "i2 2017 Ford Fusion", "availability": "AVAILABLE", "make": "Ford", "model": "Fusion", "year": "2017", "mileage": { "value": "1500", "unit": "KM", }, "image": [ { "url":"http://www.facebook.com/teapic.jpg", "tag":["Car"], }, ], "fuel_type":"gasoline", "body_style":"sedan", "drivetrain":"FWD", "vin":"1FADP5AU6DL536022", "condition":"EXCELLENT", "description": "Turbocharged! Gasoline!", "title": "SE Ford Certified and 6-Speed Automatic.", "price": "18000 USD", "exterior_color":"white", "sale_price":"16000 USD", "state_of_vehicle":"new", "longitude":"52.35", "latitude":"42.1", "address": { "addr1":"550 Auto Center Dr", "city":"Watsonville", "region":"CA", "country":"US", "postal_code":"96075" }, "url":"http://www.example.com/test" } }, { "method": "UPDATE", "data": { "price": "16000 USD", "vehicle_id": "vehicle-3", } } ] }
VEHICLE
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
/{catalog_id}/localized_items_batch
Veja a lista de campos compatíveis e as respectivas descrições para o ponto de extremidade /{catalog_id}/localized_items_batch
:
Confira a lista completa de campos aceitos em catálogos.
/{catalog_id}/batch
/{catalog_id}/items_batch
/{catalog_id}/check_batch_request_status
/{catalog_id}/localized_items_batch