หน้านี้ได้รับการแปลโดย Cloud Translation API

เทมเพลต URL สำหรับเปลี่ยนเส้นทางการชำระเงิน

เมื่อจองช่วงเวลาที่พร้อมให้บริการในราคาที่เจาะจงแล้ว ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าการจองโดยใช้ URL ที่คุณกำหนด ขั้นตอนที่ระบุไว้จะแสดงวิธีดำเนินการต่อไปนี้

กําหนดเทมเพลต URL
ตั้งค่าเทมเพลต URL ในฟีด
เปิดใช้การลิงก์ออกตามช่วงเวลาที่พร้อมให้บริการ
ยืนยันช่องในศูนย์การดำเนินการ

1. การกำหนดเทมเพลต URL

เทมเพลต URI เป็นไปตามคณะทำงานเฉพาะกิจด้านวิศวกรรมอินเทอร์เน็ต (IETF) RFC6570 ข้อกำหนดของเทมเพลต Uri ระดับ 2 ดูรายละเอียดเพิ่มเติมได้ที่ datatracker.ietf.org คุณตั้งค่า URL ด้วยพารามิเตอร์ที่สร้างขึ้นแบบไดนามิกโดยอิงตามข้อมูลเกี่ยวกับการจองนั้น ตารางต่อไปนี้มีพารามิเตอร์ที่จําเป็นและไม่บังคับสําหรับเทมเพลต URI

`https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}`

ค่าที่ใช้ได้สำหรับเทมเพลต URL

พารามิเตอร์ของเทมเพลต	ต้องระบุ/ไม่บังคับ	ฟีด	ฟิลด์	ค่าตัวอย่าง
availability_slot_start_seconds	ต้องระบุ	availability	start_sec	4152695841
resources_party_size	ต้องระบุ	availability.resources	party_size	2
availability_slot_availability_tag	ไม่บังคับ	availability	availability_tag	res-123
availability_slot_duration_seconds	ไม่บังคับ	availability	duration_sec	3600
resources_room_id	ไม่บังคับ	availability.resources	room_id	bar_123

2. ตั้งค่าเทมเพลต URI ในฟีด

ส่วนต่อไปนี้จะถือว่าคุณมีการผสานรวม E2E แบบเรียลไทม์กับ ฟีดบริการ URL ที่คุณกำหนดจะถูกตั้งค่าใน ฟีดบริการ ต่อไปนี้คือคำจำกัดความของช่องนั้น

message Service {
  // ..
  UriTemplate uri_template = 38;
}

หมายเหตุ: มีการกำหนดเทมเพลต URI สำหรับช่วงเวลาที่พร้อมให้บริการทั้งหมดที่เชื่อมโยงกับบริการ หากต้องตั้งค่าพารามิเตอร์ที่แตกต่างกันสําหรับร้านอาหาร คุณสามารถทำได้โดย การส่งบริการที่ต่างกันโดยมีเทมเพลต URI ที่ไม่ซ้ำกันสำหรับแต่ละรายการ ตัวอย่างเช่น บริการหนึ่งจะเชื่อมโยงกับการจองโต๊ะอาหารทั่วไป อีกลิงก์หนึ่งสามารถเชื่อมโยงกับการจองห้องพักด้วย วิธีนี้จะช่วยให้คุณ กำหนดเทมเพลตด้วย "room_id" สำหรับช่องโฆษณาที่มีห้อง

คําจํากัดความของเทมเพลต URI

// A template specifying how Google should generate URLs to external site.
message UriTemplate {
  // The uri template must follow the RFC6570, see
  // https://datatracker.ietf.org/doc/html/rfc6570.
  // Supports Level 2 templates.
  // These parameters will be resolved to their values specified in their
  // respective entities.
  //
  // 5 available parameters for Dining Reservation Linkout:
  // 1) (required) {availability_slot_start_seconds} :: populated from start_sec
  //   field in availability feed
  // 2) (required) {availability_slot_duration_seconds} :: populated from
  //   duration_sec field in availability feed
  // 3) (optional) {resources_party_size} :: populated from party_size field in
  //   availability feed
  // 4) (optional) {availability_availability_tag} :: populated from
  //   availability_tag field in availability feed
  // 5) (optional) {resources_room_id} :: populated from room_id field in
  //   availability feed
  //
  // Example usage:
  // http://example.com/book/restaurant?start={availability_slot_start_seconds}
  // &num_guests={resources_party_size}
  // * start_sec = 123456
  // * party_size = 2
  // https://example.com/book/restaurant?start=123456&num_guests=2
  string uri_template = 1;
}

