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