מעבר מגרסה 4 לגרסה 5 של Display & Video 360 API

עדכון אחרון: 22.10.2026

העברת האפליקציה

כדי לעבור מגרסה 4 לגרסה 5, צריך לעדכן את כתובות ה-URL של נקודות הקצה כך שיקראו לגרסה 5, לעדכן את האפליקציה כך שתביא בחשבון שינויי תוכנה שעלולים לגרום לכשל, ולבדוק אם יש תכונות חדשות שיכולות לשפר את השילוב.

עדכון הקריאות ל-API מגרסה 4 לגרסה 5

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

לדוגמה, כדי להפעיל את השיטה advertisers.get בגרסה 4, משתמשים בכתובת ה-URL הבאה:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

בגרסה 5, מעדכנים את כתובת ה-URL לכתובת הבאה:

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

אם אתם משתמשים בספריית לקוח כדי לשלוח בקשות ל-API, השתמשו בגרסה העדכנית ביותר של ספריית הלקוח ועדכנו את ההגדרות כך שישתמשו בגרסה 5.

מבצעים את השינויים הנדרשים

בגרסה 5 של Display & Video 360 API יש כמה שינויים שעלולים לגרום לכשל. כדאי לקרוא את ההוראות הבאות ולבצע את השינויים הנדרשים בהתאם לשימוש הקיים שלכם ב-Display & Video 360 API.

רשימה מלאה של ההבדלים בין גרסה 4 לגרסה 5 של Display & Video 360 API מופיעה בנתוני הגרסה.

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

בגרסה 5 של Display & Video 360 API, השתנה האופן שבו המערכת מאחזרת ומטרגטת עסקאות של מקורות מלאי שטחי פרסום וחבילות מכרזים.

בגרסה 4, משאבי InventorySource שאוחזרו באמצעות השירות inventorySources מייצגים גם עסקאות של מקורות מלאי וגם חבילות מכרזים. גם עסקאות וגם חבילות של מכרזים מטורגטות באמצעות TARGETING_TYPE_INVENTORY_SOURCE.

בגרסה 5, עסקאות של מקורות מלאי שטחי פרסום וחבילות מכרזים מטופלות בנפרד:

  • הטירגוט של עסקאות במקורות מלאי שטחי פרסום מתבצע באמצעות TARGETING_TYPE_INVENTORY_SOURCE_DEAL, והן מאוחזרות באמצעות השירותים advertisers.inventorySources ו-partners.inventorySources. הטירגוט מתבצע באמצעות השדה AssignedTargetingOption inventorySourceDetails.
  • הטירגוט של חבילות המכרזים מתבצע באמצעות TARGETING_TYPE_AUCTION_PACKAGE, והן מאוחזרות באמצעות השירות targetingTypes.targetingOptions. הטירגוט מתבצע באמצעות השדה AssignedTargetingOption auctionPackageDetails.

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

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

עדכון הלוגיקה של הטירגוט לפי קהל במשאבים של קמפיינים ליצירת ביקוש ו-YouTube

בגרסה 5 של Display & Video 360 API, לוגיקת הטירגוט לפי קהל עודכנה במשאבים של קמפיינים ליצירת ביקוש ו-YouTube, כך שנעשה שימוש באפשרויות שהוקצו בנפרד לכל רשימת קהלים מטורגטים.

בגרסה 4, כל הטירגוט לפי קהל מנוהל באמצעות TARGETING_TYPE_AUDIENCE_GROUP.

בגרסה 5, הטירגוט לפי קהל שמוקצה לקבוצות של מודעות ליצירת ביקוש ולמודעות YouTube מנוהל באמצעות אחד מסוגי הטירגוט הבאים ושדות המשאבים של AssignedTargetingOption, בהתאם לסוג הקהל:

פריטים ימשיכו להשתמש ב-TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption יחיד כדי לנהל את הטירגוט לפי קהל בכל הסוגים.

שדרוג ל-Data Manager API לניהול קהלים מסוג "התאמה ללקוחות"

