Stay organized with collections
Save and categorize content based on your preferences.
An action link provides the ability for users to interact with a deep link
which links out to the partner's website to perform an action. Deep links
are displayed on the merchant's knowledge panel. This guide will describe how
to add action links to the feeds.
Action links can be provided in two places:
Merchant feed
- Implement action links via the merchant feeds, when a single merchant has multiple services
performing a similar action.
Services feed
- Implement action links via the services feeds, when a single merchant has multiple services
performing different actions.
Merchant level action links
You should provide an action link via the Merchant feeds when all services
for a given merchant redirects the user to the same landing page on the
partner's website.
This is usually the only meaningful implementation for dining
as there is only one service per merchant.
An example is:
A merchant provides multiple services like
yoga classes, boxing classes, cycling classes, haircut, hair coloring, shampoo.
The action link redirects to a landing page
displaying the entire service catalog for the merchant.
The type of action must be specified using the ActionLinkType which is part of
ActionLink
in the merchants feed.
You should provide an action link via the Services feed when the merchant has
different deep links per service or the merchant has multiple services
performing different actions like food ordering and dining reservation.
An example is:
A restaurant provides dining reservation and food ordering. One action
link redirects the user to the dining reservation page and another redirects
the user to the food ordering page
The type of action can be specified using the ServiceType in
the services and ActionLinkType which is part of
ActionLink in the merchants feed.
The OrderOnlineMetadata is used to specify information to be displayed to
the user about any fees, minimum order amounts, and availability for different
online shopping fulfillment methods. When included, this metadata is included
with the action link in the Merchant feed.
For additional information on how to properly include this information in
your feeds if your integration requires it can be found in the following
documentation:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-20 UTC."],[[["\u003cp\u003eThis legacy tutorial explains how to add action links (deep links to partner websites) to Merchant and Services feeds for existing Actions Center integrations.\u003c/p\u003e\n"],["\u003cp\u003eAction links in Merchant feeds are suitable when all services for a merchant lead to the same landing page, while Services feeds are used for distinct service actions or multiple service types.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eActionLinkType\u003c/code\u003e and \u003ccode\u003eServiceType\u003c/code\u003e enums define the specific action associated with a link and are mandatory for starter integrations; using \u003ccode\u003eUNSPECIFIED\u003c/code\u003e types is discouraged.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOrderOnlineMetadata\u003c/code\u003e should only be included by partners participating in Retail Ordering actions, providing details on fees, minimum order amounts, and fulfillment availability.\u003c/p\u003e\n"],["\u003cp\u003eNew integrations should refer to the up-to-date tutorial linked at the beginning of the document.\u003c/p\u003e\n"]]],["Action links, directing users to partner websites, are added to merchant or services feeds. Merchant-level links suit when a merchant's services share a landing page; services-level links are for when services have distinct deep links or offer diverse actions. Action types are specified using `ActionLinkType` or `ServiceType`. `OrderOnlineMetadata`, used for retail ordering, details fees, minimums, and fulfillment options. It is noted that this is a legacy tutorial.\n"],null,["# Specify action links (Legacy)\n\n| **Warning:** This is a legacy tutorial and should only be used to maintain existing integrations. New integrations must used the [up-to-date tutorial](/actions-center/verticals?vertical_redirect_fragment=guides/tutorials/tutorial-specifying-action-links).\n\n\u003cbr /\u003e\n\n| **Note:** This guide only applies to partners who are integrating with the Actions Center Legacy Starter integration.\n\nAn action link provides the ability for users to interact with a deep link\nwhich links out to the partner's website to perform an action. Deep links\nare displayed on the merchant's knowledge panel. This guide will describe how\nto add action links to the feeds.\n\nAction links can be provided in two places:\n\n- [Merchant feed](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed) - Implement action links via the merchant feeds, when a single merchant has multiple services performing a similar action.\n- [Services feed](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/services-feed) - Implement action links via the services feeds, when a single merchant has multiple services performing different actions.\n\nMerchant level action links\n---------------------------\n\nYou should provide an action link via the Merchant feeds when all services\nfor a given merchant redirects the user to the same landing page on the\npartner's website.\n\nThis is usually the only meaningful implementation for dining\nas there is only one service per merchant.\n\nAn example is:\n\n- A merchant provides multiple services like yoga classes, boxing classes, cycling classes, haircut, hair coloring, shampoo. The action link redirects to a landing page displaying the entire service catalog for the merchant.\n\n| **Note:** Currently, only one action link is displayed for a single merchant on the merchant knowledge panel for a particular [`ActionLinkType`](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#ActionLink-definition) (e.g.: food ordering or making a dining reservation, making an appointment for in-person or online). Therefore, only deeplinks listing all services can be surfaced.\n\nThe type of action must be specified using the `ActionLinkType` which is part of\n[`ActionLink`](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#ActionLink-definition)\nin the merchants feed. \n\n```gdscript\n // Predetermined type of action associated with an action link.\n enum ActionLinkType {\n // The action link type is unspecified.\n ACTION_LINK_TYPE_UNSPECIFIED = 0;\n\n // The action link type is booking an appointment.\n ACTION_LINK_TYPE_BOOK_APPOINTMENT = 1;\n\n // The action link type is booking an online appointment.\n ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT = 2;\n\n // The action link type is ordering food for delivery or takeout or both.\n ACTION_LINK_TYPE_ORDER_FOOD = 3;\n\n // The action link type is ordering food for delivery.\n ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY = 4;\n\n // The action link type is ordering food for takeout.\n ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT = 5;\n\n // The action link type is making a dining reservation.\n ACTION_LINK_TYPE_MAKE_DINING_RESERVATION = 6;\n\n // The action link type allows users to shop from the given merchant. It\n // could either be delivery or pickup.\n ACTION_LINK_TYPE_SHOP_ONLINE = 7;\n }\n```\n\nServices level action links\n---------------------------\n\nYou should provide an action link via the Services feed when the merchant has\ndifferent deep links per service or the merchant has multiple services\nperforming different actions like food ordering and dining reservation.\n\nAn example is:\n\n- A restaurant provides dining reservation and food ordering. One action link redirects the user to the dining reservation page and another redirects the user to the food ordering page\n\nThe type of action can be specified using the `ServiceType` in\nthe services and `ActionLinkType` which is part of\n`ActionLink` in the merchants feed.\n**Note:** Specifying `ServiceType` or `ActionLinkType` is mandatory for starter integration. \n\n```gdscript\n enum ServiceType {\n SERVICE_TYPE_UNSPECIFIED = 0;\n\n // Service that provides dining reservation.\n SERVICE_TYPE_DINING_RESERVATION = 1;\n\n // Service that provides food ordering in general, could be either takeout\n // or delivery or both.\n SERVICE_TYPE_FOOD_ORDERING = 2;\n\n // Service that only provides food delivery.\n SERVICE_TYPE_FOOD_DELIVERY = 6;\n\n // Service that only provides food takeout.\n SERVICE_TYPE_FOOD_TAKEOUT = 7;\n\n // Services that provide event based ticketing (e.g. concerts, sporting\n // events, shows). Do not use for Reserve with Google integrations.\n SERVICE_TYPE_EVENT_TICKET = 3;\n SERVICE_TYPE_TRIP_TOUR = 4;\n\n // Service that provides appointments or classes. Recommended for (1) health\n // and fitness, (2) spa and beauty, and (3) financial consults and\n // evaluations services. Please see the supported service types:\n // https://developers.google.com/maps-booking/guides/end-to-end-integration/overview\n SERVICE_TYPE_APPOINTMENT = 5;\n\n // Service that provides appointment for an online class or session which\n // will be fully virtual. Must be set if enabling virtual service bookings.\n SERVICE_TYPE_ONLINE_APPOINTMENT = 8;\n\n // Service that allows users to shop from the given merchant. It could\n // either be delivery or pickup.\n SERVICE_TYPE_SHOPPING = 9;\n }\n```\n| **Note:** We do not recommend using `SERVICE_TYPE_UNSPECIFIED` or `ACTION_LINK_TYPE_UNSPECIFIED` for any of your actions links.\n\nUsing OrderOnlineMetadata\n-------------------------\n\n| **Note:** OrderOnlineMetadata should only be included by partners who participate in Retail Ordering actions. Please do not include this information in your feeds unless you have been instructed to do so by your Actions Center contact.\n\nThe OrderOnlineMetadata is used to specify information to be displayed to\nthe user about any fees, minimum order amounts, and availability for different\nonline shopping fulfillment methods. When included, this metadata is included\nwith the action link in the Merchant feed.\n\nFor additional information on how to properly include this information in\nyour feeds if your integration requires it can be found in the following\ndocumentation:\n\n- [Retail Ordering Feed samples](/actions-center/verticals/shopping/samples/starter-feed-samples/shopping-with-metadata) that include this metadata\n- A tutorial on [adding and updating availability metadata](/actions-center/verticals/shopping/guides/tutorials/tutorial-adding-shopping-availability)\n- [OrderOnlineMetadata](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#orderonlinemetadata_definition) Reference definition for"]]