Especificar links de ação (legado)

Com um link de ação, os usuários podem interagir 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 do comerciante: implemente links de ação por meio dos feeds do comerciante quando um único comerciante tiver vários serviços realizando uma ação semelhante.
  • Feed de serviços: implemente links de ação por meio dos feeds de serviços quando um único comerciante tiver vários serviços executando ações diferentes.

É necessário fornecer um link de ação nos 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, porque há apenas um serviço por comerciante.

Veja o exemplo a seguir:

  • Um comerciante oferece vários serviços, como aulas de ioga, boxe, ciclismo, corte de cabelo, coloração de cabelo e xampu. O link de ação redireciona para uma página de destino que exibe 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 de comerciantes.

  // 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;
  }

É necessário fornecer um link de ação pelo feed de serviços quando o comerciante tiver links diretos diferentes por serviço ou tiver vários serviços executando ações diferentes, como pedidos de comida e reserva de restaurantes.

Veja o exemplo a seguir:

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

O tipo de ação pode ser especificado usando ServiceType nos serviços e ActionLinkType, que faz parte de ActionLink no feed de 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 OrderOnlineMetadata

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

Para mais informações sobre como incluir corretamente essas informações nos seus feeds, caso sua integração exija que elas sejam exigidas, consulte a seguinte documentação: