הממשק הקודם של Search Ads 360 Reporting API יוצא משימוש ב-30 ביוני 2024. חשוב לדעת ש-Search Ads 360 Conversion API לא מושפע מכך, ונמשיך לתמוך בו. בכל פיתוח הדוחות החדש יש להשתמש ב-Search Ads 360 Reporting API החדש.

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

מומלץ מאוד להעביר את כל ההטמעות הקיימות של Search Ads 360 ל-API החדש. מידע נוסף זמין במדריך לתחילת העבודה ובמדריך להעברת נתונים של Search Ads 360 Reporting API.

דף זה תורגם על ידי Cloud Translation API.

API Reference

הפניית API זו מאורגנת לפי סוג המשאב. לכל סוג משאב יש ייצוג אחד או יותר של נתונים ושיטה אחת או יותר.

סוגי המשאבים

לפרטים על משאבי ההמרות, אפשר לעיין בדף ייצוג משאבים.

שיטה	בקשת HTTP	התיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/doubleclicksearch/v2, אלא אם צוין אחרת
מקבלים	`GET /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion`	אחזור של רשימת המרות מחשבון מנוע חיפוש ב-DoubleClick. הפרמטרים הנדרשים של השאילתה: `endDate`, `rowCount`, `startDate`, `startRow`
getByCustomerId	`GET /customer/customerId/conversion`	אחזור של רשימת המרות מחשבון מנוע חיפוש ב-DoubleClick Search באמצעות מספר לקוח חדש ב-Search Ads 360. הפרמטרים הנדרשים של השאילתה: `endDate`, `rowCount`, `startDate`, `startRow`
הוספה	`POST /conversion`	מוסיף קבוצה של המרות חדשות ל-DoubleClick Search.
עדכון	`PUT /conversion`	עדכון קבוצה של המרות ב-DoubleClick Search.
updateAvailability	`POST /conversion/updateAvailability`	עדכון הזמינות של קבוצה של פעילויות Floodlight ב-DoubleClick Search.

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

שיטה	בקשת HTTP	התיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/doubleclicksearch/v2, אלא אם צוין אחרת
generate	`POST /reports/generate`	הפונקציה יוצרת ומחזירה דוח באופן מיידי.
מקבלים	`GET /reports/reportId`	סקרים לגבי הסטטוס של בקשת דיווח.
getFile	`GET /reports/reportId/files/reportFragment`	מורידה קובץ דוח עם קידוד UTF-8.
getIdMappingFile	`GET /agency/agencyId/advertiser/advertiserId/idmapping`	תתבצע הורדה של קובץ CSV (שמקודד ב-UTF-8) שמכיל מיפויים של מזהים בין הממשק הקודם של Search Ads 360 לבין הממשק החדש של Search Ads 360. עבור המפרסם המבוקש, הקובץ כולל את כל ישויות הצאצא (למשל, חשבונות מנוע חיפוש, קמפיינים, קבוצות של מודעות וכו') שקיימות גם בממשק הקודם של Search Ads 360 וגם בממשק החדש של Search Ads 360.
בקשה	`POST /reports`	הוספה של בקשת דוח למערכת הדיווח.

לפרטים על מקורות המידע של SaveColumns, אפשר לעיין בדף Resource Protection.

שיטה	בקשת HTTP	התיאור
מזהי URI ביחס לכתובת https://www.googleapis.com/doubleclicksearch/v2, אלא אם צוין אחרת
list	`GET /agency/agencyId/advertiser/advertiserId/savedcolumns`	אחזור של רשימת העמודות השמורות של מפרסם ספציפי.