คำขอ API แต่ละรายการจะยืนยันว่าโควต้ายังไม่หมดและใช้โควต้าไม่หมด หากโควต้าใดหมด คำขอจะไม่สำเร็จโดยมีข้อความแสดงข้อผิดพลาดที่เกี่ยวข้อง คำขอ Data API แต่ละรายการจะตรวจสอบที่เก็บข้อมูลโควต้าหลายรายการ
หมวดหมู่โควต้า
สำหรับวัตถุประสงค์ของโควต้า Data API มีคำขอ 3 หมวดหมู่ ได้แก่ หลัก เรียลไทม์ และช่องทาง คำขอ API ไปยังเมธอดหลักเรียกเก็บโควต้าหลัก คำขอ API ไปยังเมธอด Realtime จะเรียกเก็บเงินโควต้าแบบเรียลไทม์ คำขอ 1 รายการจะไม่ใช้ทั้งโควต้าหลักและโควต้าแบบเรียลไทม์ ต่อไปนี้คือเมธอดและหมวดหมู่ของ 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 ระบบจะเรียกเก็บเงินโควต้าข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์เมื่อคำขอเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์เท่านั้น เมื่อโควต้าข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์สําหรับโปรเจ็กต์และคู่พร็อพเพอร์ตี้หมดลงแล้ว ระบบจะบล็อกคําขอทั้งหมดที่ส่งไปยังพร็อพเพอร์ตี้จากโปรเจ็กต์นั้น
- คำขอแต่ละรายการจะใช้โควต้าสำหรับทั้งโทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมงและโทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง ซึ่งหมายความว่าจะต้องมีการเข้าถึงพร็อพเพอร์ตี้ 1 รายการมากกว่า 3 โปรเจ็กต์ก่อนที่โควต้า "โทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมง" จะหมดก่อนโควต้า "โทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง"
พร็อพเพอร์ตี้อนุญาตให้มีคำขอที่อาจถึงเกณฑ์ 120 รายการต่อชั่วโมง มิติข้อมูล userAgeBracket, userGender, brandingInterest, audienceId และ audienceName อาจมีเกณฑ์ มีการนำเกณฑ์มาใช้เพื่อป้องกันไม่ให้ผู้ที่ดูรายงานคาดการณ์ข้อมูลประชากรหรือความสนใจของผู้ใช้แต่ละรายได้
โควต้าโทเค็นพร็อพเพอร์ตี้
โทเค็นจะได้รับการคำนวณพร้อมกับคำขอแต่ละรายการ ขึ้นอยู่กับความซับซ้อนของคำขอในการดำเนินการให้เสร็จสมบูรณ์ คำขอส่วนใหญ่จะเรียกเก็บเงินจากโทเค็นไม่เกิน 10 รายการ เมื่อคำขอใช้โทเค็นโควต้าจำนวนมาก มักเกิดจากปัจจัยต่อไปนี้
- แถวจำนวนมาก
- คอลัมน์จำนวนมาก
- เกณฑ์ตัวกรองที่ซับซ้อน
- ช่วงวันที่ยาว
ในคำขอ API แต่ละรายการ คุณสามารถระบุ "returnPropertyQuota": true ในส่วนเนื้อหาของคำขอเพื่อแสดงสถานะโทเค็นโควต้าพร็อพเพอร์ตี้ปัจจุบัน สถานะนี้จะมีทั้งจำนวนเงินที่คำขอนี้ใช้และจำนวนที่เหลืออยู่สำหรับกลุ่มโควต้าแต่ละกลุ่ม เช่น ลองระบุพารามิเตอร์นี้ใน RunReportRequest