מתבצע אחזור של אובייקטים

GoogleAdsService הוא שירות מאוחד של אחזור אובייקטים ודיווח ב-Google Ads API. לשירות יש שיטות שמאפשרות:

• אחזור מאפיינים ספציפיים של אובייקטים.
• אחזור מדדי ביצועים של אובייקטים לפי טווח תאריכים.
• סידור אובייקטים על סמך המאפיינים שלהם.
• משתמשים בתנאים כדי לציין אילו אובייקטים רוצים להחזיר בתגובה.
• להגביל את מספר האובייקטים שיוחזרו.

הפונקציה GoogleAdsService יכולה להחזיר תוצאות בשתי דרכים:

• GoogleAdsService.SearchStream מחזירה את כל השורות בתגובה אחת בסטרימינג, יעילה יותר לקבוצות תוצאות גדולות (יותר מ-10,000 שורות). האפשרות הזו מתאימה יותר אם אתם רוצים להוריד כמה שיותר נתונים מהר ככל האפשר באפליקציית האצווה.
• GoogleAdsService.Search מחלק תשובות גדולות לדפי תוצאות מנוהלים. האפשרות הזו מתאימה יותר אם באפליקציה האינטראקטיבית מוצג דף אחד של תוצאות בכל פעם.

מידע נוסף על דפים לעומת סטרימינג

שליחת בקשה

שיטת החיפוש דורשת את הערך SearchGoogleAdsRequest, שמורכב מהמאפיינים הבאים:

• customer_id
• שפת שאילתות של Google Ads‏ query שמציינת את המשאב שאליו צריך לשלוח שאילתה, את המאפיינים, הפלחים והמדדים שצריך לאחזר ואת התנאים שבהם צריך להשתמש כדי להגביל את האובייקטים שיוחזרו
• (GoogleAdsService.Search בלבד) הערך page_size מציין כמה אובייקטים יוחזרו בתגובה אחת כשמשתמשים בדפים.
• (GoogleAdsService.Search בלבד) page_token אופציונלי לאחזור המקבץ הבא של תוצאות כשמשתמשים בחלוקה לדפים.

מידע נוסף על שפת השאילתות של Google Ads זמין במדריך לשפת השאילתות של Google Ads.

עיבוד התשובה

הפונקציה GoogleAdsService מחזירה רשימה של אובייקטים מסוג GoogleAdsRow.

כל GoogleAdsRow מייצג אובייקט שהוחזר על ידי שאילתה, והוא מורכב מקבוצת מאפיינים שמאוכלסים על סמך השדות שביקשת בפסקה SELECT. מאפיינים שלא נכללים בפסקה SELECT לא מאוכלסים באובייקטים GoogleAdsRow בתגובה.

לדוגמה, למרות של-ad_group_criterion יש מאפיין status, השדה status של המאפיין ad_group_criterion בשורה לא מאוכלס בתגובה לשאילתה שבה התנאי SELECT לא כולל את ad_group_criterion.status. באופן דומה, המאפיין campaign של השורה לא מאוכלס אם התנאי SELECT לא כולל שדות מהמשאב campaign.

לכל GoogleAdsRow יכולים להיות מאפיינים ומדדים שונים משורה אחרת באותה קבוצת תוצאות, לכן צריך להתייחס לשורות כאל אובייקטים ולא כשורות קבועות בטבלה.

סוגי enum מסוג UNKNOWN

משאבים שמוחזרים עם הסוג UNKNOWN לא נתמכים באופן מלא בגרסה הזו של ה-API. יכול להיות שהמשאבים האלה נוצרו דרך ממשקים אחרים, כמו ממשק המשתמש של Google Ads. אפשר לבחור מדדים כשסוג המשאב הוא UNKNOWN, אבל אי אפשר לשנות את המשאב דרך ה-API. לדוגמה, קמפיין או מודעה חדשים שהוצגו בממשק המשתמש אבל לא נתמכים בגרסה של ה-API שאליה אתם שולחים את השאילתה.

ריכזנו כאן כמה שיקולים שכדאי לזכור:

• אפשר להוסיף תמיכה למשאב מסוג UNKNOWN מאוחר יותר, או שהוא יכול להישאר בסטטוס UNKNOWN ללא הגבלת זמן.
• אובייקטים חדשים מסוג UNKNOWN יכולים להופיע בכל שלב. האובייקטים האלה תואמים לאחור כי ערך המאפיין enum כבר זמין. המשאבים יוצגו עם השינוי הזה ככל שהם יהיו זמינים, כדי שתוכלו לקבל תמונה מדויקת של החשבון. המשאב UNKNOWN יכול להופיע בגלל פעילויות חדשות בחשבון דרך ממשקים אחרים, או כשמשאב מסוים כבר לא נתמך.
• למשאבי UNKNOWN יכולים להיות מדדים מפורטים שאפשר להריץ עליהם שאילתות.
• בדרך כלל, המשאבים מסוג UNKNOWN גלויים במלואם בממשק המשתמש של Google Ads.
• בדרך כלל אי אפשר לשנות את המשאבים של UNKNOWN.

פילוח

התשובה תכלול ערך GoogleAdsRow אחד לכל שילוב של הפרטים הבאים:

• מופע של המשאב הראשי שצוין בפסקה FROM
• הערך של כל שדה segment שנבחר

לדוגמה, התגובה לשאילתה שבוחרת את FROM campaign ויש בה את segments.ad_network_type ו-segments.date בתנאי SELECT תכלול שורה אחת לכל שילוב של הערכים הבאים:

• campaign
• segments.ad_network_type
• segments.date

התוצאות מחולקות באופן משתמע לפי כל מופע של המשאב הראשי, ולא לפי הערכים של השדות הנבחרים. לדוגמה,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

תיצור שורה אחת לכל קמפיין, ולא שורה אחת לכל ערך ייחודי בשדה campaign.status.