ย้อนกลับไปที่ "ข่าวสำหรับผู้พัฒนา"

การเปลี่ยนแปลงที่กำลังจะเกิดขึ้นในการเลิกใช้งานเวอร์ชั่นของ API การตลาด เพื่อเปิดใช้งานการอัพเกรดเวอร์ชั่นโดยอัตโนมัติ

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

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

เราจะเลิกใช้งานเวอร์ชั่น 17.0 ในวันที่ 14 พฤษภาคม 2024 ตามบันทึกการเปลี่ยนแปลงของเวอร์ชั่น 18.0 ตำแหน่งข้อมูลต่อไปนี้จะได้รับผลกระทบ

  • POST /act_{ad-account-id}/reachfrequencypredictions
  • GET /act_{ad-account-id}/reachestimate
  • GET /act_{ad-account-id}/delivery_estimate
  • POST /act_{ad-account-id}/adsets
  • POST /{adset-id}
  • POST /act_{ad-account-id}/saved_audiences
  • POST /{saved-audience-id}
  • POST /act_{ad-account-id}/credit_cards

หากแอพของคุณเรียกใช้ POST /{adset-id} ด้วยเวอร์ชั่น 17.0 หลังจากที่เลิกใช้งานแล้วในวันที่ 14 พฤษภาคม 2024 คำขอ API นี้จะล้มเหลวเนื่องจากระบบจะไม่ใช้การอัพเกรดโดยอัตโนมัติกับตำแหน่งข้อมูลที่ได้รับผลกระทบจากเวอร์ชั่นถัดไปที่เปิดให้ใช้งาน นั่นคือ เวอร์ชั่น18 0

หากแอพของคุณเรียกใช้ GET /{ad-account-id}/insights ด้วยเวอร์ชั่น 17.0 หลังจากที่เลิกใช้งานแล้ว แพลตฟอร์มจะอัพเกรดการเรียกใช้ของคุณเป็นเวอร์ชั่นถัดไปที่เปิดให้ใช้งาน นั่นคือ เวอร์ชั่น 18.0

หากแอพของคุณเรียกใช้ด้วยเวอร์ชั่นที่สูงกว่าเวอร์ชั่น 17.0 อยู่แล้ว จะไม่มีการเปลี่ยนแปลงในวันที่เลิกใช้งานเวอร์ชั่น

หากต้องการเลือกไม่ใช้การอัพเกรดเวอร์ชั่นโดยอัตโนมัติ โปรดตรวจสอบ "การตั้งค่า > การตั้งค่าเวอร์ชั่นของ API โฆษณา" ในส่วนการ์ดผลิตภัณฑ์แอพ API การตลาด เพื่อปิดใช้งานฟีเจอร์นี้

หากต้องการยืนยันว่าการเรียกใช้ได้รับการอัพเกรดโดยอัตโนมัติหรือไม่ โปรดตรวจสอบส่วนหัวของการตอบกลับจาก API เพื่อดูรายละเอียดเพิ่มเติม

  • ตัวอย่างส่วนหัวของการแจ้งเตือน: 'X-Ad-Api-Version-Warning:' การเรียกใช้ได้รับการอัพเกรดโดยอัตโนมัติเป็นเวอร์ชั่น 17.0 เนื่องจากเลิกใช้เวอร์ชั่น 16.0 แล้ว’’

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการทำงานดังกล่าว โปรดดูที่การกำหนดเวอร์ชั่นของ API การตลาด

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

ตำแหน่งข้อมูลที่ได้รับผลกระทบ:

  • ตำแหน่งข้อมูล MAPI ทั้งหมด

ลิงก์ไปยังเอกสารประกอบสำหรับผู้พัฒนา

ลิงก์ไปยังบทความช่วยเหลือเกี่ยวกับฟีเจอร์