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