ขีดจำกัดและโควต้าของคำขอ API

เอกสารนี้จะอธิบายขีดจำกัดและโควต้าของการขอ Management API และ Reporting API

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

วิดีโอนี้จะพูดถึงแนวทางปฏิบัติแนะนำในการจัดการโควต้าคำขอ Google Analytics API

ขีดจำกัดโควต้าทั่วไป

โควต้าต่อไปนี้มีผลกับ Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API และReal Time Reporting API

  • คำขอ 50,000 รายการต่อโปรเจ็กต์ต่อวัน ซึ่งเพิ่มได้
  • 10 คำค้นหาต่อวินาที (QPS) ต่อที่อยู่ IP
    • ซึ่งในคอนโซล API มีโควต้าที่คล้ายกันที่เรียกว่าคําขอต่อ 100 วินาทีต่อผู้ใช้ โดยค่าเริ่มต้น ระบบจะตั้งค่าคำขอเป็น 100 คำขอต่อ 100 วินาทีต่อผู้ใช้ และปรับได้เป็นจำนวนสูงสุด 1,000 รายการ แต่จำนวนคำขอที่ส่งไปยัง API จำกัดไว้ที่ไม่เกิน 10 คำขอต่อวินาทีต่อผู้ใช้
    • หากแอปพลิเคชันของคุณสร้างคำขอ API ทั้งหมดจากที่อยู่ IP เดียว (นั่นคือ ในนามของผู้ใช้) ให้ใช้พารามิเตอร์ userIP หรือ quotaUser กับคำขอแต่ละรายการเพื่อรับโควต้า QPS เต็มสำหรับผู้ใช้แต่ละราย โปรดดูรายละเอียดในสรุปพารามิเตอร์การค้นหามาตรฐาน

API การจัดการ

Google Analytics ใช้โควต้ากับคำขอไปยัง API การจัดการต่อไปนี้

เขียน API

โควต้าเหล่านี้จะมีผลกับคำขอการเขียน (insert, update, patch และ delete)

  • คำขอเขียน 50 รายการต่อโปรเจ็กต์ต่อวัน ซึ่งเพิ่มขึ้นได้
  • 1.5 คำค้นหาต่อวินาที (QPS) ต่อรหัสบัญชี

ข้อผิดพลาดในการเขียนคำขอ

หากคำขอเขียนไม่สำเร็จและคุณได้รับรหัสตอบกลับ 500 หรือ 503 คุณสามารถส่งอีกครั้งได้ Google Analytics ช่วยให้

  • คำขอการเขียนที่ล้มเหลว 50 รายการต่อชั่วโมง

หากคุณพยายามส่งคำขอการเขียนที่ล้มเหลวมากกว่า 50 รายการต่อชั่วโมง คุณจะได้รับข้อผิดพลาดต่อไปนี้

Quota Error: The number of recent failed writes is too high.

แทนที่จะส่งคำขอการเขียนที่ไม่สำเร็จอยู่เรื่อยๆ ให้ใช้ Exponential Backoff เพื่อส่งใหม่

API การนำเข้าข้อมูล

โควต้าต่อไปนี้มีไว้สำหรับทรัพยากร Uploads โดยเฉพาะ

  • ขีดจำกัดพื้นที่เก็บข้อมูลสำหรับการนำเข้าข้อมูลที่ขยายตลอดช่วงอายุการใช้งาน (ไม่มีผลกับข้อมูล Hit ที่ส่งจาก API และ SDK รวบรวมข้อมูล) มีดังนี้
  • 50 ชุดข้อมูลต่อพร็อพเพอร์ตี้
  • 50 การอัปโหลดต่อพร็อพเพอร์ตี้ต่อวัน
  • 1 GB ต่อไฟล์ที่อัปโหลด
  • ขีดจำกัดเฉพาะข้อมูลค่าใช้จ่าย
    • 100 MB ต่อวัน (ga:date) ต่อชุดข้อมูล ตัวอย่างเช่น หากคุณนำเข้าข้อมูล 50 MB ในวันที่ 2014-10-10 ในการอัปโหลด 1 ครั้ง และข้อมูล 50 MB สำหรับ 2014-10-10 ในการอัปโหลดครั้งที่ 2 สำหรับชุดข้อมูลดังกล่าวถึงขีดจำกัด 100 MB แล้วสำหรับชุดข้อมูลดังกล่าวในปี 2014-10-10

