Добавить онлайн-сервисы (устарело)

Онлайн-услуги определяются как услуги, которые предоставляются полностью онлайн через размещенную платформу и не требуют от клиента личного присутствия на службе. Некоторые примеры онлайн-сервисов могут включать в себя:

  • Онлайн-занятия йогой через Zoom
  • Онлайн мастер-класс по макияжу через Google Meet
  • Онлайн видеооценка сантехники по Skype

Требования к онлайн-сервисам

Прежде чем приступить к внедрению, ознакомьтесь с политиками и лучшими практиками онлайн-сервисов .

Реализация онлайн-сервисов

Интеграция онлайн-сервисов является дополнением к существующей сквозной интеграции Appointments и требует некоторых изменений в существующей реализации. На высоком уровне следующие изменения включают в себя:

  • Каналы : добавьте type , VirtualSession , DirectMerchantPayment и CancellationPolicy (если они еще не добавлены) в фиды услуг.
  • Сервер бронирования : добавьте VirtualSessionInfo в метод CreateBooking, отправьте пользователю электронные письма с информацией о виртуальной настройке.
  • Обновления в реальном времени (существующее поведение) : обработка изменений виртуального инвентаря через InventoryUpdate RTU, изменений бронирования через BookingNotification RTU и изменений в услуге через Service RTU.

Ленты

Лента услуг

Следующие поля добавляются в фид «Услуги» для поддержки онлайн-сервисов.

Характеристики фида услуг 

 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;

    // 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/actions-center/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;
  }
// Information about virtual/online session. E.g. Online yoga class, virtual
// cooking class etc.
message VirtualSession {
  // Instructions on how this virtual class is set up. If the partner does not
  // include the video URL with the booking, then this text must include when
  // the video URL will be shared with the user. Eg. “Zoom url will be mailed
  // 30 minutes prior to the class”. (Recommended)
  // Only the folloiwng four tags are supported: <br>, <strong>, <em>, <i>.
  Text session_instructions = 1;

  // Requirements for the given virtual session. Eg. yoga mat,
  // cooking utensils etc. (Recommended)
  // Only the folloiwng four tags are supported: <br>, <strong>, <em>, <i>.
  Text session_requirements = 2;

  // Information about the virtual platform used in this session. (Required to
  // enable virtual services)
  message VirtualPlatformInfo {
    // Enum to indicate which virtual platform would be used by the merchant.
    enum Platform {
      PLATFORM_UNSPECIFIED = 0;

      // The merchant is flexible in which video platform they use.
      FLEXIBLE = 1;
      GOOGLE_HANGOUTS = 2;
      GOOGLE_MEET = 3;
      ZOOM = 4;
      SKYPE = 5;
      YOUTUBE = 6;

      // Should be set if the video platform used is different from the ones
      // mentioned here.
      OTHER = 7;
    }

    Platform platform = 1;

    // The name of the platform if the platform is set to OTHER. (Required if
    // platform is set to OTHER)
    Text other_platform_name = 2;
  }

  VirtualPlatformInfo virtual_platform_info = 3;

  // Set this as true if the virtual session is not live and is pre-recorded.
  // (Optional)
  bool is_session_prerecorded = 4;
}

// Information about how the user can pay directly to the merchant instead of
// pre-paying for the service via RwG.
message DirectMerchantPayment {
  // Users would be advised to pay only via the payment methods mentioned below.
  repeated Text payment_methods = 1;
}

// Cancellation policy for a service.
message CancellationPolicy {
  // Defines a single refund condition. Multiple refund conditions could be
  // used together to describe "refund steps" as various durations before the
  // service start time.
  message RefundCondition {
    // Duration in seconds before the start time, until when the customer can
    // receive a refund for part of the service's cost specified in
    // `refund_percent`.
    // When set to 0 (default), the service can be cancelled at any time.
    int64 min_duration_before_start_time_sec = 1;

    // The percent that can be refunded, as long as the service booking is
    // cancelled at least `min_duration_before_start_time` before the service
    // start time, in the range of [0, 100]. When set to 0 (default), the
    // service is not refundable. When set to 100 this service is fully
    // refundable.
    uint32 refund_percent = 2;
  }

  // Zero or more refund conditions applicable to the policy.
  repeated RefundCondition refund_condition = 1;
}

Пример фида услуг

