จัดการการตั้งค่าการชำระเงิน

ฟีเจอร์การชำระเงินจะช่วยเร่งการซื้อของลูกค้าที่พร้อมซื้อด้วยการอนุญาตให้ลูกค้าไปยังหน้ารถเข็นหรือหน้าชำระเงินของเว็บไซต์ได้โดยตรงจากข้อมูลผลิตภัณฑ์ที่แสดงใน Google ซึ่งจะช่วยเพิ่มอัตรา Conversion และมอบประสบการณ์การช็อปปิ้งที่ราบรื่น

เมื่อใช้ Merchant API คุณจะจัดการการตั้งค่าสำหรับฟีเจอร์นี้ได้โดยใช้แหล่งข้อมูล CheckoutSettings

คู่มือนี้จะอธิบายวิธีใช้ Merchant API เพื่อสร้างและจัดการการลงทะเบียนในฟีเจอร์การชำระเงินโดยใช้โปรแกรม

ดูข้อมูลเพิ่มเติมได้ที่เพิ่มลิงก์หน้าชำระเงินสำหรับผลิตภัณฑ์

ข้อกำหนดเบื้องต้น

หากต้องการใช้แหล่งข้อมูล CheckoutSettings และวิธีการที่เกี่ยวข้อง โปรดทําดังนี้

  • คุณต้องได้รับอนุมัติและเข้าร่วมในโฆษณา Shopping, ข้อมูลที่แสดงฟรี หรือทั้ง 2 อย่าง
  • ประเทศที่ขายของคุณต้องเป็นสหรัฐอเมริกา

เมธอด

หากต้องการสร้าง เรียกดู อัปเดต และลบการตั้งค่าการชำระเงิน คุณสามารถใช้วิธีต่อไปนี้

สร้างการตั้งค่าการชำระเงิน

หากต้องการสร้างการตั้งค่าการชำระเงิน ให้ใช้เมธอด checkoutSettings.create รวม uri_settings กับ checkout_uri_template หรือ cart_uri_template และ eligible_destinations ที่เลือกไว้ในเนื้อหาคำขอ

ตัวอย่างคําขอมีดังนี้

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

แทนที่ {ACCOUNT_ID} ด้วยตัวระบุที่ไม่ซ้ำกันของบัญชี Merchant Center

ตัวอย่างการตอบกลับจากการเรียกใช้ที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

เรียกข้อมูลการตั้งค่าการชำระเงิน

หากต้องการเรียกข้อมูลการตั้งค่าการชำระเงิน ซึ่งรวมถึงเทมเพลต URL, ปลายทางที่เลือก, สถานะการลงทะเบียน และสถานะการตรวจสอบ URL ให้ใช้วิธี checkoutSettings.get

ตัวอย่างคําขอมีดังนี้

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

ตัวอย่างการตอบกลับจากการเรียกใช้ที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

อัปเดตการตั้งค่าการชำระเงิน

หากต้องการอัปเดตการตั้งค่าการชำระเงิน ให้ใช้checkoutSettings.updateวิธีนี้ ใส่ช่องที่ต้องการเปลี่ยนในเนื้อหาคําขอ แล้วระบุช่องเหล่านั้นในพารามิเตอร์การค้นหา update_mask

update_mask รองรับฟิลด์ต่อไปนี้

  • eligible_destinations
  • uri_settings

ต่อไปนี้คือตัวอย่างคําขออัปเดต URL และนําปลายทางโฆษณาออก

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

ตัวอย่างการตอบกลับจากการเรียกใช้ที่สำเร็จมีดังนี้

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

ลบ

หากต้องการลบการตั้งค่าการชำระเงิน ให้ใช้วิธีการ checkoutSettings.delete

การดำเนินการนี้จะนําการกำหนดค่าระดับบัญชีออก ยกเลิกการลงทะเบียนคุณจากโปรแกรมการชำระเงิน และหยุดไม่ให้ลิงก์การชำระเงินปรากฏในผลิตภัณฑ์ของคุณในข้อมูลที่แสดงฟรีและโฆษณา Shopping

ตัวอย่างคําขอมีดังนี้

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