בגרסה 5 של Display & Video 360 API, הסרנו את היכולת ליצור ולנהל את החברות בקהלים של התאמה ללקוחות, על ידי הסרת השיטות הבאות:

  • firstPartyAndPartnerAudiences.create
  • firstPartyAndPartnerAudiences.editCustomerMatchMembers
  • firstPartyAndPartnerAudiences.patch

כדי להמשיך לנהל קהלים מסוג "התאמה ללקוחות", צריך לשדרג את תהליכי העבודה ולהשתמש ב-Data Manager API.

הוספת תמיכה באחזור של הזמנות חוצות דיגיטליות (DOOH)

בגרסה 5 של Display & Video 360 API נוספה תמיכה באחזור של הזמנות קמפיין בפרסום חוצות דיגיטלי (DOOH).

אם המפרסמים שלכם משתמשים בפרסום חוצות דיגיטלי (DOOH), שדרגו כל שילוב שקורא ל-advertisers.insertionOrders.list לקראת הכללת משאבי InsertionOrder עם ערך השדה OUT_OF_HOME ב-insertionOrderType.

בגרסה 5, אפשר יהיה להמשיך לאחזר פריטים שהוקצו להזמנות פרסום חוצות דיגיטלי (DOOH) כמו בגרסה 4.

עדכון ההפניות ל-Adloox כך שיפנו ל-Peer39

בגרסה 5, שדות וערכי enum שמתייחסים לשילוב של Display & Video 360 עם Adloox (שנקרא גם Scope3) לצורך בדיקת התאמה למותג על ידי צד שלישי, עודכנו ל-Peer39:

עדכון שדות של פריטים, קבוצות של מודעות ומודעות ב-YouTube

בגרסה 5, שדות שונים במשאבים LineItem,‏ AdGroup ו-AdGroupAd הוסרו או עודכנו. כדי להתאים את עצמכם לשינויים האלה, אתם צריכים לעדכן את הלוגיקה של שליפת המשאבים.

במשאב LineItem:

במשאבים LineItem ו-AdGroup:

במשאב AdGroupAd:

הסרת הפניות לערכי enum שהוצאו משימוש

בגרסה 5, ערכי enum שהוצאו משימוש בעבר הוסרו לחלוטין. אם תשתמשו בערכים האלה בבקשות ל-API, תקבלו שגיאה בגרסה 4. השינוי הזה מסיר כל התייחסות אליהם מספריות הלקוח בגרסה 5. אם יש בקוד שלכם הפניות לערכים האלה שהוצאו משימוש, יכול להיות שיופיעו שגיאות כשתשדרגו לגרסה 5.

סוגי ה-enum שכוללים ערכים שהושפעו הם ContentRatingTier,‏ GoogleAudienceType,‏ SdfVersion ו-SensitiveCategory. בנתוני הגרסה מופיעה רשימה מלאה של כל ערכי ה-enum שהוסרו.

לבדוק את התכונות החדשות

בנוסף לשינויי תוכנה שעלולים לגרום לכשל, גרסה 5 כוללת גם את התכונות החדשות הבאות:

  • ניהול מלא של טירגוט החרגות של סרטונים וערוצים ב-YouTube ברמת המפרסם, בסוגי הטירגוט TARGETING_TYPE_YOUTUBE_VIDEO ו-TARGETING_TYPE_YOUTUBE_CHANNEL. בגרסה 4, הטירגוט הזה היה לקריאה בלבד.
  • היכולת ליצור משאבים של פרסום חוצות דיגיטלי (DOOH) InsertionOrder.
  • תמיכה בקבוצות של מודעות שמשתמשות בנכסי קריאייטיב שהוקצו כדי ליצור מודעות, באמצעות הוספת השדות adSource ו-creativeAssignments של AdGroup והשדה parentCreativeId של AdGroupAd.
  • היכולת ליצור ולאחזר משאבים של LookalikeAudience.
  • שדה containsSyntheticMedia חדש במשאב AdGroupAd.