ขีดจำกัดและโควต้าของคำขอ API

เอกสารนี้จะอธิบายขีดจำกัดและโควต้าของการขอ Management API และ Reporting API

เว็บไซต์หลายล้านแห่งใช้ Google Analytics เรากำหนดขีดจำกัดและโควต้าสำหรับคำขอ API เพื่อป้องกันไม่ให้ระบบรับข้อมูลมากเกินกว่าจะจัดการได้ รวมถึงเพื่อให้มั่นใจว่าจะมีการกระจายทรัพยากรระบบอย่างเท่าเทียม ขีดจำกัดและโควต้าอาจมีการเปลี่ยนแปลง

วิดีโอนี้จะพูดถึงแนวทางปฏิบัติแนะนำในการจัดการโควต้าคำขอ Google Analytics API

ขีดจำกัดโควต้าทั่วไป

โควต้าต่อไปนี้มีผลกับ Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API และReal Time Reporting API

  • คำขอ 50,000 รายการต่อโปรเจ็กต์ต่อวัน ซึ่งเพิ่มได้
  • 10 คำค้นหาต่อวินาที (QPS) ต่อที่อยู่ IP
    • ซึ่งในคอนโซล API มีโควต้าที่คล้ายกันที่เรียกว่าคําขอต่อ 100 วินาทีต่อผู้ใช้ โดยค่าเริ่มต้น ระบบจะตั้งค่าคำขอเป็น 100 คำขอต่อ 100 วินาทีต่อผู้ใช้ และปรับได้เป็นจำนวนสูงสุด 1,000 รายการ แต่จำนวนคำขอที่ส่งไปยัง API จำกัดไว้ที่ไม่เกิน 10 คำขอต่อวินาทีต่อผู้ใช้
    • หากแอปพลิเคชันของคุณสร้างคำขอ API ทั้งหมดจากที่อยู่ IP เดียว (นั่นคือ ในนามของผู้ใช้) ให้ใช้พารามิเตอร์ userIP หรือ quotaUser กับคำขอแต่ละรายการเพื่อรับโควต้า QPS เต็มสำหรับผู้ใช้แต่ละราย โปรดดูรายละเอียดในสรุปพารามิเตอร์การค้นหามาตรฐาน

Reporting APIs

โควต้าต่อไปนี้มีผลกับ API การรายงานทั้งหมด รวมถึง Core Reporting API v3, Analytics Reporting API v4, Real Time API v3 และ Multi-channel Funnel API v3

  • คำขอ 10,000 รายการต่อการดู (โปรไฟล์) ต่อวัน (เพิ่มไม่ได้)
  • คำขอพร้อมกัน 10 รายการต่อการดู (โปรไฟล์) (เพิ่มไม่ได้)
การเรียก Analytics Real Time Reporting API ระบบจะนับแยกต่างหากจาก API อื่นๆ ของ Analytics ซึ่งหมายความว่าสามารถ โทร 10,000 ครั้งต่อวันต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) โดยใช้ Analytics Realtime Reporting API และเรียกอีก 10,000 ครั้งต่อวันต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) โดยใช้ Analytics API อื่นๆ

ลักษณะการทำงานนี้เป็นวิธีการที่ละเอียดมากขึ้นและมีความปลอดภัยเมื่อล้มเหลวในการจัดการโควต้า ดังนั้นการเรียกบ่อยๆ โดยใช้ API การรายงานแบบเรียลไทม์ของ Analytics จะไม่บล็อกการเรียก API อื่นๆ ของ Analytics ทั้งหมดโดยไม่ได้ตั้งใจในช่วงที่เหลือของวันสำหรับข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) แต่ละรายการ

ข้อผิดพลาดเกี่ยวกับคำขอ Reporting API

หากคำขอไปยัง Reporting API ไม่สำเร็จโดยมีข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คุณจะได้รับรหัสการตอบกลับ 500 หรือ 503 คุณจะส่งคำขออีกครั้งได้ แต่อย่าส่งคำขอนี้ซ้ำมากกว่า 1 ครั้งหากคำขอไม่สำเร็จซ้ำๆ Google Analytics อนุญาต:

  • คำขอข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ที่ล้มเหลว 10 รายการต่อโปรเจ็กต์ต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ต่อชั่วโมง
  • คำขอเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ที่ไม่สำเร็จ 50 รายการต่อโปรเจ็กต์ต่อข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ต่อวัน

