โควต้าตามทรัพยากร

เอกสารนี้อธิบายระบบโควต้าตามทรัพยากรสำหรับ 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 ในการตอบกลับ

หากต้องการดูหรือเปลี่ยนแปลงขีดจำกัดการใช้งานสำหรับโปรเจ็กต์หรือขอเพิ่มโควต้า ให้ทำดังนี้

  1. หากยังไม่มีบัญชีสำหรับการเรียกเก็บเงินสำหรับโปรเจ็กต์ ให้สร้างบัญชี
  2. ไปที่หน้า API ที่เปิดใช้ของไลบรารี API ในคอนโซล API และเลือก API จากรายการ
  3. หากต้องการดูและเปลี่ยนการตั้งค่าที่เกี่ยวข้องกับโควต้า ให้เลือกโควต้า หากต้องการดูสถิติการใช้งาน ให้เลือกการใช้งาน