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