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

Data API มีโควต้าและขีดจำกัดต่อไปนี้

วิธีใช้โควต้า

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

  • คำขอที่ตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบ OAuth 2.0
  • คำขอที่ตรวจสอบสิทธิ์โดยใช้คีย์ API เท่านั้น

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

หมวดหมู่โควต้า

Data API มีหมวดหมู่โควต้าคำขอ 3 หมวดหมู่ ได้แก่ หลัก เรียลไทม์ และ Funnel คำขอ API ไปยังเมธอดหลักจะเรียกเก็บโควต้าหลัก คำขอ API ไปยังเมธอดเรียลไทม์ จะเรียกเก็บโควต้าเรียลไทม์ คำขอแต่ละรายการจะใช้โควต้าเพียงประเภทเดียว

หมวดหมู่โควต้า เมธอดของ API
หลัก runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports
เรียลไทม์ runRealtimeReport
Funnel runFunnelReport

โควต้าพร็อพเพอร์ตี้ Analytics

คำขอทั้งหมดจะใช้โควต้าพร็อพเพอร์ตี้

ชื่อโควต้า ขีดจํากัดของพร็อพเพอร์ตี้มาตรฐาน ขีดจํากัดของพร็อพเพอร์ตี้ Analytics 360
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อวัน 200,000 2,000,000
โทเค็นหลักต่อพร็อพเพอร์ตี้ต่อชั่วโมง 40,000 400,000
โทเค็นหลักต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 14,000 140,000
คำขอพร้อมกันหลักต่อพร็อพเพอร์ตี้ 10 50
ข้อผิดพลาดของเซิร์ฟเวอร์หลักต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 10 50
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อวัน 200,000 2,000,000
โทเค็นแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 40,000 400,000
โทเค็นแบบเรียลไทม์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 14,000 140,000
คำขอพร้อมกันแบบเรียลไทม์ต่อพร็อพเพอร์ตี้ 10 50
ข้อผิดพลาดของเซิร์ฟเวอร์แบบเรียลไทม์ต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 10 50
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อวัน 200,000 2,000,000
โทเค็น Funnel ต่อพร็อพเพอร์ตี้ต่อชั่วโมง 40,000 400,000
โทเค็น Funnel ต่อโปรเจ็กต์ ต่อพร็อพเพอร์ตี้ ต่อชั่วโมง 14,000 140,000
คำขอพร้อมกันใน Funnel ต่อพร็อพเพอร์ตี้ 10 50
ข้อผิดพลาดของเซิร์ฟเวอร์ Funnel ต่อโปรเจ็กต์ ต่อพร็อพเพอร์ตี้ ต่อชั่วโมง 10 50
  • คำขอพร้อมกันจะวัดจากจำนวนคำขอที่ดำเนินการพร้อมกัน หากต้องการลดการทำงานพร้อมกันของคำขอ ให้รอให้คำขอก่อนหน้าเสร็จสมบูรณ์ก่อนส่งคำขอเพิ่มเติม
  • ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์คือรหัส 500 และ 503 ระบบจะเรียกเก็บโควต้าข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ก็ต่อเมื่อคำขอทำให้เกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์เท่านั้น เมื่อโควต้าข้อผิดพลาดของเซิร์ฟเวอร์สำหรับคู่โปรเจ็กต์และพร็อพเพอร์ตี้หมด ระบบจะบล็อกคำขอทั้งหมดที่ส่งไปยังพร็อพเพอร์ตี้จากโปรเจ็กต์
  • คำขอแต่ละรายการจะใช้โควต้าทั้งโทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมงและโทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง ซึ่งหมายความว่าต้องมีโปรเจ็กต์มากกว่า 3 รายการเข้าถึงพร็อพเพอร์ตี้ 1 รายการก่อน โควต้า "โทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมง" จึงจะหมดก่อนโควต้า "โทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อ ชั่วโมง"

พร็อพเพอร์ตี้ได้รับอนุญาตให้ส่งคำขอที่อาจมีเกณฑ์จำกัด 120 รายการต่อชั่วโมง มิติข้อมูล userAgeBracket, userGender, brandingInterest, audienceId และ audienceName อาจมีการกำหนดเกณฑ์ มีการนำเกณฑ์มาใช้เพื่อป้องกันผู้ใดก็ตามที่ดูรายงานไม่ให้สรุปข้อมูลประชากรหรือความสนใจของผู้ใช้ได้

โควต้าโทเค็นของพร็อพเพอร์ตี้

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

  • จำนวนแถวมาก
  • มีคอลัมน์จำนวนมาก
  • เกณฑ์การกรองที่ซับซ้อน
  • ช่วงวันที่ยาว

คุณระบุ "returnPropertyQuota": true ในส่วนเนื้อหาของคำขอเพื่อแสดงสถานะโทเค็นโควต้าพร็อพเพอร์ตี้ปัจจุบันได้ในคำขอ API แต่ละรายการ สถานะนี้ ประกอบด้วยทั้งจำนวนที่ใช้ไปจากคำขอนี้และจำนวนที่เหลือสำหรับ แต่ละกลุ่มโควต้า เช่น ลองระบุพารามิเตอร์นี้ใน RunReportRequest