ลบผู้ขาย

หน้านี้ให้คำแนะนำเกี่ยวกับวิธีลบผู้ขายออกจากโฆษณาของพาร์ทเนอร์ภายใต้สัญญา

หมายเหตุ: เราเรียกธุรกิจที่ขายสินค้าของตนผ่าน Marketplace หรือผู้ค้าปลีกว่าผู้ขาย เมื่อคุณให้ผู้ขายเริ่มต้นใช้งานโฆษณาของพาร์ทเนอร์ภายใต้สัญญาแล้ว เราจะถือว่าผู้ขายดังกล่าวเป็นพาร์ทเนอร์ภายใต้สัญญา แต่เพื่อไม่ให้เกิดความยุ่งยาก ในหน้านี้เราจะเรียกพาร์ทเนอร์ภายใต้สัญญา (กล่าวคือ ผู้ขายที่เริ่มต้นใช้งานแล้ว) ว่า "ผู้ขาย" ด้วยเช่นกัน

คุณไม่สามารถลบผู้ขายที่มีแคมเปญโฆษณาที่กำลังใช้งานอยู่

API การลบผู้ขายจะปิดใช้งานบัญชีโฆษณาและลบองค์ประกอบทั้งหมดที่สร้างขึ้นระหว่างการเริ่มต้นใช้งาน ได้แก่

  • กลุ่มสินค้าจากแค็ตตาล็อก
  • เพจ
  • ผู้ใช้ระบบ
  • ธุรกิจ

เมื่อลบสำเร็จแล้ว vendor_id ที่เชื่อมโยงกับผู้ขายที่ถูกลบสามารถนำกลับมาใช้ใหม่และกำหนดให้กับผู้ขายรายอื่นได้หากต้องการ

สิทธิ์การอนุญาตที่จำเป็น

คุณจะต้องมีสิทธิ์การอนุญาตต่อไปนี้เพื่อเรียกใช้ API การลบผู้ขาย

  • ผู้ดูแลธุรกิจ
  • จัดการเครดิต
  • ผู้พัฒนาแอพ

การเรียกใช้ API การลบผู้ขาย

คำขอ

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v20.0"

เมื่อเรียกใช้ API นี้ ระบบจะส่งคืนการตอบกลับด้วย ASYNC_SESSION_ID ในทันที ซึ่งในระหว่างที่ระบบกำลังประมวลผลคำขอ คุณควรตรวจสอบ ASYNC_SESSION_ID เป็นระยะ จนกว่าจะถึงสถานะเทอร์มินัล [COMPLETED|FAILED]

พารามิเตอร์

ชื่อคำอธิบาย

appsecret_proof

สตริง

ต้องระบุ
สตริงเลขฐานสิบหกที่จะพิสูจน์ความเป็นเจ้าของโทเค็นการเข้าถึงที่ระบุ โดย appsecret_proof ควรสร้างขึ้นจากโทเค็นการเข้าถึงและข้อมูลลับของแอพของ Marketplace

child_business_external_id

สตริง

ต้องระบุ เว้นแต่จะมีการระบุ child_business_id
Marketplace ควรส่ง ID ที่ไม่ซ้ำกันสำหรับผู้ขายแต่ละราย โดยที่ช่องนี้ในฝั่ง Marketplace จะใช้ชื่อว่า vendor_id

child_business_id

สตริง

ต้องระบุ เว้นแต่จะมีการระบุ child_business_external_id
ID ตัวจัดการธุรกิจของผู้ขาย

marketplace_bm_id

สตริง

ต้องระบุ
ID ตัวจัดการธุรกิจของ Marketplace
ดูข้อมูลเพิ่มเติมได้ที่ "ค้นหา ID ธุรกิจของคุณในตัวจัดการธุรกิจของ Meta"

การตอบกลับ

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

ใช้ ASYNC_SESSION_ID เพื่อรับสถานะการลบผู้ขายออกจากโฆษณาของพาร์ทเนอร์ภายใต้สัญญา

ดูข้อมูลเพิ่มเติมได้ที่ "วิธีตรวจสอบเซสชั่นแบบไม่ซิงค์ของการตอบกลับเป็นระยะ"

การตอบกลับเมื่อสำเร็จ

หากมีสถานะเป็น COMPLETED ข้อมูลแสดงผลลัพธ์ของการตรวจสอบเซสชั่นแบบไม่ซิงค์เป็นระยะจะมีลักษณะดังนี้

{
  "result": "{\"id\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

การตอบกลับเมื่อล้มเหลว

หากมีสถานะเป็น FAILED ข้อมูลแสดงผลลัพธ์ของการตรวจสอบเซสชั่นแบบไม่ซิงค์เป็นระยะจะมีลักษณะดังนี้

รหัสข้อผิดพลาด

คำขอที่ส่งถึง API การลบผู้ขายสามารถส่งผลให้มีการตอบกลับด้วยข้อผิดพลาดได้หลายแบบ ดูข้อมูลเพิ่มเติมได้ที่ "วิธีจัดการข้อผิดพลาด

รหัสข้อผิดพลาดรหัสย่อยของข้อผิดพลาดข้อความแสดงข้อผิดพลาด

1800007

2310162

ID ธุรกิจที่คุณป้อน {business_id} ไม่ใช่ ID สำหรับพาร์ทเนอร์ในโฆษณาของพาร์ทเนอร์ภายใต้สัญญา ให้ตรวจสอบข้อมูลที่คุณป้อนหรือป้อน ID ธุรกิจใหม่

1800007

2310163

ID ผู้ให้บริการที่คุณป้อน {vendor_id} ไม่ใช่ ID สำหรับพาร์ทเนอร์ในโฆษณาของพาร์ทเนอร์ภายใต้สัญญา ให้ตรวจสอบข้อมูลที่คุณป้อนหรือป้อน ID ผู้ให้บริการใหม่

1800008

2310164

ธุรกิจของคุณไม่ได้จัดการพาร์ทเนอร์ {business_id หรือ vendor_id} ที่คุณพยายามจะลบ ให้ตรวจสอบ ID ดังกล่าวหรือป้อน ID ใหม่

1800009

2310113

ไม่สามารถลบพาร์ทเนอร์ภายใต้สัญญาที่มี ID ธุรกิจ {business_id} ได้ คุณไม่สามารถลบในขณะที่ยังมียอดค้างชำระ {amount} {currency} เมื่อคุณชำระเงินตามใบแจ้งหนี้แล้ว ให้ลองลบพาร์ทเนอร์ดังกล่าวอีกครั้ง

1800009

2310134

เจ้าของเพจ {page_owner_id} ของเพจ {page_id} ไม่ใช่ผู้ใช้ระบบที่เป็นผู้ดูแล โฆษณาของพาร์ทเนอร์ภายใต้สัญญาไม่ได้เป็นผู้สร้างเพจดังกล่าว และคุณจะต้องลบเพจก่อนจึงจะสามารถลบพาร์ทเนอร์ได้

1800009

2310135

พาร์ทเนอร์รายนี้มีเพจ Facebook ที่โฆษณาของพาร์ทเนอร์ภายใต้สัญญาไม่ได้เป็นผู้สร้างอย่างน้อย 1 เพจ คุณจะต้องลบเพจเหล่านี้ก่อนจึงจะสามารถลบพาร์ทเนอร์ได้: {list_of_page_ids}

1800009

2310165

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