מדי פעם כדאי לשדרג מגרסה ראשית ישנה יותר של Google Ads API לגרסה ראשית חדשה יותר. יכול להיות שהסיבה לכך היא שהוצאה משימוש של גרסה מסוימת, או שאתם רוצים להשתמש בתכונה חדשה. אנחנו ממליצים לשדרג תמיד לגרסה החדשה ביותר.
מומלץ לעיין בלוח הזמנים להוצאה משימוש כדי לתכנן את השדרוגים. כדי ללמוד איך פועל ניהול הגרסאות, אפשר לעיין במדריך לניהול גרסאות.
הנה רשימת משימות שתעזור לכם להתחיל בתהליך השדרוג:
- נקודת הקצה (endpoint) משתנה כשמחליפים גרסאות ראשיות. מעדכנים את ספריות הלקוח כך שישתמשו בנקודת הקצה החדשה ביותר.
- בנתוני הגרסה אפשר לראות את השינויים שנוספו בכל גרסה.
- בטבלאות הבאות מפורטים אזורים ספציפיים שבהם כדאי להתמקד בגרסה שאליה משדרגים.
לסקירה כללית מקיפה של השינויים על סמך ההבדלים בין גרסאות ה-Proto משתי הגרסאות, עיינו בטבלת ההבדלים.
v16 עד v17
שינויים בשירותים וברכיבים שלהם | |
---|---|
GoogleAdsService
Search ו-SearchStream בקשות |
השגיאה שמופיעה בזמן ויסות נתונים (throttle) של הבקשה כי היא יקרה מדי תהיה |
GoogleAdsService
בקשות Search . |
העברת |
הפקודה Campaign והפקודה Ad |
במקום זאת, קמפיינים עם בנוסף, מודעות מסוימות ישנו את שמות הסוג והשדות לצורך דיווח:
|
AdService |
נקודת הקצה (endpoint) GetAd תוסר. באופן הזה, AdService יכול להתאים לשירותים אחרים ב-Google Ads API. מומלץ לעיין במדריך שלנו בנושא אחזור אובייקטים כדי ללמוד על הדרך המומלצת לאחזור מודעות וסוגי משאבים אחרים. |
CustomerLifecycleGoal
ו-CampaignLifecycleGoal |
אופן הניהול של פלחים עבור יעדים של מחזורי חיים שונה. סקירה כללית מלאה זמינה בקטע פילוח הקהלים במאמרי העזרה בנושא מטרות עסקיות במחזור החיים. |
ProductLink |
כשמריצים בקשה מסוג GoogleAdsService לחיפוש או לזרם חיפוש, עבור product_link , עכשיו אפשר לבחור רק שדות שקשורים למוצר מקושר אחד. אם בוחרים כמה שדות ממוצרים מקושרים שונים, תופיע השגיאה QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE . |
דיווח | שיניתם את השם של השדה metrics.sk_ad_network_conversion_value ל-metrics.sk_ad_network_fine_conversion_value . |
v15 עד v16
שינויים בשירותים וברכיבים שלהם | |
---|---|
AccountLink |
הקישורים data_partner ו-google_ads ב-linked_account הוסרו. במקום זאת, השתמשו ב-ProductLinkService וב-ProductLinkInvitationService . |
CampaignLifecycleGoal |
כשמעדכנים CampaignLifecycleGoal קיים בעבר, צריך לבצע פעולה create עם דרישות ספציפיות.
עכשיו אפשר לבצע פעולת update כמו בסוגי משאבים אחרים. |
דיווח על שגיאות | בשני מקרים שבהם השגיאה הגנרית ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT הוחזרה, מתקבלות הודעות שגיאה ספציפיות יותר:
|
AudienceInsightsAttributeMetadata |
השדה score הוסר. |
KeywordMatchTypeRecommendation |
אם סוג ההתאמה של מילת המפתח לא מוגדר, ה-API יחזיר עכשיו UNSPECIFIED במקום UNKNOWN לשדה recommended_match_type . |
v14 עד v15
שינויים בשירותים וברכיבים שלהם | |
---|---|
AssetGroupListingGroupFilter
|
השם של השדה vertical enum השתנה ל-feed_type .
|
MediaFileService
|
השירות הוסר כי אין בו יותר צורך.
השינוי בImageAdInfo מוצג בהמשך.
|
ImageAdInfo
|
השדה media_file הוחלף ב-image_asset .
|
MerchantCenterLinkService
|
השירות הוחלף ב-
ProductLinkInvitationService וב-
ProductLinkService .
|
Campaign.ShoppingSetting
|
השדה sales_country הוסר. המידע מוחזר בשדה feed_label .
|
ProductBiddingCategoryConstant
|
הוחלף ב-
ProductCategoryConstant .
השמות של כמה שדות השתנו בהתאם. אפשר לראות את שלושת השינויים הבאים למטה.
|
ListingDimensionInfo
|
השדה product_bidding_category הוחלף ב-product_category .
|
ListingGroupFilterDimension
|
השדה product_bidding_category הוחלף ב-product_category .
|
דוח shopping_performance_view |
שדות הפילוח הבאים:
|
Campaign.shopping_setting
|
הוסרה התמיכה ביצירת קמפיינים לרשת החיפוש עם השדה הזה. |
CampaignCriterion.listing_scope
|
הוסרה התמיכה ביצירת קמפיינים לרשת החיפוש עם השדה הזה. |
דוח sk_ad_network_conversions |
השדה metrics.sk_ad_network_conversions הוחלף ב-metrics.sk_ad_network_installs .
|
OfflineConversionClientSummary
|
העברתם את השדה offline_conversion_client_summaries מ-Customer למשאב ברמה עליונה שאפשר לשלוח שאילתות בנפרד.
שינוי השאילתה מ: SELECT customer.offline_conversion_client_summaries FROM customerאל: SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary תוכלו להשתמש בכלי ליצירת שאילתות כדי לעיין ברשימת השדות הזמינים לבחירה ולסינון. |
OfflineConversionUploadAlert
|
שינית את שם השיחה לשם
OfflineConversionAlert . |
OfflineConversionUploadError
|
שינית את שם השיחה לשם
OfflineConversionError . |
AdNetworkType
|
הערכים של טיפוסים בני מנייה (enum)
YOUTUBE_SEARCH ו-
YOUTUBE_WATCH מוזגו ל-enum אחד:
YOUTUBE .
|