מעבר מ-v1 ל-v2

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

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

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

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

כדי להשתמש ב-v2 במקום ב-v1, צריך לעדכן את הבקשות כך שישתמשו בגרסה החדשה. נקודות קצה (endpoints).

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

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

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

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

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

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

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

עדכון קריאות לשיטות טירגוט

חלק מסוגי הטירגוט מוקצים עכשיו באמצעות ערכי enum במקום טירגוט המזהים של האפשרויות. לדוגמה, מכשירי טאבלט מטורגטים עכשיו ישירות באמצעות DEVICE_TYPE_TABLET DeviceType enum, במקום את המזהה של אפשרות הטירגוט שירות targetingTypes.targetingOptions. גרסאות מחרוזת של מיוצגים טיפוסים כאלה השדה assignedTargetingOptionIdAlias בשפות האלה AssignedTargetingOption משאבים ואפשר להשתמש בהם במהלך אחזור או מחיקת טירגוט קיים. הערך assignedTargetingOptionId מתוך AssignedTargetingOption משאבים אלה לא השתנו.

מעדכנים את הקריאות שמנהלות את סוגי הטירגוט הבאים כדי להשתמש בערכי enum:
השיטה advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions האפשרות הוחלפה בשיטה advertisers.lineItems.bulkEditAssignedTargetingOptions
השיטה advertisers.lineItems.bulkListLineItemAssignedTargetingOptions האפשרות הוחלפה בשיטה advertisers.lineItems.bulkListAssignedTargetingOptions
עדכון השיחות בניהול TARGETING_TYPE_PROXIMITY_LOCATION_LIST כדי להשתמש בגודל רדיוס מוגדר יחידת מרחק במקום ערך enum ProximityRadiusRange.
שיטות טירגוט שמאחזרות או עורכים אפשרויות טירגוט בכמה שיטות סוגי הטירגוט במשאב הורה יחיד השתנו.

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

עדכון השיחות לשירות `advertisers.lineItems`

השדה inventorySourceIds הוסר. בעלי הרשאת ניהול הקצאת מקור מלאי שטחי פרסום באמצעות AssignedTargetingOption משאבים מתוך TARGETING_TYPE_INVENTORY_SOURCE.
לערכי enum של LineItemWarningMessage יש את הערכים הבאים: הוצאו משימוש ב-v2 ולא יופיעו יותר LineItem.warningMessages:
- NO_POSITIVE_AUDIENCE_LIST_TARGETED
- APP_INSTALL_NO_CONVERSION_PIXEL
- TARGETING_REVOKED_OR_CLOSED_USER_LIST
- APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
- CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
- NO_CREATIVE_FOR_TARGETED_DEALS
- TARGETING_DEPRECATED_GEO_TARGET
השדה triggerId הוסר אובייקט LineItemFlight, הערך LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER הוסר מ- LineItemFlightDateType מסוג 'טיפוסים בני מנייה (enum)'. גרסה 2 לא תומכת הגדרת פריטים להוצאה על סמך הפעלה של טריגרים ידניים.

עדכון השיחות לשירות `customBiddingAlgorithms`

customBiddingAlgorithmState וmodelReadiness השדות הוחלפו ב-modelDetails השדה, שמספק את הפרמטר מוכנות ואת מצבי ההשעיה של האלגוריתם הקיים לכל מפרסם שיש לו גישה באמצעות רשימה של CustomBiddingModelDetails אובייקטים.

שינויים נוספים

בנוסף לשינויי התוכנה שהוזכרו למעלה, גרסה 2 כוללת גם פיצ'רים חדשים לבינה מלאכותית גנרטיבית.

את התכונות שנוספו לגרסה 2 לאחר ההשקה הראשונית ניתן למצוא נתוני גרסה.

הרשאת קריאה בלבד לפריטים ב-YouTube

בגרסה 2, ניתן לאחזר את הפריטים ב-YouTube ואת הגדרות הטירגוט שלהם באמצעות advertisers.lineItems advertisers.lineItems.targetingTypes.assignedTargetingOptions השירותים שלנו, בהתאמה. ה-API מספק הרשאת קריאה בלבד, כלומר בקשות כתיבה שנשלחו לפריטים האלה יחזירו שגיאה. YouTube הפריטים יהיו באחד מהערכים הבאים של LineItemType ערכים:

שיטות חדשות לשיפור הביצועים

בגרסה 2, השירות advertisers.lineItems מספק שיטות לשימוש במקום בקשות מרובות, ביצועים וצריכה מופחתת של מכסות:

אפשר להשתמש ב-advertisers.lineItems.bulkUpdate כדי להגדיר אותם ערכי שדה למספר פריטים. רק עדכונים של השדה entityStatus נתמך בשלב הזה.
אפשר להשתמש advertisers.lineItems.bulkEditAssignedTargetingOptions כדי להוסיף או להסיר את אותן אפשרויות טירגוט שהוקצו במספר קווים פריטים.
אפשר להשתמש advertisers.lineItems.bulkListAssignedTargetingOptions כדי להציג רשימה של אפשרויות טירגוט שהוקצו לפריטים מרובים.
אפשר להשתמש ב-advertisers.lineItems.duplicate כדי ליצור שכפול של פריט קיים באותה הזמנת קמפיין, העתקה של כל הפריטים והגדרות הטירגוט.

גישת כתיבה חלקית לטירגוט של הזמנת קמפיין

בגרסה 2 אפשר לערוך הגדרות טירגוט של קבוצת משנה עבור InsertionOrder משאבים באמצעות create שיטה delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions לאחר השיפור. אפשר לנהל את סוגי הטירגוט הבאים באופן מלא בכניסה לחשבון רמת הזמנה:

TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_GENDER
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_VIEWABILITY