วางแผนสำหรับเวลาในการตอบสนองของ API

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

คำขอ Merchant API ส่วนใหญ่จะเสร็จสมบูรณ์ภายในเวลาไม่ถึง 1 วินาที การอัปเดตสินค้าคงคลังในพื้นที่และระดับภูมิภาคอาจใช้เวลา 2-3 วินาที และการค้นหารายงานบางรายการอาจใช้เวลานานกว่านั้นมาก

เวลาในการตอบสนองโดยทั่วไป

ตารางต่อไปนี้แสดงเวลาในการตอบสนองโดยประมาณตามประเภทคำขอ เวลาในการตอบสนองโดยทั่วไปคือค่ามัธยฐาน: ครึ่งหนึ่งของคำขอจะเสร็จสมบูรณ์เร็วกว่า คำขอที่ช้าที่สุด 1% จะใช้เวลานานเท่ากับที่คอลัมน์สุดท้ายแสดงหรือนานกว่านั้น

ประเภทคำขอ ตัวอย่างวิธีการ เวลาในการตอบสนองปกติ คำขอที่ช้าที่สุด 1%
การอ่านและเขียนข้อมูลผลิตภัณฑ์ products.get, productInputs.insert, productInputs.patch, productInputs.delete 100 ถึง 600 มิลลิวินาที ประมาณ 2 วินาที
คำขออื่นๆ ส่วนใหญ่ products.list, accounts.get, dataSources.list, aggregateProductStatuses.list น้อยกว่า 1 วินาที ไม่กี่วินาที
การเขียนสินค้าคงคลังในร้านและระดับภูมิภาค localInventories.insert, regionalInventories.insert และเมธอด delete ที่เกี่ยวข้อง ไม่กี่วินาที 10 วินาทีขึ้นไป
ข้อความค้นหารายงาน accounts.reports.search ประมาณครึ่งวินาที 30 วินาทีขึ้นไป

ข้อความค้นหารายงานจะแตกต่างกันมากที่สุด เวลาในการตอบสนองจะขึ้นอยู่กับตารางรายงานที่คุณค้นหาและปริมาณข้อมูลที่การค้นหาครอบคลุม โดยปกติแล้ว การค้นหารายงานประมาณ 1 ใน 10 รายการจะใช้เวลานานกว่า 2 วินาที และมีเพียงส่วนน้อยเท่านั้นที่อาจใช้เวลานานกว่า 1 นาที

คำแนะนำ

  • ตั้งค่าการหมดเวลาโดยมีระยะเวลาสำรอง หากคุณตั้งค่าระยะหมดเวลาของคำขอในไคลเอ็นต์ ให้ตั้งค่าให้สูงกว่าเวลาในการตอบสนองที่ช้าที่สุดที่ระบุไว้ในเวลาในการตอบสนองโดยทั่วไป ตัวอย่างเช่น การหมดเวลา 60 วินาทีจะทำให้มีพื้นที่ว่างเหลือเฟือสำหรับคำขอส่วนใหญ่ แต่ไม่ใช่สำหรับคำค้นหารายงานทั้งหมด
  • ส่งคำขอที่แยกกันแบบพร้อมกัน เนื่องจากการเขียนพื้นที่โฆษณาแต่ละครั้งใช้เวลา 2-3 วินาที การส่งทีละรายการจึงจำกัดอัตราการส่งข้อมูลของคุณ ส่งคำขออิสระพร้อมกันหรือใช้คำขอแบบกลุ่ม เมื่อส่งคำขอหลายรายการ โปรดคำนึงถึงขีดจำกัดต่อนาทีและขีดจำกัดการใช้งานต่อวัน ดูข้อมูลเพิ่มเติมได้ที่โควต้าอัตรา
  • จำกัดการค้นหารายงานให้แสดงเฉพาะข้อมูลที่คุณต้องการ การค้นหาที่ครอบคลุมชุดข้อมูลขนาดใหญ่ เช่น ช่วงวันที่ที่ยาวนาน จะใช้เวลานานกว่าและอาจหมดเวลา หากต้องการข้อมูลจำนวนมาก ให้พิจารณาใช้ BigQuery ดูข้อมูลเพิ่มเติมได้ที่โหลดข้อมูล Google Merchant Center ลงใน BigQuery
  • ลองอีกครั้งโดยใช้ Exponential Backoff หากคำขอหมดเวลาหรือดำเนินการไม่สำเร็จเนื่องจากข้อผิดพลาดชั่วคราว ให้ลองอีกครั้งโดยใช้ Exponential Backoff

เวลาในการประมวลผล

สำหรับคำขอที่เปลี่ยนแปลงข้อมูล การตอบกลับที่สำเร็จหมายความว่า Merchant API ยอมรับการเปลี่ยนแปลง แต่การประมวลผลจะดำเนินต่อไปหลังจากการตอบกลับ เวลาในการประมวลผลคือเวลาตั้งแต่การตอบกลับจนกระทั่งการเปลี่ยนแปลงปรากฏในแหล่งข้อมูลอื่นๆ เวลาในการประมวลผลไม่ได้เป็นส่วนหนึ่งของเวลาในการตอบสนอง และอาจใช้เวลานานกว่ามาก ตัวอย่างเช่น อาจใช้เวลา 2-3 นาทีกว่าที่ผลิตภัณฑ์ที่ประมวลผลแล้วจะแสดงข้อมูลผลิตภัณฑ์ที่แทรกไว้

ดูข้อมูลเพิ่มเติมเกี่ยวกับสถานะการประมวลผลขั้นสุดท้ายของข้อมูลได้ในคำแนะนำต่อไปนี้