Especificar links de ação (legado)

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

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

  • Feed de comerciantes - Implemente links de ação usando os 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 usando os feeds de serviços quando um único comerciante tiver vários serviços realizando ações diferentes.

Você precisa fornecer um link de ação pelos feeds do comerciante quando todos os serviços de um determinado comerciante redirecionam 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, boxe e ciclismo, corte de cabelo, tintura e xampu. 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 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;
  }

Você precisa fornecer um link de ação pelo feed de serviços quando o comerciante tem vários links diretos por serviço ou quando ele tem vários serviços que realizam ações diferentes, como pedido de comida e reserva de restaurante.

Veja o exemplo a seguir:

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

O tipo de ação pode ser especificado usando o ServiceType nos serviços e o ActionLinkType, que faz parte do 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 taxas, valores mínimos de pedidos e disponibilidade para diferentes métodos de atendimento 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 corretamente essas informações nos seus feeds, caso sua integração exija isso, consulte a seguinte documentação: