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

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

การเรียกที่สำเร็จจะแสดงเนื้อหาการตอบกลับที่ว่างเปล่า

คุณมี 2 วิธีในการระบุ URL การชำระเงินสำหรับสินค้า

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

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