Data API มีขีดจำกัดและโควต้าดังต่อไปนี้
วิธีใช้โควต้า
คำขอทั้งหมดที่ส่งไปยัง Google Analytics Data API v1 ต้องใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud และอยู่ภายใต้โควต้าที่ระบุไว้ในหน้านี้ ระบบจะใช้โควต้าไม่ว่าคุณจะใช้วิธีใดในการระบุโปรเจ็กต์ที่เรียกใช้ ซึ่งรวมถึง
- คำขอที่ตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบ OAuth 2.0
- คำขอที่ตรวจสอบสิทธิ์โดยใช้คีย์ API เท่านั้น
ระบบจะใช้คีย์ API เพื่อเชื่อมโยงคำขอกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่เฉพาะเจาะจงเพื่อวัตถุประสงค์ด้านโควต้าและการเรียกเก็บเงิน การเรียก 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 อาจมีเกณฑ์ มีการนำเกณฑ์มาใช้เพื่อป้องกันผู้ใดก็ตามที่ดูรายงานไม่ให้สรุปข้อมูลประชากรหรือความสนใจของผู้ใช้ได้
โควต้าโทเค็นพร็อพเพอร์ตี้
ระบบจะใช้โทเค็นกับคำขอแต่ละรายการที่ส่งไปยัง Google Analytics Data API v1 จำนวนโทเค็นที่เรียกเก็บจะขึ้นอยู่กับความซับซ้อนของคำขอ แม้ว่าคำขอส่วนใหญ่จะเรียกเก็บโทเค็นไม่เกิน 10 รายการ แต่คำขอที่ซับซ้อนกว่าจะใช้โทเค็นมากกว่า
ปัจจัยที่ส่งผลต่อการใช้โทเค็น
ระบบจะกำหนดค่าใช้จ่ายโทเค็นที่แน่นอนสำหรับคำขอ ณ เวลาที่ดำเนินการ ซึ่งทำให้การคำนวณล่วงหน้าอย่างแม่นยำเป็นเรื่องยาก ค่าใช้จ่ายขึ้นอยู่กับปัจจัยหลายอย่างที่เกี่ยวข้องกับคำขอเองและข้อมูลพื้นฐานในพร็อพเพอร์ตี้ Google Analytics ปัจจัยเหล่านี้อาจทำให้ค่าใช้จ่ายสูงขึ้น
- จำนวนแถว: การขอแถวจำนวนมากขึ้น
- จำนวนมิติข้อมูลและเมตริก: การรวมมิติข้อมูลและเมตริกจำนวนมากขึ้น
- ความซับซ้อนของตัวกรอง: การใช้นิพจน์ตัวกรองที่ซับซ้อน
- ระยะเวลาของช่วงวันที่: การค้นหาข้อมูลในช่วงวันที่ที่ยาวขึ้น
- คาร์ดินัลลิตี้ของข้อมูล: มิติข้อมูลที่มีคาร์ดินัลลิตี้สูง (ค่าที่ไม่ซ้ำกันจำนวนมาก เช่น
pagePath, มิติข้อมูลที่กำหนดเอง) อาจเพิ่มค่าใช้จ่ายโทเค็นอย่างมาก - ปริมาณเหตุการณ์ของพร็อพเพอร์ตี้: การค้นหาข้อมูลในพร็อพเพอร์ตี้ที่มีปริมาณเหตุการณ์สูงกว่าอาจใช้โทเค็นมากกว่าการค้นหาเดียวกันในพร็อพเพอร์ตี้ที่มีข้อมูลน้อยกว่า
การตรวจสอบการใช้งานโทเค็น
วิธีที่มีประสิทธิภาพที่สุดในการกำหนดค่าใช้จ่ายโทเค็นสำหรับการเรียก API ที่เฉพาะเจาะจง
คือการใส่พารามิเตอร์ "returnPropertyQuota": true ในเนื้อหาของคำขอ
จากนั้นการตอบกลับของ API จะมีออบเจ็กต์ PropertyQuota ซึ่งแสดงรายละเอียดโทเค็นที่คำขอเฉพาะเจาะจงนั้นใช้ไปและยอดคงเหลือของโควต้า