Nguồn cấp dữ liệu lịch hẹn còn trống

Tạo và tải nguồn cấp dữ liệu về tình trạng rảnh/bận của cuộc hẹn lên

Khi tạo và tải nguồn cấp dữ liệu lịch hẹn lên, hãy làm theo các hướng dẫn sau:

  • Tuân thủ quy cách được mô tả trong nguồn cấp dữ liệu về tình trạng còn lịch hẹn cho tệp dữ liệu về tình trạng còn lịch hẹn. Bạn nên sử dụng tên tệp dữ liệu riêng biệt về lịch hẹn trống cho mỗi lần tải lên. Thêm dấu thời gian vào tên tệp, ví dụ: appointment availability_1633621547.json.
  • Trong bộ mô tả nhóm tệp, hãy đặt trường name thành appointment.availability. Để xem ví dụ về tệp mô tả, hãy tham khảo mẫu JSON. Bạn nên sử dụng tên tệp mô tả riêng biệt cho mỗi lần tải lên. Thêm dấu thời gian vào tên tệp, ví dụ: appointment availability_1633621547.filesetdesc.json. Bạn phải tải tệp mô tả lên máy chủ SFTP chung.
  • Tải nguồn cấp dữ liệu lên máy chủ SFTP chung sau mỗi 30 phút dưới dạng bản làm mới đầy đủ.
  • Bạn có thể xem thông tin chi tiết về máy chủ SFTP trong phần Cấu hình > Nguồn cấp dữ liệu của Cổng đối tác.

    • Chọn máy chủ nguồn cấp dữ liệu

    Chọn máy chủ nguồn cấp dữ liệu trong Partner Portal
  • Xem trạng thái nhập nguồn cấp dữ liệu trong phần Nguồn cấp dữ liệu > Nhật ký của Cổng đối tác.

Tải nguồn cấp dữ liệu gia tăng lên

Tính năng lịch hẹn cũng hỗ trợ nguồn cấp dữ liệu gia tăng, cho phép đối tác chỉ tải những thay đổi về lịch hẹn lên bằng cách sử dụng tính năng tải nguồn cấp dữ liệu lên.

Để tải một nguồn cấp dữ liệu gia tăng lên, hãy đặt is_incremental: true trong ít nhất một trong các khoảng trống về tình trạng còn hàng trong nguồn cấp dữ liệu của bạn. Nếu một số nguồn cấp dữ liệu có is_incremental được đặt thành true và một số nguồn cấp dữ liệu có is_incremental được đặt thành false, thì hệ thống sẽ coi tất cả các nguồn cấp dữ liệu đó là gia tăng.

Bản cập nhật gia tăng cung cấp các thao tác sau:

Không có thay đổi
Không thêm mã nhận dạng tình trạng còn hàng cho những thực thể không có thay đổi.
Cập nhật tình trạng còn hàng
Để cập nhật một tình trạng còn phòng, hãy tải mục tình trạng còn phòng cụ thể (cùng một availability_id) cần sửa đổi lên, thay đổi bất kỳ trường nào bạn chọn.
Xoá tình trạng rảnh/bận
Nếu một mục tình trạng còn hàng không còn hoặc cần bị xoá, hãy tải mục tình trạng còn hàng đó lên (cùng availability_id) với spots_available được đặt thành 0 và hệ thống sẽ tự động xoá mục đó. Ngoài ra, để xoá tất cả dữ liệu cho một người bán / thực thể, hãy đặt tất cả các khung giờ có thể đặt lịch hẹn của họ spots_available thành 0. Thao tác này sẽ xoá chính người bán / thực thể đó khỏi Lịch hẹn.
Thêm phạm vi cung cấp
Đối với các khung giờ trống mới, hãy thêm mục khung giờ trống mới có availability_id mới duy nhất vào nội dung tải lên nguồn cấp dữ liệu. Hệ thống sẽ xử lý thông tin này giống như khi thông tin đó được đưa vào một nguồn cấp dữ liệu thông thường.

Định nghĩa

Định nghĩa AppointmentAvailabilityFeed

message AppointmentAvailabilityFeed {
  repeated AppointmentAvailability data = 1;
}

Định nghĩa AppointmentAvailability

