כדי לאחזר ישויות של Google Ads API ונתוני דיווח, אפשר להשתמש באחת מהשיטות הבאות:
הנה ההבדלים ברמה הכללית בין שתי השיטות:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| מתאים לקוד ייצור | כן | כן |
| שירות | GoogleAdsService |
GoogleAdsService |
| תרחיש | אחזור אובייקטים ודוחות | אחזור אובייקטים ודוחות |
| תשובה | זרם של GoogleAdsRow אובייקטים |
דפים של GoogleAdsRow אובייקטים |
| השדות של התשובה | רק את אלה שצוינו בשאילתה | רק את אלה שצוינו בשאילתה |
| מגבלות יומיות | מגבלות יומיות לפי רמות גישה | מגבלות יומיות לפי רמות גישה |
SearchStream לעומת חיפוש
אפשר לשלוח באמצעות Search מספר בקשות לפי עימוד להורדת הדוח כולו, אבל SearchStream שולח בקשה אחת ויוצר חיבור קבוע עם Google Ads API, ללא קשר לגודל הדוח.
עבור SearchStream, חבילות הנתונים יתחילו לרדת מיד כשכל התוצאה תישמר במאגר נתונים זמני. הקוד יכול להתחיל לקרוא את הנתונים ששמורים במאגר נתונים זמני, בלי לחכות עד שכל השידור יסתיים.
על ידי ביטול הזמן ברשת הלוך ושוב שנדרש כדי לבקש כל דף בתגובה Search, בהתאם לאפליקציה שלכם, SearchStream יכול להציע ביצועים משופרים לעומת דפדוף, במיוחד בדוחות גדולים יותר.
דוגמה
לדוגמה, דוח שמורכב מ-100,000 שורות. הטבלה הבאה מפרטת את ההבדלים החשבונאיים בין שתי השיטות.
| SearchStream | חיפוש | |
|---|---|---|
| גודל הדף | לא רלוונטי | 10,000 שורות בכל דף |
| מספר בקשות API | בקשה אחת | 10 בקשות |
| מספר תגובות API | שידור רציף אחד | 10 תשובות |
גורמי ביצועים
ברוב התרחישים לדוגמה, אנחנו ממליצים על SearchStream מעל Search מהסיבות הבאות:
בדוחות על דף יחיד (פחות מ-10,000 שורות): אין הבדלים משמעותיים בביצועים בין שתי השיטות.
בדוחות מרובים על דפים:
SearchStreamבדרך כלל מהיר יותר כי נמנעים מכמה מהלכים, וקריאה או כתיבה ממטמון הדיסק פחות חשובות.
הגבלות קצב של יצירת בקשות
המגבלות היומיות בשתי השיטות תואמות למגבלות הסטנדרטיות ולרמות הגישה של קוד המפתח. שאילתה או דוח יחידים נספרים כפעולה אחת, ללא קשר לתוצאה המשודרת או שמשודרת.