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

ฟีเจอร์การชำระเงินช่วยให้ลูกค้าที่พร้อมซื้อสามารถซื้อสินค้าได้เร็วขึ้นโดยให้ลูกค้าไปยังรถเข็นหรือหน้าชำระเงินของเว็บไซต์ได้โดยตรงจากข้อมูลผลิตภัณฑ์ใน 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 วิธีดังนี้

  • ระดับบัญชี (Sub-API หรือ Merchant Center): หากต้องการกำหนดเทมเพลต URL รายการเดียว ไม่ว่าจะเป็น checkout_uri_template หรือ cart_uri_template คุณสามารถใช้ Sub-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 ฟิลด์นี้ยอมรับเทมเพลตใดเทมเพลตหนึ่งจาก 2 เทมเพลตต่อไปนี้

  • 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 และไม่กำหนดให้ลูกค้าต้องลงชื่อเข้าใช้
  • โดเมนจากเทมเพลตการชำระเงินที่ระบุต้องตรงกับโดเมนของผลิตภัณฑ์

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

ก่อนหน้า
Manage online return policies
ถัดไป
Enable automatic improvements