Data API มีโควต้าและขีดจำกัดต่อไปนี้
วิธีใช้โควต้า
คำขอทั้งหมดไปยัง Google Analytics Data API v1 ต้องใช้โปรเจ็กต์ Google Cloud และเป็นไปตามโควต้าที่ระบุไว้ในหน้านี้ ระบบจะใช้โควต้า ไม่ว่าคุณจะใช้วิธีใดในการระบุโปรเจ็กต์ที่เรียกใช้ รวมถึง
- คำขอที่ตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบ OAuth 2.0
- คำขอที่ตรวจสอบสิทธิ์โดยใช้คีย์ API เท่านั้น
คีย์ API ใช้เพื่อเชื่อมโยงคำขอกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่เฉพาะเจาะจง เพื่อวัตถุประสงค์ด้านโควต้าและการเรียกเก็บเงิน การเรียก API ทั้งหมดที่ทำโดยใช้ข้อมูลเข้าสู่ระบบหรือคีย์ API จากโปรเจ็กต์จะนับรวมในโควต้าที่เกี่ยวข้องของโปรเจ็กต์และพร็อพเพอร์ตี้ Google Analytics
หมวดหมู่โควต้า
Data API มีหมวดหมู่โควต้าคำขอ 4 หมวดหมู่ ได้แก่ หลัก เรียลไทม์ Funnel และ แชท
คำขอ API ไปยังเมธอดหลักจะเรียกเก็บโควต้าหลัก คำขอ API ไปยังเมธอด Realtime จะเรียกเก็บโควต้าเรียลไทม์ คำขอ API ไปยังเมธอด Funnel จะใช้โควต้า Funnel คำขอ API ไปยังเมธอดของ Chat จะเรียกเก็บโควต้าของ Chat คำขอแต่ละรายการจะใช้โควต้าเพียงประเภทเดียว
| หมวดหมู่โควต้า | เมธอดของ API |
|---|---|
| หลัก | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| เรียลไทม์ | runRealtimeReport |
| Funnel | runFunnelReport |
| แชท | properties.chat |
โควต้าพร็อพเพอร์ตี้ 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 |
| โทเค็นแชทต่อพร็อพเพอร์ตี้ต่อวัน | 3,750,000 | 3,750,000 |
| โทเค็นแชทต่อพร็อพเพอร์ตี้ต่อชั่วโมง | 500,000 | 500,000 |
- คำขอพร้อมกันจะวัดจากจำนวนคำขอที่ดำเนินการพร้อมกัน หากต้องการลดการทำงานพร้อมกันของคำขอ ให้รอให้คำขอก่อนหน้าเสร็จสมบูรณ์ก่อนส่งคำขอเพิ่มเติม
- ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์คือรหัส 500 และ 503 ระบบจะเรียกเก็บโควต้าข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ก็ต่อเมื่อคำขอทำให้เกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์เท่านั้น เมื่อโควต้าข้อผิดพลาดของเซิร์ฟเวอร์หมดสำหรับคู่โปรเจ็กต์และพร็อพเพอร์ตี้ ระบบจะบล็อกคำขอทั้งหมดที่ส่งไปยังพร็อพเพอร์ตี้จากโปรเจ็กต์ ดูรายการการตอบกลับข้อผิดพลาดทั้งหมดได้ที่การตอบกลับข้อผิดพลาด
- คำขอแต่ละรายการจะใช้โควต้าสำหรับทั้งโทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมงและโทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อชั่วโมง ซึ่งหมายความว่าต้องมีโปรเจ็กต์มากกว่า 3 รายการเข้าถึงพร็อพเพอร์ตี้หนึ่งๆ ก่อน โควต้า "โทเค็นต่อพร็อพเพอร์ตี้ต่อชั่วโมง" จึงจะหมดก่อนโควต้า "โทเค็นต่อโปรเจ็กต์ต่อพร็อพเพอร์ตี้ต่อ ชั่วโมง"
พร็อพเพอร์ตี้ได้รับอนุญาตให้ส่งคำขอที่อาจถึงเกณฑ์ 120 รายการต่อชั่วโมง userAgeBracket, userGender, brandingInterest, audienceId และ audienceName
อาจมีการกำหนดเกณฑ์ มีการนำเกณฑ์มาใช้เพื่อป้องกันผู้ใดก็ตามที่ดูรายงานไม่ให้สรุปข้อมูลประชากรหรือความสนใจของผู้ใช้ได้
โควต้าโทเค็นของพร็อพเพอร์ตี้
ระบบจะใช้โทเค็นกับคําขอแต่ละรายการไปยัง Google Analytics Data API v1
จำนวนโทเค็นที่เรียกเก็บจะขึ้นอยู่กับความซับซ้อนของคำขอ แม้ว่าคำขอส่วนใหญ่จะเรียกเก็บโทเค็นไม่เกิน 10 รายการ แต่คำขอที่ซับซ้อนกว่า (เช่น คำค้นหาchatของที่ปรึกษา Analytics)
จะใช้โทเค็นมากกว่า
ปัจจัยที่มีผลต่อการใช้โทเค็น
ระบบจะกำหนดต้นทุนโทเค็นที่แน่นอนสำหรับคำขอ ณ เวลาที่ดำเนินการ ซึ่งทำให้การคำนวณล่วงหน้าอย่างแม่นยำเป็นเรื่องยาก ค่าใช้จ่ายขึ้นอยู่กับ การรวมกันของปัจจัยที่เกี่ยวข้องกับคำขอเองและข้อมูลพื้นฐานใน พร็อพเพอร์ตี้ Google Analytics ปัจจัยเหล่านี้อาจส่งผลให้มีค่าใช้จ่ายสูงขึ้น
- จำนวนแถว: การขอจำนวนแถวที่มากขึ้น
- จํานวนมิติข้อมูลและเมตริก: รวมมิติข้อมูลและเมตริกจํานวนมากขึ้น
- ความซับซ้อนของตัวกรอง: การใช้นิพจน์ตัวกรองที่ซับซ้อน
- ระยะเวลาช่วงวันที่: การค้นหาในช่วงวันที่ที่ยาวขึ้น
- Cardinality ของข้อมูล: มิติข้อมูลที่มี Cardinality สูง (ค่าที่ไม่ซ้ำกันจํานวนมาก เช่น
pagePathมิติข้อมูลที่กําหนดเอง) อาจเพิ่มต้นทุนโทเค็นอย่างมาก - ปริมาณเหตุการณ์ของพร็อพเพอร์ตี้: การค้นหาในพร็อพเพอร์ตี้ที่มีปริมาณเหตุการณ์สูงกว่า อาจใช้โทเค็นมากกว่าการค้นหาเดียวกันในพร็อพเพอร์ตี้ที่มีข้อมูลน้อยกว่า
การตรวจสอบการใช้งานโทเค็น
วิธีที่มีประสิทธิภาพที่สุดในการกำหนดต้นทุนโทเค็นสำหรับการเรียก API ที่เฉพาะเจาะจง
คือการรวมพารามิเตอร์ "returnPropertyQuota": true ไว้ในเนื้อหาคำขอ
จากนั้นการตอบกลับของ API จะมีออบเจ็กต์ PropertyQuota ซึ่งให้รายละเอียดเกี่ยวกับโทเค็นที่คำขอเฉพาะนั้นใช้และโควต้าคงเหลือ
การใช้และการตรวจสอบโทเค็นแชท
สําหรับคําขอของที่ปรึกษา Analytics chat
โทเค็นแสดงถึงการคํานวณโมเดล การให้เหตุผล และต้นทุนการดึงข้อมูลพื้นฐาน
การใช้โทเค็นของแชทได้รับผลกระทบจากปัจจัยต่อไปนี้
- ขอบเขตการค้นหาและการวิเคราะห์: ความซับซ้อนและความกว้างของการวิเคราะห์ที่ขอ
- โทเค็นอินพุตและเอาต์พุตของโมเดล: ปริมาณข้อมูลเชิงบริบทที่ประมวลผลและ การบรรยายคำตอบที่สร้างขึ้น
- โทเค็นการคิด: ขั้นตอนการให้เหตุผลของโมเดลที่จำเป็นต่อการสังเคราะห์ข้อมูล
- เวลาในการตอบสนองของการดำเนินการ: เวลาในการประมวลผลที่จำเป็นสำหรับการสํารวจข้อมูลแบบหลายขั้นตอน
หากต้องการตรวจสอบการใช้โทเค็นแชท ให้ตั้งค่า "returnPropertyQuota": true
ใน
ChatRequest
การตอบกลับจะมีออบเจ็กต์
PropertyChatQuota
ซึ่งมีฟิลด์
tokensPerDay
และ
tokensPerHour
พร้อมยอดคงเหลือที่ใช้ไปและยอดคงเหลือ