การเรียกใช้ที่สำเร็จจะแสดงผลลัพธ์การตอบกลับที่ว่างเปล่า

คุณระบุ URL การชำระเงินสำหรับผลิตภัณฑ์ได้ 2 วิธีดังนี้

  • ระดับบัญชี (API ย่อยหรือ Merchant Center): หากต้องการกำหนดเทมเพลต URL รายการเดียว ไม่ว่าจะเป็น checkout_uri_template หรือ cart_uri_template คุณสามารถใช้การตั้งค่า API ย่อยหรือ Merchant Center เทมเพลตนี้จะมีผลกับผลิตภัณฑ์ที่มีสิทธิ์ทั้งหมด เราขอแนะนำให้คุณใช้ URL ที่สอดคล้องกันสำหรับผลิตภัณฑ์ทั้งหมด เช่น yourstore.com/checkout?id={id}

  • ระดับผลิตภัณฑ์ (ฟีด): หากต้องการระบุ URL การชำระเงินที่เฉพาะเจาะจงสำหรับผลิตภัณฑ์แต่ละรายการ ให้ใช้แอตทริบิวต์ checkout_link_template ในฟีดผลิตภัณฑ์ วิธีนี้ช่วยให้คุณปรับแต่ง URL ต่อผลิตภัณฑ์หรือเสนอการชำระเงินสำหรับสินค้าคงคลังชุดย่อยได้

  • หากคุณตั้งค่าเทมเพลต URL ระดับบัญชีโดยใช้ API ย่อยนี้ โปรดตรวจสอบว่าคุณไม่ได้ส่งค่าสำหรับแอตทริบิวต์ checkout_link_template ในฟีดสำหรับผลิตภัณฑ์เหล่านั้น

  • หากคุณใช้แอตทริบิวต์ฟีด checkout_link_template โปรดตรวจสอบว่าคุณไม่ได้ตั้งค่าเทมเพลต URL ระดับบัญชีโดยใช้การตั้งค่า API ย่อยหรือ Merchant Center คุณยังคงใช้ API ย่อยเพื่อเลือก eligible_destinations ได้โดยไม่ต้องระบุ uri_settings หากจัดการ URL ผ่านฟีดเท่านั้น

เทมเพลต URL การชำระเงิน

เทมเพลต URL การชำระเงินช่วยให้คุณระบุ URL การชำระเงินในข้อมูลผลิตภัณฑ์ได้ ซึ่งทำให้ผู้เลือกซื้อออนไลน์มีตัวเลือกในการไปยังหน้าชำระเงินได้โดยตรงจากข้อมูล โดยต้องมีตัวยึดตําแหน่งพารามิเตอร์ {ID} และมีโดเมนที่ตรงกัน

เมื่อตั้งค่าลิงก์การชำระเงินโดยใช้ API ย่อย ให้ใช้ช่อง uri_settings ช่องนี้ยอมรับเทมเพลตอย่างใดอย่างหนึ่งต่อไปนี้

  • checkout_uri_template: เทมเพลต URL ที่เมื่อป้อนตัวยึดตำแหน่งแล้ว จะนําผู้ใช้ไปยังหน้าชำระเงินพร้อมสินค้าที่เจาะจงซึ่งพร้อมสําหรับการซื้อ
  • cart_uri_template: เทมเพลต URL ที่นําผู้ใช้ไปยังหน้ารถเข็นช็อปปิ้งพร้อมเพิ่มสินค้าที่ต้องการลงในรถเข็น

ตัวอย่างเทมเพลต

  • การชำระเงิน: https://www.your-store.com/checkout?item_id={id}
  • รถเข็น: https://shop.your-store.com/add_to_cart?product_sku={id}

โปรดตรวจสอบว่ามีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้

  • เทมเพลต URL ต้องชี้ไปยังหน้าที่ถูกต้องในเว็บไซต์ซึ่งตรงกับโดเมนที่จดทะเบียน ทำงานโดยใช้วิธีการ HTTP GET และไม่กำหนดให้ลูกค้าต้องลงชื่อเข้าใช้
  • โดเมนจากเทมเพลตการชำระเงินที่ระบุต้องตรงกับโดเมนผลิตภัณฑ์

ดูข้อมูลเพิ่มเติม