// This represents the availability data for a bookable service provided by a
// merchant.
// For example, it can be a haircut/nail manicure service for a beauty salon or
// a massage service for a spa.
// The availability feed should be a list of this message.
message AppointmentAvailability {
  // An opaque string generated by the partner that identifies a service time
  // slot. Must be unique across all entities and service time slots.
  // Strongly recommended to only include URL-safe characters.
  // Required.
  string availability_id = 1;

  // An opaque string generated by the partner that identifies an Entity.
  // Must be unique across all entities.
  // Strongly recommended to only include URL-safe characters.
  // Required.
  string entity_id = 2;

  // An opaque string of ASCII characters from an aggregator partner which
  // uniquely identifies the Service (haircut, nail manicure, massage).
  // Strongly recommended to only include URL-safe characters.
  // Required.
  string service_id = 3;

  // The name of the service provider. For example, the name of the
  // hairdresser or the spa staff member.
  // Optional.
  string provider = 12;

  // Timestamp of when this availability slot starts in UTC.
  // Given in seconds since the unix epoch.
  // For example, 1735714800 seconds for 1 Jan 2025, 07:00:00 (UTC).
  // Required.
  int64 start_time_sec = 4;

  // The minimum number of minutes in advance before the start time that this
  // availability slot can be booked.
  // For example, if the start time is 10:00 AM and the min_advance_minutes is
  // 60, then the latest time this slot can be booked is 9:00 AM on the day of
  // the appointment.
  // If not set, it is assumed to be 0, meaning the slot can be booked at any
  // time before the start time.
  // Optional.
  int32 min_advance_minutes = 13;

  // Number of total spots and available spots of this booking availability.
  // Required.
  int32 spots_total = 5;
  // Required.
  int32 spots_available = 6;

  // The minimum number of spots that should be booked for this availability.
  // For example, a user has to book at least 2 spots for a time slot sometimes.
  // If set, spots_minimum_book should be less or equal to spots_available.
  // Optional.
  int32 spots_minimum_book = 7;

  // Link of this booking availability. Users will be redirected to partner
  // website to continue booking after clicking this link.
  // Required.
  string booking_link = 8;

  // Base price per person.
  // Required.
  google.type.Money base_price = 9;
  // Fee per person.
  // Required.
  google.type.Money fee_price = 10;

  // Whether the feed is incremental or not.
  // By default it is false, meaning the Availability feed will override the
  // previous data for the same entity_id.
  // If this is set to be true, the Availability feed will be proceeded as
  // incremental updates for the same entity_id.
  //    1) If it is a new availability_id, the entry is added.
  //    2) If it is an existing availability_id and the spots_available is 0,
  //       the entry is removed.
  //    3) If it is an existing availability_id and the spots_available is not
  //    0, the entry is updated.
  bool is_incremental = 11;
}

Tham chiếu proto bên ngoài:

Mẫu nguồn cấp dữ liệu về tình trạng còn chỗ chơi gôn

Nguồn cấp dữ liệu về lịch hẹn còn trống

{
  "data": [
    {
      "availability_id": "availability_id_1",
      "entity_id": "entity_id_1",
      "service_id": "service_id_1",
      "start_time_sec": 1728257400,
      "spots_total": 4,
      "spots_available": 4,
      "spots_minimum_book": 2,
      "booking_link": "https://www.googleappointments.com/a_link_direct_to_booking_page",
      "base_price": {
        "currency_code": "USD",
        "units": 80,
        "nanos": 0
      },
      "fee_price": {
        "currency_code": "USD",
        "units": 1,
        "nanos": 750000000
      }
    },
    {
      "availability_id": "availability_id_2",
      "entity_id": "entity_id_2",
      "service_id": "service_id_2",
      "start_time_sec": 1728259200,
      "spots_total": 4,
      "spots_available": 4,
      "spots_minimum_book": 2,
      "booking_link": "https://googlegolfappointments.com/a_link_direct_to_booking_page",
      "base_price": {
        "currency_code": "USD",
        "units": 80,
        "nanos": 0
      },
      "fee_price" : {
        "currency_code": "USD",
        "units": 2,
        "nanos": 850000000
      }
    }
  ]
}

Tệp mô tả

{
  "generation_timestamp": 1663347730,
  "name": "appointment.availability",
  "data_file": [
    "appointment_availability_1663347730.json"
  ]
}