מעבר מגרסת v3 ל-v4

העדכון האחרון: 31 ביולי 2025

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

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

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

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

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

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

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

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

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

ביצוע השינויים הנדרשים

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

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

FirstAndThirdPartyAudience משאבים הוחלפו בFirstPartyAndPartnerAudience משאבים.

כדי שהשינוי הזה יחול, צריך לעדכן את הדברים הבאים:

• הפניות למשאבי FirstAndThirdPartyAudience כדי להשתמש במשאב החדש FirstPartyAndPartnerAudience.
• בקשות קיימות לשיטות בשירות v3‏ firstAndThirdPartyAudiences לשירות v4 החדש firstPartyAndPartnerAudiences.
• הגודל המקסימלי של דף שמוגדר כברירת מחדל לבקשות של firstPartyAndPartnerAudiences.list הוא 5,000 פריטים, והמינימלי הוא 100 פריטים.
• הפניות לשדה firstAndThirdPartyAudienceType בגרסה 3 לשדה firstPartyAndPartnerAudienceType החדש בגרסה 4, באמצעות סוג ה-enum החדש FirstPartyAndPartnerAudienceType, עם ערכים ישנים שתואמים לערכים החדשים הבאים:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY עד TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY עד TYPE_PARTNER

• הפניות לערך enum‏ AudienceType‏ LICENSED יוחלפו באחד מהערכים החדשים והספציפיים יותר הבאים:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• הפניות למשאבי AssignedTargetingOption של TargetingType TARGETING_TYPE_AUDIENCE_GROUP כדי להחליף את השדות בגרסה 3 של AudienceGroupAssignedTargetingOptionDetails בשדות החדשים הבאים בגרסה 4:

  • ‫excludedFirstAndThirdPartyAudienceGroup עם excludedFirstPartyAndPartnerAudienceGroup
  • ‫includedFirstAndThirdPartyAudienceGroups עם includedFirstPartyAndPartnerAudienceGroups

עדכון של בקשות קיימות לטירגוט לפי רשימות בכמות גדולה של קבוצות של מודעות

השם של advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions שונה ל-advertisers.adGroups.bulkListAssignedTargetingOptions. צריך לעדכן את הבקשות הקיימות כדי להשתמש בשם השיטה החדש.

הכללת יעד אופטימיזציה כשיוצרים הזמנות קמפיין

השדה optimizationObjective הוא עכשיו שדה חובה במשאב InsertionOrder. צריך לעדכן את הבקשות של advertisers.insertionOrders.create כדי לוודא שהשדה הזה מוגדר.

הסרת הפניות לשדה משאב הקריאייטיב publisherReviewStatuses

השדה publisherReviewStatuses הוסר מהאובייקט ReviewStatusInfo במשאב Creative אחרי שהוצא משימוש ביוני 2024.