คำจำกัดความตัวอย่างบริการ

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "12484913",
    "generation_timestamp": 1530432018
  },
  "service": [
    {
      "merchant_id": "dining-A",
      "service_id": "reservation",
      "uri_template": {
        "uri_template": "https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}"
      },
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Reservation"
          }
        ]
      }
    }
  ]
}

3. เปิดใช้ลิงก์ต่อช่วงเวลาที่พร้อมให้บริการ

ส่วนต่อไปนี้จะถือว่าคุณมีการผสานรวม E2E แบบเรียลไทม์กับ ฟีดความพร้อมจำหน่ายสินค้า เมื่อคุณตั้งค่าเทมเพลต URL ใน ฟีดบริการของคุณ คุณจะต้องระบุช่วงเวลาว่างที่จะ ที่จำเป็นต่อการลิงก์

โดยเพิ่มช่อง linkout_required_reason ที่มีค่าเป็น PAYMENT_REQUIRED

คำนิยามเหตุผลของการลิงก์

message Availability {
  // ..
  LinkoutRequiredReason linkout_required_reason = 19;
}

  // The reason why a slot requires a linkout. Currently only used for Dining
  // Reservations Payment Redirect Partners.
  enum LinkoutRequiredReason {
    // Default value: Do not use, equates to unknown.
    LINKOUT_REQUIRED_REASON_UNSPECIFIED = 0;
    // Slot requires payment in the partner platform to be booked.
    PAYMENT_REQUIRED = 1;
  }

คําจํากัดความตัวอย่างเหตุผลของลิงก์ออก

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "11203880",
    "generation_timestamp": 1543875200
  },
  "service_availability": [
    {
      "availability": [
        {
          "merchant_id": "dining-A",
          "service_id": "reservation",
          "linkout_required_reason": "PAYMENT_REQUIRED",
          "start_sec": 1535853600,
          "duration_sec": 2700,
          "spots_total": 2,
          "spots_open": 2,
          "resources": {
            "room_id": "A-dining-room",
            "room_name": "Dining Room",
            "party_size": 2
          }
        }
      ]
    }
  ]
}

4. ยืนยันช่องในศูนย์การดำเนินการ

เมื่อส่งฟีดเรียบร้อยแล้วและไม่มีข้อผิดพลาดในประวัติฟีด คุณจะยืนยันช่องได้โดยใช้ขั้นตอนต่อไปนี้

เทมเพลต URL ในโปรแกรมดูพื้นที่โฆษณา

ดูคำจำกัดความของเทมเพลต URL ได้ในส่วน "บริการ" ของผู้ขาย พื้นที่โฆษณาของคุณ คุณจะเห็นเทมเพลตใต้ "ตัวอย่างฟีด" ดูรายละเอียดเพิ่มเติมเกี่ยวกับมุมมองผู้ขายและมุมมองบริการได้ที่มุมมองสินค้าคงคลัง

รูปที่ 1: ตัวอย่างการค้นหา URL ภายในศูนย์การดำเนินการ — **ภาพที่ 1:** ตำแหน่งของ URL เทมเพลตภายใน Action Center

เหตุผลในการลิงก์ในเครื่องมือดูความพร้อมใช้งาน

คุณจะเห็นช่อง linkout_reason_required เมื่อดูข้อมูล ช่วงเวลาที่พร้อมจำหน่ายในมุมมองความพร้อมจำหน่ายสินค้า

รูปที่ 1: ตัวอย่างการค้นหา URL ภายใน Action Center — **รูปที่ 1:** ตําแหน่งเทมเพลต URL ภายในศูนย์การดำเนินการ