ขีดจำกัด

หน้านี้จะแสดงรายการโควต้าและขีดจำกัดต่างๆ สำหรับ AdSense Management API โดยเฉพาะ โดยจะมีผลเพิ่มเติมจากขีดจำกัดเฉพาะผลิตภัณฑ์ (เช่น จำนวนแชแนลต่อบัญชี) ที่มีผลกับ AdSense โดยทั่วไป

โควต้าระดับ API

คำขอทั้งหมดที่ส่งไปยัง AdSense Management API จะนับรวมในโควต้าอัตราคำขอทั่วไป โดยไม่ขึ้นอยู่กับประเภทของคำขอ

คุณดูการใช้งานปัจจุบันสำหรับโควต้าเหล่านี้ได้โดยใช้หน้าโควต้าในคอนโซล Google API นอกจากนี้ คุณยังตั้งค่าการแจ้งเตือนการใช้งานหรือการตรวจสอบเพิ่มเติมได้ด้วย ดูเอกสารภาพรวมภาพรวมโควต้าของ Google Cloud ทั่วไปสำหรับข้อมูลเพิ่มเติม

การเกินโควต้าเหล่านี้จะทำให้คำขอถูกปฏิเสธโดยมีข้อผิดพลาด HTTP 429 คำขอมากเกินไป ข้อความแสดงข้อผิดพลาดจะแสดงรายละเอียดว่าเกินโควต้าใด

คำอธิบาย ค่า Notes
การค้นหาต่อนาทีสำหรับผู้ใช้และโปรเจ็กต์เดียว 100 ไม่มี
การค้นหาต่อนาทีสำหรับผู้ใช้ทั้งหมดที่ใช้โปรเจ็กต์เดียว 500 ไม่มี
การค้นหาต่อวัน 10,000 ระบบจะรีเซ็ตโควต้ารายวันประมาณเที่ยงคืนตามเวลาแปซิฟิก

ขีดจำกัดขนาดรายงาน

รายงานที่สร้างโดย AdSense Management API จะมีขนาดสูงสุดซึ่งขึ้นอยู่กับรูปแบบเอาต์พุต ดังนี้

  • รายงาน JSON (เช่น ที่สร้างโดยเมธอด accounts.reports.generate) มีแถวได้ไม่เกิน 100,000 แถว ระบบจะตัดรายงานที่มีขนาดใหญ่กว่านี้ออก แต่การตอบกลับจะมีช่อง totalMatchedRows ซึ่งมีขนาดของรายงานฉบับเต็ม ซึ่งใช้ระบุว่ามีการตัดข้อความหรือไม่
  • รายงาน CSV (เช่น ที่สร้างจากเมธอด accounts.reports.generateCsv) มีแถวได้ไม่เกิน 1,000,000 แถว รายงานที่มีขนาดใหญ่กว่านี้จะถูกตัดออก

รายงานโควต้าแถว

นอกจากนี้ AdSense Management API ยังบังคับใช้ขีดจำกัดกับจำนวนข้อมูลการรายงานทั้งหมดที่ระบบอาจดึงมาในแต่ละวันและระยะเวลาที่สั้นลง เพื่อป้องกันการใช้งานที่ไม่เหมาะสม การมีคำขอเกินขีดจำกัดนี้จะทำให้คำขอถูกปฏิเสธโดยมีข้อผิดพลาด HTTP 429 คำขอจำนวนมากเกินไปโดยมีข้อความเชื่อมโยงว่า "เกินโควต้าแถวของรายงาน"

ขีดจำกัดอื่นๆ ของคำขอ

พารามิเตอร์คำขอต่างๆ จะควบคุมปริมาณข้อมูลที่ควรส่งคืนสำหรับคำขอหนึ่งๆ (เช่น page_size สำหรับคำขอที่อนุญาตให้ใส่เลขหน้า หรือพารามิเตอร์ limit สำหรับคำขอสร้างรายงาน) หากไม่ได้ระบุพารามิเตอร์เหล่านี้ ค่าเริ่มต้นจะเป็นค่าสูงสุดที่อนุญาตเสมอ การระบุค่าที่สูงกว่าจะทำให้คำขอถูกปฏิเสธโดยมีข้อผิดพลาด HTTP 400 Bad Request