{
  "service": [
    {
      "merchant_id": "100",
      "service_id": "100-1",
      "type" : "SERVICE_TYPE_ONLINE_APPOINTMENT",
      "localized_service_name": {
        "value": "Makeup masterclass",
        "localized_value": [
          {
            "locale": "en",
            "value": "Makeup masterclass"
          }
        ]
      },
      "localized_description": {
        "value": "Learn how to do runway makeup from an award winning makeup artist.",
        "localized_value": [
          {
            "locale": "en",
            "value": "Learn how to do runway makeup from an award winning makeup artist."
          }
        ]
      },
      "virtual_session": {
        "session_instructions": {
          "value": "You must have access to a computer, and a solid internet connection. Class registration link will be sent to you 15 mins before the start of the class. The class link will be accessible 1 day after the class.  ",
          "localized_value": [
            {
              "locale": "en",
              "value": "You must have access to a computer, and a solid internet connection. Class registration link will be sent to you 15 mins before the start of the class. The class link will be accessible 1 day after the class.  "
            }
          ]
        },
        "session_requirements": {
          "value": "makeup brush, makeup palette, mirror",
          "localized_value": [
            {
              "locale": "en",
              "value": "makeup brush, makeup palette, mirror"
            }
          ]
        },
        "virtual_platform_info": {
          "platform": "OTHER",
          "other_platform_name": "Susan's hosted platform"
        }
      },
      "direct_merchant_payment": {
        "payment_methods": [
          {
            "value": "Venmo",
            "localized_value": [
              {
                "locale": "en",
                "value": "Venmo"
              }
            ]
          }
        ]
      },
      "price": {
        "price_micros": 75000000,
        "currency_code": "USD"
      },
      "rules": {
        "min_advance_booking": 0,
        "min_advance_online_canceling": 86400,
        "cancellation_policy": {
          "refund_condition": [
            {
              "min_duration_before_start_time_sec": 3600,
              "refund_percent": 100
            }
          ]
        }
      },
      "prepayment_type": "NOT_SUPPORTED",
      "tax_rate": {
        "micro_percent": 7750000
      }
    },
    {
      "merchant_id": "100",
      "service_id": "100-2",
      "type" : "SERVICE_TYPE_ONLINE_APPOINTMENT",
      "localized_service_name": {
        "value": "Advanced Vinyasa Yoga",
        "localized_value": [
          {
            "locale": "en",
            "value": "Advanced Vinyasa Yoga"
          }
        ]
      },
      "localized_description": {
        "value": "Learn the advanced techniques of vinyasa yoga taught by award winning yoga instructors.",
        "localized_value": [
          {
            "locale": "en",
            "value": "Learn the advanced techniques of vinyasa yoga taught by award winning yoga instructors."
          }
        ]
      },
      "virtual_session": {
        "session_instructions": {
          "value": "You must have access to a computer, and a solid internet connection. Class registration link will be included in an email from the merchant.",
          "localized_value": [
            {
              "locale": "en",
              "value": "You must have access to a computer, and a solid internet connection. Class registration link will be included in an email from the merchant."
            }
          ]
        },
        "session_requirements": {
          "value": "yoga mat, dumbbells",
          "localized_value": [
            {
              "locale": "en",
              "value": "yoga mat, dumbbells"
            }
          ]
        },
        "virtual_platform_info": {
          "platform": "ZOOM"
        }
      },
      "price": {
        "price_micros": 40000000,
        "currency_code": "USD"
      },
      "rules": {
        "min_advance_booking": 0,
        "min_advance_online_canceling": 86400,
        "cancellation_policy": {
          "refund_condition": [
            {
              "min_duration_before_start_time_sec": 86400,
              "refund_percent": 100
            },
            {
              "min_duration_before_start_time_sec": 3600,
              "refund_percent": 50
            }
          ]
        }
      },
      "prepayment_type": "REQUIRED",
      "tax_rate": {
        "micro_percent": 7750000
      },
      "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
    }
  ]
}
  • Локализованное описание . В описании должно быть четко указано, о чем идет речь. Пожалуйста, обратитесь к руководству по передовому опыту , чтобы узнать, как лучше всего структурировать контент ваших услуг.
  • Инструкции по сеансу . Инструкции по сеансу должны описывать все необходимые настройки и соответствовать рекомендациям, изложенным в политике .
    • Если URL-адрес видео платформы и идентификатор встречи не создаются автоматически как часть CreateBooking (например, сведения не отправляются через CreateBookingResponse ), вам следует четко указать в session_instructions , когда и от кого пользователь должен ожидать отправки сведений о платформе. им.
  • Требования к сеансу : Требования к сеансу должны описывать все необходимое оборудование или материалы, необходимые пользователю для эффективного участия в занятии. Вы также можете включить дополнительные материалы, которые могут понадобиться пользователю, но отметьте их как необязательные.
  • Платформа : Платформа должна указывать платформу, которую пользователь будет использовать для доступа к онлайн-сервису.
    • Если платформа будет определена продавцом позже, установите для platform значение FLEXIBLE .
    • Если платформа, которую использует продавец, отсутствует в списке, установите для platform значение OTHER и other_platform_name .
  • Политика отмены : важно иметь четкую политику отмены. Установите CancellationPolicy , если разрешены возвраты и отмены. По умолчанию, если оно не установлено, возврат средств не допускается.

