หากต้องการเรียกเอนทิตี Google Ads API และข้อมูลการรายงาน ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
ต่อไปนี้เป็นความแตกต่างระดับสูงสำหรับทั้งสองวิธีนี้:
| 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 รายการ |
ปัจจัยด้านประสิทธิภาพ
สําหรับ Use Case ส่วนใหญ่ เราขอแนะนําให้ SearchStream มากกว่า Search ด้วยเหตุผลต่อไปนี้
สำหรับรายงานหน้าเดียว (ไม่เกิน 10,000 แถว): ไม่มีความแตกต่างด้านประสิทธิภาพอย่างมีนัยสำคัญระหว่าง 2 วิธีเหล่านี้
สำหรับรายงานหลายหน้า โดยปกติ
SearchStreamจะทำงานเร็วกว่าเนื่องจากการหลีกเลี่ยงการส่งไป-กลับหลายครั้ง และการอ่านหรือการเขียนจากดิสก์แคชจะเป็นปัจจัยน้อยกว่า
ขีดจำกัดอัตรา
ขีดจำกัดรายวันสำหรับทั้ง 2 วิธีจะเป็นไปตามขีดจำกัดมาตรฐานและระดับการเข้าถึงของโทเค็นของนักพัฒนา คำค้นหาหรือรายงานเดียวจะนับเป็นการดำเนินการ 1 รายการ โดยไม่คำนึงว่าผลลัพธ์จะถูกแบ่งหน้าหรือสตรีม