Различие между ссылками на доставку заказа и ссылками на действия на вынос (устаревшая версия)

Предупреждение. Это устаревшее руководство, которое следует использовать только для поддержки существующих интеграций. Для новых интеграций необходимо использовать актуальное руководство .

Примечание. Данное руководство применимо только к партнерам по интеграции Actions Center Legacy Starter, которые предоставляют action_link , которые позволяют пользователям выполнять действия заказа.

Цель: в этом руководстве объясняется, как партнеры могут предоставлять Центру действий информацию о том, какие действия в отношении продуктов питания пользователь может выполнить с помощью определенной action_link .

Партнеры по интеграции Legacy Starter имеют возможность связывать различные action_link_type со своими action_link (s) . action_link_type помогает определить, какое действие может выполнить пользователь, когда он перенаправляется на веб-сайт партнера по этой ссылке.

• С каждой ссылкой action_link можно связать только один action_link_type .

При заказе еды пользователь может запросить выполнение следующих двух действий:

• Заказать еду на вынос из ресторана (Заказать еду на вынос)
• Запросить доставку еды в определенное место (Заказать доставку еды)

Это рекомендуется для всех партнеров, участвующих в Food Actions. Если вы в настоящее время отправляете нам action_link (s) с action_link_type = ACTION_LINK_TYPE_ORDER_FOOD или service_type = SERVICE_TYPE_FOOD_ORDERING мы рекомендуем вам обновить ваши каналы, чтобы они соответствовали текущему подходу.

Примечание. Мы по-прежнему продолжим поддерживать старую реализацию .

Продавцы, поддерживающие заказ еды на вынос

Ключевой момент: чтобы пометить action_link (s) только как Food Takeout, нам необходимо использовать action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Торговцы Услуги

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "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"
        }
      ]
    }
  ]
}

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

Торговцы, поддерживающие заказ доставки еды

Ключевой момент: чтобы пометить action_link (s) только как «Доставка еды», нам необходимо использовать action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY .

Торговцы Услуги

{
 "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "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"
        }
      ]
    }
  ]
}

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

Продавцы, поддерживающие самовывоз и доставку еды

Если продавец поддерживает оба действия, т. е. доставку заказа на еду и получение заказа на еду, рекомендуется предоставить две отдельные action_link (s) и связать их с соответствующими действиями.

Примечание. Убедитесь, что глубокая ссылка action_link (s) указывает на соответствующее действие, а не на общую целевую страницу.

Торговцы Услуги

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "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"
        }
      ]
    }
  ]
}

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

Продавцы, поддерживающие оба действия через один URL-адрес

Например, если action_link ведет на общую страницу заказа ресторана, где пользователю необходимо будет выбрать между доставкой еды и самовывозом , мы рекомендуем следующее:

Отправьте URL-адрес action_link дважды, связывая каждый экземпляр с соответствующим action_link_type , как указано ниже:

• Для начала пометьте action_link , используя action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
• Во втором случае пометьте action_link , используя action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP

Торговцы Услуги

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "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"
        }

      ]
    }
  ]
}

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