Esta página foi traduzida pela API Cloud Translation.

Como diferenciar links de ação de pedir para entrega e para retirada (legado)

Objetivo:este guia explica como os parceiros podem fornecer ao Centro de ações informações sobre quais ações de alimentos um usuário pode concluir usando um action_link específico.

Os parceiros de integração inicial legadas podem associar diferentes action_link_type aos action_link. O action_link_type ajuda a identificar que tipo de ação um usuário pode realizar quando é redirecionado para o site do parceiro usando esse link.

Só é possível associar um único action_link_type a cada action_link.

Ao pedir comida, um usuário pode solicitar que as duas ações a seguir sejam realizadas:

Solicitar a retirada de alimentos do restaurante (pedido de comida para viagem)
Solicitar entrega de alimentos para um local específico (pedido de entrega de alimentos)

Isso é recomendado para todos os parceiros que participam das Ações de alimentos. Se você estiver enviando action_link(s) com action_link_type = ACTION_LINK_TYPE_ORDER_FOOD ou service_type = SERVICE_TYPE_FOOD_ORDERING, recomendamos que atualize seus feeds para que estejam alinhados à abordagem atual.

Comerciantes que aceitam pedidos de comida para viagem

Importante:para marcar action_links como apenas "Comida para viagem", é necessário usar action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Comerciantes

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "+1-650-123-4567",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Serviços

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comerciantes que aceitam pedidos de entrega de comida

Importante:para marcar action_links como apenas entrega de alimentos, é necessário usar action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.

Comerciantes

{
 "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "+1-650-123-4567",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Serviços

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comerciantes que oferecem entrega e retirada de comida

Se um comerciante oferecer suporte a ambas as ações, ou seja, entrega de pedidos de comida e retirada de pedidos de comida, é recomendável fornecer duas action_link separadas e associá-las às ações apropriadas.

Comerciantes

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "+1-650-123-4567",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Serviços

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodpickup/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/fooddelivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Comerciantes que oferecem as duas ações em um único URL

Por exemplo, quando um action_link que faz um link direto para a página de pedidos genérica do restaurante em que o usuário precisa escolher entre Entrega de comida e Retirada de comida, recomendamos o seguinte:

Envie o URL action_link duas vezes, associando cada instância ao action_link_type apropriado, conforme mencionado abaixo:

Na primeira instância, marque o action_link usando action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
Na segunda instância, marque o action_link usando action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP

Comerciantes

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "+1-650-123-4567",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }

      ]
    }
  ]
}

Serviços

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}