เอกสารนี้อธิบายระบบโควต้าตามทรัพยากรสำหรับ Google Analytics Reporting API v4 ซึ่งมีให้บริการสำหรับลูกค้า Analytics 360 เท่านั้น โปรดดูขีดจำกัดและโควต้า API สำหรับชุดขีดจำกัดทั้งหมดที่ใช้กับ API
เกริ่นนำ
ทุกโปรเจ็กต์ที่เข้าถึง Analytics Reporting API จะมีขีดจํากัดและโควต้าเพื่อให้มั่นใจว่าทรัพยากรที่ใช้ร่วมกันใช้งานได้และมีความเสถียร เมื่อค้นหาชุดข้อมูลขนาดใหญ่ อาจมีการใช้การสุ่มตัวอย่างโดย Analytics Reporting API ซึ่งอาจส่งผลต่อผลลัพธ์ของข้อมูล
ระบบโควต้าตามทรัพยากรเป็นระบบโควต้าใหม่ซึ่งจะช่วยให้บัญชี Analytics 360 มีเกณฑ์การสุ่มตัวอย่างที่สูงขึ้นในขณะที่ใช้ Analytics Reporting API ระบบนี้เป็นแบบไม่บังคับและไม่ขึ้นอยู่กับขีดจำกัดที่ใช้กับข้อมูลพร็อพเพอร์ตี้และโปรเจ็กต์ที่มีอยู่ เช่น ระบบที่รายงานในหน้าโควต้าของคอนโซล Google API
โควต้าตามทรัพยากร
คำขอแต่ละรายการไม่ได้มีมูลค่าเท่ากัน คำขอบางรายการมีการคำนวณแพงกว่าคำขออื่นๆ มาก ระบบโควต้าตามทรัพยากรได้รับการออกแบบมาเพื่อรองรับเกณฑ์การสุ่มตัวอย่างที่สูงขึ้นในขณะที่ยังคงปกป้องโครงสร้างพื้นฐานการรายงานของ Analytics ไว้
พร็อพเพอร์ตี้แต่ละรายการจะได้รับการจัดสรรโทเค็นทรัพยากรการค้นหาจำนวนหนึ่ง ไคลเอ็นต์ API สามารถเพิ่มช่องที่ไม่บังคับลงในคำขอ API เพื่อรับเกณฑ์การสุ่มตัวอย่างที่สูงขึ้นโดยแลกเปลี่ยนกับโทเค็นทรัพยากรการค้นหาที่เกี่ยวข้อง คำขอที่คำนวณได้ซึ่งมีราคาแพงกว่าจะต้องใช้โทเค็นมากกว่า
เกณฑ์การสุ่มตัวอย่าง
คำขอข้อมูลโดยใช้ Google Analytics API v4 อยู่ภายใต้เกณฑ์การสุ่มตัวอย่างทั่วไปต่อไปนี้ ตามจํานวนเซสชันในช่วงวันที่ที่ขอ (ที่ระดับพร็อพเพอร์ตี้)
- Analytics มาตรฐาน: 500,000 เซสชัน
- Analytics 360: 1 ล้านเซสชัน
- Analytics 360 ที่ใช้โควต้าตามทรัพยากร: 100 ล้านเซสชัน
เปิดใช้โควต้าตามทรัพยากร
หากต้องการเปิดใช้โควต้าตามทรัพยากรสำหรับคำขอหนึ่งๆ การเรียก API ต้องมีช่อง useResourceQuotas
ที่ไม่บังคับในเมธอด batchGet
{
"reportRequests": [{object(ReportRequest)}],
"useResourceQuotas": boolean,
}
เช่น
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2017-06-15",
"endDate":"2017-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}],
"useResourceQuotas": true
}
ช่องตอบกลับเกี่ยวกับค่าใช้จ่ายของทรัพยากรการค้นหา
สำหรับการเรียกเมธอด batchGet
แต่ละครั้ง คำตอบจะมีช่อง queryCost
{
"reports": [{ object(Report) }],
"queryCost": number
}
ช่อง queryCost
เป็นจำนวนเต็มที่แสดงค่าใช้จ่ายสำหรับทรัพยากรทั้งหมดของ ReportRequests
ทั้งหมดในคำขอ batchGet
เช่น
{
"reports": [
{
"columnHeader": {...},
"data": {
"rows": [...]
}
}
],
"queryCost": 1337
}
การจัดสรรโควต้า
โควต้าพร็อพเพอร์ตี้ Analytics 360
- หน่วยค่าใช้จ่ายของการค้นหา 100,000 หน่วยต่อวันต่อพร็อพเพอร์ตี้
- หน่วยค่าใช้จ่ายของข้อความค้นหา 25,000 หน่วยต่อชั่วโมงต่อพร็อพเพอร์ตี้
คุณจะได้รับข้อผิดพลาด RESOURCE_EXHAUSTED
หากใช้เกินโควต้า โปรดดูรายละเอียดในการตอบกลับข้อผิดพลาด
การคำนวณค่าใช้จ่าย
ค่าใช้จ่ายในคำขอจะเป็นสัดส่วนกับ
- ขนาดของช่วงวันที่
- จำนวน Hit ภายในมุมมอง
- Cardinality ของมิติข้อมูลที่ขอ
- จำนวนมิติข้อมูลและเมตริกที่ขอ
- ความซับซ้อนของคำจำกัดความกลุ่มและตัวกรอง
- สถานะการประมวลผลข้อมูลที่ขอ (การขอข้อมูลวันนี้มีค่าใช้จ่ายมากกว่าการขอข้อมูลของเมื่อวาน)
- มีมิติข้อมูลและเมตริกการนำเข้าเวลาสืบค้น
ขีดจำกัดและการใช้งาน API
นอกจากระบบโควต้าตามทรัพยากรแล้ว API ยังอยู่ภายใต้ขีดจำกัดและโควต้าใน Analytics API v4 ด้วย
Notes
- ฟิลด์ตอบกลับ
queryCost
จะแสดงค่าใช้จ่ายที่คำนวณได้ของคำขอ โดยไม่ต้องเสียค่าใช้จ่ายใดๆ และใช้ API ได้ฟรี - รายงานระหว่างวันและข้อมูลย้อนหลังบางรายการ (อายุ 1 ปีขึ้นไป) อาจยังคงมีการสุ่มตัวอย่างไม่ว่าการตั้งค่า
useResourceQuotas
จะเป็นอย่างไรก็ตาม - หากคำขอตอบสนองเกณฑ์การสุ่มตัวอย่างที่สูงขึ้นไม่ได้ ระบบจะไม่หักโทเค็นโควต้าทรัพยากร (คำตอบจากการสุ่มตัวอย่างจะไม่มีค่าใช้จ่ายสำหรับโควต้าทรัพยากรเสมอ)
- รายงานมีข้อมูลตัวอย่างหากมีช่อง
samplesReadCounts
,samplingSpaceSizes
ในการตอบกลับ
หากต้องการดูหรือเปลี่ยนแปลงขีดจำกัดการใช้งานสำหรับโปรเจ็กต์หรือขอเพิ่มโควต้า ให้ทำดังนี้
- หากยังไม่มีบัญชีสำหรับการเรียกเก็บเงินสำหรับโปรเจ็กต์ ให้สร้างบัญชี
- ไปที่หน้า API ที่เปิดใช้ของไลบรารี API ในคอนโซล API และเลือก API จากรายการ
- หากต้องการดูและเปลี่ยนการตั้งค่าที่เกี่ยวข้องกับโควต้า ให้เลือกโควต้า หากต้องการดูสถิติการใช้งาน ให้เลือกการใช้งาน