API การทดสอบ

โควต้านี้ใช้กับการทดสอบเท่านั้น

  • 12 การทดสอบต่อการดู (โปรไฟล์)

การทดสอบที่มี statuses รายการใดรายการหนึ่งต่อไปนี้จะนับรวมอยู่ในโควต้านี้

  • DRAFT
  • READY_TO_RUN
  • RUNNING

การทดสอบที่สิ้นสุด (สถานะ = ENDED) นานกว่า 1 วันจะไม่นับรวมในโควต้านี้

API รายงานที่ไม่ได้เก็บตัวอย่าง

โควต้าเหล่านี้จะใช้กับรายงานที่ไม่ได้เก็บตัวอย่างเท่านั้น

  • คำขอ API เพื่อสร้างรายงานแบบไม่สุ่มตัวอย่างจะนับรวมอยู่ในโควต้าคำขอเขียนทั่วไป
  • API ใช้ระบบโทเค็นต่อพร็อพเพอร์ตี้ ต่อวัน เดียวกันกับที่อินเทอร์เฟซเว็บใช้เพื่อสร้างรายงานแบบไม่สุ่มตัวอย่าง
  • จำนวนรายงานที่ไม่ได้เก็บตัวอย่างสูงสุดที่อนุญาตคือ 3,500 รายการ เมื่อถึงขีดจำกัดนี้แล้ว ให้พยายามสร้างรายงานแบบไม่สุ่มตัวอย่างเพิ่มเติมด้วยผลลัพธ์ API ด้วยข้อผิดพลาดต่อไปนี้ 
    Error creating this entity. You have reached the maximum allowed entities of this type.

API สิทธิ์ของผู้ใช้

โควต้านี้ใช้กับสิทธิ์ของผู้ใช้เท่านั้น

  • ผู้ใช้มีบัญชี Analytics ได้สูงสุด 100 บัญชี การเพิ่มผู้ใช้ที่มีบัญชี Analytics 100 บัญชีลงในบัญชีใหม่จะทำให้เกิดข้อผิดพลาด

โควต้าต่อไปนี้มีผลกับคำขอการเขียนเป็นกลุ่ม (delete, insert, update) ที่ส่งไปยังสิทธิ์ของผู้ใช้

  • คำขอสิทธิ์ผู้ใช้เขียน 300 รายการต่อคำขอแบบกลุ่ม
  • คำขอเขียนสิทธิ์จากผู้ใช้แบบกลุ่ม 30 รายการนับเป็นคำขอเขียน 1 รายการ

เกินขีดจำกัดโควต้า

หากเกินโควต้าในการขอ Google Analytics API แล้ว API จะแสดงผลรหัสข้อผิดพลาด 403 หรือ 429 และข้อความว่าบัญชีดังกล่าวเกินโควต้าแล้ว ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการให้บริการ

กำลังขอโควต้าเพิ่มเติม

คุณขอเพิ่มได้เฉพาะรายการต่อไปนี้

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

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

หากต้องการขอเพิ่มโควต้าสูงสุด โปรดใช้แบบฟอร์มขอโควต้า Analytics API โปรดอย่าลืมตรวจสอบข้อมูลและทำตามวิธีการในแบบฟอร์มคำขอโควต้าก่อนที่จะส่งคำขอ สำหรับ Reporting API v4 ชื่อ API ในคอนโซล Google API คือ Google Analytics Reporting API API v3 อื่นๆ ทั้งหมด (เช่น Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) จะแสดงอยู่ในหัวข้อ Analytics API ในคอนโซล Google API

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