Especificar links de ação (legado)

Um link de ação permite que os usuários interajam com um link direto que leva ao site do parceiro para realizar uma ação. Os links diretos são exibidos no painel de informações do comerciante. Este guia descreve como adicionar links de ação aos feeds.

Os links de ação podem ser fornecidos em dois lugares:

  • Feed de comerciantes: implemente links de ação nos feeds de comerciantes quando um único comerciante tiver vários serviços realizando uma ação semelhante.
  • Feed de serviços: implemente links de ação nos feeds de serviços quando um único comerciante tiver vários serviços realizando ações diferentes.

Forneça um link de ação pelos feeds do comerciante quando todos os serviços de um determinado comerciante redirecionarem o usuário para a mesma página de destino no site do parceiro.

Essa é geralmente a única implementação significativa para restaurantes, já que há apenas um serviço por comerciante.

Veja o exemplo a seguir:

  • Um comerciante oferece vários serviços, como aulas de ioga, aulas de boxe, aulas de ciclismo, corte de cabelo, tingimento de cabelo e lavagem. O link de ação redireciona para uma página de destino que mostra todo o catálogo de serviços do comerciante.

O tipo de ação precisa ser especificado usando o ActionLinkType, que faz parte de ActionLink no feed do comerciante.

  // Predetermined type of action associated with an action link.
  enum ActionLinkType {
    // The action link type is unspecified.
    ACTION_LINK_TYPE_UNSPECIFIED = 0;

    // The action link type is booking an appointment.
    ACTION_LINK_TYPE_BOOK_APPOINTMENT = 1;

    // The action link type is booking an online appointment.
    ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT = 2;

    // The action link type is ordering food for delivery or takeout or both.
    ACTION_LINK_TYPE_ORDER_FOOD = 3;

    // The action link type is ordering food for delivery.
    ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY = 4;

    // The action link type is ordering food for takeout.
    ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT = 5;

    // The action link type is making a dining reservation.
    ACTION_LINK_TYPE_MAKE_DINING_RESERVATION = 6;

    // The action link type allows users to shop from the given merchant. It
    // could either be delivery or pickup.
    ACTION_LINK_TYPE_SHOP_ONLINE = 7;
  }

Forneça um link de ação pelo feed de serviços quando o comerciante tiver links diretos diferentes por serviço ou vários serviços realizando ações diferentes, como pedir comida e reservar mesas.

Veja o exemplo a seguir:

  • Um restaurante oferece reserva de mesas e pedidos de comida. Um link de ação redireciona o usuário para a página de reserva de restaurantes, e outro redireciona o usuário para a página de pedidos de comida.

O tipo de ação pode ser especificado usando o ServiceType nos serviços e ActionLinkType, que faz parte de ActionLink no feed dos comerciantes.

  enum ServiceType {
    SERVICE_TYPE_UNSPECIFIED = 0;

    // Service that provides dining reservation.
    SERVICE_TYPE_DINING_RESERVATION = 1;

    // Service that provides food ordering in general, could be either takeout
    // or delivery or both.
    SERVICE_TYPE_FOOD_ORDERING = 2;

    // Service that only provides food delivery.
    SERVICE_TYPE_FOOD_DELIVERY = 6;

    // Service that only provides food takeout.
    SERVICE_TYPE_FOOD_TAKEOUT = 7;

    // Services that provide event based ticketing (e.g. concerts, sporting
    // events, shows). Do not use for Reserve with Google integrations.
    SERVICE_TYPE_EVENT_TICKET = 3;
    SERVICE_TYPE_TRIP_TOUR = 4;

    // Service that provides appointments or classes. Recommended for (1) health
    // and fitness, (2) spa and beauty, and (3) financial consults and
    // evaluations services. Please see the supported service types:
    // https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
    SERVICE_TYPE_APPOINTMENT = 5;

    // Service that provides appointment for an online class or session which
    // will be fully virtual. Must be set if enabling virtual service bookings.
    SERVICE_TYPE_ONLINE_APPOINTMENT = 8;

    // Service that allows users to shop from the given merchant. It could
    // either be delivery or pickup.
    SERVICE_TYPE_SHOPPING = 9;
  }

Como usar o OrderOnlineMetadata

O OrderOnlineMetadata é usado para especificar informações que serão exibidas para o usuário sobre taxas, valores mínimos de pedidos e disponibilidade de diferentes métodos de cumprimento de compras on-line. Quando incluídos, esses metadados são adicionados ao link de ação no feed do comerciante.

Para mais informações sobre como incluir essas informações corretamente nos seus feeds, caso sua integração exija isso, consulte a documentação a seguir: