Ordering Redirect Action Links - Delivery and Takeout

  • This guide is for Actions Center Ordering Redirect integration partners who use action_links for Food Ordering actions.

  • You can associate only one action_link_type with each action_link.

  • The two food ordering actions a user can perform are food pickup (Order Food Takeout) and food delivery (Order Food Delivery).

  • To specify food takeout only, use action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT.

  • To specify food delivery only, use action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.

Ordering Redirect Integration partners have the ability to associate different action_link_type with their action_link(s). action_link_type helps identify what kind of action a user can perform when they are redirected to the partners’ website using that link.

  • You can only associate a single action_link_type with each action_link.

When ordering food, a user can request one of the following two actions to be performed:

  • Request food pickup from the restaurant (Order Food Takeout)
  • Request food delivery to a specific location (Order Food Delivery)

This is recommended for all partners participating in Food Actions, if you are currently sending us action_link(s) with action_link_type = ACTION_LINK_TYPE_ORDER_FOOD or service_type = SERVICE_TYPE_FOOD_ORDERING we recommend that you update your feeds to be inline with the current approach.

Merchants supporting ordering food takeout pickup

Merchants

{
  "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"
        }
      ]
    }
  ]
}

Merchants supporting ordering food delivery

Merchants

{
 "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"
        }
      ]
    }
  ]
}

Merchants supporting food takeout pickup and delivery

If a merchant supports both actions i.e. Food order delivery and Food order pickup, it is recommended that you provide two separate action_link(s) and associate them with the appropriate actions.

Merchants

{
  "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"
        }
      ]
    }
  ]
}

Merchants supporting both actions via a single URL

For instance where an action_link which deeplinks to generic ordering page for the restaurant where the user would be required to choose between Food delivery and Food pickup, we recommend the following

Submit the action_link URL twice, associating each instance with the appropriate action_link_type as mentioned below:

  • For the first instance, tag the action_link using action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
  • For the second instance, tag the action_link using action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Merchants

{
  "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"
        }

      ]
    }
  ]
}