หากจำนวนคำขอที่ล้มเหลวเกินโควต้าเหล่านี้ คุณจะได้รับข้อผิดพลาดต่อไปนี้

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

หากต้องการลดโอกาสที่เซิร์ฟเวอร์คำขอจะเกิดข้อผิดพลาด ให้ลดความซับซ้อนของคำขอโดยลดช่วงวันที่ ลดจำนวนมิติข้อมูลในคำขอ หรือลดจำนวนเมตริกในคำขอ

อย่าส่งคำขอที่ล้มเหลวอีกครั้งอย่างต่อเนื่อง แต่ให้ใช้ Exponential Backoff เพื่อส่งอีกครั้ง

ระบบจะบังคับใช้โควต้าอัตราข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ในกรอบเวลาต่อเนื่องสำหรับโควต้าอัตราข้อผิดพลาดรายชั่วโมงและรายวัน หลังจากเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ครั้งแรกของโปรเจ็กต์และคู่ข้อมูลพร็อพเพอร์ตี้ 1 ชั่วโมง ระบบจะรีเซ็ตโควต้า หากคู่โปรเจ็กต์และมุมมองส่งข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ 10 รายการในช่วง 1 ชั่วโมง ระบบจะบล็อกคู่โปรเจ็กต์และมุมมองจาก API จนกว่าข้อผิดพลาดแรกของเซิร์ฟเวอร์จะผ่านไปครบ 1 ชั่วโมง

เช่น หากคู่โปรเจ็กต์และข้อมูลพร็อพเพอร์ตี้ไม่ได้แสดงข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ในช่วง 24 ชั่วโมงที่ผ่านมา โปรเจ็กต์นี้และข้อมูลพร็อพเพอร์ตี้จะใช้โควต้า 0 จาก 50 รายการ สมมติว่าในตอนนี้โปรเจ็กต์และมุมมองนี้ส่งข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์เมื่อเวลา 6:12 น. หากโปรเจ็กต์นี้และมุมมองส่งข้อผิดพลาดเซิร์ฟเวอร์เพิ่มเติม 49 รายการก่อนเวลา 6:12 น. ของวันถัดไป โปรเจ็กต์และมุมมองนี้จะถูกบล็อกจนถึงเวลา 6:12 น. ของวันถัดไป เมื่อเวลา 6:12 น. ของวันถัดไป โควต้าอัตราข้อผิดพลาดของเซิร์ฟเวอร์จะรีเซ็ตสำหรับโปรเจ็กต์นี้และมุมมองนี้โดยสมบูรณ์

เกินขีดจำกัดโควต้า

หากเกินโควต้าในการขอ Google Analytics API แล้ว API จะแสดงผลรหัสข้อผิดพลาด 403 หรือ 429 และข้อความว่าบัญชีดังกล่าวเกินโควต้าแล้ว ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการให้บริการ

กำลังขอโควต้าเพิ่มเติม

คุณขอเพิ่มได้เฉพาะรายการต่อไปนี้

หากต้องการดูหรือเปลี่ยนแปลงขีดจำกัดการใช้งานสำหรับโปรเจ็กต์หรือขอเพิ่มโควต้า ให้ทำดังนี้

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

หากต้องการขอเพิ่มโควต้าสูงสุด โปรดใช้แบบฟอร์มขอโควต้า Analytics API โปรดอย่าลืมตรวจสอบข้อมูลและทำตามวิธีการในแบบฟอร์มคำขอโควต้าก่อนที่จะส่งคำขอ สำหรับ Reporting API v4 ชื่อ API ในคอนโซล Google API คือ Google Analytics Reporting API API v3 อื่นๆ ทั้งหมด (เช่น Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) จะแสดงอยู่ในหัวข้อ Analytics API ในคอนโซล Google API

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