หากต้องการดึงเอนทิตี Google Ads API และข้อมูลการรายงาน ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
ข้อแตกต่างระดับสูงของทั้ง 2 วิธีมีดังนี้
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| เหมาะสำหรับโค้ดเวอร์ชันที่ใช้งานจริง | มี | มี |
| บริการ | GoogleAdsService |
GoogleAdsService |
| สถานการณ์ | การดึงข้อมูลออบเจ็กต์และรายงาน | การดึงข้อมูลออบเจ็กต์และรายงาน |
| คำตอบ | สตรีมของวัตถุ GoogleAdsRow รายการ |
หน้าของออบเจ็กต์ GoogleAdsRow รายการ |
| ช่องของการตอบกลับ | เฉพาะที่ระบุไว้ในข้อความค้นหา | เฉพาะที่ระบุไว้ในข้อความค้นหา |
| ขีดจำกัดการใช้งานต่อวัน | ขีดจำกัดรายวันตามระดับการเข้าถึง | ขีดจำกัดรายวันตามระดับการเข้าถึง |
SearchStream กับ Search
แม้ว่า Search จะส่งคำขอที่มีเลขหน้าหลายรายการเพื่อดาวน์โหลดทั้งรายงานได้ แต่ SearchStream จะส่งคำขอเดียวและเริ่มการเชื่อมต่อถาวรกับ Google Ads API โดยไม่คำนึงถึงขนาดรายงาน
สำหรับ SearchStream แพ็กเก็ตข้อมูลจะเริ่มดาวน์โหลดทันทีพร้อมทั้งผลลัพธ์ทั้งหมดที่แคชไว้ในบัฟเฟอร์ข้อมูล โค้ดจะเริ่มอ่านข้อมูลที่บัฟเฟอร์ได้โดยไม่ต้องรอให้ทั้งสตรีมสิ้นสุด
การลดเวลาของเครือข่ายแบบไป-กลับที่ต้องใช้ในการส่งคำขอการตอบกลับ Search แต่ละหน้า ซึ่ง SearchStream สามารถมอบประสิทธิภาพที่ดีขึ้นมากกว่าการแบ่งหน้า โดยเฉพาะสำหรับรายงานขนาดใหญ่
ตัวอย่าง
ดูรายงานที่มี 100,000 แถวเป็นตัวอย่าง ตารางต่อไปนี้แจกแจงความแตกต่างทางบัญชีระหว่าง 2 วิธี
| SearchStream | ค้นหา | |
|---|---|---|
| ขนาดหน้า | ไม่เกี่ยวข้อง | 10,000 แถวต่อหน้า |
| จำนวนคำขอ API | คำขอ 1 รายการ | คำขอ 10 รายการ |
| จำนวนการตอบกลับจาก API | สตรีมอย่างต่อเนื่อง 1 รายการ | การตอบกลับ 10 รายการ |
ปัจจัยด้านประสิทธิภาพ
สำหรับกรณีการใช้งานส่วนใหญ่ เราขอแนะนำให้ใช้ SearchStream มากกว่า Search ด้วยเหตุผลต่อไปนี้
สำหรับรายงานแบบหน้าเดียว (น้อยกว่า 10,000 แถว): ไม่มีความแตกต่างด้านประสิทธิภาพที่สำคัญระหว่างทั้งสองวิธีนี้
สำหรับรายงานหลายหน้า: โดยทั่วไป
SearchStreamจะเร็วกว่าเนื่องจากมีการหลีกเลี่ยงการไป-กลับหลายรอบ และการอ่านหรือการเขียนจากดิสก์แคชจะเป็นปัจจัยที่น้อยกว่า
ขีดจำกัดอัตรา
ขีดจำกัดรายวันสำหรับทั้ง 2 วิธีจะเป็นไปตามขีดจำกัดมาตรฐานและระดับการเข้าถึงของโทเค็นของนักพัฒนาซอฟต์แวร์ การค้นหาหรือรายงานเดียวจะนับเป็น 1 การดำเนินการ ไม่ว่าจะมีการเพจหรือสตรีมผลลัพธ์หรือไม่ก็ตาม