การปรับปรุงนโยบายการใช้ทรัพยากรของ Google Ads API

วันพุธที่ 1 พฤษภาคม 2024

สิ่งที่เปลี่ยนแปลงไป

เรากำลังปรับปรุงนโยบายการใช้ทรัพยากรของ Google Ads API เพื่อจำกัดรูปแบบการค้นหา GoogleAdsService.Search และ GoogleAdsService.SearchStream ที่ใช้ทรัพยากร API มากเกินไป หากรูปแบบการค้นหาหนึ่งๆ ถูกจำกัด บริการ วิธีการ และรูปแบบการค้นหาอื่นๆ จะยังคงทำงานต่อไปโดยไม่ได้รับผลกระทบ

ตั้งแต่วันที่ 17 มิถุนายน 2024 เป็นต้นไป คำขอจะได้รับผลกระทบดังต่อไปนี้ โดยจะมีผลเฉพาะกับรูปแบบการค้นหาที่ถูกจำกัดเท่านั้น

  • หากใช้ API เวอร์ชัน v17 หรือเก่ากว่า คุณจะได้รับข้อผิดพลาด QuotaError.RESOURCE_EXHAUSTED
  • หากใช้ API เวอร์ชัน v18 ขึ้นไป คุณจะได้รับ QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION หรือ QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION โดยขึ้นอยู่กับว่าการใช้ทรัพยากรมากเกินไปนั้นเกิดขึ้นเป็นระยะเวลาสั้นๆ (ไม่กี่นาที) หรือเป็นระยะเวลานาน

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

เหตุผลในการเปลี่ยนแปลงครั้งนี้

เราทำการเปลี่ยนแปลงนี้เพื่อรักษาความน่าเชื่อถือและความเสถียรของ API

สิ่งที่ต้องทำ

ก่อนวันที่ 17 มิถุนายน 2024 โปรดอัปเดตแอปพลิเคชันให้ทำดังต่อไปนี้

  • จัดการรหัสข้อผิดพลาดใหม่เมื่อทำการเรียก GoogleAdsService::Search or GoogleAdsService::SearchStream
    • หากคุณใช้ Google Ads API เวอร์ชัน v17 หรือก่อนหน้า ให้จัดการข้อผิดพลาด QuotaError.RESOURCE_EXHAUSTED
    • หากใช้ API เวอร์ชัน v18 ขึ้นไป ให้จัดการข้อผิดพลาด QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION และ QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
  • หากรูปแบบการค้นหาการรายงานอย่างน้อย 1 รูปแบบถูกจำกัด คุณควรตรวจสอบและแก้ไขรูปแบบการค้นหาดังกล่าว วิธีปรับปรุงประสิทธิภาพการค้นหามีดังนี้
    • เรียกใช้การค้นหาให้น้อยลง
    • ใช้รูปแบบการค้นหาหรือมุมมองที่มีค่าใช้จ่ายน้อยกว่า

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพการค้นหาได้ที่จัดการประสิทธิภาพของข้อมูล

  • [ไม่บังคับ] รวมเมตริก query_resource_consumption ใหม่เข้ากับระบบการตรวจสอบเพื่อตรวจหาและจัดการคำค้นหาใหม่ที่มีค่าใช้จ่ายสูง

วิธีรับความช่วยเหลือ

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

- David Stevens, ผู้จัดการผลิตภัณฑ์ Google Ads API

ป้ายกำกับ: google-ads-api