Фид доступности

  • Spots Total : установите общее количество участников, разрешенное для платформы (не забудьте вычесть персонал).

Сервер бронирования

Необязательно: если ваша система создает идентификатор и URL-адрес встречи от имени вашего продавца, включите VirtualSessionInfo в свой CreateBookingResponse .

Спецификация CreateBooking 

message Booking {
// Information related to the virtual session which was booked.
message VirtualSessionInfo {
  // URL which was created for the virtual session. (optional)
  string session_url = 1;

  // The meeting id which was created for the virtual session. (optional)
  string meeting_id = 2;

  // Password required to access the session. (optional)
  string password = 3 [(datapol.semantic_type) = ST_ACCOUNT_CREDENTIAL];
}


 VirtualSessionInfo virtual_session_info = X;
}

Создать запрос на бронирование 

{
  "idempotency_token": "10000000000",
  "payment_information": {
    "prepayment_status": "PREPAYMENT_NOT_PROVIDED"
  },
  "slot": {
    "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS",
    "duration_sec": "3600",
    "merchant_id": "10001",
    "service_id": "10001-1",
    "start_sec": "1586829600"
  },
  "user_information": {
    "email": "john.doe@gmail.com",
    "family_name": "John",
    "given_name": "Doe",
    "telephone": "+123 456 7890",
    "user_id": "110291237"
  }
}

CreateBookingResponse 

{
  "booking": {
    "bookingId": "abcdefg-12345",
    "slot": {
      "merchantId": "10001",
      "serviceId": "10001-1",
      "startSec": "1586804400",
      "durationSec": "3600"
    },
    "userInformation": {
      "userId": "110291237",
      "givenName": "John",
      "familyName": "Doe",
      "telephone": "+123 456 7890",
      "email": "john.doe@gmail.com"
    },
    "status": "CONFIRMED",
    "virtual_session_info": {
      "video_url": "meet.google.com/abcd-efg",
      "meeting_id": "abcd-efg",
      "password" : "somepassword"
    }
  }
}

Обновления в реальном времени

Существующую логику обновления инвентаря или заказов следует сохранить для виртуальных заказов.

  • InventoryUpdate RTU : любые обновления изменений слотов в вашей системе или системе Центра действий должны запускать InventoryUpdate RTU, чтобы уведомить нас об изменениях в слотах.
  • BookingNotification RTU : любые обновления бронирований (например, изменение времени или отмены) в вашей системе или системе Центра действий должны запускать BookingNotification RTU, чтобы уведомить нас об изменениях в бронировании.
    • Если пользователь не отправляет платеж продавцу/партнеру, отправьте нам RTU об отмене. Центр действий отправит электронное письмо об отмене.
  • Сервисный RTU : если вы в настоящее время обновляете службы через Сервисный RTU, обязательно включите соответствующие поля онлайн-сервиса при обновлении для онлайн-сервиса.

Электронная почта

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

Партнеры должны дополнительно отправить пользователю информацию о конференции, платежные реквизиты и информацию о политике отмены в отдельных электронных письмах. При желании вы можете отправить электронное письмо с напоминанием перед встречей или занятием. Ознакомьтесь с документом о политике , чтобы убедиться, что вы соблюдаете политику электронной почты для виртуальных классов.